From owner-freebsd-doc  Tue Oct  6 12:02:04 1998
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Received: (from majordom@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id MAA19658
          for freebsd-doc-outgoing; Tue, 6 Oct 1998 12:02:04 -0700 (PDT)
          (envelope-from owner-freebsd-doc@FreeBSD.ORG)
Received: from pluto.plutotech.com (mail.plutotech.com [206.168.67.137])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id MAA19610
          for <freebsd-doc@FreeBSD.ORG>; Tue, 6 Oct 1998 12:01:46 -0700 (PDT)
          (envelope-from kelly@plutotech.com)
Received: from plutotech.com (tampopo.plutotech.com [206.168.67.161])
	by pluto.plutotech.com (8.8.7/8.8.5) with ESMTP id NAA21564;
	Tue, 6 Oct 1998 13:01:29 -0600 (MDT)
Message-ID: <361A6908.D4200B63@plutotech.com>
Date: Tue, 06 Oct 1998 13:01:28 -0600
From: Sean Kelly <kelly@plutotech.com>
Organization: Pluto Technologies
X-Mailer: Mozilla 4.04 [en] (X11; I; FreeBSD 3.0-CURRENT i386)
MIME-Version: 1.0
To: Jim Dutton <jimd@dutton3.it.siu.edu>
CC: freebsd-doc@FreeBSD.ORG
Subject: Re: New Handbook section suggestion: Advanced Printing - Print Server
References: <199809042245.RAA24130@dutton3.it.siu.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Jim Dutton wrote:
> It would be in a new section that explicitly states "print server" and
> would (eventually) refer to all of the other pertinent sections.

Whew!  I'm finally getting around to reviewing this!  (It's been a
*terrible* month.)  Feel free to heed or ignore as much of this as you
wish:

The introductory paragraph is pretty good.  I think I'd add an
additional paragraph or two with headings that answer direct questions
so the reader can know right away if s/he needs to delve any further,
plus a paragraph giving an outline of what's to follow is nice:

	Introduction
		<your current paragraph>
		Do I Need a Print Server?
			<paragraph describing situations in which one's useful>
			<plus material from your current introduction>
		What's In This Chapter
			<bullet list of major subheadings>

Next, you might want to create a new section that separates out
installation issues (how much disk space to allocate) from the print
server proper issues (how to set up /etc/printcap).  For example, your
headings might go:

	Disk Space Considerations
	Location of the Print Server
		On a FreeBSD host
		In a LPD-capable network printer
		...
	Print Server Deployment
		Store-and-forward
			...
		Filtering
			...
	Examples
		...

The rest of the body text is nicely explanatory.  I wouldn't change a
thing except to change passive to active voice (replace "a2ps was used
to convert..." to "Here, we use a2ps to convert the ...")

In the example section, I particulary liked the diagrams that show the
flow of the print job from user workstation eventually to printer---a
nice touch.  It shows a novice user what's going on, but also lets an
advanced user say, "There's the configuration I want, so I'll just
modify this example."  Good stuff.

Are you ready to create an SGML version of this text?

Take care.
--Sean

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message