Merge branch 'master' of github.com:doxygen/doxygen #2818
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: CMake Build for Doxygen | |
| on: [push, pull_request] | |
| jobs: | |
| build: | |
| permissions: | |
| contents: write # to push pages branch (peaceiris/actions-gh-pages) | |
| name: ${{ matrix.config.name }} | |
| runs-on: ${{ matrix.config.os }} | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| config: | |
| - { | |
| name: "Ubuntu Latest GCC Release", | |
| os: ubuntu-20.04, | |
| build_type: "Release", cc: "gcc", cxx: "g++", | |
| build_gen: "Unix Makefiles", | |
| cmake_extra_opts: "-Dbuild_search=YES -Dbuild_app=YES -Dbuild_parse=YES" | |
| } | |
| - { | |
| name: "Ubuntu Latest GCC Debug", | |
| os: ubuntu-20.04, | |
| build_type: "Debug", cc: "gcc", cxx: "g++", | |
| build_gen: "Unix Makefiles", | |
| cmake_extra_opts: "-Dbuild_search=YES -Dbuild_app=YES -Dbuild_parse=YES" | |
| } | |
| - { | |
| name: "Ubuntu Latest Clang Release", | |
| os: ubuntu-20.04, | |
| build_type: "Release", cc: "clang", cxx: "clang++", | |
| build_gen: "Unix Makefiles", | |
| cmake_extra_opts: "-Duse_libclang=YES -Dstatic_libclang=YES -Duse_libc++=NO" | |
| } | |
| - { | |
| name: "Ubuntu Latest Clang Debug", | |
| os: ubuntu-20.04, | |
| build_type: "Debug", cc: "clang", cxx: "clang++", | |
| build_gen: "Unix Makefiles", | |
| cmake_extra_opts: "-Duse_libclang=YES -Dstatic_libclang=YES -Duse_libc++=NO" | |
| } | |
| - { | |
| name: "macOS Latest Release (Intel)", | |
| os: macos-13, | |
| build_type: "Release", cc: "clang", cxx: "clang++", | |
| build_gen: "Unix Makefiles" | |
| } | |
| - { | |
| name: "macOS Latest Debug (Intel)", | |
| os: macos-13, | |
| build_type: "Debug", cc: "clang", cxx: "clang++", | |
| build_gen: "Unix Makefiles" | |
| } | |
| # - { | |
| # name: "macOS Latest Release (Apple Silicon)", | |
| # os: macos-14-arm64, | |
| # build_type: "Release", cc: "clang", cxx: "clang++", | |
| # build_gen: "Unix Makefiles" | |
| # } | |
| # - { | |
| # name: "macOS Latest Debug (Apple Silicon)", | |
| # os: macos-14-arm64, | |
| # build_type: "Debug", cc: "clang", cxx: "clang++", | |
| # build_gen: "Unix Makefiles" | |
| # } | |
| - { | |
| name: "Windows Latest MSVC Debug", | |
| os: windows-latest, | |
| build_type: "Debug", cc: "cl", cxx: "cl", | |
| build_gen: "NMake Makefiles" | |
| } | |
| - { | |
| name: "Windows Latest MSVC Release", | |
| os: windows-latest, | |
| build_type: "Release", cc: "cl", cxx: "cl", | |
| build_gen: "NMake Makefiles" | |
| } | |
| steps: | |
| - name: Checkout doxygen | |
| uses: actions/checkout@v4 | |
| with: | |
| fetch-depth: 0 | |
| - name: Install libiconv (Windows) | |
| uses: suisei-cn/actions-download-file@v1 | |
| with: | |
| url: "https://github.com/pffang/libiconv-for-Windows/releases/download/v1.16/libiconv-for-Windows_1.16.7z" | |
| target: . | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Install LaTeX (Linux) | |
| run: | | |
| sudo apt update --fix-missing | |
| sudo apt upgrade | |
| sudo apt update | |
| sudo apt-get install texlive texlive-latex-recommended texlive-extra-utils texlive-latex-extra texlive-font-utils | |
| if: startsWith(matrix.config.os,'ubuntu-') | |
| - name: Install LaTeX (MacOS) | |
| run: | | |
| brew update | |
| brew install --cask mactex; | |
| echo "/Library/TeX/texbin/" >> $GITHUB_PATH | |
| if: matrix.config.os == 'macos-13' | |
| - name: Install libclang (Ubuntu 20.04) | |
| run: | | |
| sudo apt update | |
| sudo apt remove llvm-8 clang-8 libclang-common-8-dev clang-format-8 libllvm8 | |
| sudo apt remove llvm-9 llvm-9-dev llvm-9-tools llvm-9-runtime clang-9 libclang-common-9-dev clang-format-9 libllvm9 | |
| #sudo apt remove llvm-10 llvm-10-dev llvm-10-tools llvm-10-runtime clang-10 clang-format-10 libclang-common-10-dev libclang-cpp10 libclang1-10 libllvm10 | |
| sudo apt remove llvm-11 llvm-11-dev llvm-11-tools llvm-11-runtime clang-11 clang-format-11 libclang-common-11-dev libclang-cpp11 libclang1-11 libllvm11 | |
| sudo apt remove llvm-12 llvm-12-dev llvm-12-tools llvm-12-runtime clang-12 clang-format-12 libclang-common-12-dev libclang-cpp12 libclang1-12 libllvm12 | |
| sudo apt-get autoremove | |
| sudo apt-get clean | |
| sudo apt install libclang-common-10-dev libclang-10-dev | |
| apt list --installed | egrep '(clang|llvm)' | |
| ls -d /usr/lib/llvm-*/include/ | |
| sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-10 100 | |
| sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-10 100 | |
| ls -al /usr/bin/clang++ | |
| ls -al /etc/alternatives/clang++ | |
| which clang++ | |
| clang++ -v | |
| if: matrix.config.os == 'ubuntu-20.04' | |
| - name: Install libxapian (Ubuntu 20.04) | |
| run: | | |
| sudo apt update | |
| sudo apt install libxapian-dev | |
| if: matrix.config.os == 'ubuntu-20.04' | |
| - name: Install LaTeX (Windows) | |
| uses: teatimeguest/setup-texlive-action@v3 | |
| with: | |
| packages: >- | |
| scheme-medium | |
| collection-latexextra | |
| babel-dutch | |
| cjk | |
| bibtex | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Install Ghostscript (Linux) | |
| run: | | |
| sudo apt update | |
| sudo apt-get install ghostscript | |
| if: startsWith(matrix.config.os,'ubuntu-') | |
| - name: Install Ghostscript (Windows) | |
| run: | |
| choco install ghostscript | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Setting Ghostscript paths (Windows) | |
| shell: bash | |
| run: | | |
| export GSpath=`find /c/Prog*/gs -name gswin\*c.exe | sed -e "s/gswin.*c.exe//"` | |
| export PATH="$GSpath:$PATH" | |
| export GSpath=`echo "$GSpath" | sed -e "s%/c%C:%"` | |
| echo "$GSpath" >> $GITHUB_PATH | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Install xmllint (Linux) | |
| run: | | |
| sudo apt-get update | |
| sudo apt-get install libxml2-utils | |
| if: startsWith(matrix.config.os,'ubuntu-') | |
| - name: Install xmllint (MacOS) | |
| run: | | |
| brew install --force --overwrite python@3.11 # temp hack | |
| brew install --force --overwrite python@3.12 # temp hack | |
| brew update | |
| brew install libxml2 | |
| if: matrix.config.os == 'macos-13' | |
| - name: Install bison (MacOS) | |
| run: | | |
| brew update | |
| brew install bison; | |
| echo "$(brew --prefix bison)/bin" >> $GITHUB_PATH | |
| #echo "/usr/local/opt/bison/bin" >> $GITHUB_PATH | |
| if: matrix.config.os == 'macos-13' | |
| - name: Install bison/flex (Windows) | |
| run: | | |
| #Choco-Install -PackageName winflexbison | |
| choco install winflexbison | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Install Graphviz (Linux) | |
| run: | | |
| sudo apt update | |
| sudo apt-get install graphviz | |
| if: startsWith(matrix.config.os,'ubuntu-') | |
| - name: Install Graphviz (MacOS) | |
| run: | | |
| if ! brew install graphviz; then | |
| # Workaround issue with unexpected symlinks: https://github.com/actions/runner-images/issues/6817 | |
| for f in 2to3 idle3 pydoc3 python3 python3-config; do | |
| rm /usr/local/bin/$f || true | |
| done | |
| # Try again | |
| brew install graphviz | |
| fi | |
| if: matrix.config.os == 'macos-13' | |
| - name: Install Graphviz (Windows) | |
| run: | |
| choco install graphviz.portable | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Setup VS Environment (Windows) | |
| uses: seanmiddleditch/gha-setup-vsdevenv@master | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Refresh Env (Windows) | |
| run: | | |
| Import-Module $env:ChocolateyInstall\helpers\chocolateyProfile.psm1 | |
| refreshenv | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Install Qt 6 | |
| uses: jurplel/install-qt-action@v4 | |
| with: | |
| version: 6.2.* | |
| if: matrix.config.is == 'macos-13' | |
| - name: Install Qt 5 | |
| uses: jurplel/install-qt-action@v4 | |
| with: | |
| version: 5.* | |
| if: matrix.config.is != 'macos-13' | |
| - name: Check tool versions (Linux / MacOS) | |
| shell: bash | |
| run: | | |
| echo "=== perl ==="; | |
| perl --version; | |
| echo "=== python ==="; | |
| python --version; | |
| echo "=== cmake ==="; | |
| cmake --version; | |
| echo "=== latex ==="; | |
| latex --version; | |
| echo "=== bibtex ==="; | |
| bibtex --version | |
| echo "=== dvips ==="; | |
| dvips --version | |
| echo "=== bison ==="; | |
| bison --version; | |
| echo "=== flex ==="; | |
| flex --version; | |
| echo "=== dot ==="; | |
| dot -V; | |
| echo "=== ghostscript ==="; | |
| gs --version; | |
| if: matrix.config.os != 'windows-latest' | |
| - name: Check tool versions (Windows) | |
| shell: bash | |
| run: | | |
| echo "=== perl ==="; | |
| perl --version; | |
| echo "=== python ==="; | |
| python --version; | |
| echo "=== cmake ==="; | |
| cmake --version; | |
| echo "=== latex ==="; | |
| latex --version; | |
| echo "=== bibtex ==="; | |
| bibtex --version | |
| echo "=== dvips ==="; | |
| dvips --version | |
| echo "=== bison ==="; | |
| win_bison --version; | |
| echo "=== flex ==="; | |
| win_flex --version; | |
| echo "=== dot ==="; | |
| dot -V; | |
| echo "=== ghostscript ==="; | |
| gswin64c --version; | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Configure | |
| shell: cmake -P {0} | |
| run: | | |
| set(ENV{CC} ${{ matrix.config.cc }}) | |
| set(ENV{CXX} ${{ matrix.config.cxx }}) | |
| execute_process( | |
| COMMAND cmake | |
| -S . | |
| -B build | |
| -D CMAKE_BUILD_TYPE=${{ matrix.config.build_type }} | |
| -G "${{ matrix.config.build_gen }}" | |
| -Dbuild_doc=YES | |
| -Dbuild_wizard=YES | |
| ${{ matrix.config.cmake_extra_opts }} | |
| RESULT_VARIABLE result | |
| ) | |
| if (NOT result EQUAL 0) | |
| message(FATAL_ERROR "Bad exit status") | |
| endif() | |
| - name: Build | |
| shell: cmake -P {0} | |
| run: | | |
| include(ProcessorCount) | |
| ProcessorCount(N) | |
| execute_process( | |
| COMMAND cmake --build build --parallel ${N} | |
| RESULT_VARIABLE result | |
| OUTPUT_VARIABLE output | |
| ERROR_VARIABLE output | |
| ECHO_OUTPUT_VARIABLE ECHO_ERROR_VARIABLE | |
| ) | |
| if (NOT result EQUAL 0) | |
| string(REGEX MATCH "FAILED:.*$" error_message "${output}") | |
| string(REPLACE "\n" "%0A" error_message "${error_message}") | |
| message("::error::${error_message}") | |
| message(FATAL_ERROR "Build failed") | |
| endif() | |
| - name: Archive build artifacts | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: "${{ matrix.config.name }} build artifacts" | |
| path: build/bin/ | |
| - name: Run tests (Linux / MacOS) | |
| shell: cmake -P {0} | |
| run: | | |
| set(ENV{CTEST_OUTPUT_ON_FAILURE} "ON") | |
| execute_process( | |
| COMMAND | |
| cmake -E env TEST_FLAGS="--xml --xmlxsd --xhtml --qhp --docbook --rtf" | |
| cmake --build build --target tests | |
| RESULT_VARIABLE result | |
| ) | |
| if (NOT result EQUAL 0) | |
| message(FATAL_ERROR "Running tests failed!") | |
| endif() | |
| if: matrix.config.os != 'windows-latest' | |
| - name: Run tests (Windows) | |
| shell: cmake -P {0} | |
| run: | | |
| set(ENV{CTEST_OUTPUT_ON_FAILURE} "ON") | |
| execute_process( | |
| COMMAND | |
| cmake -E env TEST_FLAGS="--xml --xmlxsd --xhtml --qhp --docbook --rtf --pdf" | |
| cmake --build build --target tests | |
| RESULT_VARIABLE result | |
| ) | |
| if (NOT result EQUAL 0) | |
| message(FATAL_ERROR "Running tests failed!") | |
| endif() | |
| if: matrix.config.os == 'windows-latest' | |
| - name: Generate documentation | |
| shell: cmake -P {0} | |
| run: | | |
| execute_process( | |
| COMMAND cmake --build build --target docs | |
| RESULT_VARIABLE result | |
| ) | |
| if (NOT result EQUAL 0) | |
| message(FATAL_ERROR "Building documentation failed") | |
| endif() | |
| - name: Archive html documentation artifacts | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: "Html documentation artifacts" | |
| path: build/html/ | |
| if: matrix.config.name == 'Ubuntu Latest GCC Release' | |
| - name: Archive Latex documentation artifacts | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: "Latex documentation artifacts" | |
| path: build/latex/doxygen_manual.pdf | |
| if: matrix.config.name == 'Ubuntu Latest GCC Release' | |
| - name: Generate Internal documentation | |
| shell: cmake -P {0} | |
| run: | | |
| execute_process( | |
| COMMAND cmake --build build --target docs_internal | |
| RESULT_VARIABLE result | |
| ) | |
| if (NOT result EQUAL 0) | |
| message(FATAL_ERROR "Building internal documentation failed") | |
| endif() | |
| if: matrix.config.name == 'Ubuntu Latest GCC Release' | |
| - name: Publish Internal documentation to Github pages | |
| uses: peaceiris/actions-gh-pages@v4 | |
| with: | |
| deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }} | |
| external_repository: doxygen/doxygen-docs | |
| publish_dir: build/doxygen_docs/html | |
| force_orphan: true | |
| if: ${{ github.event_name == 'push' && matrix.config.name == 'Ubuntu Latest GCC Release' }} | |