Skip to content

Commit 4f1447f

Browse files
committed
fix discussion of building in parallel
Signed-off-by: Gregory Becker <becker33@llnl.gov>
1 parent fe3896b commit 4f1447f

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

tutorial_stacks.rst

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -296,8 +296,9 @@ to be able to re-build the specs from sources. Alternatively, to create a buildc
296296
Don't forget to set an appropriate value for the padding of the install tree, see `how to setup relocation <https://spack.readthedocs.io/en/latest/binary_caches.html#relocation>`_ in our documentation.
297297

298298
By default, Spack installs one package at a time, using the ``-j`` option where it can.
299-
If you are installing a large environment, and have at disposal a beefy build node, you might need to start more installations in parallel to make an optimal use of the resources.
300-
This can be done by creating a ``depfile``, when the environment is active:
299+
The ``spack install`` command has an optional ``-p`` option for the number of packages to build in parallel.
300+
Note that each parallel package may consume the number of threads of the ``-j`` option.
301+
You can use node resources more optimally by creating a ``depfile``, when the environment is active:
301302

302303
.. code-block:: console
303304
@@ -306,6 +307,7 @@ This can be done by creating a ``depfile``, when the environment is active:
306307
The result is a makefile that starts multiple Spack instances, and the resources are shared through the GNU jobserver.
307308
More information of this feature can be found `in our documentation <https://spack.readthedocs.io/en/latest/environments.html#generating-depfiles-from-environments>`_.
308309
This might cut down your build time by a fair amount, if you build frequently from sources.
310+
Expect this feature to be streamlined in future versions of Spack.
309311

310312
-----------------------------------
311313
Make the software stack easy to use

0 commit comments

Comments
 (0)