[bind10-dev] generated docs in git repo
Jeremy C. Reed
jreed at isc.org
Fri Jun 15 15:21:34 UTC 2012
trac1687 is a branch for removing the generated docs from the git bind10
repo. The generated docs are: manual pages, and HTML guide and messages
file, and text guide. A reason to remove the docs is that each time
someone commits to them there may be a lot of changes due to different
docs toolchain (they can be considered binary objects).
The plan is to have the generated docs be included in the "dist"
tarballs.
Two things to discuss:
- need install directions in the git repo in text format? They will be
in tarballs, is it also needed in the git repo? We can just point to the
docs.
- disable generation by default? It needs xsltproc, docbook and
appropriate stylesheets. It also needs a way to generate the plain text
(I use html to text using elinks, but a stylesheet for docbook to text
would be fine too.)
I don't want to install all the dependencies on all the build systems.
Any thoughts on this?
More information about the bind10-dev
mailing list