<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 TRANSITIONAL//EN"> <HTML> <HEAD> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=UTF-8"> <META NAME="GENERATOR" CONTENT="GtkHTML/3.26.0"> </HEAD> <BODY> On Sun, 2010-10-10 at 10:50 -0700, Dan Nicholson wrote: <BLOCKQUOTE TYPE=CITE> <TT>> Should we be distributing the doc output in the tarball then?</TT> <TT>> Currently, we're not, but that would be a simple update to</TT> <TT>> spec/xmlrules.in in libX11.</TT> <TT>Oh, I thought they were, but I didn't actually check. IMO, I'd either</TT> <TT>leave the compose key charts out or distribute just the html versions.</TT> <TT>Either way, I'd default fop to off. People that really want the pdf or</TT> <TT>ps versions of the docs can build them on their own.</TT> </BLOCKQUOTE> 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. </BODY> </HTML>