chiark / gitweb /
build-sys,man: use XML entities to substite strings
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 29 Mar 2013 18:22:27 +0000 (14:22 -0400)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Sat, 30 Mar 2013 00:30:21 +0000 (20:30 -0400)
commit1a13e31d275430ffba713c8a68ee7f22093c29e0
tree66b0b3e91d22fce58affea603c2a5cbf6eb0c6a9
parent4e7b3c20e00c40372c551bd42c57e40500f4ceb4
build-sys,man: use XML entities to substite strings

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.
.gitignore
Makefile.am
make-directive-index.py
make-man-index.py
make-man-rules.py
man/.gitignore
man/systemd.unit.xml
xml_helper.py [new file with mode: 0644]