doc/script: fix missing role colons, refresh release guide and sign off release commits

.hunspell.en.dic

@@ -1263,7 +1263,7 @@ bsky
 Furlan
 SVG
 conf
-3b68dee7
+9b1d0134
 Koji
 bz2
 lh

MIGRATING.rst

@@ -502,7 +502,7 @@ option.
 Issue warning upon module evaluation
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The mfcmd:`module-warn` modulefile Tcl command is introduced to define warning
+The :mfcmd:`module-warn` modulefile Tcl command is introduced to define warning
 message to print when loading specified modulefiles.
 
 .. parsed-literal::
@@ -522,7 +522,7 @@ The warning message is printed when targeted modulefile is evaluated in
 of affected or unaffected users or groups. Warning may also be only effective
 before or after a particular date.
 
-The ``warning`` tag is set on modules targeted by a mfcmd:`module-warn`
+The ``warning`` tag is set on modules targeted by a :mfcmd:`module-warn`
 command.
 
 Simplified way to define module help message

NEWS.rst

@@ -77,7 +77,7 @@ Modules 5.7.0 (2026-09-21)
   :mconfig:`source_cache` configuration option is enabled to support
   ``-encoding`` option. (fix issue #627)
 * Correctly parse the module specifications passed as argument on
-  :mfcmd:`depends-on`, mfcmd:`always-load` and :mfcmd:`prereq-all` modulefile
+  :mfcmd:`depends-on`, :mfcmd:`always-load` and :mfcmd:`prereq-all` modulefile
   commands. It especially fixes module specification containing the definition
   of variants. (fixes issue #626)
 * Report the full *via* path for modules on :subcmd:`avail` and

doc/source/design/lmod-tcl-modulefile-compat.rst

@@ -51,7 +51,7 @@ Lmod Tcl modulefile compatibility
   context (not within modulerc)
 
 - An update is made on Modules version 5.6: argument *value* of
-  mfcmd:`add-property` is converted to :mfcmd:`module-tag` onto loading
+  :mfcmd:`add-property` is converted to :mfcmd:`module-tag` onto loading
   modulefile
 
   - Argument *name* is ignored as it seems *value* is the deterministic

doc/source/design/magic-cookie-check.rst

@@ -81,7 +81,7 @@ configuration option is not set to ``always`` as this procedure is called by
 all module search contexts. It is called by:
 
 * ``findModules`` to check files in directories within modulepaths
-* ``getModules`` to check files pointed by mfcmd:`module-virtual`
+* ``getModules`` to check files pointed by :mfcmd:`module-virtual`
 * ``getPathToModule`` to check files transmitted as full path file
 
 .. note:: File readability (permission check) is not verified when

doc/source/devel/create-new-release.rst

@@ -30,7 +30,8 @@ Finalize release content:
 
 * Update version number in :file:`version.inc.in` and
   :file:`doc/source/conf.py`
-* Set release date in :file:`NEWS.rst` and :file:`MIGRATING.rst`
+* Set release date in :file:`NEWS.rst` and remove the *not yet released*
+  mention in :file:`MIGRATING.rst`
 * Update version number and draft changelog message in
   :file:`share/rpm/environment-modules.spec.in`
 
@@ -43,16 +44,20 @@ Finalize release content:
 * If Modules Tcl extension library has been changed since last release, update
   the version number of this library in :file:`lib/configure.ac`.
 * Update table of supported versions in :file:`SECURITY.md`.
+* Update the ``|modules_version|`` substitution in
+  :file:`doc/source/other-implementations.rst` to remove the *not yet
+  released* mention, and refresh ``|lmod_version|`` to the latest Lmod
+  release the comparison was checked against.
 
-Look at previous release commit, like :ghcommit:`3b68dee7`, to view the lines
+Look at previous release commit, like :ghcommit:`9b1d0134`, to view the lines
 that should be modified and what content to write.
 
 Perform commit:
 
 .. code-block:: console
 
   version=$(grep ^MODULES_RELEASE version.inc.in | cut -d ' ' -f 3)
-  git commit -a -m "Release of version $version"
+  git commit -s -a -m "Release of version $version"
 
 Tag version:
 
@@ -148,7 +153,7 @@ Create release on GitHub at https://github.com/envmodules/modules/releases/new:
    grep -B1000 ".. _$previous_version release notes:" NEWS.rst | grep -A1000 -- "--------------------------" >NEWS.new
    nb_lines=$(wc -l NEWS.new| cut -d ' ' -f 1)
    sed -i -e "1,2d;$((nb_lines-3)),\$d" NEWS.new
-   sed -i -z -e "s/\n   / /g" -e "s/\n  / /g" -e 's/:option://g' -e 's/:mfcmd://g' -e 's/:subcmd://g' -e 's/:file://g' -e 's/:ref://g' -e 's/:mfcmd://g' -e 's/:mconfig://g' -e 's/:instopt://g' -e 's/:mfvar://g' -e 's/:envvar://g' -e 's/:command://g' -e 's/:sitevar://g' -e 's/``/`/g' NEWS.new
+   sed -i -z -e "s/\n   / /g" -e "s/\n  / /g" -e 's/:option://g' -e 's/:mfcmd://g' -e 's/:subcmd://g' -e 's/:file://g' -e 's/:ref://g' -e 's/:mfcmd://g' -e 's/:mconfig://g' -e 's/:instopt://g' -e 's/:mfvar://g' -e 's/:envvar://g' -e 's/:command://g' -e 's/:sitevar://g' -e 's/:mhook://g' -e 's/``/`/g' NEWS.new
 
 Check resulting :file:`NEWS.new` to adapt RST code for boxes, links, codes
 (especially cleaning those containing ``\<`` or ``\>``) and make them valid

doc/source/modulefile.rst

@@ -2563,7 +2563,7 @@ See the :ref:`ENVIRONMENT<module ENVIRONMENT>` section in the
 SEE ALSO
 --------
 
-:ref:`envml(1)`, :ref:`ml(1)`, :ref:`module(1)`, ref:`modulecmd(1)`,
+:ref:`envml(1)`, :ref:`ml(1)`, :ref:`module(1)`, :ref:`modulecmd(1)`,
 :manpage:`Tcl(n)`, :manpage:`TclX(n)`, :manpage:`id(1)`, :manpage:`xrdb(1)`,
 :manpage:`exec(n)`, :manpage:`uname(1)`, :manpage:`domainname(1)`,
 :manpage:`tclvars(n)`, :manpage:`lsort(n)`, :manpage:`string(n)`

script/mpub

@@ -207,7 +207,7 @@ set fid [open index.html w]
 puts -nonewline $fid [string map [list modules-$prevver modules-$relver\
    "Download ($prevtag)" "Download ($reltag)"] $index]
 close $fid
-runcmd 2>@$logfid git commit -m "release of version $relver" index.html
+runcmd 2>@$logfid git commit -s -m "release of version $relver" index.html
 
 # upload new page
 runcmd 2>@$logfid git push $ghremote gh-pages