From 1a608ba9a7bee17cfda000c8dd7a64560d850559 Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Tue, 12 Dec 2023 16:30:43 +0100
Subject: [PATCH 1/9] CHANGELOG updated

---
 CHANGELOG.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 386d32c..d47342b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,20 @@
 # Changelog of Pmodules
 
+## Version 1.1.16
+### **modulecmd**
+**User visible changes**
+* YAML module configuration file. Configured in this file
+  * release stage
+  * list of systems the module is available for
+  * list of systems the module shadowed
+	
+### **modbuild**
+**User visible changes**
+* YAML build configuration files
+
+**Internal changes and fixes**
+
+
 ## Version 1.1.15
 * **modulecmd**
   * *User visible changes*
-- 
GitLab


From edadd0683e133a80667fb29d9f423248984297e6 Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Tue, 12 Dec 2023 16:41:16 +0100
Subject: [PATCH 2/9] CHANGELOG updated

---
 CHANGELOG.md | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d47342b..1a186c3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,11 +3,14 @@
 ## Version 1.1.16
 ### **modulecmd**
 **User visible changes**
-* YAML module configuration file. Configured in this file
-  * release stage
-  * list of systems the module is available for
-  * list of systems the module shadowed
-	
+* YAML module configuration file. Configured in this file are
+  * the release stage
+  * the list of systems the module is available
+  * the list of systems the module shadowed
+  Wherby the items in list of systems are either
+  * hostnames or glob style patterns of hostnames (e.g. merlin-*)
+  * OS names like rhel7
+
 ### **modbuild**
 **User visible changes**
 * YAML build configuration files
-- 
GitLab


From 94825f90f76c73cac8ce2ea6149421be38869d04 Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Tue, 12 Dec 2023 16:47:09 +0100
Subject: [PATCH 3/9] CHANGELOG updated

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1a186c3..6f5070c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,7 @@
   * the release stage
   * the list of systems the module is available
   * the list of systems the module shadowed
+
   Wherby the items in list of systems are either
   * hostnames or glob style patterns of hostnames (e.g. merlin-*)
   * OS names like rhel7
-- 
GitLab


From 4b45dbe6bb3814d0a5e5cc32f61f91472c157e2d Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Tue, 12 Dec 2023 17:10:34 +0100
Subject: [PATCH 4/9] CHANGELOG updated

---
 CHANGELOG.md | 34 ++++++++++++++++++++--------------
 1 file changed, 20 insertions(+), 14 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6f5070c..52b8f50 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,7 @@
 # Changelog of Pmodules
 
 ## Version 1.1.16
+
 ### **modulecmd**
 **User visible changes**
 * YAML module configuration file. Configured in this file are
@@ -11,26 +12,31 @@
   Wherby the items in list of systems are either
   * hostnames or glob style patterns of hostnames (e.g. merlin-*)
   * OS names like rhel7
+  
+  The filename is `.config-<version>` and is located in the same directory as the modulefile.
+  For now the `.release-<version>` files are still used if no YAML configuration file exist.
 
 ### **modbuild**
 **User visible changes**
-* YAML build configuration files
+* YAML build configuration files. For now `variants` files are still supported.
+---
 
-**Internal changes and fixes**
+## Version 1.1.15
 
+### **modulecmd**
 
-## Version 1.1.15
-* **modulecmd**
-  * *User visible changes*
-	* prevent loading of a module on dedicated systems via blocklist
-* **modbuild**
-  * *User visible changes*
-    * the function to compare versions can now be called with a single
-	  argument. In this case the given version is compared to version
-	  of currently build module.
-  * *Internal changes and fixes*
-    * bugfix: due to a bug in compiling the list of (legacy) config files,
-	  each module was build twice.
+**User visible changes**
+* prevent loading of a module on dedicated systems via blocklist
+
+### **modbuild**
+**User visible changes**
+* the function to compare versions can now be called with a single
+  argument. In this case the given version is compared to version
+  of currently build module.
+
+**Internal changes and fixes***
+* bugfix: due to a bug in compiling the list of (legacy) config files,
+  each module was build twice.
 
 ## Version 1.1.14
 * **modbuild** 
-- 
GitLab


From e72939229d346a6a9629a0e3f4d68083bdb1fa97 Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Tue, 12 Dec 2023 17:41:42 +0100
Subject: [PATCH 5/9] CHANGELOG updated

