r7370 - in trunk/BOOK: basicnet/textweb general/genutils multimedia/libdriv postlfs/config postlfs/editors pst/printing pst/ps xsoft/suites

randy at linuxfromscratch.org randy at linuxfromscratch.org
Wed Apr 9 08:40:36 PDT 2008


Author: randy
Date: 2008-04-09 09:40:36 -0600 (Wed, 09 Apr 2008)
New Revision: 7370

Modified:
   trunk/BOOK/basicnet/textweb/links.xml
   trunk/BOOK/basicnet/textweb/lynx.xml
   trunk/BOOK/general/genutils/gperf.xml
   trunk/BOOK/multimedia/libdriv/xine-lib.xml
   trunk/BOOK/postlfs/config/autofs.xml
   trunk/BOOK/postlfs/editors/bluefish.xml
   trunk/BOOK/postlfs/editors/vim.xml
   trunk/BOOK/pst/printing/cups.xml
   trunk/BOOK/pst/ps/a2ps.xml
   trunk/BOOK/xsoft/suites/openoffice.xml
Log:
Fixed typos and minor rewording in various package instructions

Modified: trunk/BOOK/basicnet/textweb/links.xml
===================================================================
--- trunk/BOOK/basicnet/textweb/links.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/basicnet/textweb/links.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -5,7 +5,7 @@
   %general-entities;
 
   <!ENTITY links-download-http "http://links.twibright.com/download/links-&Links-version;.tar.bz2">
-  <!ENTITY links-download-ftp  " ">
+  <!ENTITY links-download-ftp  "&gentoo-ftp-repo;/links-&Links-version;.tar.bz2">
   <!ENTITY links-md5sum        "8c4bc1ebbf4962d290df8218bfc21413">
   <!ENTITY links-size          "4.1 MB">
   <!ENTITY links-buildsize     "25 MB">
@@ -102,24 +102,28 @@
     <bridgehead renderas="sect3">Links Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Recommended</bridgehead>
-    <para role="recommended"><xref linkend="gpm"/>, and
-    <xref linkend="openssl"/>.</para>
+    <para role="recommended"><xref linkend="gpm"/> (if mouse support is
+    desired) and 
+    <xref linkend="openssl"/></para>
     <!-- pcre was used in previous versions only, for javascript
     <xref linkend="pcre"/>
     -->
-   <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional">Support of graphical mode requires at least one of
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">Support for graphical mode requires at least one of
     <xref linkend="gpm"/> (to be used with a framebuffer-based console),
     <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
     <!-- SDL support is removed upstream until someone fixes it
     <xref linkend="sdl"/>,
     -->
     <ulink url="http://www.directfb.org/">DirectFB</ulink>, and
-    <xref linkend="x-window-system"/>. For decoding various image formats,
-    <application>Links</application> can utilize
+    <xref linkend="x-window-system"/></para>
+
+    <para>For decoding various image formats <application>Links</application>
+    can utilize
     <xref linkend="libpng"/>,
     <xref linkend="libjpeg"/>, and
-    <xref linkend="libtiff"/>.</para>
+    <xref linkend="libtiff"/></para>
 
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/LinksBrowser"/></para>
@@ -134,8 +138,7 @@
 <screen><userinput>bzcat ../links-&Links-version;-utf8.diff.bz2 | patch -p1 &&
 cd intl &&
 ./gen-intl && ./synclang &&
-cd ..
-</userinput></screen>
+cd ..</userinput></screen>
    
    <para>Install <application>Links</application> by running the following
     commands:</para>

Modified: trunk/BOOK/basicnet/textweb/lynx.xml
===================================================================
--- trunk/BOOK/basicnet/textweb/lynx.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/basicnet/textweb/lynx.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -128,10 +128,10 @@
     <para><parameter>--enable-locale-charset</parameter>: This switch allows
     <application>Lynx</application> to deduce the proper character encoding
     for terminal output from the current locale.
-    A configuration step is still needed (see below), but,
+    A configuration step is still needed (see below), but
     unlike the situation without this switch, the configuration step becomes
-    the same for all users (without the switch, one would have to specify the
-    display charcter set explicitly). This is important for environments such
+    the same for all users (without the switch one must specify the
+    display character set explicitly). This is important for environments such
     as a LiveCD, where the amount of system-specific configuration steps has
     to be reduced to the minimum.</para>
 
