docs.yml

name: docs

on:
  push:
    branches:
      - master
      - ci
      - 'release/**'
    paths:
      - 'DOCS/**'
  pull_request:
    branches: [master]
    paths:
      - 'DOCS/**'

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

jobs:
  check-docs:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - name: Docs
        run: |
          sudo apt-get install --no-install-recommends -y python3-docutils rst2pdf
          ./TOOLS/docutils-wrapper.py rst2man --strip-elements-with-class=contents --halt=2 ./DOCS/man/mpv.rst mpv.1
          ./TOOLS/docutils-wrapper.py rst2html --halt=2 ./DOCS/man/mpv.rst mpv.html
          ./TOOLS/docutils-wrapper.py rst2pdf -c -b 1 --repeat-table-rows ./DOCS/man/mpv.rst -o mpv.pdf