---
 CHANGELOG.md | 68 ++++++++++++++++++++++++++++------------------------
 1 file changed, 37 insertions(+), 31 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 52b8f50..42f6380 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -24,7 +24,6 @@
 ## Version 1.1.15
 
 ### **modulecmd**
-
 **User visible changes**
 * prevent loading of a module on dedicated systems via blocklist
 
@@ -37,45 +36,52 @@
 **Internal changes and fixes***
 * bugfix: due to a bug in compiling the list of (legacy) config files,
   each module was build twice.
+---
 
 ## Version 1.1.14
-* **modbuild** 
-  * *Internal changes and fixes*
-    * lookup of default legacy config files fixed
+
+### **modbuild** 
+**Internal changes and fixes***
+* lookup of default legacy config files fixed
+---
 
 ## Version 1.1.13
-* **modulecmd**
-  * *User visible changes*
-	* collections
-	* shadowing modules with an overlay
-	* Lmod support
-	* argument/option handling fixed
-	* using groups/extending MODULEPATH fixed (module use ...)
-  * *Internal changes and fixes*
-	* use Lua and Lmod from Pmodules
-	* std::upvar() replaced
-	* Bugfixes
+### **modulecmd**
+**User visible changes**
+* collections
+* shadowing modules with an overlay
+* Lmod support
+* argument/option handling fixed
+* using groups/extending MODULEPATH fixed (module use ...)
+
+**Internal changes and fixes**
+* use Lua and Lmod from Pmodules
+* std::upvar() replaced
+* Bugfixes
+---
 
 ## Version 1.1.12
-* **modulecmd**
-  * *User visible changes*
-	* experimental support for Lmod
-	* support for use flags has been removed.
-          (A postfix like '_slurm' can still be used)
+### **modulecmd**
+**User visible changes**
+* experimental support for Lmod
+* support for use flags has been removed.
+  (A postfix like '_slurm' can still be used)
+---
 
 ## Version 1.1.11
-* **modulecmd**
-  * *User visible changes*
-	* Improved error handling and messages
-	* Python support added
-  * *Internal changes and fixes*
-	* Bugfixes
+### **modulecmd**
+**User visible changes**
+* Improved error handling and messages
+* Python support added
 
-* **build-system**
-  * *User visible changes*
-    * building with legacy variants files fixed.
-    * building with YAML config files is still experimental
-      and not recommended for now
+**Internal changes and fixes**
+* Bugfixes
+
+### **build-system**
+**User visible changes**
+* building with legacy variants files fixed.
+* building with YAML config files is still experimental
+  and not recommended for now
 
 ## Version 1.1.10 
 * **modulecmd**
-- 
GitLab


From dbacccc47edded35ad80b23b57798b90845236fe Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Tue, 12 Dec 2023 17:46:14 +0100
Subject: [PATCH 6/9] CHANGELOG updated

---
 CHANGELOG.md | 111 ++++++++++++++++++++++++++-------------------------
 1 file changed, 57 insertions(+), 54 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 42f6380..bdc5975 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -41,7 +41,7 @@
 ## Version 1.1.14
 
 ### **modbuild** 
-**Internal changes and fixes***
+**Internal changes and fixes**
 * lookup of default legacy config files fixed
 ---
 
@@ -82,62 +82,65 @@
 * building with legacy variants files fixed.
 * building with YAML config files is still experimental
   and not recommended for now
+---
 
 ## Version 1.1.10 
-* **modulecmd**
-  * *User visible changes*
-    * New options for `module search`.
-	  * With the option `--group` the search can be restricted to a
-	    group.
-	  * With the option `--newest` only the newest versions are
-        displayed.
-	* `find` as alias for the sub-command `search` added.
-	* Bugfix: the sub-commands `whatis` and `keyword|apropos` were
-        broken by design. 
-    * Bugfix: after loading a `Pmodules` module, it was not shown with
-      `module list`.
-	* Bugfix in scanning the depth of groups.
-	* Bugfix: after `module purge` the environment variable
-      `PMODULES_HOME` was not defined an more.
-    * Bugfix: source the shell init file only if a `Pmodules` module
-      is loaded.
-	* Bugfix: unsetting aliases in modulefiles was not handled
-      properly in `module purge`
-  * *Internal changes and fixes*
-    * initialisation error for bash and zsh fixed
+### **modulecmd**
+**User visible changes**
+* New options for `module search`.
+  * With the option `--group` the search can be restricted to a
+    group.
+  * With the option `--newest` only the newest versions are
+    displayed.
+* `find` as alias for the sub-command `search` added.
+* Bugfix: the sub-commands `whatis` and `keyword|apropos` were
+  broken by design. 
+* Bugfix: after loading a `Pmodules` module, it was not shown with
+  `module list`.
+* Bugfix in scanning the depth of groups.
+* Bugfix: after `module purge` the environment variable
+  `PMODULES_HOME` was not defined an more.
+* Bugfix: source the shell init file only if a `Pmodules` module
+  is loaded.
+* Bugfix: unsetting aliases in modulefiles was not handled
+  properly in `module purge`
 
