stacks section: initial edit for spack 1.0

becker33 · becker33 · commit bff3b27d5e3b · 2025-08-04T06:55:02.000-07:00
Signed-off-by: Gregory Becker &lt;becker33@llnl.gov&gt;
diff --git a/outputs/stacks.sh b/outputs/stacks.sh
@@ -22,11 +22,6 @@ fake_example stacks/setup-1 "spack config edit" "/bin/true"
 example stacks/setup-2 "spack concretize"
 example stacks/setup-2 "spack install"
 
-example stacks/compiler-find-0 'spack compiler find "$(spack location -i gcc)"'
-example stacks/compiler-find-1 "spack location -i gcc"
-
-example stacks/compiler-list-0 "spack compiler list"
-
 example stacks/unify-0 "spack add netlib-scalapack %gcc@12 ^openblas ^openmpi"
 example stacks/unify-0 "spack add netlib-scalapack %gcc@12 ^openblas ^mpich"
 
diff --git a/outputs/stacks/examples/2.spack.stack.yaml b/outputs/stacks/examples/2.spack.stack.yaml
@@ -13,17 +13,3 @@ spack:
   view: false
   concretizer:
     unify: false
-  compilers:
-  - compiler:
-      spec: gcc@=12.3.0
-      paths:
-        cc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gcc
-        cxx: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/g++
-        f77: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-        fc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-      flags: {}
-      operating_system: ubuntu22.04
-      target: x86_64
-      modules: []
-      environment: {}
-      extra_rpaths: []
diff --git a/outputs/stacks/examples/3.spack.stack.yaml b/outputs/stacks/examples/3.spack.stack.yaml
@@ -20,17 +20,3 @@ spack:
   view: false
   concretizer:
     unify: false
-  compilers:
-  - compiler:
-      spec: gcc@=12.3.0
-      paths:
-        cc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gcc
-        cxx: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/g++
-        f77: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-        fc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-      flags: {}
-      operating_system: ubuntu22.04
-      target: x86_64
-      modules: []
-      environment: {}
-      extra_rpaths: []
diff --git a/outputs/stacks/examples/4bis.spack.stack.yaml b/outputs/stacks/examples/4bis.spack.stack.yaml
@@ -26,17 +26,3 @@ spack:
   view: false
   concretizer:
     unify: false
-  compilers:
-  - compiler:
-      spec: gcc@=12.3.0
-      paths:
-        cc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gcc
-        cxx: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/g++
-        f77: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-        fc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-      flags: {}
-      operating_system: ubuntu22.04
-      target: x86_64
-      modules: []
-      environment: {}
-      extra_rpaths: []
diff --git a/outputs/stacks/examples/5.spack.stack.yaml b/outputs/stacks/examples/5.spack.stack.yaml
@@ -28,17 +28,3 @@ spack:
   view: false
   concretizer:
     unify: false
-  compilers:
-  - compiler:
-      spec: gcc@=12.3.0
-      paths:
-        cc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gcc
-        cxx: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/g++
-        f77: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-        fc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-      flags: {}
-      operating_system: ubuntu22.04
-      target: x86_64
-      modules: []
-      environment: {}
-      extra_rpaths: []
diff --git a/outputs/stacks/examples/6.spack.stack.yaml b/outputs/stacks/examples/6.spack.stack.yaml
@@ -27,20 +27,6 @@ spack:
     - "py-scipy ^netlib-lapack"
   concretizer:
     unify: false
-  compilers:
-  - compiler:
-      spec: gcc@=12.3.0
-      paths:
-        cc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gcc
-        cxx: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/g++
-        f77: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-        fc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-      flags: {}
-      operating_system: ubuntu22.04
-      target: x86_64
-      modules: []
-      environment: {}
-      extra_rpaths: []
   view:
     default:
       root: views/default
diff --git a/outputs/stacks/examples/7.spack.stack.yaml b/outputs/stacks/examples/7.spack.stack.yaml
@@ -27,20 +27,6 @@ spack:
     - "py-scipy ^netlib-lapack"
   concretizer:
     unify: false
-  compilers:
-  - compiler:
-      spec: gcc@=12.3.0
-      paths:
-        cc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gcc
-        cxx: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/g++
-        f77: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-        fc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-      flags: {}
-      operating_system: ubuntu22.04
-      target: x86_64
-      modules: []
-      environment: {}
-      extra_rpaths: []
   view:
     default:
       root: views/default
diff --git a/outputs/stacks/examples/8.spack.stack.yaml b/outputs/stacks/examples/8.spack.stack.yaml
@@ -28,20 +28,6 @@ spack:
   view: false
   concretizer:
     unify: false
