Changeset 5f83175

Timestamp:

10/11/2014 01:52:02 AM (8 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 7.10, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, ken/inkscape-core-mods, krejzi/svn, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226

Children:

bc0ab4c

Parents:

2214b51

Message:

Expand configuration for Cups.
Cleanups and fix typos in boot scripts.

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

Files:

• general.ent (modified) (1 diff)
• introduction/welcome/changelog.xml (modified) (1 diff)
• pst/printing/cups.xml (modified) (10 diffs)

general.ent

@@ -72 +72 @@
 <!-- End LFS versions -->
 
-<!ENTITY blfs-bootscripts-version     "20140919">
+<!ENTITY blfs-bootscripts-version     "20141008">
 <!ENTITY blfs-bootscripts-download    "&downloads-root;/blfs-bootscripts-&blfs-bootscripts-version;.tar.bz2">
 

introduction/welcome/changelog.xml

@@ -49 +49 @@
       <itemizedlist>
         <listitem>
+          <para>[bdubbs] - Expand configuration for Cups.  Fixes 
+          <ulink url="&blfs-ticket-root;5628">#5628</ulink>.</para>
+        </listitem>
+        <listitem>
           <para>[fernando] - Update to Archive-Zip-1.38.  Fixes 
           <ulink url="&blfs-ticket-root;5639">#5639</ulink>.</para>

pst/printing/cups.xml

@@ -72 +72 @@
       </listitem>
     </itemizedlist>
-<!--
-    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
-    <itemizedlist spacing="compact">
-      <listitem>
-        <para>
-          Optional patch:
-          <ulink url="&patch-root;/cups-&cups-version;-content_type-1.patch"/>
-        </para>
-      </listitem>
-    </itemizedlist>-->
 
     <bridgehead renderas="sect3">Cups Dependencies</bridgehead>
@@ -103 +93 @@
       <xref linkend="python2"/>, and
       <xref linkend="xdg-utils"/>
-    </para>
-
-    <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
+     
+    </para>
+
+    <bridgehead renderas="sect4">Required (Postinstall)</bridgehead>
     <para role="required runtime">
       <xref linkend="cups-filters"/>
     </para>
 
+    <bridgehead renderas="sect4">Optional (Postinstall)</bridgehead>
+    <para role="optional runtime">
+      <xref linkend="gutenprint"/> and
+      <ulink url="http://hplipopensource.com/hplip-web/index.html">hplip</ulink> (HP printers)
+    </para>
+      
     <para condition="html" role="usernotes">User Notes:
       <ulink url="&blfs-wiki;/cups"/>
@@ -134 +131 @@
     </para>
 
-<screen>Device Drivers  ---&gt;
+<screen><literal>Device Drivers  ---&gt;
   USB support  ---&gt;
-    OHCI HCD (USB 1.1) support: Y or M
-    UHCI HCD (most Intel and VIA) support: Y or M
-    USB Printer support: Y or M</screen>
+    OHCI HCD (USB 1.1) support: Y or M            [CONFIG_USB_OHCI_HCD]
+    UHCI HCD (most Intel and VIA) support: Y or M [CONFIG_USB_UHCI_HCD]
+    USB Printer support: Y or M                   [CONFIG_USB_PRINTER]</literal></screen>
 
     <para>
@@ -146 +143 @@
 
 <screen><literal>Device Drivers  ---&gt;
-  Parallel port support  ---&gt;
-    PC-style hardware: Y or M
+  Parallel port support  ---&gt;                     [CONFIG_PARPORT]
+    PC-style hardware: Y or M                     [CONFIG_PARPORT_PC]
   Character devices  ---&gt;
-    Parallel printer support: Y or M</literal></screen>
+    Parallel printer support: Y or M              [CONFIG_PRINTER]</literal></screen>
 
     <indexterm zone="cups cups-kernel">
@@ -201 +198 @@
       choice.
     </para>
-<!--
-    <para>
-       If you need to access a remote <application>Cups</application> print
-       server, use the following patch:
-    </para>
-
-<screen><userinput>patch -Np1 -i ../cups-&cups-version;-content_type-1.patch</userinput></screen>-->
 
     <!-- docdir is also document root for cups administration interface, so
@@ -218 +208 @@
 
     <para>
-      Install <application>Cups</application> by running the
-      following commands:
+      Build <application>Cups</application> by running the following commands:
     </para>
 
@@ -244 +233 @@
 
     <para>
-      Now, as the <systemitem class="username">root</systemitem>
-      user:
+      Now, as the <systemitem class="username">root</systemitem> user:
     </para>
 
@@ -353 +341 @@
 
       <para>
+        Normally, printers are set up via a web browser.  The
+        <application>Cups</application> server will normally connect via
+        the url http://localhost:631.  From there printers, print
+        jobs, and the server configuration can be set up and managed.
+        Remote system administration can also be set up.  Configuration
+        can also be done from the command line via the 
+        <command>lpadmin</command>, <command>lpoptions</command>, 
+        and <command>lpstat</command> commands.
+      </para>
+
+      <para>
         Configuration of <application>Cups</application> is dependent on
         the type of printer and can be complex. Generally, PostScript printers
         are easier. For detailed instructions on configuration and use of
         <application>Cups</application>, see <ulink
-        url="http://www.cups.org/documentation.php"/>. The Software
-        Administrators Manual and Software Users Manual are particularly useful.
+        url="http://www.cups.org/documentation.php"/>. 
       </para>
 
@@ -365 +363 @@
         <application>Cups</application>, you need to install <xref
         linkend="gs"/> to convert PostScript to raster images and a driver
-        (e.g., from <xref linkend="gutenprint"/>) to convert the resulting
+        (e.g. from <xref linkend="gutenprint"/>) to convert the resulting
         raster images to a form that the printer understands.  <ulink
         url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>
-        drivers use Ghostscript to convert PostScript to a printable form
-        directly, but this is considered to be a hack by
+        drivers use <xref linkend="gs"/> to convert PostScript to a printable
+        form directly, but this is considered suboptimal by
         <application>Cups</application> developers.
       </para>
@@ -381 +379 @@
         If <application>CUPS</application> has been built with
         <application>Linux PAM</application> support, you need to create a
-        <application>PAM</application> configuration file, to get it working
+        <application>PAM</application> configuration file to get it working
         correctly with BLFS.
       </para>