public
Description: Allows to manage the translations of GNOME I18n repositories
Homepage: http://simos.github.com/gnome-i18n-manage-vcs/
Clone URL: git://github.com/simos/gnome-i18n-manage-vcs.git
name age message
file .gitignore Tue Jul 07 08:20:12 -0700 2009 Updated gitignore [Simos Xenitellis]
file GNOMEI18nTarget.py Thu Aug 13 13:57:52 -0700 2009 Added compatibility to Python 3; still develop ... [Simos Xenitellis]
file GetKey.py Thu Oct 01 22:44:18 -0700 2009 Updated GetKey object; fixes output race condition [Simos Xenitellis]
file ModuleIterator.py Sat Oct 17 03:11:58 -0700 2009 Fixed module iterator [Simos Xenitellis]
file PLANNING Thu Oct 01 20:00:50 -0700 2009 Added --all to PLANNING [Simos Xenitellis]
file README Sat Apr 25 19:29:21 -0700 2009 Added status, poget actions; updated README [Simos Xenitellis]
file TextColorPrint.py Fri Sep 25 11:55:40 -0700 2009 Refactored code [Simos Xenitellis]
file gnome-i18n-manage-vcs Tue Oct 20 16:16:07 -0700 2009 Added filtering for vcsmanage action [Simos Xenitellis]
README
This tool allows to manage the GNOME translations that reside on a VCS.

For example, if you want to edit several translation files and then 
commit them to GNOME VCS, this tool automates the VCS access so that
what you need to worry is only the editing of the translation files.

Currently, the VCS is git throughout this program.

Workflows
A. Configuration [config]
1. Show current configuration
gnome-i18n-manage-vcs --status
2. Initial configuration (requires all options)
gnome-i18n-manage-vcs config --language el --languagefull Greek --podir `pwd`/PO --release gnome-2-26 --vcsdir `pwd`/VCS 
-u simos
3. Subsequent modification of configuration
gnome-i18n-manage-vcs config --release gnome-2-28

B. Managing VCS (GIT) repositories [vcsmanage]
1. 

C. Retrieving PO files [poget]
1. Download all PO files for a release
gnome-i18n-manage-vcs poget
2. Download PO documentation files for gnome-games
gnome-i18n-manage-vcs poget --module gnome-games --transtype doc
3. Clean downloaded PO files
gnome-i18n-manage-vcs poget --clean
4. Clean downloaded PO files (dry run)
gnome-i18n-manage-vcs poget --clean --dry-run

D. Commiting PO files [pocommit]
1. 

$ ./gnome-i18n-manage-vcs
gnome-i18n-manage-vcs a tool that helps manage translation files from a VCS
Usage: gnome-i18n-manage-vcs <action> <options>
Available actions:
 config      Initial configuration (stored in ~/.gnomemanagevcsrc)
   -l LL  --language LL       language code per ISO 639
          --languagefull LANG language name (as in "British English", Greek, etc)
         --podir PODIR       directory with .po files for uploading
   -r REL --release REL       release REL (such as 'gnome-2-26')
               --vcsdir VCSDIR     specify the local directory with the GNOME GIT clones           
   -u USR --username USR      username USR (corresponds to SVN/GIT GNOME account)

 status      Show current status

 vcsmanage   Local repository management (Module filtering applies)
    --clean             clears up the downloaded files (USE WITH CARE, WIPES REPOSITORIES)
   -r     --reset             Reset each repository (git reset --hard origin/master)
          --gitquiet          Add --quiet to GIT cloning
          --update-vcs        update local repositories (runs git pull --rebase on each)

 poget       Retrieve a selection of PO files (Module filtering applies)
    --clean             clears up the downloaded files (USE WITH CARE, WIPES PO FILES)

 pocommit    Commit and push the translation work to the repositories
          --commit            commit changes in repositories
   -d     --dry-run           do not really checkout/commit

 Module filtering
   -c CAT --category CAT      i18n category name CAT (such as 'desktop')
   -m MOD --module MOD        i18n module name MOD (such as 'gnome-games')
   -t     --transtype TYPE    optionally specify translation type, either ui or doc

 Common options
   -d     --dry-run           do not really perform the action
   -h     --help              this craft
   -q     --quiet             be quiet (even less output)
   -v     --verbose           show verbose output
$ _