sane-project-backends/po
Gerhard Jaeger 54f6a05c0f Fixed typo 2013-02-20 20:01:53 +01:00
..
.gitignore adding new kvs40xx backend 2011-06-06 14:28:55 -04:00
LINGUAS Use standard gettext infrastructure, from Adi Roiban 2010-02-27 20:51:31 -05:00
Makefile.am Fixes for "make distcheck" on cygwin. 2011-01-02 20:00:22 -06:00
Makefile.in Added optional support in saned for systemd socket activation. This will allow for 2013-01-10 20:59:26 +01:00
POTFILES add support for sanei_magic to kvs1025 backend 2011-06-06 20:52:25 -04:00
README Update developer docs about translations 2011-01-31 20:43:22 +01:00
bg.po update all .po files 2011-06-06 22:10:51 -04:00
cs.po update all .po files 2011-06-06 22:10:51 -04:00
da.po update all .po files 2011-06-06 22:10:51 -04:00
de.po Fixed typo 2013-02-20 20:01:53 +01:00
en_GB.po update all .po files 2011-06-06 22:10:51 -04:00
eo.po update all .po files 2011-06-06 22:10:51 -04:00
es.po update all .po files 2011-06-06 22:10:51 -04:00
fi.po update all .po files 2011-06-06 22:10:51 -04:00
fr.po update all .po files 2011-06-06 22:10:51 -04:00
gl.po update all .po files 2011-06-06 22:10:51 -04:00
it.po update all .po files 2011-06-06 22:10:51 -04:00
ja.po update all .po files 2011-06-06 22:10:51 -04:00
nb.po update all .po files 2011-06-06 22:10:51 -04:00
nl.po updated Dutch translation from Martin Kho 2012-08-18 22:32:29 +02:00
pl.po update all .po files 2011-06-06 22:10:51 -04:00
pt.po updated translation from cncsolutions.com.br 2011-07-07 10:45:11 -04:00
ru.po update all .po files 2011-06-06 22:10:51 -04:00
sv.po Update Swedish translations 2012-10-22 11:23:11 +02:00
uk.po Various cleanups for release 2012-07-24 21:17:15 -04:00

README

2003-02-06

This directory contains translations for the options of the SANE backends.
They are only used if the gettext tools are found by configure.
You will need GNU gettext: xgettext, msgfmt and msgmerge. The translations
are used at least by the frontends XSane and quiteinsane.


Users: I want to just read the description of SANE options in my language
-------------------------------------------------------------------------

Use XSane (>=0.90) or your favourite frontend that supports translations, read
the documentation and set the environment variable LANG to your local setting.
Example for German: export LANG=de_DE ; xsane


Translators: I want to update existing translations
---------------------------------------------------

* cd po ; make update
* Edit lang.po, add/change translations. (with lang = your
  language, e.g. "de"). You need an editor that is capable of using the
  encoding UTF8 (unicode).
* Add your name to the header. Update the "last translator" field.
* make ; make install


Translators: I want to add a new language
-----------------------------------------

* Edit po/LINGUAS, add your language to ALL_LINGUAS.
* Run automake -OR- update po/Makefile.in accordingly by hand.
* ./configure
* Go ahead with "I want to update existing translations".


Backend developers: I want to add internationalization support for my backend
-----------------------------------------------------------------------------

* Edit the source code of the backend 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.
  Examples: s->opt[5].title = SANE_I18N("Enhancement");
            #define STANDARD_FORMAT SANE_I18N("a4 Paper")
* Edit po/POTFILES. Add all source code files that contain strings marked
  by SANE_I18N() to that file.
* If you want to also add a new language, see above.
* ./configure
* See "Update existing translations" or "Add a new language".


Frontend developers: I want to add internationalization support for my frontend
-------------------------------------------------------------------------------

* The Makefile installs files called "sane-backends.mo" in the directory
  "$(prefix)/share/locale/lang/LC_MESSAGES/", e.g.:
  "/usr/local/share/locale/de/LC_MESSAGES/sane-backends.mo". For every
  language exactly one .mo file is installed. Earlier releases of
  sane-backends installed one file per backend, e.g. sane-umax.mo. For
  backward compatibility, frontends may want to check for these files, also.
* As mentioned above, GNU gettext is used. 
* With other NLS implementations, converting the mo files may work.



Bugs:
- Using sed to include macros into *.pot isn't nice.