]> git.donarmstrong.com Git - lilypond.git/commitdiff
Update CG with how to make English only docs
authorPhil Holmes <mail@philholmes.net>
Thu, 15 Sep 2011 13:24:43 +0000 (14:24 +0100)
committerPhil Holmes <mail@philholmes.net>
Thu, 15 Sep 2011 13:24:50 +0000 (14:24 +0100)
Documentation/contributor/website-work.itexi
Documentation/included/compile.itexi

index 53a223b373f46c3e7dd907b21e967220ec90a70e..1f27cdb6f5a69f4d9d7cdbca3433ad819e9ab229 100644 (file)
@@ -293,6 +293,10 @@ make WEB_TARGETS="offline online" doc
 make website
 @end example
 
+This will make all the language variants of the website.  To save
+a little time, just the English version can be made with the
+command @code{make WEB_LANGS='' website} or the English and (for
+example) the French with @code{make WEB_LANGS='fr' website}.
 
 @item
 Move the built stuff into those directories.  It's highly
@@ -345,10 +349,12 @@ scripts/build/website_post.py
 
 @item
 Translations are not included by default in @code{make website}.
-To test your translation, edit the @code{WEB_LANGS} line in
-@file{make/website.make}.  Do not submit a patch to add your language
-to this file unless @code{make website} completes with less than 5
-warnings.
+To test your translation, edit the @code{WEB_LANGUAGES =} line in
+@file{python/langdefs.py}.  You will need to copy this updated
+script to @code{build/python/out}.
+
+Do not submit a patch to add your language to this file unless
+@code{make website} completes with fewer than 5 warnings.
 
 @item
 Links to manuals are done with macros like
index b7d6acdc79fa5c1577cf6d38a39d672df66dfbaf..f4ed097da593411c2e20e41b1193735345a83616 100644 (file)
@@ -647,6 +647,14 @@ the docs.  Please do not complain about anything which is broken
 in those places; the only complete set of documentation is in
 @file{out-www/offline-root/} from the top of the source tree.
 
+@code{make doc} compiles the documents for all languages.  To save
+some compile time, the English language documents can be compiled
+on their own with:
+
+@example
+make LANGS='' doc
+@end example
+
 Compilation of documentation in Info format with images can be
 done separately by issuing: