doc: link to --tag option section

Author: xdelaruelle

NEWS.rst

@@ -190,25 +190,25 @@ Modules 5.1.0 (not yet released)
   ability to catch this content.
 * Lib: handle ``sysconf`` error in function implementing the
   ``initStateUsergroups`` procedure. (contribution from Lukáš Zaoral)
-* Introduce the ``--tag`` option for the :subcmd:`load`, :subcmd:`try-load`,
-  :subcmd:`load-any`, :subcmd:`switch` sub-commands and associated
-  :mfcmd:`module` modulefile commands and :mfcmd:`prereq`, mfcmd:`prereq-all`,
-  :mfcmd:`depends-on` and :mfcmd:`always-load` modulefile commands. This new
-  option applies specified tags to the module to load.
-* Record tags set to loaded modules with the ``--tag`` option in the
+* Introduce the :option:`--tag` option for the :subcmd:`load`,
+  :subcmd:`try-load`, :subcmd:`load-any`, :subcmd:`switch` sub-commands and
+  associated :mfcmd:`module` modulefile commands and :mfcmd:`prereq`,
+  mfcmd:`prereq-all`, :mfcmd:`depends-on` and :mfcmd:`always-load` modulefile
+  commands. This new option applies specified tags to the module to load.
+* Record tags set to loaded modules with the :option:`--tag` option in the
   :envvar:`__MODULES_LMEXTRATAG` environment variable to make this information
   persists after module being loaded.
-* When saving a collection, record loaded module tags set with the ``--tag``
-  option and those resulting from module load states (like ``auto-loaded`` and
-  ``keep-loaded``). The ``--notuasked`` string previously used to designate
-  auto-loaded modules in collection is changed into the ``--tag=auto-loaded``
-  option.
+* When saving a collection, record loaded module tags set with the
+  :option:`--tag` option and those resulting from module load states (like
+  ``auto-loaded`` and ``keep-loaded``). The ``--notuasked`` string previously
+  used to designate auto-loaded modules in collection is changed into the
+  ``--tag=auto-loaded`` option.
 * Introduce the :mconfig:`collection_pin_tag` configuration option, that
   records in collection all tags set on loaded modules when enabled. Option is
   disabled by default and when set it defines the :envvar:`MODULES_COLLECTION\
   _PIN_TAG` environment variable.
 * When a collection is saved, its content starts with a ``#%Module5.1`` file
-  signature if ``--tag`` option is recorded in it.
+  signature if :option:`--tag` option is recorded in it.
 * Update the :subcmd:`restore`, :subcmd:`savelist`, :subcmd:`saveshow` and
   :subcmd:`is-saved` sub-commands to exclude from result or return an error
   when checking a collection expressing a higher Modules version requirement

doc/source/changes.rst

@@ -828,7 +828,7 @@ The following command line switches appeared on Modules 5.
 | Introduced | New command line switches                                       |
 | in version |                                                                 |
 +============+=================================================================+
-| 5.1        | :option:`--redirect`, :option:`--no-redirect`                   |
+| 5.1        | :option:`--redirect`, :option:`--no-redirect`, :option:`--tag`  |
 +------------+-----------------------------------------------------------------+
 
 Module Sub-Commands
@@ -902,7 +902,8 @@ The following modulefile Tcl commands appeared on Modules 5.
 
 :mfcmd:`prereq`, :mfcmd:`module load/try-load/load-any/switch<module>`
 
- Starting Modules 5.1, these modulefile commands accept the ``--tag`` option.
+ Starting Modules 5.1, these modulefile commands accept the :option:`--tag`
+ option.
 
 :mfcmd:`module try-load/load-any<module>`
 

doc/source/design/module-tags.rst

@@ -19,7 +19,7 @@ Specification
 
         - For instance, a module with a ``sticky`` tag set on it cannot be unloaded
 
-- Tag may also be set manually with the ``--tag`` sub-command option
+- Tag may also be set manually with the :option:`--tag` sub-command option
 
     - Applies to :subcmd:`load`, :subcmd:`try-load`, :subcmd:`load-any` and :subcmd:`switch` sub-commands
     - When directly used from the terminal session or within modulefile