build: install man pages, add man/clean targets and CI check

Author: linux_name2

.github/workflows/ci.yml

@@ -7,13 +7,15 @@ on:
       - 'lib/**'
       - 'extras/**'
       - 'tests/**'
+      - 'man/**'
       - '.github/workflows/ci.yml'
   pull_request:
     paths:
       - 'bin/**'
       - 'lib/**'
       - 'extras/**'
       - 'tests/**'
+      - 'man/**'
       - '.github/workflows/ci.yml'
 
 jobs:
@@ -25,6 +27,7 @@ jobs:
       shell: ${{ steps.filter.outputs.shell }}
       python: ${{ steps.filter.outputs.python }}
       integration: ${{ steps.filter.outputs.integration }}
+      man: ${{ steps.filter.outputs.man }}
     steps:
       - uses: actions/checkout@v6
         with:
@@ -52,6 +55,9 @@ jobs:
               - 'etc/atomic.conf'
               - 'tests/test_integration.sh'
               - '.github/workflows/ci.yml'
+            man:
+              - 'man/*.md'
+              - '.github/workflows/ci.yml'
 
   shellcheck:
     needs: changes
@@ -103,3 +109,21 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - run: bash tests/test_integration.sh
+
+  man-check:
+    needs: changes
+    if: needs.changes.outputs.man == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install pandoc
+        run: sudo apt-get update && sudo apt-get install -y pandoc
+      - name: Regenerate man pages
+        run: make man
+      - name: Check groff files are up to date
+        run: |
+          if ! git diff --quiet man/; then
+            echo "::error::Man pages are out of date. Run 'make man' and commit the results."
+            git diff man/
+            exit 1
+          fi

Makefile

@@ -1,4 +1,4 @@
-.PHONY: install uninstall reinstall install-conf
+.PHONY: install uninstall reinstall install-conf man clean
 
 PREFIX     = /usr
 SYSCONFDIR = /etc
@@ -8,11 +8,26 @@ pkgname    = atomic-upgrade
 BINDIR       = $(PREFIX)/bin
 LIBDIR       = $(PREFIX)/lib/atomic
 SHAREDIR     = $(PREFIX)/share
+MANDIR       = $(SHAREDIR)/man
 ZSH_COMPDIR  = $(SHAREDIR)/zsh/site-functions
 BASH_COMPDIR = $(SHAREDIR)/bash-completion/completions
 HOOKSDIR     = $(SHAREDIR)/libalpm/hooks
 LICENSEDIR   = $(SHAREDIR)/licenses/$(pkgname)
 
+MANPAGES = man/atomic-upgrade.8 man/atomic-gc.8 man/atomic.conf.5
+
+# Generate groff from markdown (requires pandoc, run locally)
+man: $(MANPAGES)
+
+man/%.8: man/%.8.md
+	pandoc -s -t man -o $@ $<
+
+man/%.5: man/%.5.md
+	pandoc -s -t man -o $@ $<
+
+clean:
+	rm -f $(MANPAGES)
+
 install:
 	install -Dm755 bin/atomic-upgrade     $(DESTDIR)$(BINDIR)/atomic-upgrade
 	install -Dm755 bin/atomic-gc          $(DESTDIR)$(BINDIR)/atomic-gc
@@ -37,6 +52,10 @@ install:
 
 	install -Dm755 extras/pacman-wrapper $(DESTDIR)$(PREFIX)/local/bin/pacman
 
+	install -Dm644 man/atomic-upgrade.8 $(DESTDIR)$(MANDIR)/man8/atomic-upgrade.8
+	install -Dm644 man/atomic-gc.8      $(DESTDIR)$(MANDIR)/man8/atomic-gc.8
+	install -Dm644 man/atomic.conf.5    $(DESTDIR)$(MANDIR)/man5/atomic.conf.5
+
 	install -Dm644 LICENSE $(DESTDIR)$(LICENSEDIR)/LICENSE
 
 	@if [ ! -f "$(DESTDIR)$(SYSCONFDIR)/atomic.conf" ]; then \
@@ -58,6 +77,9 @@ uninstall:
 	rm -f  $(DESTDIR)$(BASH_COMPDIR)/atomic-rebuild-uki
 	rm -f  $(DESTDIR)$(HOOKSDIR)/00-block-direct-upgrade.hook
 	rm -f  $(DESTDIR)$(PREFIX)/local/bin/pacman
+	rm -f  $(DESTDIR)$(MANDIR)/man8/atomic-upgrade.8
+	rm -f  $(DESTDIR)$(MANDIR)/man8/atomic-gc.8
+	rm -f  $(DESTDIR)$(MANDIR)/man5/atomic.conf.5
 	rm -rf $(DESTDIR)$(LICENSEDIR)/
 	@echo "Note: $(SYSCONFDIR)/atomic.conf preserved. Remove manually if needed."