Date: Thu, 30 May 2002 09:24:46 +0300 From: Ruslan Ermilov <ru@FreeBSD.ORG> To: "J. Mallett" <jmallett@FreeBSD.ORG> 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> In-Reply-To: <20020529231925.A75782@FreeBSD.ORG> References: <200205300607.g4U67TN92422@freefall.freebsd.org> <20020529230945.A74704@FreeBSD.ORG> <20020530061403.GA60627@sunbay.com> <20020529231925.A75782@FreeBSD.ORG>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <ru@FreeBSD.ORG>
> > On Wed, May 29, 2002 at 11:09:45PM -0700, J. Mallett wrote:
> > > * From Ruslan Ermilov <ru@FreeBSD.org>
> > > > 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020530062446.GC60627>