;shake: help, cleanups
This commit is contained in:
parent
5c86e0bdbd
commit
f8a57dae51
26
Shake.hs
26
Shake.hs
@ -66,22 +66,23 @@ usage =
|
|||||||
,"Usage:"
|
,"Usage:"
|
||||||
,"./Shake.hs [CMD [ARGS]] run CMD, compiling this script first if needed"
|
,"./Shake.hs [CMD [ARGS]] run CMD, compiling this script first if needed"
|
||||||
,"./Shake [CMD [ARGS]] run CMD, using the compiled version of this script"
|
,"./Shake [CMD [ARGS]] run CMD, using the compiled version of this script"
|
||||||
,"./Shake list commands"
|
,"./Shake [help] show this help"
|
||||||
,"./Shake commandhelp build plain text help for hledger CLI commands"
|
,"./Shake commandhelp build plain text help for hledger CLI commands"
|
||||||
,"./Shake manuals build txt/man/info/web manuals for all packages"
|
,"./Shake manuals build txt/man/info/web manuals for all packages"
|
||||||
,"./Shake webmanuals build web manuals (in site/) for all packages"
|
,"./Shake webmanuals build web manuals (in site/) for all packages"
|
||||||
|
-- TODO: commit, show commit
|
||||||
|
,"./Shake setversion [VER] [PKGS] set version strings from */.version (or VER)"
|
||||||
|
-- TODO: commit, show commit
|
||||||
|
,"./Shake changelogs[-dry] add new commits, headings to */CHANGES.md"
|
||||||
|
-- ,"./Shake [PKG/]CHANGES.md[-dry] update (or preview) one changelog"
|
||||||
,"./Shake PKG build a single hledger package and its embedded docs"
|
,"./Shake PKG build a single hledger package and its embedded docs"
|
||||||
,"./Shake build build all hledger packages and their embedded docs"
|
,"./Shake build build all hledger packages and their embedded docs"
|
||||||
,"./Shake setversion [VER] [PKGS] set version strings from */.version (or VER)"
|
,"./Shake clean clean generated help texts, manuals"
|
||||||
,"./Shake changelogs add any new non-boring commits to */CHANGES.md"
|
|
||||||
,"./Shake [PKG/]CHANGES.md-finalise add version/date heading in this changelog"
|
|
||||||
-- ,"./Shake [PKG/]CHANGES.md[-dry] update (or preview) one changelog"
|
|
||||||
-- ,"./Shake site/doc/VERSION/.snapshot save current web manuals as this snapshot"
|
|
||||||
-- ,"./Shake hledgerorg update the hledger.org website (when run on prod)"
|
|
||||||
,"./Shake clean clean help texts, manuals, staged site content"
|
|
||||||
,"./Shake Clean also clean object files, Shake's cache"
|
,"./Shake Clean also clean object files, Shake's cache"
|
||||||
,"./Shake FILE build any individual file"
|
,"./Shake FILE build any individual file"
|
||||||
,"./Shake --help list Shake options (--color, --rebuild, ...)"
|
,"./Shake --help list Shake options (--color, --rebuild, ...)"
|
||||||
|
,""
|
||||||
|
,"Option arguments should be adjacent to their flag."
|
||||||
]
|
]
|
||||||
|
|
||||||
-- groff = "groff -c" ++ " -Wall" -- see "groff" below
|
-- groff = "groff -c" ++ " -Wall" -- see "groff" below
|
||||||
@ -334,15 +335,18 @@ main = do
|
|||||||
-- -- but I don't know how to do that for the Shake rules.
|
-- -- but I don't know how to do that for the Shake rules.
|
||||||
-- -- Instead we'll do the logging in "make site".
|
-- -- Instead we'll do the logging in "make site".
|
||||||
-- cmd_ Shell
|
-- cmd_ Shell
|
||||||
|
--
|
||||||
-- -- print timestamp. On mac, use brew-installed GNU date.
|
-- -- print timestamp. On mac, use brew-installed GNU date.
|
||||||
-- "PATH=\"/usr/local/opt/coreutils/libexec/gnubin:$PATH\" date --rfc-3339=seconds"
|
-- "PATH=\"/usr/local/opt/coreutils/libexec/gnubin:$PATH\" date --rfc-3339=seconds"
|
||||||
-- -- pull latest code and site repos - sometimes already done by webhook, not always
|
-- -- pull latest code and site repos - sometimes already done by webhook, not always
|
||||||
-- "&& printf 'code repo: ' && git pull"
|
-- "&& printf 'code repo: ' && git pull"
|
||||||
-- "&& printf 'site repo: ' && git -C site pull"
|
-- "&& printf 'site repo: ' && git -C site pull"
|
||||||
|
--
|
||||||
-- -- Shake.hs might have been updated, but we won't execute the
|
-- -- Shake.hs might have been updated, but we won't execute the
|
||||||
-- -- new one, too insecure. Continue with this one.
|
-- -- new one, too insecure. Continue with this one.
|
||||||
|
--
|
||||||
|
-- Help:
|
||||||
|
-- ,"./Shake hledgerorg update the hledger.org website (when run on prod)"
|
||||||
|
|
||||||
-- HLEDGER PACKAGES/EXECUTABLES
|
-- HLEDGER PACKAGES/EXECUTABLES
|
||||||
|
|
||||||
@ -593,6 +597,8 @@ main = do
|
|||||||
-- cmd_ Shell "cp" f (snapshot </> takeFileName f)
|
-- cmd_ Shell "cp" f (snapshot </> takeFileName f)
|
||||||
-- cmd_ Shell "cp -r site/images" snapshot
|
-- cmd_ Shell "cp -r site/images" snapshot
|
||||||
-- cmd_ Shell "touch" out
|
-- cmd_ Shell "touch" out
|
||||||
|
-- Help:
|
||||||
|
-- ,"./Shake site/doc/VERSION/.snapshot save current web manuals as this snapshot"
|
||||||
|
|
||||||
-- Cleanup.
|
-- Cleanup.
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user