Re: Some observations regarding manpage translations
Le 18/04/2022 à 13:17, Helge Kreutzmann a écrit :
Hello fellow manpage translators,
I made some observations when watching the French updates which I
would like to share with you. Please kindly disregard them if they are
obvious, done on purpose or do not apply; I'm not speaking French and
I'm not involved in any discussion regarding French translation, hence
these observations might be totally not applicable.
Thanks for your message, it is useful to see how we can do better
Without further ado:
1. After completing a translation, it is quite helpful to reformat it,
either before committing or in a second commit. This has two
a) If there are any syntax errors, you immediately spot this.
b) Further scripts do not touch the file simply for reformatting,
making the "git diff" better to read.
I apply hooks/pre-commit in my git command. Is this enough?
2. If a translation has been proofread, it is usually quite helpful to
immediately (after reformatting) add it to the compendium
and then update all translations
To be honest I am not completely confortable with compendium stuff, so
ok, I add those 2 commands to my automated committing scripts and we
will see the result. I trust you.
Before committing, "git diff" is quite helpful.
This has two benefits:
a) In many cases, other man page translations (fuzzy strings, missing
strings) are updated as well, easing the work and bringing more
pages over 80% (and thus the translations to users).
b) This is an extra check; in my recent updates I noticed errors
when performing these steps, especially during the final "git diff",
which I corrected, even though I do not speak French.
Could you give an example please? I dont feel good to review again via
git diff before commit but if something was not seen by our review
process, I can try for it to eliminate this kind of typo
3. I'm not sure about your systematics, but I do notice that quite a
few man pages are close to complete or close to reach the 80%
threshhold. Once they are at 80% they are shipped to users. Of
course, sometimes you do not want them to be shipped (unless 100%),
maybe because of problematic strings, so this might be deliberate.
However, when prioritizing, looking at
(and similarly for all other distros like Arch, Fedora, ...) you
can notice that several man pages just lack one or two strings to
reach 80% (and using the compendium, see 2., the number of these
pages maybe reduced even further).
I regularly build all man pages and provide you a list of all pages
between 70%-79% below. In case you would like to receive this list
regularly, I can try to set this up (but the web listing above
should cover this nicely as well).
Many thanks. So far I just go forward following the alphabetic order.
Because I want to avoid the risk of duplicate work with other
translators, without needing to use an ITT message to the list. It would
require a good coordination process. But why not, according to what
4. Check for similar strings or easy unfuzzy after upstream updates.
When looking at French pages, I often noticed that there were quite
a few strings which are trivially to handle. Sometimes upstream
just removed or added spaces after full stops, corrected a link or
a typo ...
Indeed, unfortunately. It completely disappointed me last months to
review man1 due to this. A pain! Thanks to Jean-Pierre who tries to
catch up this.
Another example from today: wget.1.po was checked in today,
unfortunately not completely translated. However, one missing
string was just a typo away from an already translated string and
others were trivially to handle (e.g. version numbers), so I could
almost complete the part of OpenSUES Leap as well, even without
I noticed (and sometimes handled) similiar issues in the past as well,
but doing this more systematically of course requires some time. And
since I don't speak French, I can only perform trivial updates and some
easy fixes (if I knew French), i.e. "low hanging fruits" I have to
What is your approach? Reviewing this manually is really a pain for me.
Any suggestion to reduce the needed work is welcome.
I hope the above might give you some ideas how to improve the quality
and number of translated pages into French; again, if any (or all) of
this is not applicable, please ignore.
Here is the current list (as of this morning) of pages which are close
to reach 80%: