]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/TRANSLATION
Clean up buildscripts
[lilypond.git] / Documentation / TRANSLATION
index 433e6d4cbdfc9e84cac9cb5cf36c63a2ba2e3744..ada4bd7b156ed0cb910c6d31df582fe31f4d6525 100644 (file)
@@ -93,7 +93,7 @@ Cd into Documentation and run:
 where <MY-LANGUAGE> is the ISO 639 language code.
 
 Add a language definition for your language in
-buildscripts/langdefs.py.
+python/langdefs.py.
 
 See next section about what files to translate and the following
 detailed instructions after the next section.
@@ -120,9 +120,9 @@ Word counts (excluding lilypond snippets) are given for each file.
 23    user/dedication.itely
 423   user/macros.itexi
 171   index.html.in
-6339  po/lilypond-doc.pot (translate to po/<MY_LANGUAGE>.po)
+6346  po/lilypond-doc.pot (translate to po/<MY_LANGUAGE>.po)
 ---   ../lilypond-texi2html.init (section TRANSLATIONS)
-13750 total
+13757 total
 
 -2- Introduction and beginning of Application Usage
 411   user/preface.itely
@@ -148,7 +148,7 @@ Word counts (excluding lilypond snippets) are given for each file.
 1146  user/expressive.itely
 555   user/repeats.itely
 1455  user/simultaneous.itely
-1635  user/staff.itely
+1701  user/staff.itely
 895   user/editorial.itely
 2286  user/text.itely
 76    user/specialist.itely -- Specialist notation
@@ -159,7 +159,7 @@ Word counts (excluding lilypond snippets) are given for each file.
 826   user/guitar.itely
 66    user/strings.itely
 242   user/bagpipes.itely
-4486  user/ancient.itely
+4487  user/ancient.itely
 5805  user/input.itely -- Input syntax
 2164  user/non-music.itely -- Non-musical notation
 8451  user/spacing.itely -- Spacing issues
@@ -167,7 +167,7 @@ Word counts (excluding lilypond snippets) are given for each file.
 5202  user/programming-interface.itely -- Interfaces for programmers
 1190  user/notation-appendices.itely -- Notation manual tables
 250   user/cheatsheet.itely -- Cheat sheet
-62689 total
+62756 total
 
 -5- Application usage
 3248  user/lilypond-book.itely -- LilyPond-book
@@ -670,25 +670,38 @@ which works regardless of the branch checked out.
 TECHNICAL BACKGROUND
 
 A number of Python scripts handle a part of the documentation
-translation process.  All are located in buildscripts/, except
-langdefs.py which is in python/
+translation process.
+All scripts used to maintain the translations
+are located in scripts/aux/:
 
-* buildlib.py -- module containing common functions (read piped output
-of a shell command, use Git)
-* langdefs.py  -- language definitions module
 * 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
+* update-snippets.py -- synchronize ly snippets with those from
+English docs
+* translations-status.py -- update translations status pages and word
+counts in the file you are reading.
+* tely-gettext.py -- gettext node names, section titles and references
+in the sources; WARNING only use this script when support for
+"makeinfo --html" has been dropped.
+
+Other scripts are used in the build process, in scripts/build/:
 * html-gettext.py -- translate node names, section titles and cross
 references in HTML files generated by makeinfo
-* add_html_footer.py (module imported 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
-* update-snippets.py -- synchronize ly snippets with those from
-English docs
-* translations-status.py -- update translations status pages and word
-counts in the file you are reading.
+
+Python modules used by scripts in scripts/aux/ or scripts/build/ (but
+not by installed Python scripts) are located in python/aux/:
+* manuals_definitions.py -- define manual names and name of
+cross-reference Texinfo macros
+* buildlib.py -- common functions (read piped output
+of a shell command, use Git)
+* postprocess_html.py (module imported by www_post.py) -- add footer and
+tweak links in HTML pages
+
+And finally
+* python/langdefs.py  -- language definitions module