File HOWTO of Package gnome-patch-translation

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

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.

4) See Novell Forge LCN repository and update
gnome-patch-translation-collect from translation collection tools:
https://forgesvn1.novell.com/svn/suse-i18n/trunk/lcn/50-tools


HOW TO PROVIDE TRANSLATIONS

See Novell Forge LCN repository for more:
https://forgesvn1.novell.com/svn/suse-i18n

If you plan to update translations, you should use Novell Forge LCN
translation tools.
https://forgesvn1.novell.com/svn/suse-i18n/trunk/lcn/50-tools

After using tools, submit updated package for Factory.

Tools performs following steps:

1) Collect all files created by COMPENDIUM_UPDATE_MODE=1
gnome-patch-translation-update in all included packages. They are picked
by calling %prep phase of rpmbuild.

2) Use upper mentioned files to 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