[Xfce-i18n] A guidance for the committer

[Daichi Kawahata]

Hi committers,

In this time, I'd like to inform you about the best way to
proceed when you commit translations.

    1. Don't use `trunk-po' module to grab PO files.
    2. Before commit, please wrap +80 lines by `make update-po'.
    3. Check your file sanity with `msgfmt -c'.
    4. If it's newly added, don't forget to add your language code
       to `configure.ac' or `po/LINGUAS' and it should be put
       alphabetically.
    5. Do `one-stop-commit' as much as possible.
    6. Leave a decent log when you commit.

1. If you grab PO files from module above, the following 2 processes
   must be impossible to do because you cannot commit in the modules,
   also you can't add your language code when a module doesn't get the
   language code from `po/LINGUAS'.

   Please use scripts at http://i18n.xfce.org/wiki/svn_howto instead,
   the PO file modules `4.4-po', `trunk-po' is for casual translators,
   not for committers.

2. You can see why that line wrapping is required via commits log,
   there are so many unnecessary diffs shadowing actual diffs,
   in general, the PO editors listed
   http://i18n.xfce.org/wiki/translation_software expand a large
   line without re-wrapping. Before doing this, you have to run
   `xdt-autogen' in the toplevel directory.

3. Please modify your Makefile.in.in file at `/usr/share/intltool'
   like below (-c option is added):

    .po.gmo:
           file=`echo $* | sed 's,.*/,,'`.gmo \
             && rm -f $$file && $(GMSGFMT) -c -o $$file $<

   Then, if you have source tree installed, it's simply

   $ rm -f *.gmo && make

   in the po directory.

4. Without that, your translations are only appeared at
   http://i18n.xfce.org/stats and no go.

5. That's a commit by using wild card like:

   $ svn ci */trunk/po/*.po

   Nobody prefers to see the split commit logs when they're
   unified with `xxx update', and `trunk-po' doesn't allow to
   commit several files at once, therefore

   `1. Don't use `trunk-po' module to grab PO files.'

   Please try to minimize your commits.

6. Like I had informed before*, you're supposed to leave your change
   logs. Please accustom yourself to leaving logs you did.

   * http://foo-projects.org/pipermail/xfce-i18n/2005-October/003394.html
     http://foo-projects.org/pipermail/xfce-i18n/2005-October/003449.html

Like above, a committer is supposed to build the applications from
the sources without any troubles, assumed to be familiar with
command line operation in terminal (but it's not so hard).

The listed persons below are the current committers (as of 14/04/2007):

  ar:    Mohamed Magdy <alnokta at xfce.org>
  be:    Alexander Nyakhaychyk <nab at xfce.org>
  bn_IN: Runa Bhattacharjee <runabh at gmail.com>
  ca:    Pau Rullan Ferragut <paurullan at xfce.org>
  cs:    Michal Varady <majkl at xfce.org>
  de:    Moritz Heiber <moe at xfce.org>
* dz:    Tenzin Dendup <tdendup at dit.gov.bt>
  el:    Stavros Giannouris <stavrosg at xfce.org>
  eo:    Sylvain Vedrenne <gnu_sylvain at xfce.org>
  et:    Peeter Vois <Peeter.Vois at proekspert.ee>
  eu:    Piarres Beobide <piarres at xfce.org>
  fi:    Jari Rahkonen <jari at xfce.org>
  fr:    Maximilian Schleiss <maximilian at xfce.org>
  gu:    Ankitkumar Rameshchandra Patel <ankit at redhat.com>
  he:    Yuval Tanny <yuvaltanny at xfce.org>
  hu:    Szervac Attila <sas at xfce.org>
  it:    Alex Dupre <ale at FreeBSD.org>
  ja:    Daichi Kawahata <daichi at xfce.org>
  ka:    Dimitri Gogelia <delphi.knight at gmail.com>
  lt:    Mantas Zapolskas <mantas at xfce.org>
  nl:    Stephan Arts <stephan at xfce.org>
  pa:    Amanpreet Singh Brar <aalam at xfce.org>
  pt_BR: Adriano Winter Bess <adriano at xfce.org>
  sk:    Juraj Brosz <juro at jurajbrosz.info>
  sv:    Alexander Toresson <eulex at xfce.org>
  tr:    Eren Turkay <erenturkay at xfce.org>
  uk:    Maxim V. Dziumanenko <mvd at xfce.org>
  zh_TW: Hydonsingore Cia <hydonsingore at xfce.org>

* In the process of account creation.

Thanks for your considerations,
--
Daichi

ISO 639-2: http://www.loc.gov/standards/iso639-2/php/code_list.php
ISO 3166 : http://www.iso.org/iso/en/prods-services/iso3166ma/index.html

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 186 bytes
Desc: not available
URL: <http://mail.xfce.org/pipermail/xfce-i18n/attachments/20070414/7130156c/attachment.pgp>