po/README

   1 * Requirement for Translators and developers: gettext-0.11.5
   2
   3      http://www.gnu.org/software/gettext/
   4
   5   Read the doc. However, the logic used is a bit different
   6   than the gettext logic
   7
   8 * For translators:
   9
  10   Contact fvwm-workers@fvwm.org
  11
  12
  13 * For programmers:
  14
  15   To be written
  16
  17
  18 * For creating a new catalogs, say LL_CC (e.g., fr, zh_CN):
  19
  20   - Edit configure.in and add LL_CC to ALL_LINGUAS
  21   - run autoconf and ./configure (with your usual options) and check that
  22     the new "lang" appear in the list of "lang"
  23         Locale msg:  prefix/share/locale   ... LL_CC ...
  24   - cd to po/
  25   - create a domain.LL_CC.po file for all files domain.pot:
  26
  27       msginit -i fvwm.pot -l LL_CC -o fvwm.LL_CC.po
  28       msginit -i FvwmTaskBar.pot -l LL_CC -o FvwmTaskBar.LL_CC.po
  29       ...
  30
  31     The --no-translator option can be useful under certain situation
  32     (e.g., you do not use the LL_CC locale). In this case you should
  33     edit the files you have created and in particular set the
  34     appropriate CHARSET.
  35
  36   - Then, you can start the translation of fvwm.LL_CC.po,
  37     FvwmTaskBar.LL_CC.po ...etc
  38
  39     NOTE: You should "make domain.LL_CC.gmo" before make install
  40           and test your translation visually!
  41
  42 * make:
  43
  44     - make [all] should do nothing (but, maybe, recreating the
  45       Makefile). "make install" install! But see the previous NOTE.
  46
  47     - The following (re)build everything (safe):
  48
  49       make po-update
  50
  51     - If some messages have changed in some source files in "domain":
  52
  53        make domain.pot-update
  54
  55       update domain.pot. Then you can
  56
  57        make domain.LL_CC.po
  58
  59       to get the new messages for translation. After translation:
  60
  61        make domain.LL_CC.gmo   # create a binary mo file from the po one
  62        make install
  63        restart fvwm
  64
  65       for visual testing.
  66
  67     - Other targets:
  68
  69       make update-gmo  # build all the binary gmo files
  70
  71 * Creation of a new domain: ask the fvwm-workers@fvwm.org.
  72
  73    Basically:
  74
  75     - Update ALL_DOMAINS in configure.in
  76     - Add NEW_DOMAIN in configure.in
  77     - Create po/$NEW_DOMAIN.pot (xgettext) and add it to EXTRA_DIST
  78       (todo: remove this step)
  79     - Set the files which contains msg NEW_DOMAIN = file1 file2 ...
  80       in the beginning of po/Makefile.am
  81     - Add $(srcdir)/$(NEW_DOMAIN).pot: and $(NEW_DOMAIN).pot-update:
  82       in po/Makfile.am
  83     - Update $(POFILES): and update-po: in po/Makfile.am
  84       (todo: remove this step)
  85