From: Phil Holmes <mail@philholmes.net>
Date: Fri, 26 Aug 2011 14:14:41 +0000 (+0100)
Subject: Updates contributor to add fast doc make
X-Git-Tag: release/2.15.9-1~7^2~1
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=58d53b10f0fcfb5015f2bb3d0b57c69942865914;p=lilypond.git

Updates contributor to add fast doc make
---

diff --git a/Documentation/included/compile.itexi b/Documentation/included/compile.itexi
index 17db5163c9..b7d6acdc79 100644
--- a/Documentation/included/compile.itexi
+++ b/Documentation/included/compile.itexi
@@ -576,6 +576,7 @@ re-install.  See @ref{Configuring target directories}.
 @menu
 * Documentation editor's edit/compile cycle::
 * Building documentation::
+* Building a single document::
 * Saving time with CPU_COUNT::
 * AJAX search::
 * Installing documentation::
@@ -696,6 +697,21 @@ However, this will rebuild all of the manuals
 indiscriminately---it is more efficient to @command{touch} only
 the affected files.
 
+@node Building a single document
+@unnumberedsubsubsec Building a single document
+It's possible to build a single document.  For example, to rebuild
+only @file{contributor.pdf}, do the following:
+
+@example
+cd build/
+cd Documentation/
+touch ../../Documentation/contributor.texi
+make out=www out-www/contributor.pdf
+@end example
+
+If you are only working on a single document, test-building it in
+this way can give substantial time savings - recreating
+@file{contributor.pdf}, for example, takes a matter of seconds.
 
 @node Saving time with CPU_COUNT
 @unnumberedsubsubsec Saving time with @code{CPU_COUNT}