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

Gaetan Nadon memsize at videotron.ca
Tue Nov 23 10:42:51 PST 2010


On Tue, 2010-11-23 at 13:24 -0500, Trevor Woerner wrote:

> That sounds great to me, I can get started on that. Maybe we should
> leave off the "build" part since we're both building and installing?
> 

I only spent 0.538 ms thinking about the option name.

> The only question I have remaining is: if I user invokes build.sh with
> this new option, what are they expecting to see built and installed?
> man pages? specs? developer documentation? all of the above? I'm
> guessing you just want the specs and developer documentation, but I
> just wanted to be double-check.
> 

Anything covered by --enable-docs --enable-devel-docs and --enable-specs
as outlined in the wiki table. No man pages.

Disregard the server "legacy" enable-builddocs which will be removed
eventually.

Conversely, it would be nice to have "don't build docs" option.
This would be very appreciated by many. Just keep that in mind when
designing the code.

Perhaps --docs-only and --no-docs 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20101123/f62c01b2/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/20101123/f62c01b2/attachment.pgp>


More information about the xorg-devel mailing list