Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 523440 - app-i18n/man-pages-de-1.7 stable request
Summary: app-i18n/man-pages-de-1.7 stable request
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Keywording and Stabilization (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Markus Walter
URL:
Whiteboard:
Keywords: STABLEREQ
Depends on:
Blocks:
 
Reported: 2014-09-22 09:16 UTC by Markus Walter
Modified: 2014-11-30 20:25 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Markus Walter 2014-09-22 09:16:08 UTC
As the subject says, I think it would be a good idea to stabilize a newer version. I tested this on my stable amd64 machine at work and saw no issues. Also the it has seen no bug reports for the required 30 days. The targets would be (as with the current stable version 0.8):

alpha amd64 arm arm64 hppa ia64 m68k ppc ppc64 s390 sh sparc x86

I also think that we should then remove the older versions.

Please note that this is my first stable request, so point out any issues with it.
Comment 1 Bernd Feige 2014-10-12 16:35:35 UTC
Hi Markus,
on my system (up-to-date ~amd64, ie app-i18n/man-pages-de-1.7 installed) with LANG=de_DE.UTF-8, german manpages (Umlauts) were not displayed correctly. I looked into this and found that it's because as of 2012-05-05 (for 0.13, https://alioth.debian.org/scm/browser.php?group_id=100531) the encoding of manpages-de was changed to UTF8. With this encoding, it appears that groff must call preconv, which will do the correct thing. Alas, the default behavior is to not call it. I think that the "nroff" script must be changed to at least pass "-D" to groff. Setting GROFF_ENCODING=utf8, or even to an empty value, also results in the correct behavior. Should a blocker be added to a bug noting this dependency? Otherwise everything fine here.
Regards,
Bernd
Comment 2 Bernd Feige 2014-10-12 18:26:37 UTC
... in addition, it seems that those international man pages installed by any packages need to be recoded to utf8 as well. For example "man man" - /usr/share/man/de/man1/man.1.bz2 from current sys-apps/man-1.6g - is in latin1 encoding. Possibly doman should auto-reencode them? Hardly any man page has an encoding tag in it, which would help as well.
Blocking on each and every package which might still include a non-utf8 manpage will probably last too long, and utf8-encoded manpages appear just the way to go.
Comment 3 Markus Walter 2014-10-14 15:11:02 UTC
(In reply to Bernd Feige from comment #2)
> ... in addition, it seems that those international man pages installed by
> any packages need to be recoded to utf8 as well. For example "man man" -
> /usr/share/man/de/man1/man.1.bz2 from current sys-apps/man-1.6g - is in
> latin1 encoding. Possibly doman should auto-reencode them? Hardly any man
> page has an encoding tag in it, which would help as well.
> Blocking on each and every package which might still include a non-utf8
> manpage will probably last too long, and utf8-encoded manpages appear just
> the way to go.

Hm, I'll have to tinker a bit with it, to see what does the trick. Most probable candidate at first glance is adding an empty GROFF_ENCODING to the env and reencode everything to utf8.
Comment 4 Markus Walter 2014-10-17 09:04:26 UTC
(In reply to Bernd Feige from comment #1)
> Hi Markus,
> on my system (up-to-date ~amd64, ie app-i18n/man-pages-de-1.7 installed)
> with LANG=de_DE.UTF-8, german manpages (Umlauts) were not displayed
> correctly. I looked into this and found that it's because as of 2012-05-05
> (for 0.13, https://alioth.debian.org/scm/browser.php?group_id=100531) the
> encoding of manpages-de was changed to UTF8. With this encoding, it appears
> that groff must call preconv, which will do the correct thing. Alas, the
> default behavior is to not call it. I think that the "nroff" script must be
> changed to at least pass "-D" to groff. Setting GROFF_ENCODING=utf8, or even
> to an empty value, also results in the correct behavior. Should a blocker be
> added to a bug noting this dependency? Otherwise everything fine here.
> Regards,
> Bernd

This is bug #468428. Since sys-apps/man is basically unmaintained upstream so the preferred way to handle this is probably migration to sys-apps/man-db. Since this doesn't work for man-pages-de-0.8 either, this does not seem to be a regression which should block stabilization.
Comment 5 Bernd Feige 2014-10-17 14:58:11 UTC
> This is bug #468428. Since sys-apps/man is basically unmaintained upstream
> so the preferred way to handle this is probably migration to
> sys-apps/man-db. Since this doesn't work for man-pages-de-0.8 either, this
> does not seem to be a regression which should block stabilization.

You're right. Thanks for the link, I did not know that man-db contains a maintained and much superior man replacement. Switched to that and everything works. I think it should be the default then; if not, it should not be too harmful to make 'man' call preconv unconditionally as discussed in that bug.
Regards,
Bernd
Comment 6 Markus Walter 2014-10-18 20:18:46 UTC
Please stabilize -- no blockers.
Comment 7 Jeroen Roovers (RETIRED) gentoo-dev 2014-10-20 22:17:53 UTC
Stable for HPPA.
Comment 8 Markus Meier gentoo-dev 2014-10-22 19:19:18 UTC
arm stable
Comment 9 Agostino Sarubbo gentoo-dev 2014-10-30 14:06:49 UTC
amd64 stable
Comment 10 Agostino Sarubbo gentoo-dev 2014-10-31 15:58:44 UTC
ppc64 stable
Comment 11 Agostino Sarubbo gentoo-dev 2014-11-02 08:53:18 UTC
alpha stable
Comment 12 Agostino Sarubbo gentoo-dev 2014-11-03 09:34:15 UTC
x86 stable
Comment 13 Agostino Sarubbo gentoo-dev 2014-11-10 10:52:06 UTC
ppc stable
Comment 14 Agostino Sarubbo gentoo-dev 2014-11-11 10:45:56 UTC
ia64 stable
Comment 15 Mikle Kolyada (RETIRED) archtester Gentoo Infrastructure gentoo-dev Security 2014-11-22 21:00:50 UTC
sparc stable. All done.
Comment 16 Mikle Kolyada (RETIRED) archtester Gentoo Infrastructure gentoo-dev Security 2014-11-22 21:02:30 UTC
Old versions dropped, as requested.
Comment 17 Ulrich Fieseler 2014-11-30 00:44:36 UTC
How or where am I supposed to set GROFF_ENCODING to work around bug #468428 by making groff call preconv?

Entering (in tcsh)
setenv GROFF_ENCODING
followed by
bzcat /usr/share/man/de/man1/dd.1.bz2 | nroff -mandoc | less
(using the nroff command defined in /etc/man.conf) works, whereas
man dd
after this setting still gives me a messed man page. So, where does man or the nroff or groff it calls get its environment from?

Note that
man man
works for me (the man page source is in ISO encoding and not from man-pages-de), so does
man passwd
(the man page source is not from man-pages-de, either, and uses ASCII command sequences for German umlauts). And the respective bzcat commands similar to the above do so, too.
Comment 18 Markus Walter 2014-11-30 20:25:14 UTC
(In reply to Ulrich Fieseler from comment #17)
> How or where am I supposed to set GROFF_ENCODING to work around bug #468428
> by making groff call preconv?

As mentioned in bug 468428 the internationalisation in sys-apps/man is basically broken and it is pretty unmaintained, so a switch to the maintained sys-apps/man-db seems to be recommendable.

As to the GROFF_ENCODING: I'm a bit quizzed as it doesn't work as described earlier for me in the last try ...