Changeset 1707b87

Timestamp:

03/29/2006 08:35:47 PM (18 years ago)

Author:

Ken Moffat <ken@…>

Children:

3dc2cf3

Parents:

01486e4

Message:

Upgrade shadow to 4.0.15 with its UTF-8 man pages.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/udev_update/BOOK@7469 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Files:

• chapter01/changelog.xml (modified) (1 diff)
• chapter03/packages.xml (modified) (1 diff)
• chapter06/man-db.xml (modified) (5 diffs)
• chapter06/shadow.xml (modified) (2 diffs)
• general.ent (modified) (1 diff)

chapter01/changelog.xml

@@ -36 +36 @@
     </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>

chapter03/packages.xml

@@ -371 +371 @@
 
     <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>

chapter06/man-db.xml

@@ -26 +26 @@
 
       <seglistitem>
-        <seg>0.1 SBU</seg>
-        <seg>1.1 MB</seg>
+        <seg>0.2 SBU</seg>
+        <seg>9.0 MB</seg>
       </seglistitem>
     </segmentedlist>
@@ -117 +117 @@
 <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 &gt;&gt;convert-mans &lt;&lt;"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
@@ -275 +299 @@
     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 &amp;&amp;
-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 &amp;&amp;
-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>
@@ -302 +324 @@
 
       <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>
@@ -345 +367 @@
       </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>

chapter06/shadow.xml

@@ -26 +26 @@
 
       <seglistitem>
-        <seg>0.4 SBU</seg>
-        <seg>14.7 MB</seg>
+        <seg>0.3 SBU</seg>
+        <seg>18.6 MB</seg>
       </seglistitem>
     </segmentedlist>
@@ -81 +81 @@
 
 <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>

general.ent

@@ -76 +76 @@
 <!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">