Fix and update TRANSLATION

Thanks to Francisco Vila.

diff --git a/Documentation/TRANSLATION b/Documentation/TRANSLATION
index a34cd4b0ecc48e63c0779fb2eef7b6ac4a10fbb2..6b03886d03e34f6740215cce8e843edf9db69836 100644 (file)
--- a/Documentation/TRANSLATION
+++ b/Documentation/TRANSLATION
@@ -5,7 +5,7 @@ SOURCES
 
 The sources live in a GIT repository.  Git 1.4.4.1 or newer is
 required, and Git 1.5.x is highly recommended.  To get a fresh version
-run
+of LilyPond sources run
 
     mkdir lily ; cd lily
     git init-db
@@ -29,6 +29,16 @@ Working on LilyPond documentation translations requires:
     * gettext
 
 
+WHICH DOCUMENTATION CAN BE TRANSLATED
+
+The makfiles and scripts infrastructure currently supports translation
+of the following documentation:
+
+    * documentation index (HTML)
+    * user manual -- Texinfo source, PDF and HTML output; Info output
+might be added if there is enough demand for it.
+
+
 STARTING A TRANSLATION IN A NEW LANGUAGE
 
 At top of the source directory, do
@@ -56,6 +66,7 @@ buildscripts/langdefs.py.
 See next section about what files to translate and the following
 detailed instructions after the next section.
 
+
 FILES TO BE TRANSLATED
 
 All the following files are in Documentation/
@@ -213,9 +224,9 @@ replace 'make' with 'make -C Documentation') and run
     make ISOLANG=<MY_LANGUAGE> check-translation
 
 This presents a diff of the original files since the most recent
-revision of the translation.  To check a single page, run
+revision of the translation.  To check a single file, run
 
-    buildscripts/check-translation.py Documentation/user/<MY-LANGUAGE>/foo/bar.itely
+    python buildscripts/check_translation.py Documentation/<MY-LANGUAGE>/user/foo.itely
 
 
 
@@ -240,12 +251,16 @@ TECHNICAL BACKGROUND
 A number of Python scripts handle a part of the documentation
 translation process:
 
-langdefs.py  -- language definitions
-check_translation.py  -- show diff to update a translation
-texi-langutils.py  -- quickly and dirtily parse Texinfo files to
+* langdefs.py  -- language definitions
+* check_translation.py  -- show diff to update a translation
+* texi-langutils.py  -- quickly and dirtily parse Texinfo files to
 make message catalogs and Texinfo skeleton files
-texi-skeleton-update.py -- update Texinfo skeleton files
-html-gettext.py -- translate node names, section titles and cross
+* texi-skeleton-update.py -- update Texinfo skeleton files
+* html-gettext.py -- translate node names, section titles and cross
 references in HTML files generated by makeinfo
-add_html_footer.py (module called by www_post.py) -- add footer and
+* add_html_footer.py (module called by www_post.py) -- add footer and
 tweak links in HTML pages
+* texi-gettext.py -- gettext node names, section titles and references
+before calling texi2pdf
+* mass-link.py -- link or symlink files between English documentation
+and documentation in other languages