From owner-cvs-all@FreeBSD.ORG  Sun Jan 25 19:09:48 2004
Return-Path: <owner-cvs-all@FreeBSD.ORG>
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 2CBFC16A4CE; Sun, 25 Jan 2004 19:09:48 -0800 (PST)
Received: from smtp.omnis.com (smtp.omnis.com [216.239.128.26])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id AB08843D2F; Sun, 25 Jan 2004 19:09:46 -0800 (PST)
	(envelope-from wes@softweyr.com)
Received: from softweyr.homeunix.net (66-91-236-204.san.rr.com
	[66.91.236.204])	by smtp-relay.omnis.com (Postfix) with ESMTP
	id 319508836BF; Sun, 25 Jan 2004 19:09:45 -0800 (PST)
From: Wes Peters <wes@softweyr.com>
Organization: Softweyr
To: des@des.no (Dag-Erling =?iso-8859-1?q?Sm=F8rgrav?=),
	Diomidis Spinellis <dds@aueb.gr>
Date: Sun, 25 Jan 2004 19:09:45 -0800
User-Agent: KMail/1.5.4
References: <200401230450.i0N4omSZ049990@repoman.freebsd.org>
	<40123A86.3040102@aueb.gr> <xzp1xppt08v.fsf@dwp.des.no>
In-Reply-To: <xzp1xppt08v.fsf@dwp.des.no>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
Message-Id: <200401251909.45346.wes@softweyr.com>
cc: src-committers@FreeBSD.org
cc: Ruslan Ermilov <ru@FreeBSD.org>
cc: Wes Peters <wes@FreeBSD.org>
cc: cvs-src@FreeBSD.org
cc: Alfred Perlstein <alfred@FreeBSD.org>
cc: cvs-all@FreeBSD.org
Subject: Re: cvs commit: src/usr.bin/fetch fetch.1
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 26 Jan 2004 03:09:48 -0000

On Saturday 24 January 2004 03:06 pm, Dag-Erling Sm=F8rgrav wrote:
> Diomidis Spinellis <dds@aueb.gr> writes:
> > Let us not forget that the Unix manual pages provide reference
> > material; they are not a user guide.  They historically have been
> > terse, to the point, and honest in admitting shortcomings (bugs).
> > While a user might find it helpful to read the environment variable
> > documentation in fetch(1), the correct thing to do in reference
> > material is to document the variables where they are implemented,
> > namely fetch(3), and provide a cross reference.
>
> Yes.  I'd like to see Wes's commit backed out, please.

Roger Wilco.  Is it OK to make a stronger recommendation that the user=20
consult fetch(3) for some rather critical information about how fetch(1)=20
really works?  As it stands, the fetch(1) page really requires reading of=20
fetch(3) as well, which is fine as long as we lead the reader there with=20
a rather blunt instrument.

=2D-=20

        Where am I, and what am I doing in this handbasket?

Wes Peters                                               wes@softweyr.com