Install specific Doxygen version with brew on macOS. Issue with Doxygen 1.18.0 might be related to doxygen/doxygen#12326

Author: lebarsfa

.github/workflows/macosmatrix.yml

@@ -56,54 +56,11 @@ jobs:
     #  if: runner.os=='macOS'
     - run: brew install catch2 # Issues with binary packages when cross-compiling...
       if: (runner.os=='macOS')&&(matrix.cfg.cross!=true)
-    # Doxygen 1.18.0 crashes when parsing Codac headers on macOS.
-    # Doxygen 1.16.1 ARM64 binaries require macOS 15: build from source on macOS 14.
-    - name: Install Doxygen 1.16.1
-      shell: bash
-      env:
-        GH_TOKEN: ${{ github.token }}
-      run: |
-        set -euo pipefail
-        case "${{ matrix.cfg.arch }}" in
-          arm64)  archive="doxygen-1.16.1.src.tar.gz" ;;
-          x86_64) archive="doxygen-1.16.1-mac-intel.zip" ;;
-          *) echo "Unsupported architecture" >&2; exit 1 ;;
-        esac
-        tmpdir="$(mktemp -d)"
-        trap 'rm -rf "$tmpdir"' EXIT
-
-        # Verify the archive using its official GitHub release SHA-256 digest.
-        expected_sha="$(
-          curl -fsSL --retry 3 \
-            -H "Authorization: Bearer ${GH_TOKEN}" \
-            -H "Accept: application/vnd.github+json" \
-            https://api.github.com/repos/doxygen/doxygen/releases/tags/Release_1_16_1 \
-          | python3 -c 'import json,sys; a=next(x for x in json.load(sys.stdin)["assets"] if x["name"]==sys.argv[1]); d=a["digest"]; assert d and d.startswith("sha256:") and len(d)==71; print(d[7:])' "$archive"
-        )"
-        curl -fsSL --retry 3 \
-          "https://github.com/doxygen/doxygen/releases/download/Release_1_16_1/${archive}" \
-          -o "$tmpdir/$archive"
-        echo "${expected_sha}  ${tmpdir}/${archive}" | shasum -a 256 -c
-
-        if [[ "${{ matrix.cfg.arch }}" == arm64 ]]; then
-          brew install ninja flex bison
-          mkdir "$tmpdir/src"
-          tar -xzf "$tmpdir/$archive" -C "$tmpdir/src"
-          export PATH="$(brew --prefix flex)/bin:$(brew --prefix bison)/bin:$PATH"
-          cmake -G Ninja -S "$tmpdir/src/doxygen-1.16.1" -B "$tmpdir/build" \
-            -DCMAKE_BUILD_TYPE=Release -DCMAKE_OSX_DEPLOYMENT_TARGET=14.0 \
-            -Dbuild_wizard=OFF -Dbuild_doc=OFF -Duse_libclang=OFF
-          cmake --build "$tmpdir/build" --target doxygen --parallel 4
-          doxygen_bin="$tmpdir/build/bin/doxygen"
-        else
-          unzip -q "$tmpdir/$archive" -d "$tmpdir/unpacked"
-          doxygen_bin="$(find "$tmpdir/unpacked" -type f -name doxygen -print -quit)"
-        fi
-
-        mkdir -p "$RUNNER_TEMP/codac-doxygen-bin"
-        install -m 755 "$doxygen_bin" "$RUNNER_TEMP/codac-doxygen-bin/doxygen"
-        echo "$RUNNER_TEMP/codac-doxygen-bin" >> "$GITHUB_PATH"
-        "$RUNNER_TEMP/codac-doxygen-bin/doxygen" --version
+      # Doxygen 1.18.0 crashes when parsing Codac headers on macOS.
+    - run: |
+        wget https://github.com/lebarsfa/xbrew/releases/latest/download/xbrew.sh --no-check-certificate -nv ; sudo mv -f xbrew.sh /usr/local/bin/xbrew ; sudo chmod +x /usr/local/bin/xbrew
+        xbrew reinstall https://github.com/Homebrew/homebrew-core/raw/1d8f87380f143b838b0d6a10068e7488db79ba5d/Formula/d/doxygen.rb ; brew pin --formula doxygen
+      if: runner.os=='macOS'
     - run: brew install graphviz ; python -m pip install --upgrade pip ; pip install --upgrade wheel setuptools sphinx breathe sphinx_rtd_theme sphinx-tabs sphinx-issues sphinx-reredirects furo sphinx-math-dollar sphinx_togglebutton sympy
       if: runner.os=='macOS'
     - run: |