Date: Wed, 25 Sep 2002 15:20:08 -0700 (PDT) From: swear@attbi.com (Gary W. Swearingen) To: freebsd-doc@FreeBSD.org Subject: Re: docs/43364: Man page for hier(7) doesn' have /var/empty Message-ID: <200209252220.g8PMK8Wf049261@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
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" <sluggo@unknown.nu> Cc: <FreeBSD-gnats-submit@FreeBSD.org> Subject: Re: docs/43364: Man page for hier(7) doesn' have /var/empty Date: 25 Sep 2002 15:20:32 -0700 "Kim Scarborough" <sluggo@unknown.nu> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200209252220.g8PMK8Wf049261>