Changeset a45a7bc for introduction/important/locale-issues.xml

Timestamp:

01/20/2007 07:54:30 PM (17 years ago)

Author:

Randy McMurchy <randy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

c60dae5b

Parents:

52fb8cf

Message:

Added a shell script and additional information about UTF-8 manual pages to the Locale Related Issues page

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6437 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• introduction/important/locale-issues.xml (modified) (1 diff)

introduction/important/locale-issues.xml

@@ -260 +260 @@
     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>&amp;1 &amp;&amp; continue
+    # Non-UTF-8 manual page is OK
+    iconv -f UTF-8 -t UTF-8 "$a" >/dev/null 2>&amp;1 || continue
+    # If we got here, we found UTF-8 manual page, bad.
+    echo "UTF-8 manual page: $a" >&amp;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>