doc: --tag update tag list if mod is loaded already

Author: xdelaruelle

doc/source/module.rst

@@ -427,7 +427,9 @@ switches are accepted:
  :subcmd:`try-load` sub-commands, apply LIST of module tags to the loading
  *modulefile*. *LIST* corresponds to the concatenation of multiple tags
  separated by colon character (``:``). *LIST* should not contain tags
- inherited from *modulefile* state or from other modulefile commands.
+ inherited from *modulefile* state or from other modulefile commands. If
+ module is already loaded, tags from *LIST* are added to the list of tags
+ already applied to this module.
 
  .. only:: html
 
@@ -1439,10 +1441,9 @@ Module Sub-Commands
  modulefile alias. It may also leverage a specific syntax to finely select
  module version (see `Advanced module version specifiers`_ section below).
 
- The ``--tag`` option accepts a list of module tags to apply to *modulefile*
- once loaded. *taglist* corresponds to the concatenation of multiple tags
- separated by colon character. *taglist* should not contain tags inherited
- from *modulefile* state or from other modulefile commands.
+ The :option:`--tag` option accepts a list of module tags to apply to
+ *modulefile* once loaded. If module is already loaded, tags from *taglist*
+ are added to the list of tags already applied to this module.
 
  .. only:: html
 
@@ -1475,10 +1476,9 @@ Module Sub-Commands
  modulefile alias. It may also leverage a specific syntax to finely select
  module version (see `Advanced module version specifiers`_ section below).
 
- The ``--tag`` option accepts a list of module tags to apply to *modulefile*
- once loaded. *taglist* corresponds to the concatenation of multiple tags
- separated by colon character. *taglist* should not contain tags inherited
- from *modulefile* state or from other modulefile commands.
+ The :option:`--tag` option accepts a list of module tags to apply to
+ *modulefile* once loaded. If module is already loaded, tags from *taglist*
+ are added to the list of tags already applied to this module.
 
  .. only:: html
 
@@ -1786,10 +1786,9 @@ Module Sub-Commands
  modulefile alias. It may also leverage a specific syntax to finely select
  module version (see `Advanced module version specifiers`_ section below).
 
- The ``--tag`` option accepts a list of module tags to apply to *modulefile2*
- once loaded. *taglist* corresponds to the concatenation of multiple tags
- separated by colon character. *taglist* should not contain tags inherited
- from *modulefile* state or from other modulefile commands.
+ The :option:`--tag` option accepts a list of module tags to apply to
+ *modulefile* once loaded. If module is already loaded, tags from *taglist*
+ are added to the list of tags already applied to this module.
 
  .. only:: html
 
@@ -1841,10 +1840,9 @@ Module Sub-Commands
  modulefile alias. It may also leverage a specific syntax to finely select
  module version (see `Advanced module version specifiers`_ section below).
 
- The ``--tag`` option accepts a list of module tags to apply to *modulefile*
- once loaded. *taglist* corresponds to the concatenation of multiple tags
- separated by colon character. *taglist* should not contain tags inherited
- from *modulefile* state or from other modulefile commands.
+ The :option:`--tag` option accepts a list of module tags to apply to
+ *modulefile* once loaded. If module is already loaded, tags from *taglist*
+ are added to the list of tags already applied to this module.
 
  .. only:: html
 

doc/source/modulefile.rst

@@ -81,7 +81,8 @@ the *modulefile* is being loaded.
  once loaded in addition to the ``keep-loaded`` tag. *taglist* corresponds to
  the concatenation of multiple tags separated by colon character. *taglist*
  should not contain tags inherited from *modulefile* state or from other
- modulefile commands.
+ modulefile commands. If module is already loaded, tags from *taglist* are
+ added to the list of tags already applied to this module.
 
  .. only:: html
 
@@ -347,7 +348,8 @@ the *modulefile* is being loaded.
  the ``--tag`` option to apply specified tags to *modulefile* once loaded.
  Option accepts a concatenation of multiple module tags separated by colon
  character. *taglist* should not contain tags inherited from *modulefile*
- state or from other modulefile commands.
+ state or from other modulefile commands. If module is already loaded, tags
+ from *taglist* are added to the list of tags already applied to this module.
 
  Command line switches :option:`--auto`, :option:`--no-auto` and
  :option:`--force` are ignored when passed to a :mfcmd:`module` command set in
@@ -888,7 +890,9 @@ the *modulefile* is being loaded.
  The ``--tag`` option accepts a list of module tags to apply to *modulefile*
  once loaded. *taglist* corresponds to the concatenation of multiple tags
  separated by colon character. *taglist* should not contain tags inherited
- from *modulefile* state or from other modulefile commands.
+ from *modulefile* state or from other modulefile commands. If module is
+ already loaded, tags from *taglist* are added to the list of tags already
+ applied to this module.
 
  .. only:: html