[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