Audit translated manual pages
|Reported by:||Owned by:||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 CheckManualPages. This ticket should be closed when all BLFS packages are mentioned there as installing manual pages correctly.