#2102: Audit translated manual pages
--------------------------------------------+-------------------------------
Reporter: [EMAIL PROTECTED] | Owner: [email protected]
Type: task | Status: new
Priority: normal | Milestone: 6.2
Component: BOOK | Version: SVN
Severity: normal | Keywords:
--------------------------------------------+-------------------------------
LFS expects that manual pages are in the language-specific (usually 8-bit)
encoding, as specified on
http://www.linuxfromscratch.org/lfs/view/6.2/chapter06/man-db.html.
However, some packages install translated manual pages in UTF-8 encoding
(e.g., Shadow, already dealt with), or manual pages in languages not in
the table. All BLFS packages have to be audited for this, but I can't do
this myself due to high cost of Internet traffic.
Manual pages that are for unsupported countries can be spotted by looking
at subdirectories of /usr/share/man. If they are found, please modify the
book in order to avoid their installation, as they would not be displayed
correctly and would hide the (readable) corresponding English manual page.
Manual pages that are in UTF-8 can be found by running this simple shell
script after installing the package:
{{{
#!/bin/sh
# Begin checkman.sh
# Usage: find /usr/share/man | xargs ./checkman.sh
for a in "$@"
do
# echo "Checking $a..."
# Pure-ASCII manual page (possibly except comments) is OK
grep -v '.\\"' "$a" | iconv -f US-ASCII -t US-ASCII >/dev/null 2>&1 &&
continue
# Non-UTF-8 manual page is OK
iconv -f UTF-8 -t UTF-8 "$a" >/dev/null 2>&1 || continue
# If we got here, we found UTF-8 manual page, bad.
echo "UTF-8 manual page: $a" >&2
done
# End checkman.sh
}}}
If this script finds anything, a separate ticket should be opened with the
subject "Package foo installs UTF-8 manual pages". I will provide
instructions for each of such bugs.
Progress is tracked at [wiki:CheckManualPages]. This ticket should be
closed when all BLFS packages are mentioned there as installing manual
pages correctly.
--
Ticket URL: <http://wiki.linuxfromscratch.org/blfs/ticket/2102>
BLFS Trac <http://wiki.linuxfromscratch.org/blfs>
Beyond Linux From Scratch
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
