[bind10-dev] generated docs in git repo

[Michal 'vorner' Vaner]

Good morning

On Fri, Jun 15, 2012 at 10:21:34AM -0500, Jeremy C. Reed wrote:
> - 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.

Is it generated? If so, it is better not to have it in repo.

> - 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.)

Having a way to enable and disable the generation of docs is good. But I think
admins might be surprised little bit if they are not generated, so it might be
on by default (and have an option on the build systems to turn it off).

Or, it could detect if docbook & friends is installed and then decide to enable
or disable it. But that might be a bit more work.

With regards

-- 
Fragile. Do not turn umop ap1sdn!

Michal 'vorner' Vaner
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <https://lists.isc.org/pipermail/bind10-dev/attachments/20120615/05fc1f4d/attachment.bin>