From 104285ddd10c9be8099ddb44db011804036e8340 Mon Sep 17 00:00:00 2001
From: Nik Clayton <nik@FreeBSD.org>
Date: Thu, 2 Aug 2001 02:32:17 +0000
Subject: [PATCH] Revamp the synopsis, and move some of the other text in to
 the top of the introduction.

---
 .../books/handbook/printing/chapter.sgml      | 73 +++++++++++++++++--
 1 file changed, 68 insertions(+), 5 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/printing/chapter.sgml b/en_US.ISO8859-1/books/handbook/printing/chapter.sgml
index 81116cef90..1563e6a2b4 100644
--- a/en_US.ISO8859-1/books/handbook/printing/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/printing/chapter.sgml
@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v 1.41 2001/07/21 09:13:55 murray Exp $
+     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v 1.42 2001/07/25 20:41:28 chern Exp $
 -->
 
 <chapter id="printing">
@@ -15,6 +15,73 @@
     <indexterm><primary>LPD spooling system</primary></indexterm>
     <indexterm><primary>printing</primary></indexterm>
 
+    <para>FreeBSD can be used to print to a wide variety of printers, from the
+      oldest impact printer to the latest laser printers, and everything in
+      between, allowing you to produce high quality printed output from the
+      applications you run.</para>
+
+    <para>FreeBSD can also be configured to act as a print server on a
+      network; in this capacity FreeBSD can receive print jobs from a variety
+      of other computers, including other FreeBSD computers, Windows and MacOS
+      hosts.  FreeBSD will ensure that one job at a time is printed, and can
+      keep statistics on which users and machines are doing the most printing,
+      produce <quote>banner</quote> pages showing who's printout is who's, and
+      more.</para>
+
+    <para>After reading this chapter you will know:</para>
+
+    <itemizedlist>
+      <listitem>
+	<para>How to configure the FreeBSD print spooler</para>
+      </listitem>
+
+      <listitem>
+	<para>How to install print filters, to handle special print jobs
+	  differently, including converting incoming documents to print
+	  formats that your printers understand</para>
+      </listitem>
+
+      <listitem>
+	<para>How to enable header, or banner pages on your printout</para>
+      </listitem>
+
+      <listitem>
+	<para>How to print to printers connected to other computers</para>
+      </listitem>
+
+      <listitem>
+	<para>How to print to printers connected directly to the
+	  network</para>
+      </listitem>
+
+      <listitem>
+	<para>How to control printer restrictions, including limiting the size
+	  of print jobs, and preventing certain users from printing</para>
+      </listitem>
+
+      <listitem>
+	<para>How to keep printer statistics, and account for printer
+	  usage</para>
+      </listitem>
+
+      <listitem>
+	<para>How to troubleshoot printing problems</para>
+      </listitem>
+    </itemizedlist>
+
+    <para>Before reading this chapter you should:</para>
+
+    <itemizedlist>
+      <listitem>
+	<para>Know how to configure and install a new kernel 
+	  (<xref linkend="kernelconfig">)</para>
+      </listitem>
+    </itemizedlist>
+  </sect1>
+
+  <sect1 id="printing-intro-spooler">
+    <title>Introduction</title>
+
     <para>In order to use printers with FreeBSD, you will need to set them
       up to work with the Berkeley line printer spooling system, also
       known as the LPD spooling system.  It is the standard printer
@@ -26,10 +93,6 @@
       system, you may wish to skip to section <link
       linkend="printing-intro-setup">Setting up the spooling
       system</link>.</para>
-  </sect1>
-
-  <sect1 id="printing-intro-spooler">
-    <title>Introduction</title>
 
     <para>LPD controls everything about a host's printers.  It is
       responsible for a number of things:</para>