advopt.txt 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. Advanced commands:
  2. //compileToC, cc compile project with C code generator
  3. //compileToCpp, cpp compile project to C++ code
  4. //compileToOC, objc compile project to Objective C code
  5. //js compile project to Javascript
  6. //e run a Nimscript file
  7. //rst2html convert a reStructuredText file to HTML
  8. //rst2tex convert a reStructuredText file to TeX
  9. //jsondoc extract the documentation to a json file
  10. //jsondoc2 extract documentation to a json file (uses doc2)
  11. //buildIndex build an index for the whole documentation
  12. //run run the project (with Tiny C backend; buggy!)
  13. //genDepend generate a DOT file containing the
  14. module dependency graph
  15. //dump dump all defined conditionals and search paths
  16. //check checks the project for syntax and semantic
  17. Advanced options:
  18. -o:FILE, --out:FILE set the output filename
  19. --stdout output to stdout
  20. --colors:on|off turn compiler messages coloring on|off
  21. --listFullPaths list full paths in messages
  22. -w:on|off|list, --warnings:on|off|list
  23. turn all warnings on|off or list all available
  24. --warning[X]:on|off turn specific warning X on|off
  25. --hints:on|off|list turn all hints on|off or list all available
  26. --hint[X]:on|off turn specific hint X on|off
  27. --lib:PATH set the system library path
  28. --import:PATH add an automatically imported module
  29. --include:PATH add an automatically included module
  30. --nimcache:PATH set the path used for generated files
  31. --header:FILE the compiler should produce a .h file (FILE
  32. is optional)
  33. -c, --compileOnly compile only; do not assemble or link
  34. --noLinking compile but do not link
  35. --noMain do not generate a main procedure
  36. --genScript generate a compile script (in the 'nimcache'
  37. subdirectory named 'compile_$project$scriptext')
  38. --os:SYMBOL set the target operating system (cross-compilation)
  39. --cpu:SYMBOL set the target processor (cross-compilation)
  40. --debuginfo enables debug information
  41. -t, --passC:OPTION pass an option to the C compiler
  42. -l, --passL:OPTION pass an option to the linker
  43. --cincludes:DIR modify the C compiler header search path
  44. --clibdir:DIR modify the linker library search path
  45. --clib:LIBNAME link an additional C library
  46. (you should omit platform-specific extensions)
  47. --genMapping generate a mapping file containing
  48. (Nim, mangled) identifier pairs
  49. --project document the whole project (doc2)
  50. --docSeeSrcUrl:url activate 'see source' for doc and doc2 commands
  51. (see doc.item.seesrc in config/nimdoc.cfg)
  52. --lineDir:on|off generation of #line directive on|off
  53. --embedsrc embeds the original source code as comments
  54. in the generated output
  55. --threadanalysis:on|off turn thread analysis on|off
  56. --tlsEmulation:on|off turn thread local storage emulation on|off
  57. --taintMode:on|off turn taint mode on|off
  58. --implicitStatic:on|off turn implicit compile time evaluation on|off
  59. --patterns:on|off turn pattern matching on|off
  60. --memTracker:on|off turn memory tracker on|off
  61. --excessiveStackTrace:on|off
  62. stack traces use full file paths
  63. --skipCfg do not read the general configuration file
  64. --skipUserCfg do not read the user's configuration file
  65. --skipParentCfg do not read the parent dirs' configuration files
  66. --skipProjCfg do not read the project's configuration file
  67. --gc:refc|v2|markAndSweep|boehm|go|none|regions
  68. select the GC to use; default is 'refc'
  69. --index:on|off turn index file generation on|off
  70. --putenv:key=value set an environment variable
  71. --NimblePath:PATH add a path for Nimble support
  72. --noNimblePath deactivate the Nimble path
  73. --noCppExceptions use default exception handling with C++ backend
  74. --excludePath:PATH exclude a path from the list of search paths
  75. --dynlibOverride:SYMBOL marks SYMBOL so that dynlib:SYMBOL
  76. has no effect and can be statically linked instead;
  77. symbol matching is fuzzy so
  78. that --dynlibOverride:lua matches
  79. dynlib: "liblua.so.3"
  80. --listCmd list the commands used to execute external programs
  81. --parallelBuild:0|1|... perform a parallel build
  82. value = number of processors (0 for auto-detect)
  83. --verbosity:0|1|2|3 set Nim's verbosity level (1 is default)
  84. --experimental enable experimental language features
  85. -v, --version show detailed version information