ci: add GitHub Action to validate manpages with mandoc

Add a new workflow that builds and validates all manpages using mandoc -T lint.
The workflow runs on PRs and pushes that modify manpage-related files and
validates both English and French manpages in parallel.

Author: sylvestre

.github/workflows/manpage-lint.yml

@@ -0,0 +1,121 @@
+# spell-checker:ignore mandoc uudoc manpages dtolnay libsystemd libattr libcap
+
+name: Manpage Validation
+
+on:
+  pull_request:
+    paths:
+      - 'src/bin/uudoc.rs'
+      - 'src/uu/*/locales/*.ftl'
+      - 'src/uu/*/src/*.rs'
+      - 'Cargo.toml'
+      - 'GNUmakefile'
+      - '.github/workflows/manpage-lint.yml'
+  push:
+    branches:
+      - main
+    paths:
+      - 'src/bin/uudoc.rs'
+      - 'src/uu/*/locales/*.ftl'
+      - 'src/uu/*/src/*.rs'
+      - 'Cargo.toml'
+      - 'GNUmakefile'
+      - '.github/workflows/manpage-lint.yml'
+
+jobs:
+  manpage-lint:
+    name: Validate manpages with mandoc
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        locale: [en, fr]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Install prerequisites
+        shell: bash
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y mandoc locales-all
+          sudo apt-get install -y libselinux1-dev libsystemd-dev libacl1-dev libattr1-dev libcap-dev
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Build manpages (${{ matrix.locale }})
+        run: |
+          # Create temporary directory for manpages
+          MANPAGE_DIR=$(mktemp -d)
+          echo "MANPAGE_DIR=${MANPAGE_DIR}" >> $GITHUB_ENV
+
+          # Set locale for manpage generation
+          if [ "${{ matrix.locale }}" = "fr" ]; then
+            export LANGUAGE=fr_FR.UTF-8
+            export LANG=fr_FR.UTF-8
+            export LC_ALL=fr_FR.UTF-8
+          fi
+
+          # Build and install manpages to temporary directory
+          # codespell-ignore: DESTDIR
+          make install-manpages DESTDIR="${MANPAGE_DIR}"
+
+      - name: Validate manpages with mandoc (${{ matrix.locale }})
+        run: |
+          # Find all generated manpages
+          MANPAGE_PATH="${MANPAGE_DIR}/usr/local/share/man/man1"
+
+          # Check if manpages were generated
+          if [ ! -d "${MANPAGE_PATH}" ]; then
+            echo "Error: No manpages found at ${MANPAGE_PATH}"
+            exit 1
+          fi
+
+          # Initialize error tracking
+          ERRORS_FOUND=0
+          ERROR_LOG=$(mktemp)
+
+          echo "Validating ${{ matrix.locale }} manpages with mandoc..."
+          echo "=========================================="
+
+          # Validate each manpage
+          for manpage in "${MANPAGE_PATH}"/*.1; do
+            if [ -f "$manpage" ]; then
+              filename=$(basename "$manpage")
+              echo "Checking: $filename"
+              
+              # Run mandoc lint and capture output
+              if ! mandoc -T lint "$manpage" 2>&1 | tee -a "$ERROR_LOG"; then
+                echo "  ✗ Errors found in $filename"
+                ERRORS_FOUND=1
+              else
+                # Check if mandoc produced any output (warnings/errors)
+                if mandoc -T lint "$manpage" 2>&1 | grep -q .; then
+                  echo "  ⚠ Warnings found in $filename"
+                  ERRORS_FOUND=1
+                else
+                  echo "$filename is valid"
+                fi
+              fi
+            fi
+          done
+
+          echo ""
+          echo "=================================="
+
+          # Summary and exit
+          if [ "$ERRORS_FOUND" -eq 1 ]; then
+            echo "Manpage validation failed. Issues found:"
+            echo ""
+            cat "$ERROR_LOG"
+            exit 1
+          else
+            echo "All manpages validated successfully!"
+          fi
+
+      - name: Count manpages (${{ matrix.locale }})
+        run: |
+          MANPAGE_PATH="${MANPAGE_DIR}/usr/local/share/man/man1"
+          COUNT=$(find "${MANPAGE_PATH}" -name "*.1" -type f | wc -l)
+          echo "Total ${{ matrix.locale }} manpages generated: $COUNT"