Help: Use `option` directive for the executables manual pages

It'll allow to refer to a particular option of any executable.

There are two "fake" programs added for the CMake script mode (`cmake_P`)
and CMake CLI Tool mode (`cmake_E`).

1 files changed, 26 insertions, 12 deletions

diff --git a/Help/manual/cpack.1.rst b/Help/manual/cpack.1.rst
index 395cd41..f833f07 100644
--- a/Help/manual/cpack.1.rst
+++ b/Help/manual/cpack.1.rst
@@ -40,7 +40,10 @@ module is included by the project's ``CMakeLists.txt`` file.
 Options
 =======
 
-``-G <generators>``
+.. program:: cpack
+
+.. option:: -G <generators>
+
   ``<generators>`` is a :ref:`semicolon-separated list <CMake Language Lists>`
   of generator names.  ``cpack`` will iterate through this list and produce
   package(s) in that generator's format according to the details provided in
@@ -48,7 +51,8 @@ Options
   the :variable:`CPACK_GENERATOR` variable determines the default set of
   generators that will be used.
 
-``-C <configs>``
+.. option:: -C <configs>
+
   Specify the project configuration(s) to be packaged (e.g. ``Debug``,
   ``Release``, etc.), where ``<configs>`` is a
   :ref:`semicolon-separated list <CMake Language Lists>`.
@@ -58,36 +62,44 @@ Options
   The user is responsible for ensuring that the configuration(s) listed
   have already been built before invoking ``cpack``.
 
-``-D <var>=<value>``
+.. option:: -D <var>=<value>
+
   Set a CPack variable.  This will override any value set for ``<var>`` in the
   input file read by ``cpack``.
 
-``--config <configFile>``
+.. option:: --config <configFile>
+
   Specify the configuration file read by ``cpack`` to provide the packaging
   details.  By default, ``CPackConfig.cmake`` in the current directory will
   be used.
 
-``--verbose, -V``
+.. option:: --verbose, -V
+
   Run ``cpack`` with verbose output.  This can be used to show more details
   from the package generation tools and is suitable for project developers.
 
-``--debug``
+.. option:: --debug
+
   Run ``cpack`` with debug output.  This option is intended mainly for the
   developers of ``cpack`` itself and is not normally needed by project
   developers.
 
-``--trace``
+.. option:: --trace
+
   Put the underlying cmake scripts in trace mode.
 
-``--trace-expand``
+.. option:: --trace-expand
+
   Put the underlying cmake scripts in expanded trace mode.
 
-``-P <packageName>``
+.. option:: -P <packageName>
+
   Override/define the value of the :variable:`CPACK_PACKAGE_NAME` variable used
   for packaging.  Any value set for this variable in the ``CPackConfig.cmake``
   file will then be ignored.
 
-``-R <packageVersion>``
+.. option:: -R <packageVersion>
+
   Override/define the value of the :variable:`CPACK_PACKAGE_VERSION`
   variable used for packaging.  It will override a value set in the
   ``CPackConfig.cmake`` file or one automatically computed from
@@ -95,14 +107,16 @@ Options
   :variable:`CPACK_PACKAGE_VERSION_MINOR` and
   :variable:`CPACK_PACKAGE_VERSION_PATCH`.
 
-``-B <packageDirectory>``
+.. option:: -B <packageDirectory>
+
   Override/define :variable:`CPACK_PACKAGE_DIRECTORY`, which controls the
   directory where CPack will perform its packaging work.  The resultant
   package(s) will be created at this location by default and a
   ``_CPack_Packages`` subdirectory will also be created below this directory to
   use as a working area during package creation.
 
-``--vendor <vendorName>``
+.. option:: --vendor <vendorName>
+
   Override/define :variable:`CPACK_PACKAGE_VENDOR`.
 
 .. include:: OPTIONS_HELP.txt