<!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 Tue, 2010-12-07 at 19:50 +0200, Tiago Vignatti wrote: <BLOCKQUOTE TYPE=CITE> <PRE> From: Pauli Nieminen <<A HREF="mailto:ext-pauli.nieminen@nokia.com">ext-pauli.nieminen@nokia.com</A>> Co-authored-by: Tiago Vignatti <<A HREF="mailto:tiago.vignatti@nokia.com">tiago.vignatti@nokia.com</A>> Signed-off-by: Pauli Nieminen <<A HREF="mailto:ext-pauli.nieminen@nokia.com">ext-pauli.nieminen@nokia.com</A>> Signed-off-by: Tiago Vignatti <<A HREF="mailto:tiago.vignatti@nokia.com">tiago.vignatti@nokia.com</A>> --- doc/xml/dtrace/Makefile.am | 2 ++ 1 files changed, 2 insertions(+), 0 deletions(-) diff --git a/doc/xml/dtrace/Makefile.am b/doc/xml/dtrace/Makefile.am index 0e25e5d..a941563 100644 --- a/doc/xml/dtrace/Makefile.am +++ b/doc/xml/dtrace/Makefile.am @@ -25,11 +25,13 @@ XML_FILES = Xserver-DTrace.xml include ../xmlrules.in +if ENABLE_DEVEL_DOCS if XSERVER_DTRACE doc_DATA = $(BUILT_DOC_FILES) else noinst_DATA = $(BUILT_DOC_FILES) endif +endif CLEANFILES = $(CLEAN_DOC_FILES) </PRE> </BLOCKQUOTE> Things have significantly changed over the past few weeks. This is an excerpt from the release notes. <BLOCKQUOTE> <PRE> New configure options for documentation in modules -------------------------------------------------- As many more modules now contain documentation to be converted from DocBook XML to text, HTML, PostScript, and/or PDF formats, new standard options have been added to the configure macros to control the build of these in the modules. --with-xmlto=yes|no                      Enables or disables use of the xmlto [<A HREF="https://fedorahosted.org/">https://fedorahosted.org/</A>                      xmlto/] command to translate DocBook XML to other formats.                      All DocBook XML conversions require use of this command. --with-fop=yes|no                      Enables or disables use of the Apache fop [http://                      xmlgraphics.apache.org/fop/] command to translate DocBook                      XML to PostScript and PDF formats. --enable-docs=yes|no                      Enables or disables the build and installation of all                      documentation except traditional man pages or those covered                      by the --enable-devel-docs and --enable-specs options. --enable-devel-docs=yes|no                      Enables or disables the build and installation of documentation                      for developers of the X.Org software modules. --enable-specs=yes|no                      Enables or disables the build and installation of the formal                      specification documents for protocols and APIs. </PRE> </BLOCKQUOTE> The --enable-builddocs option will soon be removed once the posted patches get reviewed and pushed. There used to be an assumption that there was only developers docs in the xserver, but this is no longer the case. After those patches, the work will be completed. Anyone who wants to make a change, or fix what looks like a bug is invited to understand the new docs classification and the new macros supporting it. Note that all xorg modules having documentation follows this classification and use the same macros from util-macros. This allows xorg to have a "project wide" vision to communicate to users rather than doing it differently in each module. The doc generation tools are all checked at config time for their presence and their correct versions (for some). There should be no build breaks for those reasons as docs generation is skipped if the tools are not up to spec. I am taking this opportunity for a little bit of PR  :-) </BODY> </HTML>