summaryrefslogtreecommitdiff
path: root/make-man-rules.py
AgeCommit message (Collapse)Author
2013-12-21build-sys: add xml sources to EXTRA_DISTZbigniew Jędrzejewski-Szmek
Apparently automake does not include the sources if they are under a conditional that is disabled when making dist. This means that everything would have to be enabled to make distcheck work.
2013-03-29build-sys,man: use XML entities to substite stringsZbigniew Jędrzejewski-Szmek
This makes it easier to add substitutions to man pages, avoiding the separate transformation step. mkdir -p's are removed from the rule, because xsltproc will will create directories on it's own. All in all, two or three forks per man page are avoided, which should make things marginally faster. Unfortunately python parsers must too be tweaked to handle entities. This isn't particularly easy: with lxml a custom Resolver can be used, but the stdlib etree doesn't support external entities *at all*. So when running without lxml, the entities are just removed. Right now it doesn't matter, since the entities are not indexed anyway. But I intend to add indexing of filenames in the near future, and then the index generated without lxml might be missing a few lines. Oh well.
2013-03-29Revert "build-sys: substitute strings in systemd.unit(5)"Zbigniew Jędrzejewski-Szmek
This reverts commits c78ab91132aab9193f3c17a9a206f8825ff4be84 and 185c3be03cec26023acc11b49553753aa7330a1d. It is simpler to just use includes...
2013-03-09build-sys: generate links for html alias pagesZbigniew Jędrzejewski-Szmek
2013-02-27build-sys: fix update-man-rules for vpath buildsZbigniew Jędrzejewski-Szmek
2013-02-06build-sys: substitute strings in systemd.unit(5)Zbigniew Jędrzejewski-Szmek
Makefile.am is updated to deal with .xml.in sources. Nothing in the output is really changed yet, this is just preparation.
2013-02-06build-sys: create Makefile-man.am automaticallyZbigniew Jędrzejewski-Szmek
man rules were repeating the same information in too many places, which was error prone. Those rules can be easily generated from .xml files. For efficiency and because python is not a required dependency, Makefile-man.am is only regenerated when requested with make update-man-list If no metadata in man/*.xml changed, this file should not change. So only when a new man page or a new alias is added, this file should show up in 'git diff'. The change should then be committed. If the support for building from git without python was dropped, we could drop Makefile-man.am from version control. This would also increase the partial build time (since more stuff would be rebuild whenever sources in man/*.xml would be modified), so it would probably wouldn't be worth it.