From owner-cvs-all Wed May 29 23:25:11 2002 Delivered-To: cvs-all@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id 9D43037B401; Wed, 29 May 2002 23:24:50 -0700 (PDT) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.6/8.11.2) id g4U6Okt61891; Thu, 30 May 2002 09:24:46 +0300 (EEST) (envelope-from ru) Date: Thu, 30 May 2002 09:24:46 +0300 From: Ruslan Ermilov To: "J. Mallett" Cc: cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src/usr.bin/split split.1 Message-ID: <20020530062446.GC60627@sunbay.com> References: <200205300607.g4U67TN92422@freefall.freebsd.org> <20020529230945.A74704@FreeBSD.ORG> <20020530061403.GA60627@sunbay.com> <20020529231925.A75782@FreeBSD.ORG> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="5G06lTa6Jq83wMTw" Content-Disposition: inline In-Reply-To: <20020529231925.A75782@FreeBSD.ORG> User-Agent: Mutt/1.3.99i Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --5G06lTa6Jq83wMTw Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, May 29, 2002 at 11:19:25PM -0700, J. Mallett wrote: > * From Ruslan Ermilov > > On Wed, May 29, 2002 at 11:09:45PM -0700, J. Mallett wrote: > > > * From Ruslan Ermilov > > > > ru 2002/05/29 23:07:29 PDT > > > >=20 > > > > Modified files: > > > > usr.bin/split split.1=20 > > > > Log: > > > > mdoc(7) police: use .Fl to denote stdin. > > >=20 > > > Is this really right? It certainly isn't a flag in the case of: > > > diff -u foo - > > >=20 > > > is it? > > >=20 > > > Wouldn't .Pa be more appropriate, or something? > > >=20 > > No, using .Pa wouldn't be more appropriate, as ``-'' isn't a real path. > > Current mdoc(7) practices tell us: > >=20 > > : The `.Fl' macro without any arguments results in a dash representi= ng > > : stdin/stdout. >=20 > What about .Ar then, as this is an explicit argument that a program must = grok, > it is not handled like a flag, and in fact none of our flag processing st= uff > handles it, namely getopt(3). Seems to me it's just a special .Ar file .= .. > possibility. Just because it is symbolic doesn't mean it should be notat= ed > differently, unless you show all possible usages including where stdin co= uld > be used as a file... Doesn't seem right to me... What was the logic in = the > .Fl macro being used for it? >=20 =2EAr isn't right either because it denotes argument names, not the actual values. There isn't currently a macro like ``argument's value'', and I routinely use the .Cm macro for that (for well-known argument names). In this case, the file's argument value is (``-''), i.e. ``.Cm \&-'', but then again (from mdoc(7)): : Command Modifiers : The command modifier is identical to the `.Fl' (flag) command with the ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ : exception that the `.Cm' macro does not assert a dash in front of every : argument. Traditionally flags are marked by the preceding dash, howev= er, : some commands or subsets of commands do not use them. Command modifie= rs : may also be specified in conjunction with interactive commands such as : editor commands. See Flags. Cheers, --=20 Ruslan Ermilov Sysadmin and DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --5G06lTa6Jq83wMTw Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.7 (FreeBSD) iD8DBQE89cWuUkv4P6juNwoRAlLoAJ4zHXMS+ch5+B2gXRICQDe70Vt0OACeJ8xm /IhD7/AI8UqVNzTbuWyOtVk= =opd5 -----END PGP SIGNATURE----- --5G06lTa6Jq83wMTw-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message