r7472 - in trunk/BOOK: . chapter01 chapter03 chapter06

ken at linuxfromscratch.org ken at linuxfromscratch.org
Wed Mar 29 13:02:45 PST 2006


Author: ken
Date: 2006-03-29 14:02:45 -0700 (Wed, 29 Mar 2006)
New Revision: 7472

Modified:
   trunk/BOOK/chapter01/changelog.xml
   trunk/BOOK/chapter03/packages.xml
   trunk/BOOK/chapter06/man-db.xml
   trunk/BOOK/chapter06/shadow.xml
   trunk/BOOK/general.ent
Log:
Apply r7469,r7471 from udev_update branch to trunk.

Modified: trunk/BOOK/chapter01/changelog.xml
===================================================================
--- trunk/BOOK/chapter01/changelog.xml	2006-03-29 21:01:17 UTC (rev 7471)
+++ trunk/BOOK/chapter01/changelog.xml	2006-03-29 21:02:45 UTC (rev 7472)
@@ -36,6 +36,17 @@
     </listitem>
 -->
 
+    <listitem>
+      <para>March 29, 2006</para>
+      <itemizedlist>
+        <listitem>
+          <para>[ken] - Upgrade to shadow-4.0.15 and add convert-mans script
+	  to convert its UTF-8 man pages.  Thanks to Alexander and Archaic for
+	  the script and commands.  Fixes tickets #1748 and #1750.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
      <listitem>
        <para>March 22, 2006</para>
        <itemizedlist>

Modified: trunk/BOOK/chapter03/packages.xml
===================================================================
--- trunk/BOOK/chapter03/packages.xml	2006-03-29 21:01:17 UTC (rev 7471)
+++ trunk/BOOK/chapter03/packages.xml	2006-03-29 21:02:45 UTC (rev 7472)
@@ -377,7 +377,7 @@
     </varlistentry>
 
     <varlistentry>
-      <term>Shadow (&shadow-version;) - 1,218 KB:</term>
+      <term>Shadow (&shadow-version;) - 1,265 KB:</term>
       <listitem>
         <para><ulink url="ftp://ftp.pld.org.pl/software/shadow/"/></para>
 

Modified: trunk/BOOK/chapter06/man-db.xml
===================================================================
--- trunk/BOOK/chapter06/man-db.xml	2006-03-29 21:01:17 UTC (rev 7471)
+++ trunk/BOOK/chapter06/man-db.xml	2006-03-29 21:02:45 UTC (rev 7472)
@@ -25,8 +25,8 @@
       <segtitle>&diskspace;</segtitle>
 
       <seglistitem>
-        <seg>0.1 SBU</seg>
-        <seg>1.1 MB</seg>
+        <seg>0.2 SBU</seg>
+        <seg>9.0 MB</seg>
       </seglistitem>
     </segmentedlist>
 
@@ -116,6 +116,30 @@
 
 <screen><userinput>make install</userinput></screen>
 
