name: Documentation

on:
  pull_request:
    branches:
      - master
      - develop
    paths-ignore:
      - '.github/workflows/cov.yml'
      - '.github/workflows/fast.yml'
      - '.github/workflows/slow.yml'
      - 'tools/**'
      - '*.md'

concurrency:
  group: ${{ github.workflow }}-${{ github.head_ref }}
  cancel-in-progress: true

jobs:
  gcc:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/setup-python@v5
      with:
        python-version: '3.12' 

    - name: Install docbook dependencies
      run: |
        sudo apt-get update
        sudo apt-get install -y docbook-xsl docbook-xml xsltproc doxygen

    - name: Create user-config.jam
      run: |
        echo "using xsltproc ;" > $HOME/user-config.jam
        echo "using boostbook : /usr/share/xml/docbook/stylesheet/nwalsh : /usr/share/xml/docbook/schema/dtd/4.2 ;" >> $HOME/user-config.jam
        echo "using doxygen : /usr/bin/doxygen ;" >> $HOME/user-config.jam
        echo "using python : 3.12 : /usr/bin/python3 ; " >> $HOME/user-config.jam

    - uses: actions/checkout@v4

    - name: Fetch Boost superproject
      run: |
        cd ..
        git clone -b $GITHUB_BASE_REF --depth 5 https://github.com/boostorg/boost.git
        cd boost
        mv -f $GITHUB_WORKSPACE/* libs/histogram
        git submodule update --init --depth 5 tools/build tools/boostdep tools/quickbook tools/boostbook
        python tools/boostdep/depinst/depinst.py --git_args "--depth 5 --jobs 3" histogram
        python tools/boostdep/depinst/depinst.py --git_args "--depth 5 --jobs 3" ../tools/quickbook
        mv -f * $GITHUB_WORKSPACE

    - name: Prepare b2
      run: ./bootstrap.sh

    - name: Build documentation
      run: |
        cd libs/histogram
        ../../b2 doc

    - name: Upload documentation
      uses: actions/upload-artifact@v4
      with:
        name: histogram-docs
        path: libs/histogram/doc/html
        if-no-files-found: error