[PATCH libICE docs] Add top-level target for documentation.

[Gaetan Nadon]

On Tue, 2010-11-23 at 08:57 -0800, Matt Dew wrote:

> On Tue, 2010-11-23 at 11:52 -0500, Trevor Woerner wrote:
> > On Tue, Nov 23, 2010 at 10:07 AM, Gaetan Nadon <memsize at videotron.ca> wrote:
> > > As Julien suggested, it should be named install-docs perhaps.
> > 
> > If you don't mind, I prefer Julien's suggestion of "install-specs"
> > since this target is meant to work in the "specs" directory, and there
> > also exists a "doc" directory in libICE. I think it would be less
> > confusing.
> 
> Something I've been wondering.  Is there a need to have both specs and
> doc dirs?  Can they be merged?

Before the conversion, a classification existed for documentation. Some
are installed, others not.
The specs have been traditionally located in /specs. It should help
finding the right document. 


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





> 
> Matt
> 
> 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20101123/95217a55/attachment.html>
-------------- 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/20101123/95217a55/attachment.pgp>