From 2ee2d29f2b02774866c263f11ac3afb94b1b6fc5 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Thu, 4 Dec 2025 16:09:47 -1000
Subject: [PATCH] ;tools:just: manuals, manuals-site, ver, majorver

---
 Justfile | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/Justfile b/Justfile
index d6320cb7d..9a4caca04 100644
--- a/Justfile
+++ b/Justfile
@@ -745,6 +745,16 @@ quickprof CMD: #hledgerprof #samplejournals
 # ** Documenting ------------------------------------------------------------
 DOCUMENTING:
 
+# Update manuals - build hledger, regenerate flag docs, regenerate manuals
+manuals:
+    $STACK build hledger
+    ./Shake cmddocs -c
+    ./Shake manuals -c
+
+# Update the site's snapshot of the manuals for this branch's major release version.
+manuals-site: manuals
+    make -C site snapshot-$(just majorver)
+
 # Add latest commit messages to the changelogs. (Runs ./Shake changelogs [OPTS])
 changelogs *OPTS:
     ./Shake changelogs {{ OPTS }}
@@ -802,11 +812,6 @@ LOCALSITEURL := 'http://localhost:3000/index.html'
     $WATCHEXEC --no-vcs-ignore -e md,m4 -i hledger.md -i hledger-ui.md -i hledger-web.md -r './Shake webmanuals && make -sC site serve'
 # --no-vcs-ignore to include site/src/*.md
 
-# In the site repo, commit a snapshot of the manuals with this version number.
-@site-manuals-snapshot VER:
-    make -C site snapshot-{{ VER }}
-    echo "{{ VER }} manuals created. Please add the new version to site.js, Makefile, and hledger.org.caddy."
-
 # restart hledger.org's caddy server, after config changes
 site-restart:
     osh -i -c 'hledgerorgssh systemctl restart caddy'
@@ -993,8 +998,6 @@ relbranch VER:
 # Too much at once, allow smaller steps.
 #    echo "Updating all command help texts for embedding..."
 #    ./Shake cmddocs -c
-#    echo "Updating all dates in man pages..."
-#    ./Shake mandates
 #    echo "Generating all the manuals in all formats...."
 #    ./Shake manuals -c
 #    # echo "Updating CHANGES.md files with latest commits..."
@@ -1096,8 +1099,6 @@ devtag-push:
     git push origin "$DEVVER"
     echo "Setting versions to $DEVVER.."
     ./Shake setversion "$DEVVER" -c
-    echo "Setting man page dates to $(date +'%B %Y').."
-    ./Shake mandates
     echo "Regenerating manuals.."
     ./Shake manuals -c
     echo "Consider also: with $RELVER installed, ./Shake cmddocs -c"
@@ -1447,6 +1448,14 @@ time *ARGS:
 @_versionIsPreview VER:
     echo {{ if VER =~ '(\d+\.){2}99\.\d+' { 'y' } else { '' } }}
 
+# Show the hledger version number that's configured for the current branch.
+@ver:
+    cat .version
+
+# Show the hledger major version number that's configured for the current branch.
+@majorver:
+    just _versionMajorPart $(cat .version)
+
 # Increment a major version number to the next.
 # @majorVersionIncrement MAJORVER:
 #     python3 -c "print({{MAJORVER}} + 0.01)"