Ticket #2120 (closed defect: fixed)

Opened 1 year ago

Last modified 1 month ago

Outdated policy text on Man-DB page

Reported by: alexander@linuxfromscratch.org Assigned to: dj@linuxfromscratch.org
Priority: normal Milestone: 6.4
Component: Book Version: SVN
Severity: normal Keywords:
Cc:

Description

Man-DB page says:

LFS uses the same conventions as Debian. This was chosen because Man-DB does not understand man pages stored in UTF-8. And, for our purposes, Man-DB is preferable to Man as it works without extra configuration in any locale. Lastly, as of now, there is no fully-working implementation of the RedHat convention. RedHat's groff is known to misformat text.

As of Fedora 8, RedHat groff doesn't misformat manual pages, so the last two sentences have at least to be reworded to mention that the situation they describe was in effect when UTF-8 support was first added into LFS, not "as of now". And Fedora's patched man and groff do work (with one issue easily fixable by compiling man with "+lang none") without extra configuration in any locale. Lastly, Man-DB-2.5.0 does understand UTF-8 manual pages (by converting them on the fly to a 8-bit encoding before processing by Groff) if they are placed in a file with a name such as /usr/share/man/ru.UTF-8/man5/manpage.5.

However, implementing RedHat model as in RedHat means:

  • two heavily-patched packages instead of one,
  • converting all manual pages in BLFS to UTF-8 (not a doable task),
  • groff still uses hacks not welcome by upstream,
  • man (non-db) is still dead upstream.

So, until Groff-2.0 comes out, the Debian implementation should stay in LFS, possibly with "convert UTF-8 manual pages to a 8-bit encoding in the table" instruction changed to "place UTF-8 manual pages appropriately" (or present this as an alternative to conversion, which still works).

Change History

10/05/08 14:43:09 changed by bdubbs@linuxfromscratch.org

  • milestone changed from 7.0 to 6.4.

10/06/08 18:21:26 changed by dj@linuxfromscratch.org

See http://linuxfromscratch.org/pipermail/lfs-dev/2008-September/061646.html for even more details from man-db maintainer Colin Watson.

10/06/08 20:09:02 changed by dj@linuxfromscratch.org

Excellent analysis William. Thank you very much for this. The GDBM change will have to wait. While BerkelyDB is overkill for man-db, adding another package to the base is not desirable, but a swap of packages is very desirable. We'll need to see if we can kill arpd in iproute2 again (or if somebody has hacked it up to use GDBM). Perl also will utilize BerkelyDB, but I don't know what it is for, or if GDBM can replace BDB's functionality for Perl.

10/06/08 21:15:29 changed by dj@linuxfromscratch.org

http://linuxfromscratch.org/pipermail/lfs-dev/2005-December/054887.html

Going back to BDB's inclusion, I'm not so sure that GDBM over BerkelyDB is "very desirable," though it is the preferred choice of the man-db developer(s). Perl will use either/or/both. Nothing on arpd.

10/08/08 18:59:51 changed by dj@linuxfromscratch.org

  • owner changed from lfs-book@linuxfromscratch.org to dj@linuxfromscratch.org.
  • status changed from new to assigned.

10/22/08 22:34:35 changed by dj@linuxfromscratch.org

  • status changed from assigned to closed.
  • resolution set to fixed.

Fixed in r8694.

10/23/08 00:45:19 changed by dj@linuxfromscratch.org

  • status changed from closed to reopened.
  • resolution deleted.

Reopening due to continuing review on LFS-Dev.

10/25/08 15:32:00 changed by dj@linuxfromscratch.org

  • status changed from reopened to closed.
  • resolution set to fixed.

Fixed in r8698.