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

Gaetan Nadon memsize at videotron.ca
Tue Nov 23 09:25:27 PST 2010


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.


For this module module, yes. How do you plan on invoking build.sh --cmd
if
you have targets with different names?

That's the main reason behind this target, a uniquely named target
invoked through build.sh.

I am beginning to doubt this is good idea, after all. Judging by the
number of questions, it does not
seem to be intuitive.

The alternative is to implement the feature (let's call it "build all
docs") in build.sh. It already contains
the list of all modules, it's just a matter of invoking the right doc
targets. Some option like
--build-docs-only would be even easier to use.

Let me know how that sounds.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20101123/75441ce7/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/75441ce7/attachment.pgp>


More information about the xorg-devel mailing list