@@ -152,9 +152,7 @@
     <para><command>chgrp -v -R root
     /usr/share/doc/lynx-&lynx-version;/lynx_doc</command>:
     This command corrects the improper group ownership of installed
-    documentation files caused if <application>Lynx</application> is built
-    by any user other than
-    <systemitem class="username">root</systemitem>.</para>
+    documentation files.</para>
 
     <!-- This was fixed in the 2.8.6 release, though it still could
          be considered an issue by some

Modified: trunk/BOOK/general/genutils/gperf.xml
===================================================================
--- trunk/BOOK/general/genutils/gperf.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/general/genutils/gperf.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -4,27 +4,15 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-    <!-- Inserted as a reminder to do this. The mention of a test suite
-         is usually right before the root user installation commands. Please
-         delete these 12 (including one blank) lines after you are done.-->
-
-    <!-- Use one of the two mentions below about a test suite,
-         delete the line that is not applicable. Of course, if the
-         test suite uses syntax other than "make check", revise the
-         line to reflect the actual syntax to run the test suite -->
-
-    <!-- <para>This package does not come with a test suite.</para> -->
-    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
-
   <!ENTITY gperf-download-http "http://ftp.gnu.org/gnu/gperf/gperf-&gperf-version;.tar.gz">
-  <!ENTITY gperf-download-ftp "ftp://ftp.gnu.org/gnu/gperf/gperf-&gperf-version;.tar.gz">
-  <!ENTITY gperf-md5sum "cc20e58975a38075440423c8fb85fd00">
-  <!ENTITY gperf-size "866 KB">
-  <!ENTITY gperf-buildsize "4 MB">
-  <!ENTITY gperf-time "less than 0.1 SBU">
+  <!ENTITY gperf-download-ftp  "ftp://ftp.gnu.org/gnu/gperf/gperf-&gperf-version;.tar.gz">
+  <!ENTITY gperf-md5sum        "cc20e58975a38075440423c8fb85fd00">
+  <!ENTITY gperf-size          "866 KB">
+  <!ENTITY gperf-buildsize     "4 MB">
+  <!ENTITY gperf-time          "less than 0.1 SBU">
 ]>
 
-<sect1 id="gperf" xreflabel="gperf-&gperf-version;">
+<sect1 id="gperf" xreflabel="Gperf-&gperf-version;">
   <?dbhtml filename="gperf.html"?>
 
   <sect1info>
@@ -41,7 +29,8 @@
   <sect2 role="package">
     <title>Introduction to Gperf</title>
 
-    <para><application>Gperf</application> generates a perfect hash function from a key set.</para>
+    <para><application>Gperf</application> generates a perfect hash function
+    from a key set.</para>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
@@ -73,22 +62,37 @@
   <sect2 role="installation">
     <title>Installation of Gperf</title>
 
-    <para>Install <application>gperf</application> by running the following commands:</para>
+    <para>Install <application>Gperf</application> by running the following
+    commands:</para>
 
 <screen><userinput>./configure --prefix=/usr &&
 make</userinput></screen>
 
-    <para>This package does not come with a test suite.</para>
+    <para>If desired, create a text version of the documentation by issuing
+    the following command:</para>
 
+<screen><userinput>makeinfo -o doc/gperf.txt --plaintext doc/gperf.texi</userinput></screen>
+
+    <para>To test the results, issue <command>make check</command>. There
+    should be no output from the <command>diff</command> commands.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install &&
-makeinfo -o doc/gperf.txt --plaintext doc/gperf.texi &&
 install -v -m755 -d /usr/share/doc/gperf-&gperf-version; &&
 install -m644 -v doc/gperf.{dvi,ps,pdf,txt} /usr/share/doc/gperf-&gperf-version;</userinput></screen>
 
   </sect2>
 
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><command>install -m644 -v doc/gperf.{dvi,ps,pdf,txt} ...</command>:
+    This command installs documentation. Modify the command (remove ',txt') if
+    you did not build the text version.</para>
+
+  </sect2>
+
   <sect2 role="content">
     <title>Contents</title>
 
@@ -112,9 +116,9 @@
       <varlistentry id="gperf-prog">
         <term><command>gperf</command></term>
         <listitem>
-          <para> generates a perfect hash function from a key set.</para>
+          <para>generates a perfect hash function from a key set.</para>
           <indexterm zone="gperf gperf-prog">
