expanded usage

1 files changed, 16 insertions, 1 deletions

diff --git a/README b/README
index 01a01a47..2856f356 100644
--- a/README
+++ b/README
@@ -56,11 +56,26 @@ svn_method="svn+ssh://"
 Other options should be obvious by its name or comment.
 
 
-USAGE
+USAGE OF THE SCRIPT
 First time after your configuration the script will need some time to clone all the needed git repos. Just wait a bit. It will be much faster next time
 as it will only need to pull the changes from git since your last run. The script can show the differences from the last run by default but you can
 switch that off in your config. Script will show the list of resources for translation (with fuzzy and untranslated strings) on the end.
 
+In working directory script will create/update subdirectories with the following files:
+1. Translation catalog xxx.pot file, which can be used for Localize or msgmerge ("msgmerge xxx.pot_lang.po xxx.pot > new_lang.po").
+2. Translation file lang.po is there as it's safer for script not to overwrite your translation file if you run it before you pushed that translation.
+It's also useful for comparison.
+3. Working copy of translation file xxx.pot_lang.po is the one to work on. Downside of additional file is that you have to rename it before commit/push.
+4. If there is new_pot_lang.po file present in your current subdirectory you should replace existing file xxx.pot_lang.po with it before translation. If you're not sure how old that file is use msgmerge.
+
+
+
+TRANSLATION AND COMMIT
+A. It's safer and conveniant to translate file xxx_lang.po in working directory,
+B. merge ("msgmerge xxx.pot_lang.po xxx.pot > new_lang.po") and check your translation ("msgfmt -o /dev/null --statistics --check xxx_lang.po"),
+C. copy the file xxx_lang.po to git directory with the name lang.po and
+D. commit it.
+
 
 TODO
 add searching for new *.pot files and other resources in git