doc: desc. always see hidden modules in MIGRATING

Signed-off-by: Xavier Delaruelle <[email protected]>

Author: xdelaruelle

MIGRATING.rst

@@ -8,6 +8,32 @@ Modules. It provides an overview of the new features and changed behaviors
 that will be encountered when upgrading.
 
 
+v5.6 (not yet released)
+=======================
+
+Always see hidden modules
+-------------------------
+
+The ``hidden`` element is a new allowed value for the :mconfig:`avail_output`,
+:mconfig:`avail_terse_output`, :mconfig:`list_output`,
+:mconfig:`list_terse_output`, :mconfig:`spider_output` and
+:mconfig:`spider_terse_output` configuration options. When set into the value
+list of these options hidden modules are shown on the output of corresponding
+commands (:subcmd:`avail`, :subcmd:`list` and :subcmd:`spider`).
+
+.. parsed-literal::
+
+    --------------- :sgrdi:`/path/to/modulefiles` ---------------
+    bar/1.0
+    :ps:`$` module config avail_output +hidden
+    :ps:`$` ml av
+    --------------- :sgrdi:`/path/to/modulefiles` ---------------
+    bar/1.0  foo/1.0 <H>
+
+When set, this is equivalent to always adding the :option:`--all` command-line
+option.
+
+
 v5.5
 ====
 

NEWS.rst

@@ -87,7 +87,7 @@ Modules 5.6.0 (not yet released)
   :mconfig:`list_output`, :mconfig:`list_terse_output`,
   :mconfig:`spider_output` and :mconfig:`spider_terse_output` configuration
   options. When set, it is equivalent to use :option:`--all` option: hidden
-  modules are show.
+  modules are shown.
 * Produce a single output for multi pattern :subcmd:`avail` search rather than
   a separate output for each submitted pattern.
 * Produce a single output for multi pattern :subcmd:`whatis` search rather