OPTIONS_HELP.rst 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169
  1. .. |file| replace:: The output is printed to a named ``<file>`` if given.
  2. .. option:: -version [<file>], --version [<file>], /V [<file>]
  3. Show program name/version banner and exit.
  4. |file|
  5. .. option:: -h, -H, --help, -help, -usage, /?
  6. Print usage information and exit.
  7. Usage describes the basic command line interface and its options.
  8. .. option:: --help <keyword> [<file>]
  9. Print help for one CMake keyword.
  10. ``<keyword>`` can be a property, variable, command, policy, generator
  11. or module.
  12. The relevant manual entry for ``<keyword>`` is
  13. printed in a human-readable text format.
  14. |file|
  15. .. versionchanged:: 3.28
  16. Prior to CMake 3.28, this option supported command names only.
  17. .. option:: --help-full [<file>]
  18. Print all help manuals and exit.
  19. All manuals are printed in a human-readable text format.
  20. |file|
  21. .. option:: --help-manual <man> [<file>]
  22. Print one help manual and exit.
  23. The specified manual is printed in a human-readable text format.
  24. |file|
  25. .. option:: --help-manual-list [<file>]
  26. List help manuals available and exit.
  27. The list contains all manuals for which help may be obtained by
  28. using the ``--help-manual`` option followed by a manual name.
  29. |file|
  30. .. option:: --help-command <cmd> [<file>]
  31. Print help for one command and exit.
  32. The :manual:`cmake-commands(7)` manual entry for ``<cmd>`` is
  33. printed in a human-readable text format.
  34. |file|
  35. .. option:: --help-command-list [<file>]
  36. List commands with help available and exit.
  37. The list contains all commands for which help may be obtained by
  38. using the ``--help-command`` option followed by a command name.
  39. |file|
  40. .. option:: --help-commands [<file>]
  41. Print cmake-commands manual and exit.
  42. The :manual:`cmake-commands(7)` manual is printed in a
  43. human-readable text format.
  44. |file|
  45. .. option:: --help-module <mod> [<file>]
  46. Print help for one module and exit.
  47. The :manual:`cmake-modules(7)` manual entry for ``<mod>`` is printed
  48. in a human-readable text format.
  49. |file|
  50. .. option:: --help-module-list [<file>]
  51. List modules with help available and exit.
  52. The list contains all modules for which help may be obtained by
  53. using the ``--help-module`` option followed by a module name.
  54. |file|
  55. .. option:: --help-modules [<file>]
  56. Print cmake-modules manual and exit.
  57. The :manual:`cmake-modules(7)` manual is printed in a human-readable
  58. text format.
  59. |file|
  60. .. option:: --help-policy <cmp> [<file>]
  61. Print help for one policy and exit.
  62. The :manual:`cmake-policies(7)` manual entry for ``<cmp>`` is
  63. printed in a human-readable text format.
  64. |file|
  65. .. option:: --help-policy-list [<file>]
  66. List policies with help available and exit.
  67. The list contains all policies for which help may be obtained by
  68. using the ``--help-policy`` option followed by a policy name.
  69. |file|
  70. .. option:: --help-policies [<file>]
  71. Print cmake-policies manual and exit.
  72. The :manual:`cmake-policies(7)` manual is printed in a
  73. human-readable text format.
  74. |file|
  75. .. option:: --help-property <prop> [<file>]
  76. Print help for one property and exit.
  77. The :manual:`cmake-properties(7)` manual entries for ``<prop>`` are
  78. printed in a human-readable text format.
  79. |file|
  80. .. option:: --help-property-list [<file>]
  81. List properties with help available and exit.
  82. The list contains all properties for which help may be obtained by
  83. using the ``--help-property`` option followed by a property name.
  84. |file|
  85. .. option:: --help-properties [<file>]
  86. Print cmake-properties manual and exit.
  87. The :manual:`cmake-properties(7)` manual is printed in a
  88. human-readable text format.
  89. |file|
  90. .. option:: --help-variable <var> [<file>]
  91. Print help for one variable and exit.
  92. The :manual:`cmake-variables(7)` manual entry for ``<var>`` is
  93. printed in a human-readable text format.
  94. |file|
  95. .. option:: --help-variable-list [<file>]
  96. List variables with help available and exit.
  97. The list contains all variables for which help may be obtained by
  98. using the ``--help-variable`` option followed by a variable name.
  99. |file|
  100. .. option:: --help-variables [<file>]
  101. Print cmake-variables manual and exit.
  102. The :manual:`cmake-variables(7)` manual is printed in a
  103. human-readable text format.
  104. |file|