[tor-commits] r24399: {translation} Update the translation howto.txt for torbutton. (translation/trunk/documentation)

[Mike Perry]

Author: mikeperry
Date: 2011-03-21 09:52:09 +0000 (Mon, 21 Mar 2011)
New Revision: 24399

Modified:
   translation/trunk/documentation/howto.txt
Log:
Update the translation howto.txt for torbutton.



Modified: translation/trunk/documentation/howto.txt
===================================================================
--- translation/trunk/documentation/howto.txt	2011-03-21 09:03:03 UTC (rev 24398)
+++ translation/trunk/documentation/howto.txt	2011-03-21 09:52:09 UTC (rev 24399)
@@ -309,27 +309,45 @@
 
 Torbutton and Torbutton-alpha:
 
-    The Transifex configuration file, source file and translations can
-    be found here:
-    https://svn.torproject.org/svn/translation/trunk/projects/torbutton/ 
-    and here:
-    https://svn.torproject.org/svn/translation/trunk/projects/torbutton-alpha/. 
+    First, you must fetch the appropriate translation checkout for your build.
 
-    You will also need: https://gitweb.torproject.org/torbutton.git/.
+    If you are on branch master, building a Torbutton 1.3.x alpha build:
+       cd torbutton.git/trans_tools
+       svn co https://svn.torproject.org/svn/translation/trunk/projects/torbutton-alpha/po po
 
-    1. Converting Translations to Mozilla Files
+    If you are on branch maint-1.2, building a Torbutton 1.2.x build:
+       cd torbutton.git/trans_tools
+       svn co https://svn.torproject.org/svn/translation/trunk/projects/torbutton/po po
 
-       # TODO: document how to convert translations to mozilla files.
- 
-    2. Creating/Updating Translation Template Files
+    You should then run this command to pull the latest translations from
+    transifex:
+       cd po
+       tx pull -a
+       cd ..
 
-       If you made changes to strings in Torbutton, you need to rebuild
-       the templates in the 'po/templates' directory. This is done with
-       the following command from within the torbutton.git checkout
-       directory:
+    You should then verify the new strings from transifex for XSS exploits:
+       ./validate_all.py | less
 
-	$ moz2po -P -i src/chrome/locale/en/ -o /path/to/po/templates
+    Be careful, the unicode will cause tons of false positives to drown out
+    actual issues.
 
+    If you made changes to strings in Torbutton, you need to rebuild
+    the templates in torbutton.git/trans_tools/pootle/templates. This
+    is done with the following command from within the
+    torbutton.git/trans_tools directory:
+       ./new_tb_strings.sh
+
+    Then, regardless of whether or not you had changes in the
+    torbutton strings, you then need to regenerate the mozilla .dtd and
+    .properties files, especially if your svn checkout had new
+    translations from Transifex:
+       ./mkmoz.sh
+       ./mvmoz.sh
+
+    After this, you can 'git diff' to review the changes, and then commit
+    them.
+
+
 Torcheck:
 
     The Transifex configuration file, source file and translations can