-            <primary sortas="g-gperf">bc</primary>
+            <primary sortas="g-gperf">gperf</primary>
           </indexterm>
         </listitem>
       </varlistentry>
@@ -124,4 +128,3 @@
   </sect2>
 
 </sect1>
-

Modified: trunk/BOOK/multimedia/libdriv/xine-lib.xml
===================================================================
--- trunk/BOOK/multimedia/libdriv/xine-lib.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/multimedia/libdriv/xine-lib.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -5,8 +5,7 @@
   %general-entities;
 
   <!ENTITY xine-lib-download-http "http://downloads.sourceforge.net/xine/xine-lib-&xine-lib-version;.tar.bz2">
-  <!-- reinstate this if/when this version hits gentoo repos
-  <!ENTITY xine-lib-download-ftp  "&gentoo-ftp-repo;/xine-lib-&xine-lib-version;.tar.bz2">-->
+  <!ENTITY xine-lib-download-ftp  "&gentoo-ftp-repo;/xine-lib-&xine-lib-version;.tar.bz2">
   <!ENTITY xine-lib-md5sum        "7164410b533b35c0717a819bf251762e">
   <!ENTITY xine-lib-size          "7.1 MB">
   <!ENTITY xine-lib-buildsize     "241 MB">
@@ -40,9 +39,9 @@
       <listitem>
         <para>Download (HTTP): <ulink url="&xine-lib-download-http;"/></para>
       </listitem>
-      <!--<listitem>
+      <listitem>
         <para>Download (FTP): <ulink url="&xine-lib-download-ftp;"/></para>
-      </listitem>-->
+      </listitem>
       <listitem>
         <para>Download MD5 sum: &xine-lib-md5sum;</para>
       </listitem>

Modified: trunk/BOOK/postlfs/config/autofs.xml
===================================================================
--- trunk/BOOK/postlfs/config/autofs.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/postlfs/config/autofs.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -5,14 +5,14 @@
   %general-entities;
   <!ENTITY autofs-patch-dir     "http://ftp.kernel.org/pub/linux/daemons/autofs/v5">
   <!ENTITY autofs-download-http "http://ftp.kernel.org/pub/linux/daemons/autofs/v5/autofs-&autofs-version;.tar.bz2">
-  <!ENTITY autofs-download-ftp "ftp://ftp.kernel.org/pub/linux/daemons/autofs/v5/autofs-&autofs-version;.tar.bz2">
+  <!ENTITY autofs-download-ftp  "ftp://ftp.kernel.org/pub/linux/daemons/autofs/v5/autofs-&autofs-version;.tar.bz2">
   <!ENTITY autofs-md5sum        "27839fe6fa8105b2b7d31bc922fd7cf6">
   <!ENTITY autofs-size          "221 KB">
-  <!ENTITY autofs-buildsize     "8.9 MB">
+  <!ENTITY autofs-buildsize     "9 MB">
   <!ENTITY autofs-time          "less than 0.1 SBU">
 ]>
 
-<sect1 id="autofs" xreflabel="autofs-&autofs-version;">
+<sect1 id="autofs" xreflabel="Autofs-&autofs-version;">
   <?dbhtml filename="autofs.html"?>
 
   <sect1info>
@@ -29,10 +29,10 @@
   <sect2 role="package">
     <title>Introduction to Autofs</title>
 
-    <para>The <application>autofs</application> package contains userspace
+    <para>The <application>Autofs</application> package contains userspace
     tools that work with the kernel to mount and un-mount removable file
     systems. The primary use is to mount external network file systems like
-    nfs (see <xref linkend="nfs-utils"/>) or Samba (see <xref linkend="samba3"/>)
+    NFS (see <xref linkend="nfs-utils"/>) or Samba (see <xref linkend="samba3"/>)
     on demand.</para>
     
     <para>It may also be useful for allowing users to mount floppies, cdroms and
@@ -64,12 +64,14 @@
     </itemizedlist>
 
     <bridgehead renderas="sect3">Additional Downloads</bridgehead>
-        <para>Recommended Patches: There are frequent patches issued
-        for <application>autofs</application>.  To get the current patches, 
-        start in the same directory as the main tar file and run:</para>
+
+    <para>Recommended Patches: There are frequent patches issued
+    for <application>Autofs</application>.  To get the current patches, 
+    start in the same directory as the main tar file and run:</para>
         
 <screen><userinput>wget &autofs-patch-dir;/patch_order-&autofs-version; &&
