id	summary	reporter	owner	description	type	status	priority	milestone	component	version	severity	resolution	keywords	cc
2102	Audit translated manual pages	alexander@…	Randy McMurchy	"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."	defect	closed	normal	6.2.0	BOOK	SVN	medium	fixed