-* **build-system**
-  * *User visible changes*
-    * `modbuild` is now defined as function like `module`. Therefor no
-	`Pmodules` module must be loaded to build a module with `modbuild`
-	* The system can now be defined in the module (YAML) configuration
-      file.
-	* Build dependencies can (and should) now be specified with
-      `build_requires` in the YAML configuration file.
-	* Bugfix: cleanup of modulefiles in overlays fixed. A module can be in
-      more than one overlay. These overlays must be specified in the
-      module configuration file. 
-	* Bugfix: querying dependencies from YAML configuration file
-      fixed. Under some conditions the string 'null' was in the list
-      of dependencies.
-	* Bugfix: create group directory if it doesn't exist.
-	* Bugfix: create the module `$PREFIX` before processing the
-      install targets not before all targets. If `$PREFIX` is created
-      before processing any target and the build fails, `modbuild`
-      assumes that the module have been already built successfully.
- * *Internal changes and fixes*
-    * code review/re-factoring
-	* `modbuild` is now using the Bash installed in `Pmodules` itself.
-	* test code with `set -o nounset`, several issues with this
-      setting fixed (not necessarily bugs).
-
-* **other changes**
- * The build script to bootstrap Pmodules itself doesn't use modbuild
-   any more to compile required software packages.  With this change
-   we can remove some special cases from modbuild.
- * The bootstrap script requires Bash 5.0 or newer now.
- * Bugfix: in the `Pmodules` modulefile force the sourcing of the
-   shell init script while in mode `load` only.
+**Internal changes and fixes**
+* initialisation error for bash and zsh fixed
+
+### **build-system**
+**User visible changes**
+* `modbuild` is now defined as function like `module`. Therefor no
+  `Pmodules` module must be loaded to build a module with `modbuild`
+* The system can now be defined in the module (YAML) configuration
+  file.
+* Build dependencies can (and should) now be specified with
+  `build_requires` in the YAML configuration file.
+* Bugfix: cleanup of modulefiles in overlays fixed. A module can be in
+  more than one overlay. These overlays must be specified in the
+  module configuration file. 
+* Bugfix: querying dependencies from YAML configuration file
+  fixed. Under some conditions the string 'null' was in the list
+  of dependencies.
+* Bugfix: create group directory if it doesn't exist.
+* Bugfix: create the module `$PREFIX` before processing the
+  install targets not before all targets. If `$PREFIX` is created
+  before processing any target and the build fails, `modbuild`
+  assumes that the module have been already built successfully.
+
+**Internal changes and fixes**
+* code review/re-factoring
+* `modbuild` is now using the Bash installed in `Pmodules` itself.
+* test code with `set -o nounset`, several issues with this
+  setting fixed (not necessarily bugs).
+
+**other changes**
+* The build script to bootstrap Pmodules itself doesn't use modbuild
+  any more to compile required software packages.  With this change
+  we can remove some special cases from modbuild.
+* The bootstrap script requires Bash 5.0 or newer now.
+* Bugfix: in the `Pmodules` modulefile force the sourcing of the
+  shell init script while in mode `load` only.
 
 ## Version 1.1.9
 * **modulecmd**
-- 
GitLab


From 4c7a810284ad379224148fdd96708b263eb8e0e4 Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Wed, 13 Dec 2023 09:35:58 +0100
Subject: [PATCH 7/9] CHANGELOG.md reformatted

---
 CHANGELOG.md | 162 ++++++++++++++++++++++++++++-----------------------
 1 file changed, 88 insertions(+), 74 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bdc5975..bc8c1f4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -141,92 +141,106 @@
 * The bootstrap script requires Bash 5.0 or newer now.
 * Bugfix: in the `Pmodules` modulefile force the sourcing of the
   shell init script while in mode `load` only.
