doc: desc. cmds/vars hooks in NEWS

Author: xdelaruelle

.aspell.en.pws

@@ -1,4 +1,4 @@
-personal_ws-1.1 en 854
+personal_ws-1.1 en 855
 ABBRVLIST
 ActiveTcl
 Adrien
@@ -711,6 +711,7 @@ simd
 siteProcsToExposeToItrp
 siteconfig
 sitevalue
+sitevar
 sitevarvalue
 soFT
 soFt

NEWS.rst

@@ -146,6 +146,23 @@ Modules 5.2.0 (not yet released)
   :envvar:`__MODULES_LMREFRESH` environment variable.
 * Optimize :subcmd:`refresh` sub-command to only evaluate loaded modules that
   defines volatile environment changes (shell completion, alias or function).
+  (fix issue #477)
+* Add :sitevar:`modulefile_extra_cmds` hook variable that could be defined in
+  :file:`siteconfig.tcl` file to define specific commands in modulefile
+  interpreter context. :sitevar:`modulefile_extra_cmds` is a list of command
+  name and relative procedure pairs. (fix issue #286)
+* Add :sitevar:`modulefile_extra_vars` hook variable that could be defined in
+  :file:`siteconfig.tcl` file to define specific variables in modulefile
+  interpreter context. :sitevar:`modulefile_extra_vars` is a list of variable
+  name and value pairs. (fix issue #286)
+* Add :sitevar:`modulerc_extra_cmds` hook variable that could be defined in
+  :file:`siteconfig.tcl` file to define specific commands in modulerc
+  interpreter context. :sitevar:`modulerc_extra_cmds` is a list of command
+  name and relative procedure pairs. (fix issue #286)
+* Add :sitevar:`modulerc_extra_vars` hook variable that could be defined in
+  :file:`siteconfig.tcl` file to define specific variables in modulerc
+  interpreter context. :sitevar:`modulerc_extra_vars` is a list of variable
+  name and value pairs. (fix issue #286)
 
 .. _Nagelfar: http://nagelfar.sourceforge.net/
 .. _ShellCheck: https://www.shellcheck.net/

doc/source/conf.py

@@ -345,7 +345,7 @@ def ghcommit_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
     return [title], []
 
 # define new directive/role that can be used as .. subcmd::/:subcmd:,
-# .. mfcmd::/:mfcmd: and .. mfvar::/:mfvar:
+# .. mfcmd::/:mfcmd:, .. mfvar::/:mfvar: and .. sitevar::/:sitevar:
 def setup(app):
     app.add_object_type('subcmd', 'subcmd',
                         objname='module sub-command',
@@ -359,6 +359,10 @@ def setup(app):
                         objname='modulefile variable',
                         indextemplate='pair: %s; modulefile variable',
                         parse_node=parse_cmd_args_node)
+    app.add_object_type(directivename='sitevar', rolename='sitevar',
+                        objname='siteconfig variable',
+                        indextemplate='pair: %s; siteconfig variable',
+                        parse_node=parse_cmd_args_node)
     app.add_object_type('instopt', 'instopt',
                         objname='installation option',
                         indextemplate='pair: %s; installation option',