Author: randy
Date: 2007-01-20 12:54:30 -0700 (Sat, 20 Jan 2007)
New Revision: 6437
Modified:
trunk/BOOK/introduction/important/locale-issues.xml
trunk/BOOK/introduction/welcome/changelog.xml
Log:
Added a shell script and additional information about UTF-8 manual pages to the
Locale Related Issues page
Modified: trunk/BOOK/introduction/important/locale-issues.xml
===================================================================
--- trunk/BOOK/introduction/important/locale-issues.xml 2007-01-20 18:29:54 UTC
(rev 6436)
+++ trunk/BOOK/introduction/important/locale-issues.xml 2007-01-20 19:54:30 UTC
(rev 6437)
@@ -259,11 +259,43 @@
url="&lfs-root;/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. Not all BLFS packages
- have been audited for conformance with the requirements put in LFS. If you
- find a manual page installed by any of BLFS packages that is obviously in
- the wrong encoding, please remove or convert it as needed, and report this
- to BLFS team as a bug.</para>
+ have been audited for conformance with the requirements put in LFS (the
+ large majority have been checked, and fixes placed in the book for packages
+ known to install non-conforming manual pages). If you find a manual page
+ installed by any of BLFS packages that is obviously in the wrong encoding,
+ please remove or convert it as needed, and report this to BLFS team as a
+ bug.</para>
+ <para>You can easily check your system for any non-conforming manual pages
+ by copying the following short shell script to some accessible location,
+
+<screen><literal>#!/bin/sh
+# Begin checkman.sh
+# Usage: find /usr/share/man -type f | 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
+</literal></screen>
+
+ and then issuing the following command (modify the command below if the
+ <command>checkman.sh</command> script is not in your <envar>PATH</envar>
+ environment variable):</para>
+
+<screen><userinput>find /usr/share/man -type f | xargs
checkman.sh</userinput></screen>
+
+ <para>Note that if you have manual pages installed in any location other
+ than <filename class='directory'>/usr/share/man</filename> (e.g.,
+ <filename class='directory'>/usr/local/share/man</filename>), you must
+ modify the above command to include this additional location.</para>
+
</sect2>
</sect1>
Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml 2007-01-20 18:29:54 UTC
(rev 6436)
+++ trunk/BOOK/introduction/welcome/changelog.xml 2007-01-20 19:54:30 UTC
(rev 6437)
@@ -45,6 +45,10 @@
<para>January 20th, 2007</para>
<itemizedlist>
<listitem>
+ <para>[randy] - Added a shell script and additional information
+ about UTF-8 manual pages to the Locale Related Issues page.</para>
+ </listitem>
+ <listitem>
<para>[randy] - Moved the CM-Super type1ec.sty file from the
texmf-local directory structure to the texmf structure.</para>
</listitem>
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