-sed 's;autofs;&autofs-patch-dir;/autofs;' patch_order-&autofs-version; > wget-list &&
+sed 's;autofs;&autofs-patch-dir;/autofs;' \
+    patch_order-&autofs-version; > wget-list &&
 wget -i wget-list</userinput></screen>
     
     <para condition="html" role="usernotes">User Notes:
@@ -101,7 +103,7 @@
 
     <title>Installation of Autofs</title>
 
-    <para>Install <application>autofs</application> by running the following
+    <para>Install <application>Autofs</application> by running the following
     commands:</para>
 
 <screen><userinput>for f in `cat ../patch_order-&autofs-version;`; do 
@@ -123,8 +125,8 @@
     <title>Command Explanations</title>
 
     <para><command>for f in `cat ../patch_order-&autofs-version;`; do
-      patch -Np1 -i ../$f;  done</command>: This command applies all the 
-      patches fetched earlier in the correct order.</para>
+    patch -Np1 -i ../$f;  done</command>: This command applies all the 
+    patches fetched earlier in the correct order.</para>
 
     <para><command>ln -sf  ../init.d/autofs 
     $(EXTDIR)/rc.d/rcsysinit.d/S52autofs</command>: This command sets the 
@@ -166,8 +168,8 @@
 
       <para>The installation process creates <filename>auto.master</filename>,
       <filename>auto.misc</filename>,  <filename>auto.smb</filename>, and
-      <filename>auto.net</filename>. You will replace the
-      <filename>auto.master</filename> with the following commands:</para>
+      <filename>auto.net</filename>. Replace the
+      <filename>auto.master</filename> file with the following commands:</para>
 
 <screen role="root"><userinput>mv /etc/auto.master /etc/auto.master.bak &&
 cat > /etc/auto.master << "EOF"
@@ -187,25 +189,24 @@
 
       <para>that will mount a cdrom as <filename>/media/auto/cd</filename> if
       that directory is accessed.  The <option>--ghost</option> option tells
-      the automounter to create "ghost" versions (i.e. empty directories) of
-      all the mount points listed in the configuration file regardless of
-      whether any of the file systems is actually mounted or not. This is very
-      convenient and highly recommended, because it will show you the available
-      auto-mountable file systems as existing directories, even when their file
-      systems aren't currently mounted. Without the <option>--ghost</option>
-      option, you'll have to remember the names of the directories. As soon as
-      you try to access one of them, the directory will be created and the file
-      system will be mounted. When the file system gets unmounted again, the
-      directory is destroyed too, unless the <option>--ghost</option> option
-      was given.</para>
+      the automounter to create <quote>ghost</quote> versions (i.e. empty
+      directories) of all the mount points listed in the configuration file
+      regardless whether any of the file systems are actually mounted or not.
+      This is very convenient and highly recommended, because it will show you
+      the available auto-mountable file systems as existing directories, even
+      when their file systems aren't currently mounted. Without the
+      <option>--ghost</option> option, you'll have to remember the names of the
+      directories. As soon as you try to access one of them, the directory will
+      be created and the file system will be mounted. When the file system gets
+      unmounted again, the directory is destroyed too, unless the
+      <option>--ghost</option> option was given.</para>
 
       <note>
-
         <para>An alternative method would be to specify another automount
-        location such as <filename>/var/lib/auto/cdrom</filename> and create a
-        symbolic link from <filename>/media/cdrom</filename> to the automount
-        location.</para>
-      
+        location such as <filename
+        class='directory'>/var/lib/auto/cdrom</filename> and create a
+        symbolic link from <filename class='directory'>/media/cdrom</filename>
+        to the automount location.</para>
       </note>
 
       <para>The <filename>auto.misc</filename> file must be configured to your
@@ -225,15 +226,15 @@
       exported via NFS from the system example.org.  NFS shares
       are covered on the next page.</para>
 
-      <para>This package could also be used to mount SMB shares, that feature
-      is not configured in these instructions.  For additional configuration
-      information, see the man pages for auto.master(5).  There
+      <para>This package could also be used to mount SMB shares, however that
+      feature is not configured in these instructions.  For additional
+      configuration information, see the man pages for auto.master(5).  There
       are also web resources such as this <ulink
       url='http://gentoo-wiki.com/HOWTO_Auto_mount_filesystems_(AUTOFS)#Config_files'>AUTOFS 
