documentation: Update i18n advice
authorHannu Nyman <hannu.nyman@iki.fi>
Sun, 30 Oct 2016 10:22:58 +0000 (12:22 +0200)
committerHannu Nyman <hannu.nyman@iki.fi>
Sun, 30 Oct 2016 10:37:04 +0000 (12:37 +0200)
Signed-off-by: Hannu Nyman <hannu.nyman@iki.fi>
documentation/i18n.md

index fdacb0853a2c46a413d54b9f19f14fbd3b3499ff..226a406c2aa8935ef3153ab6ec7ed3cb303b467d 100644 (file)
@@ -1,17 +1,19 @@
 # General
-Translations are saved in the folder po/. You find the reference in po/templates/<package>.pot. The actual translation files can be found at po/<lang>/<package>.po .
+Translations are saved in the folder po/ for each module and application. You find the reference in po/templates/<package>.pot. The actual translation files can be found at po/[lang]/[package].po .
 
 In order to use the commands below you need to have the _gettext'' utilities (''msgcat'', ''msgfmt'', ''msgmerge_) installed on your system.
 
 # Rebuild po files
 If you want to rebuild the translations after you made changes to a package this is an easy way:
-
-       
-       ./build/i18n-scan.pl applications/[package] > po/templates/[application].pot
-       ./build/i18n-update.pl po [application].po
        
-*Note:* Some packages share translation files, in this case you need to scan through all their folders. The first command from above should then be:
+       ./build/i18n-scan.pl applications/[application] > applications/[application]/po/templates/[application_basename].pot
+       ./build/i18n-update.pl applications/[application]/po
 
+       Example:
+       ./build/i18n-scan.pl applications/luci-app-firewall > applications/luci-app-firewall/po/templates/firewall.pot
+       ./build/i18n-update.pl applications/luci-app-firewall/po
+       (note that the directory argument can be omitted for i18n-update.pl to update all apps)
        
-       ./build/i18n-scan.pl applications/[package-1] applications/[package-2] applications/[package-n] > po/templates/[application].pot
+*Note:* Some packages share translation files, in this case you need to scan through all their folders. The first command from above should then be:
        
+       ./build/i18n-scan.pl applications/[package-1] applications/[package-2] applications/[package-n] > [location of shared template]/[application].pot