Commit Graph

295 Commits

Author SHA1 Message Date
Simon Michael
48b8dd9be7 ;shake: don't regenerate dir for now (fix) 2021-08-02 22:21:06 -10:00
Simon Michael
003391e102 ;shake: don't regenerate dir for now 2021-08-02 22:14:05 -10:00
Simon Michael
8c890f845b ;shake: webmanuals: move page toc below h1 again
To avoid extra toc items.
Also added a class permitting manual-specific styling.
2021-07-28 22:20:49 -10:00
Simon Michael
9a18eed9dd shake: changelogs: don't ignore ; messages any more
A leading semicolon now means something different (skip CI).
2021-07-20 22:39:46 -10:00
Simon Michael
c881d916eb shake: use new default resolver / ghc 9.0 2021-07-20 20:38:39 -10:00
Simon Michael
395717e778 ;shake: drop unnecessary dev: prefix in doc commits 2021-07-13 18:40:41 -10:00
Simon Michael
44c5eb5136 ;shake: update commit messages to pass commitlint 2021-07-12 18:50:06 -10:00
Simon Michael
2d87298a68 ;doc: slightly simplify dir entries, use higher-level texinfo format (#1585) 2021-06-27 21:24:51 -10:00
Simon Michael
e3edea11e8 doc: generate a single Info dir file, and commit it (#1585)
Avoids duplicate headings in info viewer, makes installing easier.
2021-06-27 19:31:15 -10:00
Simon Michael
eae4922d12 doc: info directory entries: fixes, cleanup (#1585) 2021-06-27 17:26:00 -10:00
Simon Michael
1c9a7f1bc4 doc: make hledger manuals show up in Info's directory
This continues the work begun by #1585. It moves each info manual's
directory metadata to the top of the file, where it needs to be.
I couldn't see a way to do this with pandoc/makeinfo, so the Shake
recipe prepends it from a separate file.

With this metadata in place, the hledger info manuals can be added to
an Info dir file using install-info. Eg:

$ install-info hledger/hledger.info /usr/local/share/info/dir
$ info

Secondly, the Shake "manuals"/"infomanuals" recipes now also generate
an Info dir file in each package directory, so you can also just add
the package directories to your INFOPATH. Eg:

$ export INFOPATH=~/src/hledger/hledger:~/src/hledger/hledger-ui:~/src/hledger/hledger-web:$INFOPATH
$ info
2021-06-27 17:01:59 -10:00
Simon Michael
61a3fbc019 ;shake: note how paragraph refilling affects macro arguments (#806) 2021-06-17 09:43:40 -10:00
Simon Michael
e7f4619735 ;doc: use more obscure m4 flags to avoid clashes (#806) 2021-06-17 08:37:22 -10:00
Simon Michael
23369714e1 tools: drop obsolete site/ requirement (#1565) 2021-06-14 16:56:02 -10:00
Simon Michael
7abf8eedd5 ;tools: Shake cabalfiles: fix with stack 1.7 (now does a full build) 2021-05-14 16:19:28 -10:00
Simon Michael
076da7dd18 ;shake webmanuals: update toc/versions placeholders 2021-03-21 09:01:33 -07:00
Simon Michael
16f8ed3d0f shake webmanuals: include the TOC comment 2021-03-19 08:21:28 -07:00
Simon Michael
0c56d3ffa3 shake mandates: update .date.m4 source files to current month/year 2021-03-18 07:21:51 -07:00
Simon Michael
941574423a ;shake: drop ".webmanuals" from website markdown filenames 2021-03-18 06:48:07 -07:00
Simon Michael
be50572d97 shake: bump to lts-17.4, like the rest 2021-03-10 08:19:10 -08:00
Simon Michael
286efc7b12 ;shake: use --markdown-headings to silence warning (& require pandoc-2.11.2+) 2021-02-17 12:11:15 -08:00
Simon Michael
d99c5e3087 ;Shake changelogs: avoid an error with untagged release version
(cherry picked from commit b102c2ca5d)
2020-12-29 09:38:41 -08:00
Simon Michael
81b07dd6f5 ;Shake changelogs: reduce excessive whitespace
(cherry picked from commit 7b13778a29)
2020-12-29 09:38:33 -08:00
Simon Michael
fbe30a73b9 ;doc: mention version in all manual formats 2020-12-24 17:25:11 -08:00
Simon Michael
a7e9e9ac0e doc: merge file format manuals into the hledger manual
Also flatten the journal manual topics a bit.

There are pros and cons to this, but I believe the pros outweigh the
cons.
2020-12-24 10:22:05 -08:00
Simon Michael
65a003c8ee ;doc: refactor, keep commands.m4 in Commands dir 2020-12-22 17:05:28 -08:00
Simon Michael
753ee5f50f ;doc: note dependency between shake targets 2020-12-20 20:08:35 -08:00
Simon Michael
24fad7ce35 ;doc: man: show program name & version in footer 2020-12-20 20:08:35 -08:00
Simon Michael
f42d2e2b61 ;doc: info: drop standalone headers again, they break things 2020-12-20 20:08:35 -08:00
Simon Michael
6e1a9f83e1 ;doc: info: add standalone headers, incl. text encoding 2020-12-20 20:08:29 -08:00
Simon Michael
c058d44034 ;shake: note issue
(cherry picked from commit e5b6dd3b1e)
2020-12-15 20:57:15 -08:00
Simon Michael
a764b6137f ;shake changelogs: be more robust 2020-12-15 20:21:56 -08:00
Simon Michael
25d76a7795 ;shake changelogs: make it more robust; add a newline 2020-12-15 13:04:36 -08:00
Simon Michael
1a924f3a16 ;shake: wording 2020-12-15 12:41:33 -08:00
Simon Michael
d028b1f062 ;shake: update -> docs 2020-12-15 12:38:57 -08:00
Simon Michael
6e2d4ce425 ;shake setversion: print hledger bounds for review 2020-12-15 12:30:54 -08:00
Simon Michael
12d17efcd0 ;shake setversion also updates cabal files; update help 2020-12-15 11:46:42 -08:00
Simon Michael
105f7d2944 ;tools: split defs.m4 to minimise manual rebuilding 2020-12-15 09:39:29 -08:00
Simon Michael
7d4d6517a6 ;shake: commandtxts -> cmdhelp; note todos 2020-12-15 08:53:10 -08:00
Simon Michael
e9b84ca17c ;doc: journal: separate periodic rules' two meanings 2020-12-09 10:53:10 -08:00
Simon Michael
48b09bf0b4 ;tools: Shake manuals: fix breakage 2020-12-08 20:11:17 -08:00
Simon Michael
f10cc4609d doc: fix content hierarchy when generating info manuals 2020-12-08 20:09:09 -08:00
Simon Michael
d17d92b338 ;stack, bin: bump all to lts-16.25 2020-12-08 12:59:25 -08:00
Simon Michael
116945e907 ;shake: man page date is now updated by manuals, not setversion 2020-12-07 12:26:48 -08:00
Simon Michael
84ee05baa6 Shake cabalfiles: give an error when this fails 2020-11-10 08:06:03 -08:00
Simon Michael
4388ce72f6 ;shake: manuals: commit the defs.m4 files also 2020-10-18 16:02:35 -07:00
Simon Michael
b02218586b ;shake setversion: tweak commit message 2020-09-07 12:19:16 -07:00
Simon Michael
845f344eba ;shake commandtxts,manuals,changelogs,cabalfiles,update: --commit 2020-09-07 11:41:57 -07:00
Simon Michael
d6b1a18178 ;shake setversion --commit: also commit the updated files 2020-09-07 11:41:56 -07:00
Simon Michael
0578c50bf8 ;shake update: regenerate all the usual bits 2020-09-07 11:41:56 -07:00
Simon Michael
731cda3f65 ;shake: use --dry-run instead of changelogs-dry 2020-09-07 11:41:56 -07:00
Simon Michael
00e12c626c ;shake: simplify argument handling, fix setversion 2020-09-07 11:41:56 -07:00
Simon Michael
306975e6ac ;shake cabalfiles updates .cabal files 2020-09-07 11:41:56 -07:00
Simon Michael
1f4907928c ;shake: build can take package arguments, drop Shake PKG 2020-09-07 11:41:56 -07:00
Simon Michael
a1321b7f26 ;shake: commandhelp -> commandtxts, don't build this for "manuals" 2020-09-07 11:41:56 -07:00
Simon Michael
f8a57dae51 ;shake: help, cleanups 2020-09-07 09:23:42 -07:00
Simon Michael
5c86e0bdbd ;shake changelogs: do both dev & release updates, based on .version
And add changelogs-dry.
2020-09-07 09:23:42 -07:00
Simon Michael
79b532017b ;shake: setversion can operate on specified packages 2020-09-07 09:23:42 -07:00
Simon Michael
fdd346294f ;shake: setversion can save a new version number 2020-09-07 09:23:42 -07:00
Simon Michael
ec2826ba09 ;shake: cleanup 2020-09-07 09:23:42 -07:00
Simon Michael
13ccd23304 ;shake: bump resolver 2020-09-07 09:23:42 -07:00
Simon Michael
ab9e50003c shake: refactor; use only the first argument as build target 2020-09-07 09:23:42 -07:00
Simon Michael
a0277a8d43 ;shake: docversions no longer used 2020-06-07 12:46:09 -07:00
Simon Michael
d79578cbfa ;shake: try default quiet verbosity 2020-03-18 16:22:37 -07:00
Simon Michael
fe0253eddb ;shake: cleanups 2020-03-18 15:46:43 -07:00
Simon Michael
1e2e83ab7e shake: use script command, allow running without compiling first 2020-03-18 15:40:56 -07:00
Simon Michael
ccac3d6cfa ;shake: refactor; add _info_ m4 macro
[ci skip]
2020-01-29 06:01:09 -08:00
Simon Michael
c84466fb29 ;shake: can use the default stack.yaml/GHC 8.8 (#1090)
[ci skip]
2020-01-28 09:21:10 -08:00
Simon Michael
b9763b9bdd ;stack: simplify stack file names 2020-01-27 06:25:29 -08:00
Simon Michael
444c4342ed ;doc: manuals: hide NAME/SYNOPSIS/DESCRIPTION headings in web manuals
[ci skip]
2020-01-25 16:57:51 -08:00
Simon Michael
91978db328 ;shake: generate web manuals in package dirs, like the others
[ci skip]
2020-01-25 16:26:26 -08:00
Simon Michael
84984499bb ;shake: refactor 2020-01-25 16:17:48 -08:00
Simon Michael
e789cc93f5 ;doc: fix yet another rendering issue with new pandoc ({=html})
Since pandoc 2.8 the markdown writer adds this raw_attribute syntax by default.
2020-01-06 09:41:03 -08:00
Simon Michael
6dcf6310a3 ;doc: strip html comments, preserved by latest pandoc (?)
Not sure when the --strip-comments option was added, but we seem
to need it now.

[ci skip]
2020-01-06 07:08:15 -08:00
Simon Michael
714cc18ba8 ;Shake setversion: also set man page dates (to current date)
[ci skip]
2020-01-05 09:04:50 -08:00
Simon Michael
95f1172c1b ;shake: txt manuals are different, group others together
[ci skip]
2020-01-05 07:37:09 -08:00
Simon Michael
412ea86a2d ;shake: use older GHC to work around regex#173 (#1090)
[ci skip]
2020-01-04 21:17:50 -08:00
Simon Michael
8b3e7ea72b ;Shake: consistency tweak in the webmanuals help 2019-12-09 06:36:45 -08:00
Simon Michael
ccc42d4c2b ;Shake: add "webmanuals" to the default help 2019-12-09 06:35:04 -08:00
Simon Michael
eb1bb0702d ;Shake webmanuals: add a "generated by" comment (hledger_site/#10)
[ci skip]
2019-12-09 06:33:08 -08:00
Simon Michael
87d0491103 ;bump version to 1.16 2019-12-01 10:03:58 -08:00
Simon Michael
3c226f869a ;stack: use base-compat < 0.11 and latest lts for Shake/regex (#1090)
[ci skip]
2019-11-29 07:48:03 -08:00
Simon Michael
b475ad039a ;shake: note an issue with atomic building of web manuals
[ci skip]
2019-11-10 18:33:50 -08:00
Simon Michael
2bbc9b76e5 ;Shake clean/Clean: update, fix dangerous over-cleaning in site/
[ci skip]
2019-09-15 17:16:59 -07:00
Simon Michael
4b3103cbb1 ;Shake: comment all the website generation stuff, sphinx does it now
[ci skip]
2019-09-15 17:16:58 -07:00
Simon Michael
09ff703a9b ;Shake manuals: also regenerate embeddded command help txts
[ci skip]
2019-09-13 10:58:41 -07:00
Simon Michael
4db14ef70f ;api: another round of hledger-api purging; fix the build 2019-09-11 14:49:22 -07:00
Simon Michael
68262c59ed ;shake manuals: workaround to avoid ANSI codes in plaintext help
This seems to be a groff bug, as of 1.22.3 & 1.22.4. It always calls
grotty with no flags, even with -c, so grotty adds ANSI/SGR escape
codes in the -Tascii output.

Now instead of groff, we call the lower level commands directly,
requiring tbl, eqn, troff, grotty to be in PATH and compatible.
Not ideal.

[ci skip]
2019-09-02 11:05:28 -07:00
Simon Michael
29f7654c3a bump versions to 1.15 2019-09-01 08:53:06 -07:00
Simon Michael
113f193486 api: drop from Shake scripts
[ci skip]
2019-09-01 08:53:06 -07:00
Simon Michael
40200b60a6 ;site: also drop 0.27 manual from shake scripts
[ci skip]
2019-08-30 08:00:21 -07:00
Simon Michael
f55985eb9b ;site: stop using pandoc's fenced_code_attributes
[ci skip]
2019-08-26 18:41:33 -07:00
Simon Michael
fd5dc7bc18 ;doc: fix some table rendering in the html manuals
[ci skip]
2019-08-26 09:37:03 -07:00
Simon Michael
cccaa2f1b4 ;doc: don't generate combined manual any more
[ci skip]
2019-08-26 09:37:03 -07:00
Simon Michael
da6718806a ;doc: don't add page TOCs any more, sphinx has it covered
[ci skip]
2019-08-26 09:37:03 -07:00
Simon Michael
4a5b4142e1 ;site: fix "fix the webhook's pull of site repo"
[ci skip]
2019-08-26 09:34:46 -07:00
Simon Michael
9debf0c288 ;site: fix the webhook's pull of site repo
[ci skip]
2019-08-26 09:28:52 -07:00
Simon Michael
cea86260c9 ;site: pull both repos when either one posts the webhook
[ci skip]
2019-08-25 06:26:17 -07:00
Simon Michael
b9b420290c ;site: fix generation of cookbook pages
[ci skip]
2019-08-25 06:20:14 -07:00
Simon Michael
ece3d67ebf site: drop references to the github wiki
[ci skip]
2019-08-24 04:34:17 -07:00