-      HOWTO</ulink>
-      availble.</para>
+      HOWTO</ulink> available.</para>
 
     </sect3>
+
 <!--
     <sect3  id="autofs-init">
       <title>Boot Script</title>
@@ -257,6 +258,7 @@
 
     </sect3>
 -->
+
   </sect2>
 
   <sect2 role="content">
@@ -299,4 +301,3 @@
   </sect2>
 
 </sect1>
-

Modified: trunk/BOOK/postlfs/editors/bluefish.xml
===================================================================
--- trunk/BOOK/postlfs/editors/bluefish.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/postlfs/editors/bluefish.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -5,15 +5,14 @@
   %general-entities;
 
   <!ENTITY bluefish-download-http "http://www.bennewitz.com/bluefish/stable/source/bluefish-1.0.7.tar.bz2">
-  <!-- <!ENTITY bluefish-download-ftp  "ftp://ftp.ratisbona.com/pub/bluefish/downloads/bluefish-&bluefish-version;.tar.bz2"> -->
-  <!ENTITY bluefish-download-ftp  " ">
+  <!ENTITY bluefish-download-ftp  "&gentoo-ftp-repo;/bluefish-&bluefish-version;.tar.bz2">
   <!ENTITY bluefish-md5sum        "2c3b3c9c8f8e32b9473dfd879f216dea">
-  <!ENTITY bluefish-size          "1.49 MB">
-  <!ENTITY bluefish-buildsize     "18.0 MB">
+  <!ENTITY bluefish-size          "1.4 MB">
+  <!ENTITY bluefish-buildsize     "18 MB">
   <!ENTITY bluefish-time          "0.3 SBU">
 ]>
 
-<sect1 id="bluefish">
+<sect1 id="bluefish" xreflabel="Bluefish-&bluefish-version;">
   <?dbhtml filename="bluefish.html"?>
 
   <sect1info>
@@ -68,7 +67,7 @@
     <xref linkend="aspell"/> (for spellchecking),
     <xref linkend="libgnomeui"/>,
     <xref linkend="gnome-mime-data"/>,
-    <xref linkend="desktop-file-utils"/> and
+    <xref linkend="desktop-file-utils"/>, and
     <xref linkend="shared-mime-info"/></para>
 
     <para condition="html" role="usernotes">User Notes:
@@ -89,8 +88,7 @@
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
-<screen role="root"><userinput>make install
-</userinput></screen>
+<screen role="root"><userinput>make install</userinput></screen>
 
   </sect2>
 

Modified: trunk/BOOK/postlfs/editors/vim.xml
===================================================================
--- trunk/BOOK/postlfs/editors/vim.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/postlfs/editors/vim.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -107,7 +107,7 @@
 
     <note>
       <para>If you recompile <application>Vim</application> to link against
-      <application>X</application>, and your <application>X</application>
+      <application>X</application> and your <application>X</application>
       libraries are not on the root partition, you will no longer have an editor
       for use in emergencies. You may choose to install an additional editor,
       not link <application>Vim</application> against
@@ -160,11 +160,12 @@
     <para>If you wish to update the runtime files, issue the
     following command (requires <xref linkend="rsync"/>):</para>
       
-<screen><userinput>rsync -avzcP --delete --exclude="/dos/" --exclude="/spell/" ftp.nluug.nl::Vim/runtime/ ./runtime/</userinput></screen>
+<screen><userinput>rsync -avzcP --delete --exclude="/dos/" --exclude="/spell/" \
+    ftp.nluug.nl::Vim/runtime/ ./runtime/</userinput></screen>
 
-    <para>To install the runtime files and to regenerate the
-    <filename>tags</filename> file, run as the
-    <systemitem class="username">root</systemitem> user:</para>
+    <para>To install the runtime files and regenerate the
+    <filename>tags</filename> file, as the
+    <systemitem class="username">root</systemitem> user issue:</para>
 
 <screen role="root"><userinput>make -C src installruntime &&
 vim -c ":helptags /usr/share/doc/vim-&vim-version;" -c ":q"</userinput></screen>
@@ -174,9 +175,9 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><command>patch …</command>: These patches are the same as LFS
-    and update the package with upstream patches and ensure the man pages
-    are placed in the proper locations.</para>
+    <para><command>patch …</command>: These patches are the same as the
+    ones used in the LFS build used to update the package with upstream patches
+    and ensure the man pages are placed in the proper locations.</para>
 
     <para><parameter>--with-features=huge</parameter>: This switch enables all
     the additional features available in <application>Vim</application>.</para>

