[PATCH libX11 3/3] docs: Disable fop documentation by default

[Gaetan Nadon]

On Sun, 2010-10-10 at 10:50 -0700, Dan Nicholson wrote:

> > Should we be distributing the doc output in the tarball then?
> > Currently, we're not, but that would be a simple update to
> > spec/xmlrules.in in libX11.
> 
> Oh, I thought they were, but I didn't actually check. IMO, I'd either
> leave the compose key charts out or distribute just the html versions.
> Either way, I'd default fop to off. People that really want the pdf or
> ps versions of the docs can build them on their own.
> 
> 

I am just catching up with all the posts. Are we talking about solving
a libX11
problem only, or are we talking about *all* of DocBook XML
documentation?

I can understand turning off doc build in some cases due to build time.
This can be done with
XORG_ENABLE_DOCS(no) or XORG_ENABLE_SPECS(no).

The conversion to DocBook/XML implies that the xmlto tooling was
adequate and available on
a reasonable number platforms. Including generated docs (of any kind) in
the tarball is a nightmare
which still has unresolved problems.




-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20101010/ec6890d6/attachment.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
URL: <http://lists.x.org/archives/xorg-devel/attachments/20101010/ec6890d6/attachment.pgp>