sane-project-backends/po/README

2002-01-10

This directory contains translations for the options of the SANE backends.
They are only used if configure is called with option --enable-translations.
You will nee GNU gettext: xgettext, msgfmt and msgmerge. Currently these
translations are only used by XSane.

What do you need to do if you want to:

- Just read the description of SANE options in your language
  * Use XSane, read the documentation and set LANG to your favorite
    setting (e.g. de_DE for German in Germany).

- Update existing translations when the source code has changed
  * cd po ; make
  * Edit backend.lang.po, add/change translations. (with lang = your
    language, e.g. "de", and backend = your backend, e.g. mustek)
  * make ; make install

- Add a new language to an existing backend
  * cd po ; make backend.lang.po-gen 
  * Edit backend-lang.po, enter translations. Don't forget to edit the header.
  * Edit Makefile.in, add backend.lang.po to DISTFILES.
  * make ; make install

- Add a translation for a backend that is not listed yet in Makefile.in
  * Edit your sources and add SANE_I18N to the appropriate strings. Mark the
    descriptions (desc) and titles of options with SANE_I18N(). Do the same
    for string lists used in options. The name of options must NOT be marked.
    Do NOT mark macros. Especially you don't need to mark standard option
    strings like SANE_TITLE_NUM_OPTIONS as this is already done in saneopts.h.
    Example: s->opt[5].title = SANE_I18N("Enhancement");
  * Edit po/Makefile.in. Add a line "backend.*.po: yourfiles" where
    yourfiles is a space-separated list of all your files containing
    translatable text. Also add backend.lang.po to DISTFILES.
  * ./configure --enable-translations
  * cd po ; make backend.lang.po-gen
  * Edit backend-lang.po, enter translations. Don't forget to edit the header.
  * make ; make install

Bugs:
- This is the first attempt to support translations. It's probably very buggy
  and nearly untested.
- Lot's of ugly tricks and asumptions in Makefile.in
- All well known options are added to *.lang.po even if they are not used
  in the backend.