doc: apply same markup on diff doc than man pages

This commit is contained in:
Xavier Delaruelle
2020-01-08 21:06:50 +01:00
parent 76072dc26a
commit dbeaeaa48b

View File

@@ -19,7 +19,7 @@ This section describes the features of the compatibility version that are not su
Package Initialization
^^^^^^^^^^^^^^^^^^^^^^
**MODULESBEGINENV** environment snapshot functionality is not supported on version 4. Modules collection mechanism should be preferred to save and restore sets of enabled modulepaths and loaded modulefiles. Modules 4 also introduces a system configuration file *init/modulerc*, located in Modules installation directory. Starting version ``4.3``, this file could also be *etc/initrc*. This *modulerc*/*initrc* file is sourced by Modules shell initialization scripts and helps to setup the initial environment right after initializing the **module** command.
:envvar:`MODULESBEGINENV` environment snapshot functionality is not supported on version 4. Modules collection mechanism should be preferred to save and restore sets of enabled modulepaths and loaded modulefiles. Modules 4 also introduces a system configuration file *init/modulerc*, located in Modules installation directory. Starting version ``4.3``, this file could also be *etc/initrc*. This *modulerc*/*initrc* file is sourced by Modules shell initialization scripts and helps to setup the initial environment right after initializing the :command:`module` command.
Command line switches
@@ -43,64 +43,64 @@ Command line switches
These intermediate-form command line switches are not supported on Modules 4. Short or long switch name should be used instead.
**-h**
:option:`-h`
This command line switch is short version of **--help** switch on Modules 4 whereas it is short version of **--human** switch on compatibility version.
This command line switch is short version of :option:`--help` switch on Modules 4 whereas it is short version of **--human** switch on compatibility version.
**--force**, **-f**
:option:`--force`, :option:`-f`
This command line switch was not supported starting Modules version ``4.0`` but reintroduced starting version ``4.2`` with a different meaning: instead of enabling an active dependency resolution mechanism ``--force`` command line switch now enables to by-pass dependency consistency when loading or unloading a *modulefile*.
**--verbose**, **-v**
:option:`--verbose`, :option:`-v`
**--silent**, **-s**
:option:`--silent`, :option:`-s`
These command line switches were not supported starting Modules version ``4.0`` but reintroduced starting version ``4.3``. However, reintroduced **--silent** switch does not redirect stderr channel to ``/dev/null`` if stderr is found not to be a tty.
These command line switches were not supported starting Modules version ``4.0`` but reintroduced starting version ``4.3``. However, reintroduced :option:`--silent` switch does not redirect stderr channel to ``/dev/null`` if stderr is found not to be a tty.
**--icase**, **-i**
:option:`--icase`, :option:`-i`
This command line switch was not supported starting Modules version ``4.0`` but reintroduced starting version ``4.4``. When **--icase** switch is now set it applies to search query string and module specificiation on all sub-commands and modulefile Tcl commands.
This command line switch was not supported starting Modules version ``4.0`` but reintroduced starting version ``4.4``. When :option:`--icase` switch is now set it applies to search query string and module specificiation on all sub-commands and modulefile Tcl commands.
Module Sub-Commands
^^^^^^^^^^^^^^^^^^^
On compatibility version, paths composing the **MODULEPATH** environment variable may contain reference to environment variable. These variable references are resolved dynamically when **MODULEPATH** is looked at during module sub-command action like **avail**. This feature was missing on Modules ``4.0`` but it has been re-introduced on Modules ``4.1``.
On compatibility version, paths composing the :envvar:`MODULEPATH` environment variable may contain reference to environment variable. These variable references are resolved dynamically when :envvar:`MODULEPATH` is looked at during module sub-command action like :subcmd:`avail`. This feature was missing on Modules ``4.0`` but it has been re-introduced on Modules ``4.1``.
**update**
:subcmd:`update`
This module sub-commands is not supported on Modules 4.
**clear**
:subcmd:`clear`
This command line switch was not supported starting Modules version ``4.0`` but reintroduced starting version ``4.3``. It now takes into account the **--force** command-line switch to skip confirmation dialog.
This command line switch was not supported starting Modules version ``4.0`` but reintroduced starting version ``4.3``. It now takes into account the :option:`--force` command-line switch to skip confirmation dialog.
**refresh**
:subcmd:`refresh`
On compatibility version, only the shell aliases defined by the currently loaded modulefiles are set again on a **refresh** command. Whereas on new main version this command is an alias on the **reload** command that **unload** then **load** all the currently loaded modulefiles.
On compatibility version, only the shell aliases defined by the currently loaded modulefiles are set again on a :subcmd:`refresh` command. Whereas on new main version this command is an alias on the :subcmd:`reload` command that :subcmd:`unload` then :subcmd:`load` all the currently loaded modulefiles.
**help**
:subcmd:`help`
Compatibility version redirects output made on stdout in **ModulesHelp** Tcl procedure to stderr.
Compatibility version redirects output made on stdout in ``ModulesHelp`` Tcl procedure to stderr.
During an **help** sub-command, only the **ModulesHelp** Tcl procedure of a modulefile is interpreted on compatibility version. Version 4 interprets all the content of the modulefile, then call the **ModulesHelp** procedure if it exists.
During an :subcmd:`help` sub-command, only the ``ModulesHelp`` Tcl procedure of a modulefile is interpreted on compatibility version. Version 4 interprets all the content of the modulefile, then call the ``ModulesHelp`` procedure if it exists.
On version 4, **ModulesHelp** subroutine is not ran if an error occurred during the interpretation of the *modulefile* main body.
On version 4, ``ModulesHelp`` subroutine is not ran if an error occurred during the interpretation of the *modulefile* main body.
**display**
:subcmd:`display`
On version 4, **ModulesDisplay** subroutine is not ran if an error occurred during the interpretation of the *modulefile* main body.
On version 4, ``ModulesDisplay`` subroutine is not ran if an error occurred during the interpretation of the *modulefile* main body.
**avail**
:subcmd:`avail`
On compatibility version, the same Tcl interpreter is used for the interpretation of all *.modulerc* or *.version* files during an **avail** command but the state of this interpreter is not reset between each interpretation. So some variable and procedure definitions may spread from one interpretation to another on this compatibility version. Modules 4 reuses the same interpreter for all *.modulerc* or *.version* interpretation but it is cleaned between each interpretation to protect from definition spread.
On compatibility version, the same Tcl interpreter is used for the interpretation of all *.modulerc* or *.version* files during an :subcmd:`avail` command but the state of this interpreter is not reset between each interpretation. So some variable and procedure definitions may spread from one interpretation to another on this compatibility version. Modules 4 reuses the same interpreter for all *.modulerc* or *.version* interpretation but it is cleaned between each interpretation to protect from definition spread.
In case of **--terse** or **--long** mode, all enabled modulepaths will be displayed whether they hold result to display or not. Modules 4 outputs only the modulepaths where matching results are found. Modulepaths with no result to report are discarded from output.
In case of :option:`--terse` or :option:`--long` mode, all enabled modulepaths will be displayed whether they hold result to display or not. Modules 4 outputs only the modulepaths where matching results are found. Modulepaths with no result to report are discarded from output.
**apropos**
:subcmd:`apropos`
On Modules 4, *string* passed as argument is always searched in a case insensitive manner.
**load**
:subcmd:`load`
On Modules 4, the value of an environment variable is set even if the new value is the same as the current value of this variable in environment.
@@ -110,7 +110,7 @@ On compatibility version, paths composing the **MODULEPATH** environment variabl
Starting with version ``4.1``, content sent to the ``stdout`` channel during a *modulefile* interpretation is spooled to effectively transmit this content to stdout after rendering the environment changes made by this modulefile.
**unload**
:subcmd:`unload`
On Modules 4, the value of an environment variable is set even if the new value is the same as the current value of this variable in environment.
@@ -122,75 +122,75 @@ On compatibility version, paths composing the **MODULEPATH** environment variabl
When the specified module to unload matches multiple loaded modules, Modules 4 unloads lastly loaded module whereas compatibility version unloads firstly loaded module. A configuration option ``unload_match_order`` has been introduced in version ``4.3`` and it enables to restore the behavior of compatibility version when it is set to ``returnfirst``.
**switch**
:subcmd:`switch`
When switching on version 4 an *old* modulefile by a *new* one, no error is raised if *old* modulefile is not currently loaded. In this situation compatibility version throws an error and abort switch action.
When switching on Modules 4 an *old* modulefile by a *new* one, this *new* modulefile does not keep the position that the *old* modulefile had in the **LOADEDMODULES** list as done on compatibility version but it is appended to the end of the list. Same goes for PATH-like environment variables: replaced PATH component is appended to the end or prepended to the beginning of the relative PATH-like variable, not appended or prepended relatively to the position hold by the swapped PATH component.
When switching on Modules 4 an *old* modulefile by a *new* one, this *new* modulefile does not keep the position that the *old* modulefile had in the :envvar:`LOADEDMODULES` list as done on compatibility version but it is appended to the end of the list. Same goes for PATH-like environment variables: replaced PATH component is appended to the end or prepended to the beginning of the relative PATH-like variable, not appended or prepended relatively to the position hold by the swapped PATH component.
When a modulefile loads another modulefile with a *module load* order, this sub-module is not unloaded when the top modulefile is swapped-out during a **switch** command on compatibility version. Version 4 interprets the swapped-out modulefile in unload mode, so the *module load* order is interpreted as *module unload* order and sub-module is unloaded.
When a modulefile loads another modulefile with a *module load* order, this sub-module is not unloaded when the top modulefile is swapped-out during a :subcmd:`switch` command on compatibility version. Version 4 interprets the swapped-out modulefile in unload mode, so the *module load* order is interpreted as *module unload* order and sub-module is unloaded.
**use**
:subcmd:`use`
When the modulepath to enable is passed as a relative path, compatibility version will set it using passed relative name whereas Modules 4 will determine the corresponding absolute path and will register it rather passed relative name.
**unuse**
:subcmd:`unuse`
Modules 4 provides path element counting feature which increases a reference counter each time a given path entry is added to a given environment variable. This feature also applies to the **MODULEPATH** environment variable. As consequence a modulepath entry element is removed from the modulepath enabled list only if the related element counter is equal to 1. When unusing a modulepath if its reference counter is greater than 1, modulepath is kept enabled and reference counter is decreased by 1.
Modules 4 provides path element counting feature which increases a reference counter each time a given path entry is added to a given environment variable. This feature also applies to the :envvar:`MODULEPATH` environment variable. As consequence a modulepath entry element is removed from the modulepath enabled list only if the related element counter is equal to 1. When unusing a modulepath if its reference counter is greater than 1, modulepath is kept enabled and reference counter is decreased by 1.
**whatis**
:subcmd:`whatis`
On Modules 4, environment variable edition commands (*setenv*, *unsetenv*, *append-path*, *prepend-path* and *remove-path*) do no set variable to the defined value on the modulefile evaluation context during a **whatis** evaluation. Instead environment variables are initialized with an empty value if undefined, to avoid raising error when attempting access to an undefined element during the modulefile evaluation.
On Modules 4, environment variable edition commands (*setenv*, *unsetenv*, *append-path*, *prepend-path* and *remove-path*) do no set variable to the defined value on the modulefile evaluation context during a :subcmd:`whatis` evaluation. Instead environment variables are initialized with an empty value if undefined, to avoid raising error when attempting access to an undefined element during the modulefile evaluation.
**initadd**
:subcmd:`initadd`
**initprepend**
:subcmd:`initprepend`
**initswitch**
:subcmd:`initswitch`
On version 4 no message is displayed to give details on how list of modulefiles to load has been altered in initialization file.
**initrm**
:subcmd:`initrm`
No message is displayed on Modules 4 to inform of the modulefiles that have been removed from the loading list in initialization file.
Empty **module load** line is left on version 4 when last modulefile from a line is asked to be removed. On compatibility version **module load null** line is set in this case.
Empty ``module load`` line is left on version 4 when last modulefile from a line is asked to be removed. On compatibility version ``module load null`` line is set in this case.
**initclear**
:subcmd:`initclear`
Empty **module load** lines are left on version 4 whereas **module load null** lines are set on compatibility version.
Empty ``module load`` lines are left on version 4 whereas ``module load null`` lines are set on compatibility version.
Modules Specific Tcl Commands
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**append-path**
:mfcmd:`append-path`
**prepend-path**
:mfcmd:`prepend-path`
Modules 4 produces an error when adding a bare colon character *:* as a path element to a path-like variable, as this colon cannot be distinguished from the colon used for path separator.
Modules 4 supports adding or removing empty path element to a path-like variable, whereas compatibility version looses track of this path element when the path-like variable is modified afterward. Empty path element enables to set a leading colon character *:*, which has a specific meaning on some regular environment variable like **MANPATH** or **LD_LIBRARY_PATH**.
Modules 4 supports adding or removing empty path element to a path-like variable, whereas compatibility version looses track of this path element when the path-like variable is modified afterward. Empty path element enables to set a leading colon character *:*, which has a specific meaning on some regular environment variable like :envvar:`MANPATH` or :envvar:`LD_LIBRARY_PATH`.
When adding a path element to the **MANPATH** environment variable, Modules 4 is treating this variable like any other whereas a special treatment was applied on compatibility version: a default MANPATH value, set at configure time, was appended in case **MANPATH** variable was unset.
When adding a path element to the :envvar:`MANPATH` environment variable, Modules 4 is treating this variable like any other whereas a special treatment was applied on compatibility version: a default MANPATH value, set at configure time, was appended in case :envvar:`MANPATH` variable was unset.
**remove-path**
:mfcmd:`remove-path`
Modules 4 provides path element counting feature which increases a reference counter each time a given path entry is added to a given environment variable. As consequence a path entry element is removed from a path-like variable only if the related element counter is equal to 1. If this counter is greater than 1, path element is kept in variable and reference counter is decreased by 1.
When unloading a modulefile, **remove-path** command is not applied to environment variable on Modules 4, whereas on compatibility version it is processed the exact same way than when loading modulefile.
When unloading a modulefile, :mfcmd:`remove-path` command is not applied to environment variable on Modules 4, whereas on compatibility version it is processed the exact same way than when loading modulefile.
**exit**
:mfcmd:`exit`
On Modules 4 code passed to the **exit** Modules specific Tcl command will not be thrown to be the **module** return value.
On Modules 4 code passed to the :mfcmd:`exit` Modules specific Tcl command will not be thrown to be the :command:`module` return value.
**module-alias**
:mfcmd:`module-alias`
**module-version**
:mfcmd:`module-version`
In case the specified aliased module or the symbolic version introduces a resolution loop with already defined aliases or symbolic versions, this new alias or symbolic version is not registered and an error message is raised. On compatibility version, alias or symbolic version introducing loop are registered as the modulefile resolution is not computed at registration time.
**module-info**
:mfcmd:`module-info`
**module-info flags**
@@ -200,13 +200,13 @@ Modules Specific Tcl Commands
**module-info user**
These **module-info** options are related to compatibility version-specific features so they are available on Modules 4 but with a dummy implementation that always returns false or an empty value.
These :mfcmd:`module-info` options are related to compatibility version-specific features so they are available on Modules 4 but with a dummy implementation that always returns false or an empty value.
**module-info mode**
During an **unload** sub-command, *unload* is returned instead of *remove*. However if **mode** is tested against *remove* value, true will be returned.
During an :subcmd:`unload` sub-command, ``unload`` is returned instead of ``remove``. However if *mode* is tested against ``remove`` value, true will be returned.
During a **switch** sub-command, *unload* then *load* is returned instead of *switch1* then *switch2* then *switch3*. However if **mode** is tested against *switch* value, true will be returned.
During a :subcmd:`switch` sub-command, ``unload`` then ``load`` is returned instead of ``switch1`` then ``switch2`` then ``switch3``. However if *mode* is tested against ``switch`` value, true will be returned.
**module-info name**
@@ -222,21 +222,21 @@ Modules Specific Tcl Commands
A symbolic version sets on a module alias will be propagated toward the resolution path to also apply to the relative *modulefile* if it still correspond to the same module name.
**module-log**
:mfcmd:`module-log`
**module-trace**
:mfcmd:`module-trace`
**module-user**
:mfcmd:`module-user`
**module-verbosity**
:mfcmd:`module-verbosity`
These Modules specific Tcl commands are related to compatibility version-specific features so they are available on Modules 4 but with a dummy implementation that always displays a warning message saying the command is not implemented.
**module-whatis**
:mfcmd:`module-whatis`
When multiple words are passed as argument to **module-whatis** but they are not enclosed in double-quotes or curly braces they will be displayed as a single line on Modules 4 whereas compatibility version displays them as one line per word.
When multiple words are passed as argument to :mfcmd:`module-whatis` but they are not enclosed in double-quotes or curly braces they will be displayed as a single line on Modules 4 whereas compatibility version displays them as one line per word.
**set-alias**
:mfcmd:`set-alias`
Whereas compatibility version sets a shell function when variables are in use in alias value on Bourne shell derivatives, Modules 4 always defines a shell alias never a shell function.
@@ -248,7 +248,7 @@ On version 4, when a module alias is set and overrides name of an existing direc
When looking for an implicit default in a *modulefile* directory, aliases are taken into account in addition to *modulefiles* and directories to determine the highest numerically sorted element.
Modules 4 will resolve module alias or symbolic version passed to **unload** command to then remove the loaded modulefile pointed by the mentioned alias or symbolic version.
Modules 4 will resolve module alias or symbolic version passed to :subcmd:`unload` command to then remove the loaded modulefile pointed by the mentioned alias or symbolic version.
Modules 4 resolves module alias or symbolic version pointing to a *modulefile* located in another modulepath.
@@ -266,47 +266,47 @@ Package Initialization
Compatibility version does not support *fish*, *lisp*, *tcl* and *R* as code output.
On version 4 and for *sh*, *bash*, *ksh*, *zsh* and *fish* shells, text output, like listing from the **avail** command, is redirected from *stderr* to *stdout* after shell command evaluation if shell is in interactive mode. Starting version ``4.1``, this content redirection occurs if shell session is attached to a terminal.
On version 4 and for *sh*, *bash*, *ksh*, *zsh* and *fish* shells, text output, like listing from the :subcmd:`avail` command, is redirected from *stderr* to *stdout* after shell command evaluation if shell is in interactive mode. Starting version ``4.1``, this content redirection occurs if shell session is attached to a terminal.
Modulecmd startup
^^^^^^^^^^^^^^^^^
Starting with version ``4.1``, **modulecmd.tcl** sources upon invocation a site-specific configuration script named **siteconfig.tcl**. This Tcl script enables to supersede any global variable or procedure definition of modulecmd.tcl.
Starting with version ``4.1``, :file:`modulecmd.tcl` sources upon invocation a site-specific configuration script named :file:`siteconfig.tcl`. This Tcl script enables to supersede any global variable or procedure definition of modulecmd.tcl.
Command line switches
^^^^^^^^^^^^^^^^^^^^^
**--debug**, **-D**
:option:`--debug`, :option:`-D`
**--default**, **-d**
:option:`--default`, :option:`-d`
**--latest**, **-L**
:option:`--latest`, :option:`-L`
These command line switches are not supported on compatibility version.
**--paginate**
:option:`--paginate`
**--no-pager**
:option:`--no-pager`
These command line switches appeared on version ``4.1`` and are not supported on compatibility version.
**--auto**
:option:`--auto`
**--no-auto**
:option:`--no-auto`
These command line switches appeared on version ``4.2`` and are not supported on compatibility version.
**--indepth**
:option:`--indepth`
**--no-indepth**
:option:`--no-indepth`
**--color**
:option:`--color`
**--starts-with**, **-S**
:option:`--starts-with`, :option:`-S`
**--contains**, **-C**
:option:`--contains`, :option:`-C`
These command line switches appeared on version ``4.3`` and are not supported on compatibility version.
@@ -314,74 +314,74 @@ Command line switches
Module Sub-Commands
^^^^^^^^^^^^^^^^^^^
All module sub-commands will return a non-zero exit code in case of error whereas on compatibility version issues that occurred do not lead to an exit of the **module** command with a non-zero code.
All module sub-commands will return a non-zero exit code in case of error whereas on compatibility version issues that occurred do not lead to an exit of the :command:`module` command with a non-zero code.
Starting with version ``4.1``, **module** function for all scripting languages, like Perl or Python, always returns a value. In case of error, a *false* boolean value is returned instead of raising a fatal exception. For module sub-commands returning a text value, the module function will actually return this value. In all other cases a *true* boolean value is returned.
Starting with version ``4.1``, :command:`module` function for all scripting languages, like Perl or Python, always returns a value. In case of error, a *false* boolean value is returned instead of raising a fatal exception. For module sub-commands returning a text value, the module function will actually return this value. In all other cases a *true* boolean value is returned.
**reload**
:subcmd:`reload`
**source**
:subcmd:`source`
**search**
:subcmd:`search`
**save**
:subcmd:`save`
**restore**
:subcmd:`restore`
**saverm**
:subcmd:`saverm`
**saveshow**
:subcmd:`saveshow`
**savelist**
:subcmd:`savelist`
**path**
:subcmd:`path`
**paths**
:subcmd:`paths`
**autoinit**
:subcmd:`autoinit`
**aliases**
:subcmd:`aliases`
**test**
:subcmd:`test`
These module sub-commands are not supported on compatibility version.
**append-path**
:subcmd:`append-path`
**prepend-path**
:subcmd:`prepend-path`
**remove-path**
:subcmd:`remove-path`
**is-loaded**
:subcmd:`is-loaded`
**is-saved**
:subcmd:`is-saved`
**is-used**
:subcmd:`is-used`
**is-avail**
:subcmd:`is-avail`
**info-loaded**
:subcmd:`info-loaded`
These module sub-commands appeared on version ``4.1`` and are not supported on compatibility version.
**config**
:subcmd:`config`
This module sub-command appeared on version ``4.3`` and is not supported on compatibility version.
**avail**
:subcmd:`avail`
**whatis**
:subcmd:`whatis`
**apropos**
:subcmd:`apropos`
Non-critical errors are not displayed on these sub-commands. Only valid results are returned.
Module aliases are included in the result of these sub-commands. They are displayed in the module path section where they are defined or in a *global/user modulerc* section for aliases set in user's or global modulerc file. A **@** symbol is added in parenthesis next to their name to distinguish them from *modulefiles*.
Module aliases are included in the result of these sub-commands. They are displayed in the module path section where they are defined or in a *global/user modulerc* section for aliases set in user's or global modulerc file. A ``@`` symbol is added in parenthesis next to their name to distinguish them from *modulefiles*.
Search may be performed with an alias or a symbolic version-name passed as argument.
Arguments to these **avail**, **whatis** and **apropos** commands may use wildcard characters to express glob patterns.
Arguments to these :file:`avail`, :file:`whatis` and :file:`apropos` commands may use wildcard characters to express glob patterns.
Collections
@@ -393,73 +393,73 @@ Modules collections are not supported on compatibility version.
Environment
^^^^^^^^^^^
**MODULECONTACT**
:envvar:`MODULECONTACT`
**MODULES_COLLECTION_TARGET**
:envvar:`MODULES_COLLECTION_TARGET`
**MODULES_USE_COMPAT_VERSION**
:envvar:`MODULES_USE_COMPAT_VERSION`
**<VAR>_modshare**
:envvar:`<VAR>_modshare`
These environment variables are not supported on compatibility version.
**MODULES_CMD**
:envvar:`MODULES_CMD`
**MODULES_COLLECTION_PIN_VERSION**
:envvar:`MODULES_COLLECTION_PIN_VERSION`
**MODULES_PAGER**
:envvar:`MODULES_PAGER`
**MODULES_RUNENV_<VAR>**
:envvar:`MODULES_RUNENV_\<VAR\>`
**MODULES_RUN_QUARANTINE**
:envvar:`MODULES_RUN_QUARANTINE`
**MODULES_SILENT_SHELL_DEBUG**
:envvar:`MODULES_SILENT_SHELL_DEBUG`
**<VAR>_modquar**
:envvar:`<VAR>_modquar`
These environment variables appeared on version ``4.1`` and are not supported on compatibility version.
**MODULES_AUTO_HANDLING**
:envvar:`MODULES_AUTO_HANDLING`
**MODULES_LMALTNAME**
:envvar:`MODULES_LMALTNAME`
**MODULES_LMCONFLICT**
:envvar:`MODULES_LMCONFLICT`
**MODULES_LMNOTUASKED**
:envvar:`MODULES_LMNOTUASKED`
**MODULES_LMPREREQ**
:envvar:`MODULES_LMPREREQ`
These environment variables appeared on version ``4.2`` and are not supported on compatibility version.
**MODULES_AVAIL_INDEPTH**
:envvar:`MODULES_AVAIL_INDEPTH`
**MODULES_COLOR**
:envvar:`MODULES_COLOR`
**MODULES_COLORS**
:envvar:`MODULES_COLORS`
**MODULES_IMPLICIT_DEFAULT**
:envvar:`MODULES_IMPLICIT_DEFAULT`
**MODULES_SEARCH_MATCH**
:envvar:`MODULES_SEARCH_MATCH`
**MODULES_SET_SHELL_STARTUP**
:envvar:`MODULES_SET_SHELL_STARTUP`
**MODULES_SITECONFIG**
:envvar:`MODULES_SITECONFIG`
**MODULES_TERM_BACKGROUND**
:envvar:`MODULES_TERM_BACKGROUND`
**MODULES_UNLOAD_MATCH_ORDER**
:envvar:`MODULES_UNLOAD_MATCH_ORDER`
**MODULES_VERBOSITY**
:envvar:`MODULES_VERBOSITY`
**MODULES_WA_277**
:envvar:`MODULES_WA_277`
These environment variables appeared on version ``4.3`` and are not supported on compatibility version.
**MODULES_ADVANCED_VERSION_SPEC**
:envvar:`MODULES_ADVANCED_VERSION_SPEC`
**MODULES_EXTENDED_DEFAULT**
:envvar:`MODULES_EXTENDED_DEFAULT`
**MODULES_ICASE**
:envvar:`MODULES_ICASE`
These environment variables appeared on version ``4.4`` and are not supported on compatibility version.
@@ -467,58 +467,58 @@ Environment
Modules Specific Tcl Commands
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**conflict**
:mfcmd:`conflict`
**prereq**
:mfcmd:`prereq`
Starting with version ``4.2``, these Modules-specific Tcl commands support being called with a symbolic modulefile or a modulefile alias passed as argument.
**module**
:mfcmd:`module`
In case of **module load** command specifying multiple *modulefiles*, when mode is set to **unload** these *modulefiles* will be unloaded in the reverse order to ensure correct handling of prerequisites.
In case of ``module load`` command specifying multiple *modulefiles*, when mode is set to ``unload`` these *modulefiles* will be unloaded in the reverse order to ensure correct handling of prerequisites.
**module-info**
:mfcmd:`module-info`
**module-info command**
This **module-info** option is not supported on compatibility version.
This :mfcmd:`module-info` option is not supported on compatibility version.
**module-info loaded**
This **module-info** option appeared on version ``4.1`` and is not supported on compatibility version.
This :mfcmd:`module-info` option appeared on version ``4.1`` and is not supported on compatibility version.
**append-path**
:mfcmd:`append-path`
Starting with version ``4.1``, **append-path** handles being called with multiple *value* arguments and option ``--duplicates`` is added.
Starting with version ``4.1``, :mfcmd:`append-path` handles being called with multiple *value* arguments and option ``--duplicates`` is added.
**prepend-path**
:mfcmd:`prepend-path`
Starting with version ``4.1``, **prepend-path** handles being called with multiple *value* arguments and option ``--duplicates`` is added.
Starting with version ``4.1``, :mfcmd:`prepend-path` handles being called with multiple *value* arguments and option ``--duplicates`` is added.
**remove-path**
:mfcmd:`remove-path`
Starting with version ``4.1``, **remove-path** handles being called with multiple *value* arguments and option ``--index`` is added.
Starting with version ``4.1``, :mfcmd:`remove-path` handles being called with multiple *value* arguments and option ``--index`` is added.
**is-loaded**
:mfcmd:`is-loaded`
Starting with version ``4.1``, **is-loaded** supports being called with no argument passed. In this case, it returns *true* if any modulefile is currently loaded, *false* otherwise.
Starting with version ``4.1``, :mfcmd:`is-loaded` supports being called with no argument passed. In this case, it returns *true* if any modulefile is currently loaded, *false* otherwise.
Starting with version ``4.2``, **is-loaded** supports being called with a symbolic modulefile or a modulefile alias passed as argument.
Starting with version ``4.2``, :mfcmd:`is-loaded` supports being called with a symbolic modulefile or a modulefile alias passed as argument.
This Modules-specific Tcl command was not enabled for *modulerc* evaluation starting Modules version ``4.0`` but it has been reintroduced starting version ``4.2.1``.
**is-saved**
:mfcmd:`is-saved`
**is-used**
:mfcmd:`is-used`
**is-avail**
:mfcmd:`is-avail`
**module-virtual**
:mfcmd:`module-virtual`
These Modules-specific Tcl commands appeared on version ``4.1`` and are not supported on compatibility version.
**set-function**
:mfcmd:`set-function`
**unset-function**
:mfcmd:`unset-function`
These Modules-specific Tcl commands appeared on version ``4.2`` and are not supported on compatibility version.