+    <para>Some packages provide UTF-8 man pages which this version of
+    <command>man</command> is unable to display.  The following script will
+    allow some of these to be converted into the expected encodings shown in
+    the table below. It will not help if you are using a UTF-8 locale.
+    Because this script  is intended for limited use during the system build,
+    for public data, we will not bother with error checking, nor use a
+    non-predictable temporary file name.</para>
+
+<screen><userinput>cat >>convert-mans <<"EOF"
+<literal>#!/bin/sh -e
+FROM="$1"
+TO="$2"
+shift ; shift
+while [ $# -gt 0 ]
+do
+        FILE="$1"
+        shift
+        iconv -f "$FROM" -t "$TO" "$FILE" >.tmp.iconv
+        mv .tmp.iconv "$FILE"
+done
+</literal>
+EOF
+install -m755 convert-mans  /usr/bin</userinput></screen>
+
     <para>Additional information regarding the compression of
     man and info pages can be found in the BLFS book at
     <ulink url="&blfs-root;view/cvs/postlfs/compressdoc.html"/>.</para>
@@ -274,16 +298,14 @@
     <para>If upstream distributes manual pages in UTF-8 (i.e., <quote>for
     RedHat</quote>) instead of the encoding listed in the table above, they
     have to be converted from UTF-8 to the encoding listed in the table before
-    installation. E.g., Spanish manual pages (<ulink
-    url="http://ditec.um.es/~piernas/manpages-es/man-pages-es-1.55.tar.bz2"/>)
+    installation. This can be achieved with convert-mans, e.g., Spanish manual
+    pages (<ulink url="http://ditec.um.es/~piernas/manpages-es/man-pages-es-1.55.tar.bz2"/>)
     can be installed with the following commands:</para>
 
-<screen role="nodump"><userinput>mkdir -p /usr/share/man/es &&
-find man? -type f | grep -v 'man7/iso_8859-7.7' | \
-while read F ; do
-  iconv -f UTF-8 -t ISO-8859-1 $F >tmp ; mv tmp $F
-done &&
-cp -rv man? /usr/share/man/es</userinput></screen>
+<screen role="nodump"><userinput>mv man7/iso_8859-7.7{,X}
+convert-mans UTF-8 ISO-8859-1 man?/*.? 
+mv man7/iso_8859-7.7{X,}
+make install</userinput></screen>
 
     <note>
       <para>The need to exclude the <filename>man7/iso_8859-7.7</filename> file
@@ -301,8 +323,8 @@
       <segtitle>Installed programs</segtitle>
 
       <seglistitem>
-        <seg>accessdb, apropos, catman, lexgrog, man, mandb, manpath,
-        and whatis</seg>
+        <seg>accessdb, apropos, catman, convert-mans,lexgrog, man, mandb,
+        manpath, and whatis</seg>
       </seglistitem>
     </segmentedlist>
 
@@ -344,6 +366,16 @@
         </listitem>
       </varlistentry>
 
+      <varlistentry id="convert-mans">
+        <term><command>convert-mans</command></term>
+        <listitem>
+          <para>Reformat man pages so that Man-DB can display them</para>
+          <indexterm zone="ch-system-man-db convert-mans">
+            <primary sortas="b-convert-mans">convert-mans</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
       <varlistentry id="lexgrog">
         <term><command>lexgrog</command></term>
         <listitem>

Modified: trunk/BOOK/chapter06/shadow.xml
===================================================================
--- trunk/BOOK/chapter06/shadow.xml	2006-03-29 21:01:17 UTC (rev 7471)
+++ trunk/BOOK/chapter06/shadow.xml	2006-03-29 21:02:45 UTC (rev 7472)
@@ -25,8 +25,8 @@
       <segtitle>&diskspace;</segtitle>
 
       <seglistitem>
-        <seg>0.4 SBU</seg>
-        <seg>14.7 MB</seg>
+        <seg>0.3 SBU</seg>
+        <seg>18.6 MB</seg>
       </seglistitem>
     </segmentedlist>
 
@@ -81,6 +81,22 @@
 
 <screen><userinput>sed -i -e 's/ ko//' -e 's/ zh_CN zh_TW//' man/Makefile</userinput></screen>
 
+    <para>Shadow supplies other manual pages in a UTF-8 encoding.  Man-DB
+    can display these in the recommended encodings by using the convert-mans
+    script which we installed.</para>
+
+<screen><userinput> for i in de es fi fr id it pt_BR; do
+    convert-mans UTF-8 ISO-8859-1 man/${i}/*.?
+done
+
+for i in cs hu pl; do
+    convert-mans UTF-8 ISO-8859-2 man/${i}/*.?
+done
+
+convert-mans UTF-8 EUC-JP man/ja/*.?
+convert-mans UTF-8 KOI8-R man/ru/*.?
+convert-mans UTF-8 ISO-8859-9 man/tr/*.?</userinput></screen>
+
     <para>Compile the package:</para>
 
 <screen><userinput>make</userinput></screen>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2006-03-29 21:01:17 UTC (rev 7471)
+++ trunk/BOOK/general.ent	2006-03-29 21:02:45 UTC (rev 7472)
@@ -76,7 +76,7 @@
 <!ENTITY psmisc-version "22.2">
 <!ENTITY readline-version "5.1">
 <!ENTITY sed-version "4.1.5">
-<!ENTITY shadow-version "4.0.14">
+<!ENTITY shadow-version "4.0.15">
 <!ENTITY sysklogd-version "1.4.1">
 <!ENTITY sysvinit-version "2.86">
 <!ENTITY tar-version "1.15.1">




More information about the lfs-book mailing list