LadybirdBrowser/ladybird
1
1
Fork 0
mirror of https://github.com/LadybirdBrowser/ladybird.git synced 2024-11-13 11:42:38 +03:00
Code Issues Packages Projects Releases Wiki Activity

Base: Add a man page for js(1)

Browse Source 
This also changes --ast-dump to --dump-ast, because I like it better
and that is what the variable is actually called.
This commit is contained in:
Sergey Bugaev 2020-03-26 10:03:17 +03:00 committed by Andreas Kling
parent ccdfb077d8
commit db4da68618
Notes: sideshowbarker 2024-07-19 08:07:21 +09:00 
Author: https://github.com/bugaevc
Commit: https://github.com/SerenityOS/serenity/commit/db4da68618e
Pull-request: https://github.com/SerenityOS/serenity/pull/1514
2 changed files with 46 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
Base/usr/share/man/man1/js.md Normal file
View File

@ -0,0 +1,45 @@
## Name
js - evaluate JavaScript
## Synopsis
```**sh
$ js [options...] [script.js]
```
## Description
`js` evaluates JavaScript programs using the LibJS engine. If you pass it a path
to a script file, it will execute that script. Otherwise, it enters the
Read-Eval-Print-Loop (REPL) mode, where it interactively reads pieces (usually,
single lines) of code from standard input, evaluates them in one shared
interpreter context, and prints back their results. This mode is useful for
quickly experimenting with LibJS.
## Options
* `-A`, `--dump-ast`: Dump the Abstract Syntax Tree after parsing the program.
* `-l`, `--print-last-result`: Print the result of the last statement executed.
* `-g`, `--gc-on-every-allocation`: Run garbage collection on every allocation.
## Examples
Here's how you execute a script:
```sh
$ js ~/js/type-play.js
```
And here's an example of an interactive REPL session:
```js
$ js
> function log_sum(a, b) {
. console.log(a + b)
. }
[object ScriptFunction]
> log_sum(35, 42)
77
undefined
```

2
Userland/js.cpp
View File

@ -115,7 +115,7 @@ int main(int argc, char** argv)
const char* script_path = nullptr;
Core::ArgsParser args_parser;
args_parser.add_option(dump_ast, "Dump the AST", "ast-dump", 'A');
args_parser.add_option(dump_ast, "Dump the AST", "dump-ast", 'A');
args_parser.add_option(print_last_result, "Print last result", "print-last-result", 'l');
args_parser.add_option(gc_on_every_allocation, "GC on every allocation", "gc-on-every-allocation", 'g');
args_parser.add_positional_argument(script_path, "Path to script file", "script", Core::ArgsParser::Required::No);