Merge branch '3.3dev' into https_rr

.github/pull_request_template.md

@@ -1,22 +1,36 @@
+<!--
 
 ## Describe your changes
+Please refer to an issue here or describe the change thoroughly in your PR and check the boxes which are applicable. 
 
-Please refer to an issue here or describe the change thoroughly in your PR.
+This includes:
+- Resolved or fixed issue: <-- ✍️ Add GitHub issue number in format `#0000` 
+- A clear and concise summary of the change and which issue (if any) it fixes. Should also include relevant motivation and context.
+
+-->
 
 ## What is your pull request about?
 - [ ] Bug fix
 - [ ] Improvement
 - [ ] New feature (adds functionality)
-- [ ] Breaking change (bug fix, feature or improvement that would cause existing functionality to not work as expected)
-- [ ] Typo fix
+- [ ] Breaking change: bug fix, feature or improvement that would cause existing output (especially JSON, CSV) to not work as expected before
+- [ ] Typo / spelling fix
 - [ ] Documentation update
 - [ ] Update of other files
 
 
 ## If it's a code change please check the boxes which are applicable
 - [ ] For the main program: My edits contain no tabs, indentation is five spaces and any line endings do not contain any blank chars
-- [ ] I've read CONTRIBUTING.md and Coding_Convention.md 
+- [ ] I've read [CONTRIBUTING.md](https://github.com/testssl/testssl.sh/blob/3.3dev/CONTRIBUTING.md)
+- [ ] My code follows [Coding_Convention.md](https://github.com/testssl/testssl.sh/blob/3.3dev/Coding_Convention.md) 
 - [ ] I have tested this __fix__ or __improvement__ against >=2 hosts and I couldn't spot a problem
 - [ ] I have tested this __new feature__ against >=2 hosts which show this feature and >=2 host which does not (in order to avoid side effects) . I couldn't spot a problem
 - [ ] For the __new feature__ I have made corresponding changes to the documentation and / or to ``help()``
-- [ ] If it's a bigger change: I added myself to CREDITS.md (alphabetical order) and the change to CHANGELOG.md
+- [ ] If it's a bigger change: I added myself to [CREDITS.md](https://github.com/testssl/testssl.sh/blob/3.3dev/CREDITS.md) (alphabetical order) and the change to [CHANGELOG.md](https://github.com/testssl/testssl.sh/blob/3.3dev/CHANGELOG.md)
+
+## AI section
+- [ ] My contribution does not include any AI-generated content
+- [ ] My contribution includes AI-generated content, as disclosed below:
+    - AI Tools: `[e.g. GitHub CoPilot, JetBrains Junie, VS Code plugin <NAME> etc.]`
+    - LLMs and versions: `[e.g. GPT-A.B, Claude <NAME> A.B, Gemini A.B <NAME>, Qwen<B>-Coder, DeepSeek-<A>  etc.]`
+

.github/workflows/build_docs.yml

@@ -0,0 +1,43 @@
+name: Build Documentation
+
+on:
+  pull_request:
+    paths:
+      - "doc/testssl.1.md"
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-26.04
+    # Skip fork PRs: GITHUB_TOKEN can't push to a fork's branch
+    if: github.event.pull_request.head.repo.full_name == github.repository
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+        with:
+          ref: ${{ github.head_ref }}
+          fetch-depth: 0
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y pandoc make
+
+      - name: Build documentation
+        working-directory: doc
+        run: make -B
+        # -B ensures build when doc/testssl.1.md changes. When checking out the md file
+        # it probably might have a time stamp which indicates nothing has changed
+
+      - name: Commit and push generated doc files
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add -A
+          if git diff --staged --quiet; then
+            echo "No generated changes to commit"
+          else
+            git commit -m "Auto-generate docs from testssl.1.md [skip ci]"
+            git push
+          fi
+

.github/workflows/codespell.yml

@@ -9,7 +9,7 @@ jobs:
     name: Check for spelling errors
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - uses: codespell-project/actions-codespell@master
         with:
           skip: ca_hashes.txt,tls_data.txt,*.pem,OPENSSL-LICENSE.txt,CREDITS.md,openssl.cnf,testssl.1

.github/workflows/docker-3.3dev.yml

@@ -22,7 +22,7 @@ jobs:
         run: echo "REPO=${GITHUB_REPOSITORY@L}" >> "${GITHUB_ENV}"
 
       - name: Source checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Setup QEMU
         id: qemu

.github/workflows/shellcheck.yml

@@ -30,7 +30,7 @@ jobs:
     env:
       LANG: C.UTF-8
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: Install shellcheck
         run: sudo apt update && sudo apt install -y shellcheck && shellcheck --version

.github/workflows/unit_tests_macos.yml

@@ -29,7 +29,7 @@ jobs:
     name: PoC unit test on MacOS
     steps:
       - name: checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up system (perl, curl is installed already)
         run: |
@@ -54,6 +54,7 @@ jobs:
           cpanm --notest Data::Dumper
           cpanm --notest JSON
           cpanm --notest Text::Diff
+          cpanm --notest IPC::Run3
 
       - name: run it
         run: |

.github/workflows/unit_tests_ubuntu.yml

@@ -32,7 +32,7 @@ jobs:
         perl: ['5.38']
     name: Unit test on ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: Set up perl
         uses: shogo82148/actions-setup-perl@v1
@@ -51,6 +51,8 @@ jobs:
           printf "%s\n" "----------"
           bash --version
           printf "%s\n" "----------"
+          echo $PATH
+          printf "%s\n" "----------"
 
       - name: Install perl modules
         run: |
@@ -58,6 +60,7 @@ jobs:
           cpanm --notest Data::Dumper
           cpanm --notest JSON
           cpanm --notest Text::Diff
+          cpanm --notest IPC::Run3
 
       - name: run it
         run: |