-  compilers:
-  - compiler:
-      spec: gcc@=12.3.0
-      paths:
-        cc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gcc
-        cxx: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/g++
-        f77: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-        fc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-      flags: {}
-      operating_system: ubuntu22.04
-      target: x86_64
-      modules: []
-      environment: {}
-      extra_rpaths: []
   modules:
     default:
       enable:
diff --git a/outputs/stacks/examples/9.spack.stack.yaml b/outputs/stacks/examples/9.spack.stack.yaml
@@ -28,20 +28,6 @@ spack:
   view: false
   concretizer:
     unify: false
-  compilers:
-  - compiler:
-      spec: gcc@=12.3.0
-      paths:
-        cc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gcc
-        cxx: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/g++
-        f77: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-        fc: /home/spack/spack/opt/spack/linux-ubuntu22.04-x86_64_v3/gcc-11.4.0/gcc-12.3.0-hc3fmfiuomxfx4gnvorj3z3y2gjf2doh/bin/gfortran
-      flags: {}
-      operating_system: ubuntu22.04
-      target: x86_64
-      modules: []
-      environment: {}
-      extra_rpaths: []
   modules:
     default:
       enable:
diff --git a/tutorial_stacks.rst b/tutorial_stacks.rst
@@ -39,11 +39,11 @@ Setup the compiler
 The first step to build our stack is to setup the compiler we want to use later.
 This is currently an iterative process that can be done in two ways:
 
- 1. Install the compiler first, then register it in the environment
- 2. Use a second environment just for the compiler
+ 1. Install the compiler first, then install the rest of the environment
+ 2. Install the compiler outside the environment (either in another environment or standalone)
 
 Below, we'll use the first approach.
-For people interested, an example of the latter approach can be found `at this link <https://github.com/haampie/spack-intermediate-gcc-example/>`_.
+For people interested, an example of composing a compiler from another environment can be found `at this link <https://github.com/haampie/spack-intermediate-gcc-example/>`_.
 
 Let's start by creating an environment in a directory of our choice:
 
@@ -67,27 +67,6 @@ The next step is to concretize and install our compiler:
 .. literalinclude:: outputs/stacks/setup-2.out
    :language: console
 
-Finally, let's register it as a new compiler in the environment:
-
-.. literalinclude:: outputs/stacks/compiler-find-0.out
-   :language: console
-
-The ``spack location -i`` command returns the installation prefix for the spec being queried:
-
-.. literalinclude:: outputs/stacks/compiler-find-1.out
-   :language: console
-
-This might be useful in general when scripting Spack commands, as the example above shows.
-Listing the compilers now shows the presence of ``gcc@12.3.0``:
-
-.. literalinclude:: outputs/stacks/compiler-list-0.out
-   :language: console
-
-The manifest file at this point looks like:
-
-.. literalinclude:: outputs/stacks/examples/1.spack.stack.yaml
-   :language: yaml
-
 We are ready to build more software with our newly installed GCC!
 
 ------------------------
@@ -350,7 +329,7 @@ Edit our ``spack.yaml`` file again.
 
 .. literalinclude:: outputs/stacks/examples/6.spack.stack.yaml
    :language: yaml
-   :emphasize-lines: 44-54
+   :emphasize-lines: 30-40
 
 In the configuration above we created two views, named ``default`` and ``full``.
 The ``default`` view consists of all the packages that are compiled with ``gcc@12``, but do not depend on either ``mpich`` or ``netlib-lapack``.
@@ -370,7 +349,7 @@ If we set the option to "roots", Spack links only the root packages into the vie
 
 .. literalinclude:: outputs/stacks/examples/7.spack.stack.yaml
    :language: yaml
-   :emphasize-lines: 49
+   :emphasize-lines: 35
 
 .. literalinclude:: outputs/stacks/view-1.out
    :language: console
@@ -412,7 +391,7 @@ The next step is to add some basic configuration to our ``spack.yaml`` to genera
 
 .. literalinclude:: outputs/stacks/examples/8.spack.stack.yaml
    :language: yaml
-   :emphasize-lines: 45-54
+   :emphasize-lines: 31-40
 
 In these few lines of additional configuration we told Spack to generate ``lmod`` module files in a subdirectory named ``modules``, using a hierarchy comprising both ``lapack`` and ``mpi``.
 
@@ -444,7 +423,7 @@ To address all these needs we can complicate our ``modules`` configuration a bit
 
 .. literalinclude:: outputs/stacks/examples/9.spack.stack.yaml
    :language: yaml
-   :emphasize-lines: 55-70
+   :emphasize-lines: 41-56
 
 Regenerate the modules again:
 
