apenwarr-redo/docs/all.do

redo-ifchange doc.list
sed 's/\.md/.1/' <doc.list |
xargs redo-ifchange

# mkdocs foolishly tries to process every file in this directory, which
# leads it to try to open temp files produced by the above redo-ifchange
# if it runs in parallel with those jobs.  So don't run it until they
# finish.
redo-ifchange mkdocs
Docs/cookbook: build from toplevel 'test' instead of toplevel 'all'. The cookbook examples are interesting as redo tests, but don't need to be built in order to build redo. 2018-11-28 12:55:49 -05:00			`redo-ifchange doc.list`
Generate a basic documentation website with the mkdocs toolkit. No content yet other than man pages. To make the man pages render nicely in mkdocs, I removed the static %-headers and put the code for them into default.md.tmp.do instead. That way, the raw input redo-*.md files will look right in mkdocs. 2018-11-15 23:59:22 -05:00			`sed 's/\.md/.1/' <doc.list \|`
Run mkdocs only after generating the rest of the doc files. This avoids a mkdocs bug where mkdocs will (rarely) see redo temp files in its directory list, but they're gone by the time it tries to open them, so it aborts with an exception. 2018-11-21 19:11:44 -05:00			`xargs redo-ifchange`

			`# mkdocs foolishly tries to process every file in this directory, which`
			`# leads it to try to open temp files produced by the above redo-ifchange`
			`# if it runs in parallel with those jobs. So don't run it until they`
			`# finish.`
			`redo-ifchange mkdocs`