update CI pipeline description.

.gitlab-ci.yml

+# This file should be read like a 'pure' function and these variables act as
+# arguments.
+# Gitlab overrides with their local affectations when using the "include"
+# directive on this file.
 variables:
+  #The authoritative packaging source
   ARGOPKGS : "./default.nix"
+  #Extra argonix arguments
+  EXTRA : ""
 
-before_script:
-  - CACHE=$(mktemp -d --suffix=nixcache /tmp/deletable-nix-cache-XXXX)
-  - XDG_CACHE_HOME=$CACHE nix-env -f $ARGOPKGS -iA argonix
-  - rm -rf $CACHE
+#This installs argonix before each step. The goal is for this command to be the
+#only unwrapped call to a nix binary in the whole CI setup of the project.  The
+#trick with XDG_CACHE_HOME is there to make sure that no state is propagated
+#through caching, making this file as much of a "pure" function as we can. the
+#`argonix` binary does this too when wrapping nix utilities.
+before_script: - CACHE=$(mktemp -d --suffix=nixcache
+/tmp/deletable-nix-cache-XXXX) - XDG_CACHE_HOME=$CACHE nix-env -f $ARGOPKGS -iA
+argonix - rm -rf $CACHE
 
 stages:
   - build
   - test
 
+####### templates
 .build:
   stage: build
   tags:
@@ -20,44 +32,46 @@ stages:
   tags:
     - integration
 
+###### component builds
 nrm.build:
   extends: .build
   script:
-    - "argonix build nrm --argopkgs $ARGOPKGS $EXTRA"
+    - "argonix build nrm --argopkgs $ARGOPKGS $EXTRA --verbose"
 
 libnrm.build:
   extends: .build
   script:
-    - "argonix build libnrm --argopkgs $ARGOPKGS $EXTRA"
+    - "argonix build libnrm --argopkgs $ARGOPKGS $EXTRA --verbose"
 
 containers.build:
   extends: .build
   script:
-    - "argonix build containers --argopkgs $ARGOPKGS $EXTRA"
+    - "argonix build containers --argopkgs $ARGOPKGS $EXTRA --verbose"
 
 argotk.build:
   extends: .build
   script:
-    - "argonix build argotk --argopkgs $ARGOPKGS $EXTRA"
+    - "argonix build argotk --argopkgs $ARGOPKGS $EXTRA --verbose"
 
+###### integration tests
 testHello.build:
   extends: .test
   script:
-    - "argonix build testHello --argopkgs $ARGOPKGS $EXTRA"
+    - "argonix build testHello --argopkgs $ARGOPKGS $EXTRA --verbose"
 
 testListen.build:
   extends: .test
   script:
-    - "argonix build testListen --argopkgs $ARGOPKGS $EXTRA"
+    - "argonix build testListen --argopkgs $ARGOPKGS $EXTRA --verbose"
 
 testPerfwrapper.build:
   extends: .test
   script:
-    - "argonix build testPerfwrapper --argopkgs $ARGOPKGS $EXTRA"
+    - "argonix build testPerfwrapper --argopkgs $ARGOPKGS $EXTRA --verbose"
 
 testPower.build:
   extends: .test
   script:
-    - "argonix build testPower --argopkgs $ARGOPKGS $EXTRA"
+    - "argonix build testPower --argopkgs $ARGOPKGS $EXTRA --verbose"
   tags:
     - knl