Modified: trunk/BOOK/pst/printing/cups.xml
===================================================================
--- trunk/BOOK/pst/printing/cups.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/pst/printing/cups.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -86,23 +86,13 @@
     <ulink url="ftp://oss.sgi.com/projects/xfs/cmd_tars/">libattr</ulink>),
     <ulink url="http://www.easysw.com/htmldoc/">HTMLDOC</ulink>, and
     <ulink url="http://valgrind.org/">Valgrind</ulink> (optionally used if
-      running the test suites)</para>
+    running the test suites)</para>
 
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/cups"/></para>
 
   </sect2>
 
-  <sect2 role="kernel" id="cups-kernel">
-    <title>Kernel Configuration</title>
-    
-    <para>To use your printer, you will likely need the appropriate drivers
-    enabled in the kernel - for example, "Parallel printer support" if you
-    have a parallel port printer, or "USB Printer support" for a USB
-    printer.</para>
-
-  </sect2>
-
   <sect2 role="installation">
     <title>Installation of CUPS</title>
 
@@ -185,7 +175,17 @@
     but this is considered to be a hack by
     <application>CUPS</application> developers.</para>
 
-    <sect3  id="cups-init">
+    <sect3 role="kernel" id="cups-kernel">
+      <title>Kernel Configuration</title>
+    
+      <para>To use your printer you will likely need the appropriate drivers
+      enabled in the kernel — for example, <quote>Parallel printer
+      support</quote> if you have a parallel port printer, or <quote>USB Printer
+      support</quote> for a USB printer.</para>
+
+    </sect3>
+
+    <sect3 id="cups-init">
       <title>Boot Script</title>
 
       <para>During the installation, <application>CUPS</application> added

Modified: trunk/BOOK/pst/ps/a2ps.xml
===================================================================
--- trunk/BOOK/pst/ps/a2ps.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/pst/ps/a2ps.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -8,8 +8,8 @@
   <!ENTITY a2ps-download-ftp  "ftp://ftp.gnu.org/gnu/a2ps/a2ps-&a2ps-version;.tar.gz">
   <!ENTITY a2ps-md5sum        "781ac3d9b213fa3e1ed0d79f986dc8c7">
   <!ENTITY a2ps-size          "2.6 MB">
-  <!ENTITY a2ps-buildsize     "21.9 MB">
-  <!ENTITY a2ps-time          "0.31 SBU">
+  <!ENTITY a2ps-buildsize     "22 MB">
+  <!ENTITY a2ps-time          "0.3 SBU">
 
   <!ENTITY i18n-fonts-version "0.1">
 ]>
@@ -34,15 +34,15 @@
     <para><application>a2ps</application> is a filter utilized mainly
     in the background and primarily by printing scripts to convert almost
     every input format into PostScript output. The application's name
-    expands appropriately to "all to PostScript".</para>
+    expands appropriately to <quote>all to PostScript</quote>.</para>
     
     <caution>
       <para><application>a2ps</application> cannot convert UTF-8 encoded
       text to PostScript. The issue is discussed in detail in the
       <xref linkend="locale-not-valid-option"/> section of the
       <xref linkend="locale-issues"/> page.
-      The solution is to use <xref linkend="paps"/>, instead of
-      <application>a2ps</application>, for converting
+      The solution is to use <xref linkend="paps"/> instead of
+      <application>a2ps</application> for converting
       UTF-8 encoded text to PostScript.</para>
     </caution>
 
@@ -79,7 +79,8 @@
     <bridgehead renderas="sect3">a2ps Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Recommended</bridgehead>
-    <para role="recommended"><xref linkend="psutils"/>, <xref linkend="cups"/> or <xref linkend="LPRng"/>
+    <para role="recommended"><xref linkend="psutils"/>, and
+    <xref linkend="cups"/> or <xref linkend="LPRng"/>
     (otherwise, <application>a2ps</application> will use the
     <command>cat >/dev/lp0</command> command instead of <command>lpr</command>
     for sending its output to the printer)</para>
@@ -117,16 +118,17 @@
 
     <para>To test the results, issue: <command>make check</command>.
     The <filename>printers.tst</filename> test will fail, as there is no default
