document the script I made for tx/po management + svnup ;)

repos-to-tx.sh

@@ -1,14 +1,22 @@
 #!/bin/bash
 
+#------------------------------------------------------------
+# Short doc: launch this after big changes, so that 
+# people who translate the project have the new strings ;) 
+#------------------------------------------------------------
+
+# Long doc: 
 # Take each sub-project of AlternC 
-# (EXPECTED IN PARENT FOLDERS)
+# (EXPECTED IN PARENT FOLDERS of alternc/trunk/)
 # (yes, one day we will be united again ;) )
 # and regenerate the .POT 
 # then regenerate the .PO for each language
 # then merge them into one big .po file and 
-# put them in the altenrc-i18n repository
+# put them in the lang/ folder
 #
-# finally, push all those files to transifex
+# finally, push en_US to transifex
+# to be translated.
+
 
 pushd ../..
 

svnup.sh

@@ -1,5 +1,9 @@
 #!/bin/bash
 
+# If you have all the AlternC's repositories in one folder, 
+# like alternc/trunk/ alternc-mailman/trunk/ ...
+# this script do svn update on all of them ;) 
+
 pushd ../..
 
 for i in alternc alternc-bounces alternc-jabber alternc-munin alternc-procmail alternc-stats alternc-apps alternc-changepass alternc-mailman alternc-philesight alternc-secondarymx alternc-sympa alternc-awstats alternc-doc alternc-mergelog alternc-phpcron alternc-slavedns alternc-webalizer

tx-to-repos.sh

@@ -1,7 +1,14 @@
 #!/bin/bash
 
+#------------------------------------------------------------
+# Short doc: launch this when people said they translated 
+# the program in Transifex, so that their translation appears
+# in the production package.
+#------------------------------------------------------------
+
+# Long doc: 
 # Take each sub-project of AlternC 
-# (EXPECTED IN PARENT FOLDERS)
+# (EXPECTED IN PARENT FOLDERS of alternc/trunk/)
 # (yes, one day we will be united again ;) )
 # and get the TRANSLATED strings from transifex
 # then put them at the right places in the repositories