From: Julien Rioux <jrioux@physics.utoronto.ca>
Date: Mon, 13 Feb 2012 16:29:09 +0000 (-0500)
Subject: CG: Update info about make doc.
X-Git-Tag: release/2.15.35-1~37
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=5f2e79bd78f7c350167e61e38123d7a7db7ce362;p=lilypond.git

CG: Update info about make doc.
---

diff --git a/Documentation/included/compile.itexi b/Documentation/included/compile.itexi
index f4ed097da5..c3aa45de1c 100644
--- a/Documentation/included/compile.itexi
+++ b/Documentation/included/compile.itexi
@@ -605,7 +605,6 @@ Edit/compile cycle:
 make [-j@var{X}]                  @emph{## needed if editing outside}
                             @emph{##   Documentation/, but useful anyway}
                             @emph{##   for finding Texinfo errors.}
-touch Documentation/*te??   @emph{## bug workaround}
 make [-j@var{X} CPU_COUNT=@var{X}] doc  @emph{## usually faster than initial build.}
 @end example
 
@@ -655,6 +654,17 @@ on their own with:
 make LANGS='' doc
 @end example
 
+@noindent Similarly, it is possible to compile a subset of the
+translated documentation by specifying their language codes on the
+command line.  For example, the French and German translations are
+compiled with:
+
+@example
+make LANGS='de fr' doc
+@end example
+
+@noindent Note that this will also compile the English version.
+
 Compilation of documentation in Info format with images can be
 done separately by issuing:
 
@@ -705,6 +715,18 @@ However, this will rebuild all of the manuals
 indiscriminately---it is more efficient to @command{touch} only
 the affected files.
 
+@noindent
+Another typical issue when switching branches between master and
+lilypond/translation is the appearance/disappearance of translated
+versions of some manuals.  If you see such a warning from make:
+
+@example
+No rule to make target `X', needed by `Y'
+@end example
+
+@noindent
+Your best bet is to delete the file Y.dep and to try again.
+
 @node Building a single document
 @unnumberedsubsubsec Building a single document
 It's possible to build a single document.  For example, to rebuild