;tools:just: manuals, manuals-site, ver, majorver

This commit is contained in:
Simon Michael 2025-12-04 16:09:47 -10:00
parent 809525302a
commit 2ee2d29f2b

View File

@ -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)"