From owner-freebsd-doc Tue Apr 2 13:26:59 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id E1E2537B417 for ; Tue, 2 Apr 2002 13:26:48 -0800 (PST) Received: from localhost (lcl234.zbzoom.net [208.236.36.234]) by pittgoth.com (8.11.6/8.11.6) with SMTP id g32LQjq00937; Tue, 2 Apr 2002 16:26:45 -0500 (EST) (envelope-from darklogik@pittgoth.com) Date: Tue, 2 Apr 2002 16:34:42 -0500 From: Tom Rhodes To: swear@blarg.net (Gary W. Swearingen) Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/36448: [PATCH] intro(8) Message-Id: <20020402163442.092877c2.darklogik@pittgoth.com> In-Reply-To: References: <200204021100.g32B06W53889@freefall.freebsd.org> X-Mailer: Sylpheed version 0.7.4 (GTK+ 1.2.10; i386-portbld-freebsd4.5) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit 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 On 02 Apr 2002 13:10:48 -0800 swear@blarg.net (Gary W. Swearingen) wrote: > Partially re: ..."such values are not described in the manuals." > > Peter Pentchev writes: > > > You may also want to break the second sentence, 'Its value may > > be..', onto a new line :) Also, 'errors codes' might be better > > as 'error codes' (singular 'error'), and the final 'manuals' > > might be replaced with 'manual pages'. But then, this is just > > MHO :) > > I like the first two changes and "manual pages" is surely OK, but > "manuals" might better be replaced with the sorter "manual" if the > goal is to perpetuate the tradition that there is only one "manual" > with many"manual pages". I think we could reduce the tendency to > use the silly term "man pages" by promoting the use of the cleaner > term "manuals", considering them as elements of a set of manuals, > kind of like the old Great Wall of VAX Manuals. I think we should > live with both concepts while slowly changing the tradition. But > then, this is just MHO :) > > Tom, I think it should be your choice as a meager "payment" for > doing the work. Gary, thank you. I really agree about the standard term for manual pages, and think that tradition should be uphelp. Lets do this the proper way, and make those changes. I'll grab this tonight. Thanks be to the both of you for comments. -- Tom (Darklogik) Rhodes www.FreeBSD.org -The Power To Serve www.Pittgoth.com -Pittgoth Discussion Portal trhodes@{Pittgoth.com, FreeBSD.org} PGP key by www: http://www.pittgoth.com/~darklogik/darklogik.key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message