Bug#1034412: release-notes: Information about manpages-l10n for bookworm release notes
On Fri, 28 Apr 2023 16:00:14 +0200 Helge Kreutzmann
<debian@helgefjell.de> wrote:
> > + <title>Greatly expanded translations of man pages</title>
> > + <para>
> > + Thank to many efforts of our translators, the translation of many
> >
> > That feels like one many too many for one sentence.
>
> There are often (but not always) several translators working on many
> translations. So you could remove the first "many".
>
> >
> > + manpages has been greatly expanded (e.g. we have complete
> > translation
> > + of systemd user pages into German now) and various new languages
> > have
> > + been added (Czech, Danish, Greek, Finnish, Indonesian, Macedonian,
> > + Norwegian, Russian, Serbian, Swedish, Ukranian and Vietnamesian).
> >
> > I happen to know that "Norwegian" is ambiguous? There's Bokmål and Nynorsk.
> > I assume the former is meant, maybe "Norwegian (Bokmål)"?
> >
> > My spelling checker also suggests Ukrainian and Vietnamese.
>
> I apologize for the sloppy wording/spelling. Please correct all three.
Shouldn't it include
- what is a 'man' page - i bet many people don't know this nowadays!
- how do i install and use the new translations? (do i choose what
language 'man foo' gives me? is it automatic if my locale is correct?
do i need a new package? - i certainly don't know this bit!)
I also thought
- "new languages" is unclear: does it really mean all those languages
have been added for the first time ever? (seems a bit unlikely to me,
but that';s how i read the diff?)
- too many repetition of "translation" - focus on the benefit to users
(new stuff) not the mechanism of how it was made!
- is "user" needed in the bit about systemd? (i assume not)
- seems odd to put completion of systemd before adding the other
languages (based on my assumption about the number of people likely
benefiting)
- i assume there is no way to count the translations? eg would be very
nice if it said "(x% translated)" after each language
So something like:
<title>Many more man pages have been translated</title>
<para>
Thanks to our translators, documentation in
<command>man</command>-page format is available in many more
languages.
For example, many more <!-- or "for the first time,"? --> man pages
are now available in
Czech, Danish, Greek, Finnish, Indonesian, Macedonian, Norwegian
(Bokmål), Russian, Serbian, Swedish, Ukrainian and Vietnamese,
and all <systemitem role="package">systemd</systemitem> man pages are
now available in German.
</para>
<para>
To ensure the <command>man</command> command shows you documentation
in your language (where possible), install the
<systemitem role="package">manpages</systemitem><!-- is it? -->
package and select your language using
<programlisting>dpkg-reconfigure locales</programlisting>.
</para>
Reply to: