This package is intended for collection of translation strings in
patches and merging translations back to packages.

It works only with packages using intltool for translation.

It contains:

gnome-patch-translation-prepare: This tool collects strings from
intact package.

gnome-patch-translation-update: Using previously collected strings, this
tool:
- Collects actual strings in patches into gnome-patch-translation/
  sub-directory in build directory.
- Prepares fuzzy translations for existing translations.
  (only if COMPENDIUM_UPDATE_MODE=1)
- Updates actual translations in po/ using translations from
  gnome-patch-translation package.

gnome-patch-translation-files.tar.bz2: Files created by
COMPENDIUM_UPDATE_MODE=1 gnome-patch-translation-update collected from
all needed packages.

gnome-patch-translation.tar.bz2: Translation files provided by
translators.

gnome-patch-translation-merged and /usr/share/gnome-patch-translation
(autogenerated): It contains merged files, which will be used for
translation. These files should be sent to translators for update.



HOW TO PREPARE PACKAGE FOR TRANSLATION

See SuSE LCN repository for more:
https://svn.suse.de/svn/lcn/trunk/gnome-patch-translation and
https://svn.suse.de/svn/lcn/trunk/gnome-patch-translation/packagers

1) Search for candidates on unpacked source packages:
( find -name '*patch*' ; find -name '*dif*' ) | xargs fgrep '_("' | less | grep ':[+-]' | less

2) Include selected packages to gnome-patch-translation.

You have to do following changes in the spec file:

 ...
+BuildRequires: gnome-patch-translation
 ...
 %prep
 %setup
+gnome-patch-translation-prepare
 ...
 %patch
 ...
+gnome-patch-translation-update

3) You have to update gnome-patch-translation package, if any
translatable string is changed in any patch.

Call %prep phase of the package, copy contents of
gnome-patch-translation/ to the gnome-patch-translation package, file
gnome-patch-translation-files.tar.bz2.



HOW TO PROVIDE TRANSLATIONS

See SuSE LCN repository for more:
https://svn.suse.de/svn/lcn/trunk/gnome-patch-translation

If you plan to update translations, you should do following steps:

1) Collect all files created by COMPENDIUM_UPDATE_MODE=1
gnome-patch-translation-update in all included packages. You can get
these files by picking it from last build process or by calling %prep
phase of rpmbuild (you have to install gnome-patch-translation package).

2) Using upper mentioned files update
gnome-patch-translation-files.tar.bz2

3) Build this package (it is enough to unpack archives and call
"sh gnome-patch-translation-merge").

4a) If there is not yet any translation for particular language, pick
fuzzy po file from gnome-patch-translation-merged from build directory
and send it to translator for translation.

4b) If there is already a translation for particular language, pick
updated file from /usr/share/gnome-patch-translation (resp.
gnome-patch-translation-merged) and send it to translator for update.

5) Put your new translation into gnome-patch-translation.tar.bz2

6) Submit to build system or rebuild gnome-patch-translation and all
dependent packages.
