[Mageia-dev] Need for a clear policy on translated man pages

[Kamil Rytarowski]

Hello!

Please make it clear, at least for newcomers, how to package translated 
man pages in Mageia. Our policies and guidelines aren't clear.

https://wiki.mageia.org/en/Packaging_guidelines#Handling_Locale_Files 
suggested, before the latest changes, with  "If the package includes 
translations, add  BuildRequires: gettext If you don't, your package 
could fail to generate translation files in the buildroot." that this 
section is also about man pages. Translated man pages are 
_translations_, aren't they?

In the "Packaging localisation policy" it's more clear. But still 
expressions like "some cases" aren't clear. I wouldn't say that *all* 
man pages are counted as "some [special] case". Aren't I right?

Is it possible to handle multiple man pages in different languages with 
some macro? At times it's bit complicated, for example for amule it's 
done like this:

%lang(de) %{_mandir}/de/man1/alc.1*
%lang(es) %{_mandir}/es/man1/alc.1*
%lang(hu) %{_mandir}/hu/man1/alc.1*
%lang(de) %{_mandir}/de/man1/amule.1*
%lang(it) %{_mandir}/it/man1/amule.1*
%lang(de) %{_mandir}/de/man1/amulegui.1*
%lang(it) %{_mandir}/it/man1/amulegui.1*
%lang(de) %{_mandir}/de/man1/cas.1*
%lang(de) %{_mandir}/de/man1/ed2k.1*
%lang(de) %{_mandir}/de/man1/wxcas.1*
%lang(de) %{_mandir}/de/man1/xas.1*
%lang(es) %{_mandir}/es/man1/amule.1*
%lang(es) %{_mandir}/es/man1/amulegui.1*
%lang(es) %{_mandir}/es/man1/cas.1*
%lang(es) %{_mandir}/es/man1/ed2k.1*
%lang(es) %{_mandir}/es/man1/wxcas.1*
%lang(es) %{_mandir}/es/man1/xas.1*
%lang(fr) %{_mandir}/fr/man1/alc.1*
%lang(fr) %{_mandir}/fr/man1/amule.1*
%lang(fr) %{_mandir}/fr/man1/ed2k.1*
%lang(fr) %{_mandir}/fr/man1/cas.1*
%lang(fr) %{_mandir}/fr/man1/xas.1*
%lang(fr) %{_mandir}/fr/man1/amulegui.1*
%lang(fr) %{_mandir}/fr/man1/wxcas.1*
%lang(hu) %{_mandir}/hu/man1/amule.1*
%lang(hu) %{_mandir}/hu/man1/cas.1*
%lang(hu) %{_mandir}/hu/man1/ed2k.1*
%lang(it) %{_mandir}/it/man1/ed2k.1*
%lang(it) %{_mandir}/it/man1/alc.1*
%lang(it) %{_mandir}/it/man1/cas.1*
%lang(it) %{_mandir}/it/man1/wxcas.1*
%lang(it) %{_mandir}/it/man1/xas.1*
%lang(hu) %{_mandir}/hu/man1/amulegui.1*
%lang(hu) %{_mandir}/hu/man1/wxcas.1*
%lang(hu) %{_mandir}/hu/man1/xas.1*
%lang(ru) %{_mandir}/ru/man1/alc.1*
%lang(ru) %{_mandir}/ru/man1/amule.1*
%lang(ru) %{_mandir}/ru/man1/amulegui.1*
%lang(ru) %{_mandir}/ru/man1/cas.1*
%lang(ru) %{_mandir}/ru/man1/ed2k.1*
%lang(ru) %{_mandir}/ru/man1/wxcas.1*
%lang(ru) %{_mandir}/ru/man1/xas.1*
%lang(de) %{_mandir}/de/man1/alcc.1*
%lang(es) %{_mandir}/es/man1/alcc.1*
%lang(fr) %{_mandir}/fr/man1/alcc.1*
%lang(it) %{_mandir}/it/man1/alcc.1*
%lang(ru) %{_mandir}/ru/man1/alcc.1*
%lang(hu) %{_mandir}/hu/man1/alcc.1*
%lang(de) %{_mandir}/de/man1/amulecmd.1*
%lang(es) %{_mandir}/es/man1/amulecmd.1*
%lang(fr) %{_mandir}/fr/man1/amulecmd.1*
%lang(hu) %{_mandir}/hu/man1/amulecmd.1*
%lang(it) %{_mandir}/it/man1/amulecmd.1*
%lang(ru) %{_mandir}/ru/man1/amulecmd.1*
%lang(de) %{_mandir}/de/man1/amuled.1*
%lang(es) %{_mandir}/es/man1/amuled.1*
%lang(fr) %{_mandir}/fr/man1/amuled.1*
%lang(hu) %{_mandir}/hu/man1/amuled.1*
%lang(it) %{_mandir}/it/man1/amuled.1*
%lang(ru) %{_mandir}/ru/man1/amuled.1*
%lang(de) %{_mandir}/de/man1/amuleweb.1*
%lang(es) %{_mandir}/es/man1/amuleweb.1*
%lang(fr) %{_mandir}/fr/man1/amuleweb.1*
%lang(hu) %{_mandir}/hu/man1/amuleweb.1*
%lang(it) %{_mandir}/it/man1/amuleweb.1*
%lang(ru) %{_mandir}/ru/man1/amuleweb.1*

PS. The policy suggest to follow numlock.spec and in the file we read in 
the 1st like as follows "# !!!!!!!! WARNING THIS HAS TO BE EDITED IN THE 
SVN !!!!!!!!!!!" - is this a provocation? The file was untouched for 10 
months :)