Update READMEs (quoting of branch/tag name settings)

gh-actions: fix example configurations

README.md

@@ -365,16 +365,16 @@ This will make all builds (not just for your module) verbose.
 
 Update the submodule in `.ci` first, then change your CI configuration
 (if needed) and commit both to your module. E.g., to update your Travis
-setup to release 3.1.0 of ci-scripts:
+setup to release 3.1.1 of ci-scripts:
 ```bash
 cd .ci
-git pull origin v3.1.0
+git pull origin v3.1.1
 cd -
 git add .ci
   # if needed:
   edit .travis.yml     # and/or AppVeyor/GitHub Actions configuration
   git add .travis.yml
-git commit -m "Update ci-scripts submodule to v3.1.0"
+git commit -m "Update ci-scripts submodule to v3.1.1"
 ```
 
 Check the example configuration files inside ci-scripts (and their

github-actions/README.md

@@ -48,6 +48,18 @@
  5. Push your changes and click on the `Actions` tab of your GitHub repository
     page to see your build results.
 
+## Specifics
+
+#### Quote Environment Variable Values
+
+Variable settings distinguish between numerical and string values.
+Better quote all branch and tag names. E.g.,
+```yaml
+env:
+  BASE: "7.0"
+```
+to avoid ci-scripts trying to `git clone` with `--branch 7`.
+
 ## Caches
 
 GitHub Actions provides caching of dependencies.

github-actions/ci-scripts-build.yml.example-full

@@ -12,7 +12,6 @@ on: [push, pull_request]
 
 env:
   SETUP_PATH: .ci-local:.ci
-  SET: test01
   CMP: gcc
   # For the sequencer on Linux/Windows/MacOS
   APT: re2c
@@ -35,14 +34,16 @@ jobs:
         configuration: [default, static, debug, static-debug]
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: true
     - name: Prepare and compile dependencies
-      run: python cue.py prepare
+      run: python .ci/cue.py prepare
     - name: Build main module
-      run: python cue.py build
+      run: python .ci/cue.py build
     - name: Run main module tests
-      run: python cue.py test
+      run: python .ci/cue.py test
     - name: Collect and show test results
-      run: python cue.py test-results
+      run: python .ci/cue.py test-results
 
   build-macos:
     name: ${{ matrix.cmp }} / ${{ matrix.configuration }} / ${{ matrix.os }}
@@ -61,13 +62,13 @@ jobs:
     steps:
     - uses: actions/checkout@v2
     - name: Prepare and compile dependencies
-      run: python cue.py prepare
+      run: python .ci/cue.py prepare
     - name: Build main module
-      run: python cue.py build
+      run: python .ci/cue.py build
     - name: Run main module tests
-      run: python cue.py test
+      run: python .ci/cue.py test
     - name: Collect and show test results
-      run: python cue.py test-results
+      run: python .ci/cue.py test-results
 
   build-windows:
     name: ${{ matrix.cmp }} / ${{ matrix.configuration }} / ${{ matrix.os }}
@@ -89,14 +90,16 @@ jobs:
             cmp: vs2019
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: true
     - name: Prepare and compile dependencies
-      run: python cue.py prepare
+      run: python .ci/cue.py prepare
     - name: Build main module
-      run: python cue.py build
+      run: python .ci/cue.py build
     - name: Run main module tests
-      run: python cue.py test
+      run: python .ci/cue.py test
     - name: Collect and show test results
-      run: python cue.py test-results
+      run: python .ci/cue.py test-results
 
   # Same setup and toolchain as on Travis.
   # Needs Base >= 3.15 to compile, EPICS 7 to also run the tests on qemu
@@ -113,18 +116,20 @@ jobs:
       matrix:
         os: [ubuntu-18.04]
         cmp: [gcc]
-        configuration: [default, static, debug, static-debug]
+        configuration: [default]
         rtems: ["4.9", "4.10"]
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: true
     - name: Prepare and compile dependencies
-      run: python cue.py prepare
+      run: python .ci/cue.py prepare
     - name: Build main module
-      run: python cue.py build
+      run: python .ci/cue.py build
     - name: Run main module tests
-      run: python cue.py test
+      run: python .ci/cue.py test
     - name: Collect and show test results
-      run: python cue.py test-results
+      run: python .ci/cue.py test-results
 
   # The WINE cross builds are of somewhat limited use,
   # as there are native gcc/MinGW builds available on GitHub Actions
@@ -145,11 +150,13 @@ jobs:
         wine: [32, 64]
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: true
     - name: Prepare and compile dependencies
-      run: python cue.py prepare
+      run: python .ci/cue.py prepare
     - name: Build main module
-      run: python cue.py build
+      run: python .ci/cue.py build
     - name: Run main module tests
-      run: python cue.py test
+      run: python .ci/cue.py test
     - name: Collect and show test results
-      run: python cue.py test-results
+      run: python .ci/cue.py test-results

github-actions/ci-scripts-build.yml.example-mini

@@ -12,7 +12,6 @@ on: [push, pull_request]
 
 env:
   SETUP_PATH: .ci-local:.ci
-  SET: test01
   CMP: gcc
 
 jobs:
@@ -33,11 +32,13 @@ jobs:
         base: ["7.0", "3.15"]
     steps:
     - uses: actions/checkout@v2
+      with:
+        submodules: true
     - name: Prepare and compile dependencies
-      run: python cue.py prepare
+      run: python .ci/cue.py prepare
     - name: Build main module
-      run: python cue.py build
+      run: python .ci/cue.py build
     - name: Run main module tests
-      run: python cue.py test
+      run: python .ci/cue.py test
     - name: Collect and show test results
-      run: python cue.py test-results
+      run: python .ci/cue.py test-results