Skip to content

Commit 3e7f197

Browse files
Update documentation
1 parent e28ca15 commit 3e7f197

12 files changed

+62
-62
lines changed
102 KB
Binary file not shown.

main/.doctrees/environment.pickle

102 KB
Binary file not shown.

main/developers_guide/generated/mache.MachineInfo.html

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -109,23 +109,23 @@ <h1>mache.MachineInfo<a class="headerlink" href="#mache-machineinfo" title="Link
109109
<dl class="field-list simple">
110110
<dt class="field-odd">Variables<span class="colon">:</span></dt>
111111
<dd class="field-odd"><ul class="simple">
112-
<li><p><strong>machine</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The name of an E3SM supported machine</p></li>
113-
<li><p><strong>config</strong> (<a class="reference external" href="https://docs.python.org/3/library/configparser.html#configparser.ConfigParser" title="(in Python v3.13)"><em>configparser.ConfigParser</em></a>) – Config options for this machine</p></li>
114-
<li><p><strong>e3sm_supported</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><em>bool</em></a>) – Whether this machine supports running E3SM itself, and therefore has
112+
<li><p><strong>machine</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The name of an E3SM supported machine</p></li>
113+
<li><p><strong>config</strong> (<a class="reference external" href="https://docs.python.org/3/library/configparser.html#configparser.ConfigParser" title="(in Python v3.14)"><em>configparser.ConfigParser</em></a>) – Config options for this machine</p></li>
114+
<li><p><strong>e3sm_supported</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.14)"><em>bool</em></a>) – Whether this machine supports running E3SM itself, and therefore has
115115
a list of compilers, MPI libraries, and the modules needed to load them</p></li>
116-
<li><p><strong>compilers</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.13)"><em>list</em></a>) – A list of compilers for this machine if <code class="docutils literal notranslate"><span class="pre">e3sm_supported</span> <span class="pre">==</span> <span class="pre">True</span></code></p></li>
117-
<li><p><strong>mpilibs</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.13)"><em>list</em></a>) – A list of MPI libraries for this machine if <code class="docutils literal notranslate"><span class="pre">e3sm_supported</span> <span class="pre">==</span> <span class="pre">True</span></code></p></li>
118-
<li><p><strong>os</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The machine’s operating system if <code class="docutils literal notranslate"><span class="pre">e3sm_supported</span> <span class="pre">==</span> <span class="pre">True</span></code></p></li>
116+
<li><p><strong>compilers</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.14)"><em>list</em></a>) – A list of compilers for this machine if <code class="docutils literal notranslate"><span class="pre">e3sm_supported</span> <span class="pre">==</span> <span class="pre">True</span></code></p></li>
117+
<li><p><strong>mpilibs</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.14)"><em>list</em></a>) – A list of MPI libraries for this machine if <code class="docutils literal notranslate"><span class="pre">e3sm_supported</span> <span class="pre">==</span> <span class="pre">True</span></code></p></li>
118+
<li><p><strong>os</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The machine’s operating system if <code class="docutils literal notranslate"><span class="pre">e3sm_supported</span> <span class="pre">==</span> <span class="pre">True</span></code></p></li>
119119
<li><p><strong>e3sm_unified_mpi</strong> (<em>{'nompi'</em><em>, </em><em>'system'</em><em>, </em><em>None}</em>) – Which MPI type is included in the E3SM-Unified environment (if one is
120120
loaded)</p></li>
121-
<li><p><strong>e3sm_unified_base</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The base path where E3SM-Unified and its activation scripts are
121+
<li><p><strong>e3sm_unified_base</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The base path where E3SM-Unified and its activation scripts are
122122
installed if <code class="docutils literal notranslate"><span class="pre">e3sm_unified</span></code> is not <code class="docutils literal notranslate"><span class="pre">None</span></code></p></li>
123-
<li><p><strong>e3sm_unified_activation</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The activation script used to activate E3SM-Unified if <code class="docutils literal notranslate"><span class="pre">e3sm_unified</span></code>
123+
<li><p><strong>e3sm_unified_activation</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The activation script used to activate E3SM-Unified if <code class="docutils literal notranslate"><span class="pre">e3sm_unified</span></code>
124124
is not <code class="docutils literal notranslate"><span class="pre">None</span></code></p></li>
125-
<li><p><strong>diagnostics_base</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The base directory for diagnostics data</p></li>
126-
<li><p><strong>web_portal_base</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The base directory for the web portal</p></li>
127-
<li><p><strong>web_portal_url</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The base URL for the web portal</p></li>
128-
<li><p><strong>username</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The name of the current user, for use in web-portal directories. This
125+
<li><p><strong>diagnostics_base</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The base directory for diagnostics data</p></li>
126+
<li><p><strong>web_portal_base</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The base directory for the web portal</p></li>
127+
<li><p><strong>web_portal_url</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The base URL for the web portal</p></li>
128+
<li><p><strong>username</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The name of the current user, for use in web-portal directories. This
129129
value is also added to the <code class="docutils literal notranslate"><span class="pre">web_portal</span></code> and <code class="docutils literal notranslate"><span class="pre">username</span></code> option of
130130
the <code class="docutils literal notranslate"><span class="pre">config</span></code> attribute.</p></li>
131131
</ul>
@@ -138,9 +138,9 @@ <h1>mache.MachineInfo<a class="headerlink" href="#mache-machineinfo" title="Link
138138
<dl class="field-list simple">
139139
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
140140
<dd class="field-odd"><ul class="simple">
141-
<li><p><strong>machine</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a><em>, </em><em>optional</em>) – The name of an E3SM supported machine. By default, the machine
141+
<li><p><strong>machine</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a><em>, </em><em>optional</em>) – The name of an E3SM supported machine. By default, the machine
142142
will be inferred from the host name</p></li>
143-
<li><p><strong>quiet</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to print warnings if the machine name is ambiguous</p></li>
143+
<li><p><strong>quiet</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.14)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to print warnings if the machine name is ambiguous</p></li>
144144
</ul>
145145
</dd>
146146
</dl>

