Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 7 Dec 1999 22:21:02 +0100
From:      Jeroen Ruigrok/Asmodai <asmodai@wxs.nl>
To:        Chris Costello <chris@calldei.com>
Cc:        Mike Pritchard <mpp@mppsystems.com>, 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>
In-Reply-To: <19991207082715.Z976@holly.calldei.com>; from chris@calldei.com on Tue, Dec 07, 1999 at 08:27:15AM -0600
References:  <199912070330.TAA19258@freefall.freebsd.org> <19991207053818.B5628@mppsystems.com> <19991207082715.Z976@holly.calldei.com>

next in thread | previous in thread | raw e-mail | index | archive | help
-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 <http://home.wxs.nl/~asmodai>;
Atone me to my throes curtail...


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?19991207222102.H17630>