From owner-freebsd-doc Wed Sep 25 15:20: 9 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 783D837B406 for ; Wed, 25 Sep 2002 15:20:08 -0700 (PDT) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3546C43E4A for ; Wed, 25 Sep 2002 15:20:08 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id g8PMK8Co049262 for ; Wed, 25 Sep 2002 15:20:08 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id g8PMK8Wf049261; Wed, 25 Sep 2002 15:20:08 -0700 (PDT) Date: Wed, 25 Sep 2002 15:20:08 -0700 (PDT) Message-Id: <200209252220.g8PMK8Wf049261@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: swear@attbi.com (Gary W. Swearingen) Subject: Re: docs/43364: Man page for hier(7) doesn' have /var/empty Reply-To: swear@attbi.com (Gary W. Swearingen) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/43364; it has been noted by GNATS. From: swear@attbi.com (Gary W. Swearingen) To: "Kim Scarborough" Cc: Subject: Re: docs/43364: Man page for hier(7) doesn' have /var/empty Date: 25 Sep 2002 15:20:32 -0700 "Kim Scarborough" writes: > > That huge manual doesn't need the extra words "for privilege separation" > > which will make sense to few and which those who "see sshd(8)" will find > > used there (as if it'll be of any real help to them). > > Heh, as opposed to user-friendly terms such as "POSIX real-time extensions > includes" or "genclass prototype/template class files", I suppose. If the 15 > bytes saved by the deletion of those three words is really that important, > then yeah, take it out; otherwise, I think it should follow the format of just > about every other cross-referenced listing in there and have a brief > explanation of its function. It's not about saving 15 bytes. It's about saving people from having to think about an explanation which explains nothing. It's just noise. Following the bad example of some other entries of the manual only makes a poor manual worse. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message