+---
 
 ## Version 1.1.9
-* **modulecmd**
-  * *User visible changes*
-    * Overlay info added to output of sub-command `search`.
-    * Output of `module search --verbose` revised for better readability.
-  * *Internal changes and fixes*
-    * The shell`s init file is sourced, when Pmodules is loaded as module.
-      This is required if there are changes in the module function or too
-      define new shell functions.
-    * A bug in `libmodules.tcl:module-addgroup()` which crashed 
-      `module load ...` has been fixed.
-    * In versions before 1.1.9 a colon at the beginning or end of `MODULEPATH`
-      crashed the module function. This has been fixed. 
+### **modulecmd**
+**User visible changes**
+* Overlay info added to output of sub-command `search`.
+* Output of `module search --verbose` revised for better readability.
 
-* **build-system**
-  * *User visible changes*
-    * The command `modbuild` is now defined as shell function analog to
-      the `module` command. The main reason to introduce this function
-      is due to the fact that Bash version 5 or newer is now required
-      by `modbuild`. The function `modbuild` load Bash 5.x as module
-      before calling the modbuild-script. If you want to use the script
-      directly, a Bash binary with version 5.x must be in PATH.
-    * If a build-script is in the current working directory,
-      `modbuild` can now be called without specifying the build-script.
-    * In case of an error in a build-step the build process did not 
-      abort as it should. This has been fixed.
-    * The option `--overlay` can now be used
-	  - to define an overlay if legacy variants files are used
-	  - to override the overlay in a YAML variants file.
-    * The new keyword `with` has been introduced in YAML variants file
-      to specified hierarchical dependencies.
-    * The function `pbuild::supported_os` has been
-      removed. `pbuild::supported_systems` provides the same
-      functionality for legacy configuration files. In YAML module
-      configuration files `systems` have to be used.
-
-* **Internal changes and fixes**
-    * bugfix in setting `PATH`
-    * requires bash 5 or later
+**Internal changes and fixes**
+* The shell`s init file is sourced, when Pmodules is loaded as module.
+  This is required if there are changes in the module function or too
+  define new shell functions.
+* A bug in `libmodules.tcl:module-addgroup()` which crashed 
+  `module load ...` has been fixed.
+* In versions before 1.1.9 a colon at the beginning or end of `MODULEPATH`
+  crashed the module function. This has been fixed. 
+
+### **build-system**
+**User visible changes**
+* The command `modbuild` is now defined as shell function analog to
+  the `module` command. The main reason to introduce this function
+  is due to the fact that Bash version 5 or newer is now required
+  by `modbuild`. The function `modbuild` load Bash 5.x as module
+  before calling the modbuild-script. If you want to use the script
+  directly, a Bash binary with version 5.x must be in PATH.
+* If a build-script is in the current working directory,
+  `modbuild` can now be called without specifying the build-script.
+* In case of an error in a build-step the build process did not 
+  abort as it should. This has been fixed.
+* The option `--overlay` can now be used
+  - to define an overlay if legacy variants files are used
+  - to override the overlay in a YAML variants file.
+* The new keyword `with` has been introduced in YAML variants file
+  to specified hierarchical dependencies.
+* The function `pbuild::supported_os` has been
+  removed. `pbuild::supported_systems` provides the same
+  functionality for legacy configuration files. In YAML module
+  configuration files `systems` have to be used.
+
+**Internal changes and fixes**
+* bugfix in setting `PATH`
+* requires bash 5 or later
+---
 
 ## Version 1.1.8