main/developers_guide/generated/mache.discover.discover_machine.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ <h1>mache.discover.discover_machine<a class="headerlink" href="#mache-discover-d
107107
<dd><p>Figure out the machine from the host name</p>
108108
<dl class="field-list simple">
109109
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
110-
<dd class="field-odd"><p><strong>quiet</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to print warnings if the machine name is ambiguous</p>
110+
<dd class="field-odd"><p><strong>quiet</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.14)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to print warnings if the machine name is ambiguous</p>
111111
</dd>
112112
<dt class="field-even">Returns<span class="colon">:</span></dt>
113113
<dd class="field-even"><p><strong>machine</strong> (<em>str</em>) – The name of the current machine</p>

main/developers_guide/generated/mache.permissions.update_permissions.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -109,11 +109,11 @@ <h1>mache.permissions.update_permissions<a class="headerlink" href="#mache-permi
109109
<dl class="field-list simple">
110110
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
111111
<dd class="field-odd"><ul class="simple">
112-
<li><p><strong>base_paths</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a><em> or </em><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.13)"><em>list</em></a>) – The base path(s) to recursively update permissions on</p></li>
113-
<li><p><strong>group</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The name of the group the contents of <code class="docutils literal notranslate"><span class="pre">base_paths</span></code> should belong to</p></li>
114-
<li><p><strong>show_progress</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to show a progress bar</p></li>
115-
<li><p><strong>group_writable</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to allow group write permissions</p></li>
116-
<li><p><strong>other_readable</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.13)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to allow world read (and, where appropriate, execute)
112+
<li><p><strong>base_paths</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a><em> or </em><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.14)"><em>list</em></a>) – The base path(s) to recursively update permissions on</p></li>
113+
<li><p><strong>group</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The name of the group the contents of <code class="docutils literal notranslate"><span class="pre">base_paths</span></code> should belong to</p></li>
114+
<li><p><strong>show_progress</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.14)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to show a progress bar</p></li>
115+
<li><p><strong>group_writable</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.14)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to allow group write permissions</p></li>
116+
<li><p><strong>other_readable</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.14)"><em>bool</em></a><em>, </em><em>optional</em>) – Whether to allow world read (and, where appropriate, execute)
117117
permissions</p></li>
118118
</ul>
119119
</dd>

main/developers_guide/generated/mache.spack.config_to_shell_script.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ <h1>mache.spack.config_to_shell_script<a class="headerlink" href="#mache-spack-c
115115
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
116116
<dd class="field-odd"><ul class="simple">
117117
<li><p><strong>config</strong> (<em>etree.Element</em>) – The XML element of the machine configuration.</p></li>
118-
<li><p><strong>shell_type</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – The type of shell script to generate (‘sh’ or ‘csh’).</p></li>
118+
<li><p><strong>shell_type</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – The type of shell script to generate (‘sh’ or ‘csh’).</p></li>
119119
</ul>
120120
</dd>
121121
<dt class="field-even">Returns<span class="colon">:</span></dt>

main/developers_guide/generated/mache.spack.extract_machine_config.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -114,10 +114,10 @@ <h1>mache.spack.extract_machine_config<a class="headerlink" href="#mache-spack-e
114114
<dl class="field-list simple">
115115
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
116116
<dd class="field-odd"><ul class="simple">
117-
<li><p><strong>xml_file</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – Path to the XML file.</p></li>
118-
<li><p><strong>machine</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – Machine name.</p></li>
119-
<li><p><strong>compiler</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – Compiler name.</p></li>
120-
<li><p><strong>mpilib</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – MPI library name.</p></li>
117+
<li><p><strong>xml_file</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – Path to the XML file.</p></li>
118+
<li><p><strong>machine</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – Machine name.</p></li>
119+
<li><p><strong>compiler</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – Compiler name.</p></li>
120+
<li><p><strong>mpilib</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – MPI library name.</p></li>
121121
</ul>
122122
</dd>
123123
<dt class="field-even">Returns<span class="colon">:</span></dt>

main/developers_guide/generated/mache.spack.extract_spack_from_config_machines.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -114,11 +114,11 @@ <h1>mache.spack.extract_spack_from_config_machines<a class="headerlink" href="#m
114114
<dl class="field-list simple">
115115
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
116116
<dd class="field-odd"><ul class="simple">
117-
<li><p><strong>machine</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – Machine name.</p></li>
118-
<li><p><strong>compiler</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – Compiler name.</p></li>
119-
<li><p><strong>mpilib</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – MPI library name.</p></li>
120-
<li><p><strong>shell</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – Shell script type (‘sh’ or ‘csh’).</p></li>
121-
<li><p><strong>output</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.13)"><em>str</em></a>) – Output file to write the shell script.</p></li>
117+
<li><p><strong>machine</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – Machine name.</p></li>
118+
<li><p><strong>compiler</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – Compiler name.</p></li>
119+
<li><p><strong>mpilib</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – MPI library name.</p></li>
120+
<li><p><strong>shell</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – Shell script type (‘sh’ or ‘csh’).</p></li>
121+
<li><p><strong>output</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><em>str</em></a>) – Output file to write the shell script.</p></li>
122122
</ul>
123123
</dd>
124124
</dl>

0 commit comments

Comments
 (0)