l10n.eclass - convenience functions to handle localizations
The l10n (localization) eclass offers a number of functions to more
conveniently handle localizations (translations) offered by packages.
These are meant to prevent code duplication for such boring tasks as
determining the cross-section between the user's set LINGUAS and what
is offered by the package.
Convenience function for processing localizations. The parameter should
be a function (defined in the consuming eclass or ebuild) which takes
an individual localization as (last) parameter.
Example: l10n_for_each_locale_do install_locale
Complementary to l10n_for_each_locale_do, this function will process
locales that are disabled. This could be used for example to remove
locales from a Makefile, to prevent them from being built needlessly.
l10n_find_plocales_changes <translations dir> <filename pre pattern> <filename post pattern>
Ebuild maintenance helper function to find changes in package offered
locales when doing a version bump. This could be added for example to
Determine which LINGUAS the user has enabled that are offered by the
package, as listed in PLOCALES, and return them. In case no locales
are selected, fall back on PLOCALE_BACKUP. When the disabled argument
is given, return the disabled locales instead of the enabled ones.
Variable listing the locales for which localizations are offered by
Example: PLOCALES="cy de el_GR en_US pt_BR vi zh_CN"
In some cases the package fails when none of the offered PLOCALES are
selected by the user. In that case this variable should be set to a
default locale (usually 'en' or 'en_US') as backup.