[mapserver-commits] r9903 - branches/branch-5-6/docs/en/development

[svn at osgeo.org]

Author: gislars
Date: 2010-02-25 15:24:57 -0500 (Thu, 25 Feb 2010)
New Revision: 9903

Modified:
   branches/branch-5-6/docs/en/development/documentation.txt
Log:
updated "How translations are handled"

Modified: branches/branch-5-6/docs/en/development/documentation.txt
===================================================================
--- branches/branch-5-6/docs/en/development/documentation.txt	2010-02-25 16:36:47 UTC (rev 9902)
+++ branches/branch-5-6/docs/en/development/documentation.txt	2010-02-25 20:24:57 UTC (rev 9903)
@@ -137,7 +137,7 @@
 
        sudo easy_install Sphinx
 
-# install MacTex from http://www.tug.org/mactex/2009/ if you want to build pdfs 
+# install MacTex from http://www.tug.org/mactex/2009/ if you want to build pdfs
 
 #. to process the docs, from the MapServer /docs directory, run:
 
@@ -157,7 +157,7 @@
 
     If there are more than one translation, the above commands will automatically
     build all translations.
-    
+
 How translations are handled
 ----------------------------
 
@@ -171,11 +171,15 @@
 
 .. note::
 
-    To start a new translation, copy the directory docs/en to docs/<lang>,
-    where <lang> is one of the country codes.
+    To start a new translation, copy the directories images and include
+    from docs/en to docs/<lang>, where <lang> is one of the country codes.
 
-* It is not recommended to remove untranslated files, as this would end in an
-  404 error for the user.
+* Only translated files are kept in the <lang> directories and the repository.
+* The build script (Makefile and make.bat) have an option (init) to preprocess
+  the <lang> directories. That means that each not translated English file is
+  copied to the target <lang> directory. You don't have to do this to build
+  html files locally. If you do this, you have to clean up you directories
+  afterwards.
 * To keep the translations in sync with the English docs, the translators
   can monitor commits to the repository.
 
@@ -184,14 +188,12 @@
     One way to monitor changes is to subscribe the rss feed at
     http://trac.osgeo.org/mapserver/log/trunk/docs
 
-**On Linux:**
+* You have to define which languages are available by setting TRANSLATIONS in the
+  Makefile or make.bat:
 
-* You have to define which languages are available by setting LANGUAGES in the
-  Makefile:
-
    ::
 
-      LANGUAGES     = en de
+      TRANSLATIONS     = en de
 
 The build script will then process the subdirectories *en* and *de*. If they
 are not accessible, an error message will be returned.