From e69fd85f7c7e2e64449b15d652b9e6aadf816b7f Mon Sep 17 00:00:00 2001 From: Phil Holmes Date: Thu, 15 Sep 2011 14:24:43 +0100 Subject: [PATCH] Update CG with how to make English only docs --- Documentation/contributor/website-work.itexi | 14 ++++++++++---- Documentation/included/compile.itexi | 8 ++++++++ 2 files changed, 18 insertions(+), 4 deletions(-) diff --git a/Documentation/contributor/website-work.itexi b/Documentation/contributor/website-work.itexi index 53a223b373..1f27cdb6f5 100644 --- a/Documentation/contributor/website-work.itexi +++ b/Documentation/contributor/website-work.itexi @@ -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 diff --git a/Documentation/included/compile.itexi b/Documentation/included/compile.itexi index b7d6acdc79..f4ed097da5 100644 --- a/Documentation/included/compile.itexi +++ b/Documentation/included/compile.itexi @@ -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: -- 2.39.5