manpages.yml

---

name: Generate Manual

# Controls when the workflow will run
on:
  # Triggers the workflow on push or pull request events but only for the master branch
  push:
    branches: [main]

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

jobs:

  # Check changes, cancel job is not.
  check_changes:
    runs-on: ubuntu-latest
    outputs:
      smux_changed: ${{ steps.check_file_changed.outputs.smux_changed }}
    steps:

      - uses: actions/checkout@v2
        with:
          # Checkout as many commits as needed for the diff
          fetch-depth: 2

      # man page generated from README
      - id: check_file_changed
        run: |
          if git diff --name-only HEAD^ HEAD README.md; then
            echo "smux_changed=True" >> $GITHUB_OUTPUT
          else
            echo "smux_changed=False" >> $GITHUB_OUTPUT
          fi

  gen_man:
    runs-on: ubuntu-latest
    needs: check_changes
    if: needs.check_changes.outputs.smux_changed == 'True'
    steps:
      - uses: actions/checkout@v2
      # Fetch from compatibility table all the distros supported
      - id: generate
        run: |
          sudo apt-get update
          sudo apt-get install pandoc
          ./man/gen-man

      - uses: stefanzweifel/git-auto-commit-action@v4
        with:
          branch: main
          commit_message: Automatic Man Page Update
          commit_options: '--no-verify --signoff'
          commit_user_name: smux-docs-bot
          commit_user_email: smux-docs-bot@users.noreply.github.com
          commit_author: smux-docs-bot <actions@github.com>