<!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-11-23 at 00:02 +0100, Julien Cristau wrote:<BR>
<BLOCKQUOTE TYPE=CITE>
<TT><FONT COLOR="#1a1a1a">I don't think it's a good idea for a target named 'documents' to install</FONT></TT><BR>
<TT><FONT COLOR="#1a1a1a">stuff.</FONT></TT><BR>
</BLOCKQUOTE>
Good point<BR>
<BLOCKQUOTE TYPE=CITE>
<TT><FONT COLOR="#1a1a1a"> Call it install-specs or something if it's needed, but I'm not</FONT></TT><BR>
<TT><FONT COLOR="#1a1a1a">sure what this buys you over 'make -C specs install'.</FONT></TT><BR>
<BR>
</BLOCKQUOTE>
Nothing, if you work only on one module. This is a target to take advantage<BR>
of build.sh whereby all documentation (as defined in the comment) are built.<BR>
<BR>
In previous releases, all the docs where in xorg-docs and so they could be built with one command.<BR>
Now, one has to make a custom script and hunt down all the places where docs live e.g specs,<BR>
doc, doc/xml/dtrace and so one. <BR>
<BR>
With such a target on all modules, one can simply invoke <FONT COLOR="#000000">build.sh --cmd "make documents" (with</FONT><BR>
a list of modules holding documents)<BR>
<BR>
That's the thought, there might be better ways to do it!<BR>
<BR>
Thanks
</BODY>
</HTML>