Issue #585: Updating the documentation on --with-mode-MODE

docs/source/025_new.rst

@@ -1,6 +1,13 @@
 New Features in Lmod
 ====================
 
+**Controlling installed permission**:
+    (Lmod 8.7.10+): Lmod now uses your umask to set permissions unless
+    your user id (id -u) is less than 500.  In that case, it uses a
+    umask of 022.  This translates to 755 for executable files and 644
+    for all others.  Sites can override this at configure time with
+    **--with-mode=MODE**.
+
 **LMOD_SYSTEM_DEFAULT_MODULES**:
      (Lmod 8.7.7+) If a site has no system default modules they can set this
      variable to **__NO_SYSTEM_DEFAULT_MODULES__**.  This will

docs/source/090_configuring_lmod.rst

@@ -246,6 +246,15 @@ Configuration only settings
 --**with-silentShellDebugging**:
   [yes/no, default: no] If yes then the module command will silence its output under shell debug.
 
+--**with-mode=MODE**:
+  By default Lmod uses your umask to control the permission unless
+  your user id (i.e. id -u) is less than 500.  If your id is less than
+  500 then it uses a umask of 022.  This translates to use permission
+  of 755 for executables and 644 for all other files.  Sites may wish
+  to install with  different permission.  For example 750,
+  or 700. Remember to set the execute bit.  It will be removed for
+  non-executable files.
+
 .. _lmod_config-label:
 
 Configuring Lmod with **/etc/lmod/lmod_config.lua**: