From owner-freebsd-doc Tue Dec 7 13:35:21 1999 Delivered-To: freebsd-doc@freebsd.org Received: from smtp02.wxs.nl (smtp02.wxs.nl [195.121.6.60]) by hub.freebsd.org (Postfix) with ESMTP id 3055514EB4 for ; Tue, 7 Dec 1999 13:34:55 -0800 (PST) (envelope-from asmodai@wxs.nl) Received: from daemon.ninth-circle.org ([195.121.199.163]) by smtp02.wxs.nl (Netscape Messaging Server 3.61) with ESMTP id AAB3BE; Tue, 7 Dec 1999 22:34:54 +0100 Received: (from asmodai@localhost) by daemon.ninth-circle.org (8.9.3/8.9.3) id WAA24344; Tue, 7 Dec 1999 22:21:03 +0100 (CET) (envelope-from asmodai) Date: Tue, 7 Dec 1999 22:21:02 +0100 From: Jeroen Ruigrok/Asmodai To: Chris Costello Cc: Mike Pritchard , freebsd-doc@FreeBSD.ORG Subject: Re: docs/15234: sh(1) man page have capitalised instance of "sh". Message-ID: <19991207222102.H17630@daemon.ninth-circle.org> References: <199912070330.TAA19258@freefall.freebsd.org> <19991207053818.B5628@mppsystems.com> <19991207082715.Z976@holly.calldei.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <19991207082715.Z976@holly.calldei.com>; from chris@calldei.com on Tue, Dec 07, 1999 at 08:27:15AM -0600 Organisation: Ninth-Circle Enterprises Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org -On [19991207 16:01], Chris Costello (chris@calldei.com) wrote: >On Tue, Dec 07, 1999, Mike Pritchard wrote: >> I don't like lower-case commands being capitalized in the text >> if at all possible. It makes it harder for automated man page >> checking scripts/programs to figure out of the reference is valid. > > It's an ``.Nm'', not an ``.Xr'' That might not be relevant. ;) I am doing some things wrt man and DocBook conversion and wrong usage of .Nm could lead to some interesting twists in the code. =\ I personally prefer the rewording myself. The style may be somewhat less to read, but at least it preserves proper capitalisation. -- Jeroen Ruigrok van der Werven/Asmodai asmodai@[wxs.nl|bart.nl] Documentation nutter. *BSD: Technical excellence at its best... The BSD Programmer's Documentation Project Atone me to my throes curtail... To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message