basicopt.txt 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. ::
  2. nim command [options] [projectfile] [arguments]
  3. Command:
  4. //compile, c compile project with default code generator (C)
  5. //r compile to $nimcache/projname, run with [arguments]
  6. using backend specified by `--backend` (default: c)
  7. //doc generate the documentation for inputfile for
  8. backend specified by `--backend` (default: c)
  9. Arguments:
  10. arguments are passed to the program being run (if --run option is selected)
  11. Options:
  12. -p, --path:PATH add path to search paths
  13. -d, --define:SYMBOL(:VAL)
  14. define a conditional symbol
  15. (Optionally: Define the value for that symbol,
  16. see: "compile time define pragmas")
  17. -u, --undef:SYMBOL undefine a conditional symbol
  18. -f, --forceBuild:on|off force rebuilding of all modules
  19. --stackTrace:on|off turn stack tracing on|off
  20. --lineTrace:on|off turn line tracing on|off
  21. --threads:on|off turn support for multi-threading on|off
  22. -x, --checks:on|off turn all runtime checks on|off
  23. -a, --assertions:on|off turn assertions on|off
  24. --opt:none|speed|size optimize not at all or for speed|size
  25. Note: use -d:release for a release build!
  26. --debugger:native Use native debugger (gdb)
  27. --app:console|gui|lib|staticlib
  28. generate a console app|GUI app|DLL|static library
  29. -r, --run run the compiled program with given arguments
  30. --eval:cmd evaluates nim code directly; e.g.: `nim --eval:"echo 1"`
  31. defaults to `e` (nimscript) but customizable:
  32. `nim r --eval:'for a in stdin.lines: echo a'`
  33. --fullhelp show all command line switches
  34. -h, --help show this help
  35. -v, --version show detailed version information
  36. Note, single letter options that take an argument require a colon. E.g. -p:PATH.