fa7e4f510b
Change the default to be the python2 version to match with the guidelines Switch to generic environment(modules) instead of Lmod specifically.
18 lines
750 B
Plaintext
18 lines
750 B
Plaintext
Sphinx with autodoc is sensitive to whether it is run via Python2 or Python3
|
|
as it uses the Python version that it is invoked with to parse the source
|
|
files for docstrings. Unfortunately, there's no logic to detect this within
|
|
the sphinx commands and the standard Makefiles generated by sphinx-quickstart
|
|
don't give the user any hint that it might be a problem.
|
|
|
|
The Fedora package tries to mitigate this problem by allowing the user to
|
|
switch between the Python2 and Python3 versions using environment-modules. To
|
|
switch to the Python3 commands, use::
|
|
|
|
module swap python-sphinx/python3-sphinx
|
|
|
|
To switch to the Python2 version, use::
|
|
|
|
module swap python-sphinx/python2-sphinx
|
|
|
|
The default install uses the python3 version of the modules.
|