-* **modulecmd**
-  * *User visible changes*
-    * configuration in YAML files
-    * modulefiles and software must not
-      have a common root directory
-    * the installation root must be specified, it doesn`t default
-      to the base 'overlay' any more.
-    * zsh initialisation fixed.
-  * *Internal changes and fixes*
-    * std::upvar() replaced with reference variables in part of the 
-      code.
-    * environment variable `PMODULES_ROOT` removed.
-    * unsetting aliases fixed.
-    * update to bash 5.1.16
-    * update to findutils 4.9 (macOS only)
-    * minor fixes
-* **build-system**
-  * *User visible changes*
-    * YAML format for variants files
-  * *Internal changes and fixes*
-    * use lib `libpmodules.bash`
-    * bugfixes
-* **modmanage**
-  * *User visible changes*
-    * none, support for overlays still missing
-  * *Internal changes and fixes*
-    * none
+### **modulecmd**
+**User visible changes*
+* configuration in YAML files
+* modulefiles and software must not
+  have a common root directory
+* the installation root must be specified, it doesn`t default
+  to the base 'overlay' any more.
+* zsh initialisation fixed.
+
+**Internal changes and fixes**
+* std::upvar() replaced with reference variables in part of the 
+  code.
+* environment variable `PMODULES_ROOT` removed.
+* unsetting aliases fixed.
+* update to bash 5.1.16
+* update to findutils 4.9 (macOS only)
+* minor fixes
+
+### **build-system**
+**User visible changes**
+* YAML format for variants files
+	
+**Internal changes and fixes**
+* use lib `libpmodules.bash`
+* bugfixes
+
+### **modmanage**
+**User visible changes**
+* none, support for overlays still missing
+
+**Internal changes and fixes**
+* none
+---
 
 ## Version 1.1.7
-* **modulecmd**
-  * list of available overlays in subcommand `use` is now better readable
-* **buid-system**
-  * overlay definition must now be in YAML format
-  * support for YAML formatted variant files (the legacy format 
-    is still supported)
-  * build-system in 1.1.6 was still work in progress and broken
+### **modulecmd**
+* list of available overlays in subcommand `use` is now better readable
+
+### **buid-system**
+* overlay definition must now be in YAML format
+* support for YAML formatted variant files (the legacy format 
+  is still supported)
+* build-system in 1.1.6 was still work in progress and broken
+---
 
 ## Version 1.1.6
-* **modulecmd**
-  * bugfix in searching/loading modules in a hierarchical
-    group
+### **modulecmd**
+* bugfix in searching/loading modules in a hierarchical
+  group
+---
 
 ## Version 1.1.5
+### **modulecmd**
 * first public version with the overlay feature
+---
 
 ## Version 1.0.0rc11
 * **modulecmd**
-- 
GitLab


From d68c5567c4cfba0574258eb16bf093e10400e3aa Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Wed, 13 Dec 2023 09:37:26 +0100
Subject: [PATCH 8/9] CHANGELOG.md: Markdown fixes

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bc8c1f4..441b2c0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -187,7 +187,7 @@
 
 ## Version 1.1.8
 ### **modulecmd**
-**User visible changes*
+**User visible changes**
 * configuration in YAML files
 * modulefiles and software must not
   have a common root directory
-- 
GitLab


From abee35e5fb5e3c8cd95ba73ee5d1107205efb3ed Mon Sep 17 00:00:00 2001
From: Achim Gsell <achim.gsell@psi.ch>
Date: Wed, 13 Dec 2023 14:37:35 +0100
Subject: [PATCH 9/9] reformat CHANGELOG

---
 CHANGELOG.md | 291 +++++++++++++++++++++++++++------------------------
 1 file changed, 154 insertions(+), 137 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 441b2c0..848678e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,7 +2,7 @@
 
 ## Version 1.1.16
 
-### **modulecmd**
+### modulecmd
 **User visible changes**
 * YAML module configuration file. Configured in this file are
   * the release stage
@@ -16,18 +16,19 @@
   The filename is `.config-<version>` and is located in the same directory as the modulefile.
   For now the `.release-<version>` files are still used if no YAML configuration file exist.
 
-### **modbuild**
+### build-system
 **User visible changes**
 * YAML build configuration files. For now `variants` files are still supported.
+
 ---
 
 ## Version 1.1.15
 
-### **modulecmd**
+### modulecmd
 **User visible changes**
 * prevent loading of a module on dedicated systems via blocklist
 
-### **modbuild**
+### build-system
 **User visible changes**
 * the function to compare versions can now be called with a single
   argument. In this case the given version is compared to version
@@ -36,17 +37,20 @@
 **Internal changes and fixes***
 * bugfix: due to a bug in compiling the list of (legacy) config files,
   each module was build twice.
+
 ---
 
 ## Version 1.1.14
 
-### **modbuild** 
+### build-system 
 **Internal changes and fixes**
 * lookup of default legacy config files fixed
+
 ---
 
 ## Version 1.1.13
-### **modulecmd**
+
+### modulecmd
 **User visible changes**
 * collections
 * shadowing modules with an overlay
@@ -61,15 +65,18 @@
 ---
 
 ## Version 1.1.12
-### **modulecmd**
+
+### modulecmd
 **User visible changes**
 * experimental support for Lmod
 * support for use flags has been removed.
   (A postfix like '_slurm' can still be used)
+
 ---
 
 ## Version 1.1.11
-### **modulecmd**
+
+### modulecmd
 **User visible changes**
 * Improved error handling and messages
 * Python support added
@@ -77,15 +84,17 @@
 **Internal changes and fixes**
 * Bugfixes
 
-### **build-system**
+### build-system
 **User visible changes**
 * building with legacy variants files fixed.
 * building with YAML config files is still experimental
   and not recommended for now
+
 ---
 
 ## Version 1.1.10 
-### **modulecmd**
+
+### modulecmd
 **User visible changes**
 * New options for `module search`.
   * With the option `--group` the search can be restricted to a
@@ -108,7 +117,7 @@
 **Internal changes and fixes**
 * initialisation error for bash and zsh fixed
 
-### **build-system**
+### build-system
 **User visible changes**
 * `modbuild` is now defined as function like `module`. Therefor no
   `Pmodules` module must be loaded to build a module with `modbuild`
@@ -141,10 +150,12 @@
 * The bootstrap script requires Bash 5.0 or newer now.
 * Bugfix: in the `Pmodules` modulefile force the sourcing of the
   shell init script while in mode `load` only.
+
 ---
 
 ## Version 1.1.9
-### **modulecmd**
+
+### modulecmd
 **User visible changes**
 * Overlay info added to output of sub-command `search`.
 * Output of `module search --verbose` revised for better readability.
@@ -158,7 +169,7 @@
 * In versions before 1.1.9 a colon at the beginning or end of `MODULEPATH`
   crashed the module function. This has been fixed. 
 
-### **build-system**
+### build-system
 **User visible changes**
 * The command `modbuild` is now defined as shell function analog to
   the `module` command. The main reason to introduce this function
@@ -183,10 +194,12 @@
 **Internal changes and fixes**
 * bugfix in setting `PATH`
 * requires bash 5 or later
+
 ---
 
 ## Version 1.1.8
-### **modulecmd**
+
+### modulecmd
 **User visible changes**
 * configuration in YAML files
 * modulefiles and software must not
@@ -204,7 +217,7 @@
 * update to findutils 4.9 (macOS only)
 * minor fixes
 
-### **build-system**
+### build-system
 **User visible changes**
 * YAML format for variants files
 	
@@ -212,177 +225,181 @@
 * use lib `libpmodules.bash`
 * bugfixes
 
-### **modmanage**
+### modmanage
 **User visible changes**
 * none, support for overlays still missing
 
 **Internal changes and fixes**
 * none
+
 ---
 
 ## Version 1.1.7
-### **modulecmd**
+### modulecmd
 * list of available overlays in subcommand `use` is now better readable
 
-### **buid-system**
+### buid-system
 * overlay definition must now be in YAML format
 * support for YAML formatted variant files (the legacy format 
   is still supported)
 * build-system in 1.1.6 was still work in progress and broken
+
 ---
 
 ## Version 1.1.6
-### **modulecmd**
+### modulecmd
 * bugfix in searching/loading modules in a hierarchical
   group
+
 ---
 
 ## Version 1.1.5
-### **modulecmd**
+### modulecmd
 * first public version with the overlay feature
+
 ---
 
 ## Version 1.0.0rc11
-* **modulecmd**
-  * *User visible changes*
-    * handling of set-alias in modulefile fixed
-  * *Internal changes and fixes*
-    * none
-* **build-system**
-  * *User visible changes*
-    * none
-  * *Internal changes and fixes*
-    * none
+### modulecmd
+**User visible changes**
+* handling of set-alias in modulefile fixed
+---
 
 ## Version 1.0.0rc10
