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

Sat Dec 10 17:13:40 CET 2011

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 :)
+
+