-    test printer.  The <filename>styles.tst</filename> may also fail, as the tests report
-    some inconsistencies between the generated postscript and the reference sets.  This is caused
-    by version number differences between the postscript test files and those generated by
-    the tests - these do not affect the operation of the program and can be ignored.</para>
+    test printer.  The <filename>styles.tst</filename> may also fail, as the
+    tests report some inconsistencies between the generated postscript and the
+    reference sets.  This is caused by version number differences between the
+    postscript test files and those generated by the tests — these do not
+    affect the operation of the program and can be ignored.</para>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
-    <para>Install the downloaded i18n-fonts by running the following
+    <para>If desired, install the downloaded i18n-fonts by running the following
     commands as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>tar -xf ../i18n-fonts-&i18n-fonts-version;.tar.gz &&
@@ -142,14 +144,14 @@
     <title>Command Explanations</title>
 
     <para><command>sed -i 's/+0 -1/-k 1,2/' afm/make_fonts_map.sh</command>:
-    The <filename>make_fonts_map.sh</filename> script uses an option that is invalid with the
-    version of sort installed as part of
+    The <filename>make_fonts_map.sh</filename> script uses an option that is
+    invalid with the version of <command>sort</command> installed as part of
     <application>Coreutils-&lfs-coreutils-version;</application>.
     If you are using an older version of <application>Coreutils</application>,
     skip this step.</para>
 
     <para><command>sed -i -e "s|/usr/local/share|/usr/share|" configure</command>:
-    This command modifies the configure script to search for
+    This command modifies the <command>configure</command> script to search for
     <application>Ghostscript</application> fonts at the location where they were
     installed by the BLFS instructions.</para>
 
@@ -163,7 +165,8 @@
     <para><parameter>--with-medium=letter</parameter>: This switch changes the 
     default paper format to US letter. It can either be given here or set 
     in <filename>/etc/a2ps/a2ps-site.cfg</filename> after installation. The
-    default is A4, but there are several other options, in particular: A4dj or letterdj are good 
+    default is A4, but there are several other options, in particular: A4dj or
+    letterdj are good 
     settings for HP Deskjet and other printers that need wider paper-handling 
     margins. See <filename>/etc/a2ps/a2ps.cfg</filename> after installation.</para>
 

Modified: trunk/BOOK/xsoft/suites/openoffice.xml
===================================================================
--- trunk/BOOK/xsoft/suites/openoffice.xml	2008-04-09 12:58:30 UTC (rev 7369)
+++ trunk/BOOK/xsoft/suites/openoffice.xml	2008-04-09 15:40:36 UTC (rev 7370)
@@ -193,8 +193,8 @@
       the <parameter>--enable-*</parameter>, <parameter>--disable-*</parameter>,
       and <parameter>--with-system-*</parameter> parameters.  Additionally, if
       you have installed <application>KDE</application> in the
-      <filename class='directory'>/opt</filename> prefix, and would like to use the
-      <parameter>--enable-kde</parameter> switch, you must set
+      <filename class='directory'>/opt</filename> prefix, and would like to use
+      the <parameter>--enable-kde</parameter> switch, you must set
       <command>KDEDIR=$KDE_PREFIX</command> before running
       <command>configure</command>.</para>
     </note>
@@ -213,8 +213,8 @@
 
 <screen><userinput>patch -Np1 -i ../OOo_&openoffice-version;-use_bin_hsqldb-1.patch &&
 
-sed 's at ..\$/dist\$/configure at uudecode="no" ..\$/dist\$/configure@' \
-    -i berkeleydb/makefile.mk &&
+sed -i 's at ..$/dist$/configure at uudecode="no" &@' \
+    berkeleydb/makefile.mk &&
 
 pushd config_office &&
 ./configure --prefix=/opt/openoffice-&openoffice-version; \
@@ -268,8 +268,9 @@
 
     <para>If you have installed <xref linkend="desktop-file-utils"/>, you
     should copy the <filename class='extension'>*.desktop</filename> files to
-    <filename>/usr/share/applications</filename> using the following
-    commands as the <systemitem class="username">root</systemitem> user:</para>
+    <filename class='directory'>/usr/share/applications</filename> using the
+    following commands as the <systemitem class="username">root</systemitem>
+    user:</para>
 
 <screen role="root"><userinput>install -v -d -m755 /usr/share/applications &&
 pushd /opt/openoffice-&openoffice-version;/share/xdg/ &&




More information about the blfs-book mailing list