X-Git-Url: http://nitlanguage.org diff --git a/share/man/nitc.md b/share/man/nitc.md index c537b5b..243c83a 100644 --- a/share/man/nitc.md +++ b/share/man/nitc.md @@ -7,6 +7,8 @@ nitc - compiles Nit programs. nitc [*options*] FILE... +nitc [*options*] --run FILE [ARG]... + # DESCRIPTION @@ -36,7 +38,7 @@ To combine files into a single program, use the `-m` option. $ nitc prog1.nit -m other_module.nit nitc can produces executables for various platforms when specific modules are used. -Currently, android, pnacl and emscripten are supported. +Currently, android and emscripten are supported. See the documentation of these specific modules for details. @@ -163,6 +165,21 @@ Has precedence over the environment variable `NIT_DIR`. ## COMPILATION +### `--run` +Execute the binary after the compilation. + +The binary is generated as expected then it is executed directly. +After the execution, the binary is not removed. + +When `--run` is used, the first argument is the program to compile, the rest of the arguments are the arguments of the program. +Note that you MUST use `--` before the program arguments if one of them is an option starting with a `-`. + +~~~bash +$ nitc --run foo.nit arg # compile foo.nit, then executes `./foo arg` +$ nitc --run foo.nit arg -W # compile foo.nit with warnings, then executes `./foo arg` +$ nitc --run foo.nit -- arg -W # compile foo.nit, then executes `./foo arg -W` +~~~ + ### `--compile-dir` Directory used to generate temporary files. @@ -425,6 +442,12 @@ and stack trace will be disabled. Note that the `--no-stacktrace` option (or this absence) can be toggled manually in the generated Makefile (search `NO_STACKTRACE` in the Makefile). Moreover, the environment variable `NIT_NO_STACK` (see bellow) can also be used at runtime to disable stack traces. +### `--trace-memory` +Enable dynamic measure of memory usage. + +Compiled programs will generate a large `memory.log` file that logs all memory allocations. +This logs file can then be analyzed with the tool `memplot` from contrib. + ### `--hardening` Generate contracts in the C code against bugs in the compiler.