-* **modulecmd**
-  * *User visible changes*
-    * The term "releases" has been replaced with "release stages". 
-      The visible changes are the change of the option 
-      `--all-releases` to `--all-release-stages`, adapted
-      help text and configuration files.
-    * New configuration file `Pmodules.conf` to configure the 
-      default visible group, the default visible release stages
-      and the defined releases stages. These information has
-      been stripped from the profiles `profiles.{bash,csh,zsh}`.
-    * module are now sorted numerically in output of
-      `module avail`.
-    * option `-?` added as alias for `--help`.
-    * new option `--glob` for `module search`. This enables 
-      shell glob-pattern searches.
-  * *Internal changes and fixes*
-    * bugfix in removing temp-file in exit function.
-    * terse output of `module avail` fixed.
-    * broken help for sub-commands fixed.
-    * missing group in output of `module avail` fixed.
-    * broken output of `module search --print-modulefiles` fixed.
-    * argument handling fixed after `--`.
-    * cleanup option/argument handling.
-* **build-system**
-  * *User visible changes*
-    * none
-  * *Internal changes and fixes*
-    * bugfixes in the functions `pbuild::version_{le,gt}
-    * bugfix in recognising newer CentOS versions
-* **modmanage**
-  * *User visible changes*
-    * complete re-implementation of (broken) modmanage
-
-## Version 1.0.0rc9
-* **modulecmd**
-  * *User visible changes*
-    * a Pmodules module must be the first module loaded
-    * new option `--group|-g GROUP` to list available modules in `GROUP`
-    * align columns in output of `module avail`
-    * remove path to Pmodules bin directory while unloading a Pmodules module
-    * exclude a Pmodules module from being purged 
-    * follow sym-links in `ROOT/GROUP/modulefiles`
-  * *Internal changes and fixes*
-    * use default field separator by unsetting `IFS`
-    * use read-only variables for all used commands with full path  
-    * better tmp-file creation/deletion
-    * more bugfixes
-* **build-system**
-  * *User visible changes*
-    * group hierarchy can now be defined in a config file
-  * *Internal changes and fixes*
-    * more bugfixes
-
-## Version 1.0.0rc8
-* **modulecmd**
-  * *User visible changes*
-    * Pmodules can now be loaded as module
-    * Since `${PMODULES_HOME}/bin` has been removed from `PATH` in `1.0.0rc7` a Pmodules
-      module must be loaded to make the build system available.
-  * *Internal changes and fixes*
-    * use system binaries in `/bin:/usr/bin` if possible
-
-## Version 1.0.0rc7
-
-* **modulecmd**
-  * *User visible changes*
-    * add options to `module search` to show dependencies
-  * *Internal changes and fixes*
-    * hardcoded path in `profile.csh`fixed
-    * bugfixes
-    * Update to BASH 5.1
-    * Update to Tcl 8.6.10
-* **build-system**
-  * *User visible changes*
-    * building deprecated modules must be forced
-    * support for versioned modulefiles in build-blocks: if a modulefile 
-      `modulefile-X[.Y[.Z]]` exists in the build-block it will be taken
-      in favour of `modulefile`-
-    * bootstrap/build script reviewed, `--config` option removed, help for all  
-      sub-commands added
-  * *Internal changes and fixes*
-    * installation of fallback shared libraries fixed.
-    * bugfixes
-* **modmanage**
-  * *User visible changes*
-    * Support of run-time dependencies which are required but must not be loaded
+### modulecmd
+**User visible changes**
+* The term "releases" has been replaced with "release stages". 
+  The visible changes are the change of the option 
+  `--all-releases` to `--all-release-stages`, adapted
+  help text and configuration files.
+* New configuration file `Pmodules.conf` to configure the 
+  default visible group, the default visible release stages
+  and the defined releases stages. These information has
+  been stripped from the profiles `profiles.{bash,csh,zsh}`.
+* module are now sorted numerically in output of
+  `module avail`.
+* option `-?` added as alias for `--help`.
+* new option `--glob` for `module search`. This enables 
+  shell glob-pattern searches.
+**Internal changes and fixes**
+* bugfix in removing temp-file in exit function.
+* terse output of `module avail` fixed.
+* broken help for sub-commands fixed.
+* missing group in output of `module avail` fixed.
+* broken output of `module search --print-modulefiles` fixed.
+* argument handling fixed after `--`.
+* cleanup option/argument handling.
+
+### build-system
+**User visible changes**
+* none
+**Internal changes and fixes**
+* bugfixes in the functions `pbuild::version_{le,gt}
+* bugfix in recognising newer CentOS versions
 
-## Version 1.0.0rc6
+### modmanage
+**User visible changes**
+* complete re-implementation of (broken) modmanage
+---
 
