From owner-freebsd-doc@FreeBSD.ORG  Fri Apr  4 22:16:51 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 436A9CD8;
 Fri,  4 Apr 2014 22:16:51 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id EBFC59CA;
 Fri,  4 Apr 2014 22:16:50 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.8/8.14.8) with ESMTP id s34MGm2A040774
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Fri, 4 Apr 2014 16:16:49 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.8/8.14.8/Submit) with ESMTP id s34MGm6W040771;
 Fri, 4 Apr 2014 16:16:48 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Fri, 4 Apr 2014 16:16:48 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: freebsd-doc@FreeBSD.org
Subject: Rewrite of the Handbook Printing chapter
Message-ID: <alpine.BSF.2.00.1404041538360.39747@wonkity.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Fri, 04 Apr 2014 16:16:49 -0600 (MDT)
Cc: wblock@FreeBSD.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 04 Apr 2014 22:16:51 -0000

The existing Handbook printing chapter has many weaknesses:
   It does not cover simple setup well.
   It does not cover current devices well.
   It uses some confusing terminology and shows examples for uncommon
   situations.

I've complained about these problems before, but a few months ago, Dru 
asked me to do something about it.

This is a from-scratch rewrite, attempting to address the major problems 
of the old version.

http://www.wonkity.com/~wblock/printing/printing.html
http://www.wonkity.com/~wblock/printing/printing-connections.html
http://www.wonkity.com/~wblock/printing/printing-pdls.html
http://www.wonkity.com/~wblock/printing/printing-direct.html
http://www.wonkity.com/~wblock/printing/printing-lpd.html
http://www.wonkity.com/~wblock/printing/printing-other.html

It adds a quick-start section, simplifies setup, vastly reduces the 
section on shared printers in schools and businesses, and provides a 
framework that allows the addition of other printing systems.  The first 
candidate for that would be CUPS.

Initial responses have been good.  If there are no showstopper 
complaints, I plan to commit this in the next week.

Feedback and testing welcome.  Thanks!