[Xfce-i18n] Some rules

[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.2-po', `trunk-po' is for casual translators,
   not for committers.

2. You can see why that line wrapping is required via commits log,
   there're so many unnecessary diffs to shadow 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 in libexo, Terminal, Thunar (Mousepad, xfce4-session are
   added now, later you're supposed to leave your logs in the all
   modules). 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 01/05/2006):

  bn_IN: Runa Bhattacharjee <runabh at gmail.com>
  ca:    Pau Rullan Ferragut <paurullan at bulma.net>
* cs:    Alois Nespor <Alois.Nespor at seznam.cz>
  de:    Moritz Heiber <moe at xfce.org>
  el:    Stavros Giannouris <stavrosg2002 at freemail.gr>
  eo:    Sylvain Vedrenne <gnu_sylvain at xfce.org>
  et:    Peeter Vois <Peeter.Vois at proekspert.ee>
  eu:    Piarres Beobide Egana <pi at beobide.net>
  fi:    Jari Rahkonen <jari.rahkonen at pp1.inet.fi>
  fr:    Olivier Fourdan <fourdan at xfce.org>
  gu:    Ankitkumar Rameshchandra Patel <ankit at redhat.com>
  he:    Yuval Tanny <tanai at int.gov.il>
  hu:    Szervac Attila <sas at 321.hu>
  it:    Alex Dupre <ale at FreeBSD.org>
  ja:    Daichi Kawahata <daichi at xfce.org>
  lt:    Rimas Kudelis <rq at akl.lt>
  nl:    Jasper Huijsmans <jasper at xfce.org>
  pt_BR: Adriano Winter Bess <awbess at gmail.com>
  sk:    Juraj Brosz <juro at jurajbrosz.info>
  uk:    Maxim V. Dziumanenko <mvd at mylinux.ua>
  zh_TW: Hydonsingore Cia <hydonsingore at mail.educities.edu.tw>

* In the process of account deletion.

Thanks for your consideration,
-- 
Daichi

Language Codes: http://www.w3.org/WAI/ER/IG/ert/iso639.htm
Country Codes: http://www.ics.uci.edu/pub/ietf/http/related/iso3166.txt