Update the basics section

Author: alalazo

outputs/basics.sh

@@ -9,7 +9,7 @@ project="$(dirname "$0")"
 
 export SPACK_COLOR=never
 
-# basic installation
+# Setting Up Spack
 example basics/clone           "git clone --depth=2 --branch=$tutorial_branch https://github.com/spack/spack.git ~/spack"
 example basics/clone           "cd ~/spack"
 
@@ -21,61 +21,64 @@ spack config add "config:suppress_gpg_warnings:true"
 
 example basics/source-setup     ". share/spack/setup-env.sh"
 
-# spack list
+spack repo update
+
+# Installing Packages
 example basics/list            "spack list"
 example basics/list-py         "spack list 'py-*'"
 
 # spack install
-example basics/gmake           "spack install gmake"
+example --tee basics/gmake           "spack install gmake"
 
 example basics/compiler-list   "spack compilers"
 
-example basics/mirror          "spack mirror add tutorial /mirror"
 example basics/mirror          "spack buildcache keys --install --trust --yes-to-all"
 
-example basics/zlib-clang     "spack install zlib-ng %clang"
-
+# The Spec Syntax
 example basics/versions-zlib  "spack versions zlib-ng"
-example basics/zlib-2.0.7       "spack install zlib-ng@2.0.7"
-example basics/zlib-gcc-10    "spack install zlib-ng %gcc@10"
+example --tee basics/zlib-2.0.7       "spack install zlib-ng@2.0.7"
 
-example basics/zlib-O3        "spack install zlib-ng@2.0.7 cflags=-O3"
-
-example basics/find            "spack find"
-example basics/find-lf         "spack find -lf"
+example basics/info-zlib      "spack info --no-dependencies --no-versions zlib-ng"
 
-example basics/tcl             "spack install tcl"
+example --tee basics/zlib-ipo        "spack install zlib-ng +ipo"
+example --tee basics/zlib-build-type "spack install zlib-ng build_type=Debug"
 
-example basics/tcl-zlib-clang "spack install tcl ^zlib-ng@2.0.7 %clang"
+example --tee basics/zlib-clang     "spack install zlib-ng %clang"
+example --tee basics/zlib-gcc-14    "spack install zlib-ng %gcc@14"
 
-zlib_hash=$(spack find --format "{hash:3}" zlib-ng cflags=-O3)
-example basics/tcl-zlib-hash  "spack install tcl ^/${zlib_hash}"
+example basics/spec-tcl-zlib-clang  "spack spec -l tcl ^zlib-ng@2.0.7 %clang"
+example --tee basics/tcl-zlib-clang "spack install tcl ^zlib-ng@2.0.7 %clang"
 
-example basics/find-ldf        "spack find -ldf"
+# Refer to the zlib-ng@2.0.7 %clang build we just installed by its hash
+zlib_hash=$(spack find --format "{hash:3}" zlib-ng@2.0.7 %clang)
+example basics/spec-tcl-zlib-hash   "spack spec tcl ^/${zlib_hash}"
 
 example basics/graph-tcl       "spack graph tcl"
 
+example basics/providers-mpi   "spack providers mpi"
 example basics/hdf5-spec       "spack spec hdf5"
-example basics/hdf5            "spack install hdf5"
-example basics/hdf5-no-mpi     "spack install hdf5~mpi"
-
-example basics/hdf5-hl-mpi     "spack install hdf5+hl+mpi ^mpich"
-
-example basics/find-ldf-2      "spack find -ldf"
-
-example basics/trilinos        "spack install trilinos"
-
-example basics/trilinos-hdf5   "spack install trilinos +hdf5 ^hdf5+hl+mpi ^mpich"
+example --tee basics/hdf5            "spack install hdf5"
+example --tee basics/hdf5-no-mpi     "spack install hdf5~mpi"
 
-example basics/find-d-trilinos "spack find -d trilinos"
-
-example basics/graph-trilinos  "spack graph trilinos"
+example --tee basics/hdf5-mpich      "spack install hdf5 ^mpich"
+example basics/spec-hdf5-compilers   "spack spec hdf5 %c,cxx=clang %fortran=gcc"
 
+# Querying Installations
+example basics/find            "spack find"
+example basics/find-l          "spack find -l"
 example basics/find-d-tcl      "spack find -d tcl"
+example basics/find-dep-mpich  "spack find ^mpich"
+example basics/find-px         "spack find -px"
 
+# A Realistic Example
+example --tee basics/trilinos        "spack install trilinos"
+example --tee basics/trilinos-hdf5   "spack install trilinos +hdf5 ^mpich"
+example basics/trilinos-find-mpich   "spack find ^mpich"
+
+# Uninstalling Packages
 example basics/find-zlib      "spack find zlib-ng"
 
-example basics/uninstall-zlib "spack uninstall -y zlib-ng %gcc@10"
+example basics/uninstall-zlib "spack uninstall -y zlib-ng %gcc@14"
 
 example basics/find-lf-zlib   "spack find -lf zlib-ng"
 
@@ -88,18 +91,11 @@ example --expect-error basics/uninstall-ambiguous "spack uninstall trilinos"
 trilinos_hash="$(spack find --format '{hash:3}' trilinos ^openmpi)"
 echo y | example basics/uninstall-specific  "spack uninstall /$trilinos_hash"
 
-example basics/find-dep-mpich      "spack find ^mpich"
-
-example basics/find-O3             "spack find cflags=-O3"
-
-example basics/find-px             "spack find -px"
-
-example basics/compilers           "spack compilers"
-
-example basics/install-gcc-12.1.0   "spack install gcc@12"
+# Customizing Compilers
+example --tee basics/install-gcc-16   "spack install gcc@16"
 
 example basics/compilers-2           "spack compilers"
 
-example basics/spec-zziplib          "spack spec zziplib %gcc@12"
+example basics/spec-zziplib          "spack spec zziplib %gcc@16"
 
-echo y | example basics/compiler-uninstall       'spack uninstall gcc@12'
+example basics/compiler-uninstall       'spack uninstall -y gcc@16'