Document initialization of PYTHONPATH

Signed-off-by: Byron Boulton <bboulton@ara.com>

Author: Byron Boulton

INSTALL.rst

@@ -504,6 +504,15 @@ instance :instopt:`--disable-set-manpath<--enable-set-manpath>`):
 
     .. versionadded:: 4.2
 
+.. instopt:: --enable-append-pythonpath
+
+ Append rather prepend init directory to the PYTHONPATH environment variable
+ when the :instopt:`--enable-set-pythonpath` option is enabled. (default=no)
+
+ .. only:: html
+
+    .. versionadded:: 5.7
+
 .. instopt:: --enable-auto-handling
 
  Set modulecmd.tcl to automatically apply automated modulefiles handling
@@ -799,6 +808,16 @@ instance :instopt:`--disable-set-manpath<--enable-set-manpath>`):
 
     .. versionadded:: 4.0
 
+.. instopt:: --enable-set-pythonpath
+
+ Prepend init directory defined by the :instopt:`--initdir` option to the
+ PYTHONPATH environment variable in the shell initialization scripts.
+ (default=yes)
+
+ .. only:: html
+
+    .. versionadded:: 5.7
+
 .. instopt:: --enable-set-shell-startup
 
  Set when module function is defined the shell startup file to ensure that the

doc/source/module.rst

@@ -128,10 +128,20 @@ Perl:
 
 Python:
 
+Default installation should have added |file initdir| to the :envvar:`PYTHONPATH` environment variable allowing initialization as follows
+
+.. parsed-literal::
+
+     from env_modules import module
+     module("load", "modulefile", "modulefile", "...")
+
+Otherwise
+
 .. parsed-literal::
 
-     import os
-     exec(open("\ |initdir|\ /python.py").read(), globals())
+     import sys
+     sys.path.insert(1, "\ |initdir|\ ")
+     from env_modules import module
      module("load", "modulefile", "modulefile", "...")
 
 Ruby: