From owner-freebsd-hackers  Mon Aug 11 17:07:48 1997
Return-Path: <owner-freebsd-hackers>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.5/8.8.5) id RAA09452
          for hackers-outgoing; Mon, 11 Aug 1997 17:07:48 -0700 (PDT)
Received: from phaeton.artisoft.com (phaeton.Artisoft.COM [198.17.250.50])
          by hub.freebsd.org (8.8.5/8.8.5) with SMTP id RAA09447;
          Mon, 11 Aug 1997 17:07:39 -0700 (PDT)
Received: (from terry@localhost) by phaeton.artisoft.com (8.6.11/8.6.9) id RAA22671; Mon, 11 Aug 1997 17:03:49 -0700
From: Terry Lambert <terry@lambert.org>
Message-Id: <199708120003.RAA22671@phaeton.artisoft.com>
Subject: Re: ncr(4) man page update
To: se@FreeBSD.ORG (Stefan Esser)
Date: Mon, 11 Aug 1997 17:03:48 -0700 (MST)
Cc: garbanzo@hooked.net, freebsd-hackers@FreeBSD.ORG, se@FreeBSD.ORG
In-Reply-To: <19970812002212.10899@mi.uni-koeln.de> from "Stefan Esser" at Aug 12, 97 00:22:12 am
X-Mailer: ELM [version 2.4 PL24]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-hackers@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

> You may of course suggest improvements to the man 
> page, but I don't want to add descriptions for the
> more obscure and possibly short lived options that
> you most probably found :)

How about:

1)	Add them to the man page
2)	Note that they are obsoleted and should not be used
3)	Remove them from the man page when (if) they are
	removed from the driver

Documentation should be about what a system is, not about what
it would be if it were idealized...


					Terry Lambert
					terry@lambert.org
---
Any opinions in this posting are my own and not those of my present
or previous employers.