-**Added features:**
+## Version 1.0.0rc9
+### modulecmd
+**User visible changes**
+* a Pmodules module must be the first module loaded
+* new option `--group|-g GROUP` to list available modules in `GROUP`
+* align columns in output of `module avail`
+* remove path to Pmodules bin directory while unloading a Pmodules module
+* exclude a Pmodules module from being purged 
+* follow sym-links in `ROOT/GROUP/modulefiles`
 
-- Support for shell `sh` added (#86, #90).
-- Support added for a wildcard (`.*`) version as argument to `modbuild` (#78)
+**Internal changes and fixes**
+* use default field separator by unsetting `IFS`
+* use read-only variables for all used commands with full path  
+* better tmp-file creation/deletion
+* more bugfixes
 
-**Fixed bugs:**
+### build-system
+**User visible changes***
+* group hierarchy can now be defined in a config file
 
-- Handle empty list of be installed shared libraries fixed (#89).
-- Broken 'module load'  with (T)CSH fixed (#88).
-- prepend instead of append Pmodules bin directory to `PATH` (#87).
-- Bugs in bootstrapping Pmodules fixed (#82)
+**Internal changes and fixes**
+* more bugfixes
 
+---
 
-## Version 1.0.0rc5 (since 1.0.0rc2)
+## Version 1.0.0rc8
+### modulecmd
+**User visible changes**
+* Pmodules can now be loaded as module
+* Since `${PMODULES_HOME}/bin` has been removed from `PATH` in `1.0.0rc7` a Pmodules
+  module must be loaded to make the build system available.
 
-**Added features:**
+**Internal changes and fixes**
+* use system binaries in `/bin:/usr/bin` if possible
+---
 
-- log `module load` commands to system logger (#80)
+## Version 1.0.0rc7
+### modulecmd
+**User visible changes**
+* add options to `module search` to show dependencies
 
+**Internal changes and fixes**
+* hardcoded path in `profile.csh`fixed
+* bugfixes
+* Update to BASH 5.1
+* Update to Tcl 8.6.10
 
-**Changed:**
+### build-system
+**User visible changes**
+* building deprecated modules must be forced
+* support for versioned modulefiles in build-blocks: if a modulefile 
+  `modulefile-X[.Y[.Z]]` exists in the build-block it will be taken
+  in favour of `modulefile`-
+* bootstrap/build script reviewed, `--config` option removed, help for all  
+  sub-commands added
 
-- The argument passed with the `--system` is not any more a synonym for kernel of the system a build process is running on. It now defines a target operating system like RHEL6, macOS1014 etc (#72).
+**Internal changes and fixes**
+* installation of fallback shared libraries fixed.
+* bugfixes
 
+### modmanage
+**User visible changes**
+* Support of run-time dependencies which are required but must not be loaded
+---
 
-**Deprecated:**
+## Version 1.0.0rc6
+### modulecmd
+- Support for shell `sh` added (#86, #90).
+- Broken 'module load'  with (T)CSH fixed (#88).
+- prepend instead of append Pmodules bin directory to `PATH` (#87).
 
-- calling `pbuild::make_all` in a build-script is now deprecate
+### build-system
+- Support added for a wildcard (`.*`) version as argument to `modbuild` (#78)
+- Handle empty list of be installed shared libraries fixed (#89).
 
-**Fixed bugs:**
+### Building and installing Pmodules
+- Bugs in bootstrapping Pmodules fixed (#82)
+---
 
+## Version 1.0.0rc5 (since 1.0.0rc2)
+### modulecmd
+- log `module load` commands to system logger (#80)
 - Bugs fixed in printing load hints (#48, #49)
-- Several bugs in build-systen and `modulecmd` fixed.
 - `--with` option of sub-command search now accepts a comma separated list of strings
 - `PMODULES_ENV` is exported only on content changes
+- more bugfixes
 
+### build-system
+- The argument passed with the option `--system` is not any more a synonym for
+  the kernel of the system (like Linux, Darwin). It now defines a target operating
+  system like RHEL6, macOS1014 etc (#72).
+- calling `pbuild::make_all` in a build-script is now deprecate
+- bugfixes
+---
 
 ## 1.0.0rc4
-  - never tagged
-  
+- never tagged
+---
+
 ## 1.0.0rc3
-  - never tagged
+- never tagged
-- 
GitLab