From owner-cvs-all@FreeBSD.ORG  Sat Jan 24 15:06:55 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 3DC0816A4CE; Sat, 24 Jan 2004 15:06:55 -0800 (PST)
Received: from smtp.des.no (flood.des.no [217.116.83.31])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 46AB643D41; Sat, 24 Jan 2004 15:06:51 -0800 (PST)
	(envelope-from des@des.no)
Received: by smtp.des.no (Pony Express, from userid 666)
	id B5287530A; Sun, 25 Jan 2004 00:06:49 +0100 (CET)
Received: from dwp.des.no (des.no [80.203.228.37])
	by smtp.des.no (Pony Express) with ESMTP
	id 1957D5309; Sun, 25 Jan 2004 00:06:41 +0100 (CET)
Received: by dwp.des.no (Postfix, from userid 2602)
	id B25BB33C9A; Sun, 25 Jan 2004 00:06:40 +0100 (CET)
To: Diomidis Spinellis <dds@aueb.gr>
References: <200401230450.i0N4omSZ049990@repoman.freebsd.org>
	<20040123080657.GC34542@FreeBSD.org.ua>
	<20040123102933.GC53344@elvis.mu.org> <40123A86.3040102@aueb.gr>
From: des@des.no (Dag-Erling =?iso-8859-1?q?Sm=F8rgrav?=)
Date: Sun, 25 Jan 2004 00:06:40 +0100
In-Reply-To: <40123A86.3040102@aueb.gr> (Diomidis Spinellis's message of
 "Sat, 24 Jan 2004 11:27:34 +0200")
Message-ID: <xzp1xppt08v.fsf@dwp.des.no>
User-Agent: Gnus/5.090024 (Oort Gnus v0.24) Emacs/21.3 (berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
X-Spam-Checker-Version: SpamAssassin 2.61 (1.212.2.1-2003-12-09-exp) on 
	flood.des.no
X-Spam-Level: ss
X-Spam-Status: No, hits=2.6 required=5.0 tests=RCVD_IN_DYNABLOCK,
	RCVD_IN_SORBS autolearn=no version=2.61
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: Sat, 24 Jan 2004 23:06:55 -0000

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.

DES
--=20
Dag-Erling Sm=F8rgrav - des@des.no