From owner-cvs-all Wed May 29 23:19:41 2002 Delivered-To: cvs-all@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 931) id BC3E037B49A; Wed, 29 May 2002 23:19:25 -0700 (PDT) Date: Wed, 29 May 2002 23:19:25 -0700 From: "J. Mallett" To: Ruslan Ermilov Cc: cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src/usr.bin/split split.1 Message-ID: <20020529231925.A75782@FreeBSD.ORG> References: <200205300607.g4U67TN92422@freefall.freebsd.org> <20020529230945.A74704@FreeBSD.ORG> <20020530061403.GA60627@sunbay.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20020530061403.GA60627@sunbay.com>; from ru@FreeBSD.ORG on Thu, May 30, 2002 at 09:14:03AM +0300 Organisation: The FreeBSD Project X-Alternate-Addresses: , , , X-Affiliated-Projects: FreeBSD, xMach, ircd-hybrid-7 X-Towel: Yes 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 * 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 > > > > > > Modified files: > > > usr.bin/split split.1 > > > Log: > > > mdoc(7) police: use .Fl to denote stdin. > > > > Is this really right? It certainly isn't a flag in the case of: > > diff -u foo - > > > > is it? > > > > Wouldn't .Pa be more appropriate, or something? > > > No, using .Pa wouldn't be more appropriate, as ``-'' isn't a real path. > Current mdoc(7) practices tell us: > > : The `.Fl' macro without any arguments results in a dash representing > : stdin/stdout. 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 stuff 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 notated differently, unless you show all possible usages including where stdin could be used as a file... Doesn't seem right to me... What was the logic in the .Fl macro being used for it? -- J. Mallett FreeBSD: The Power To Serve To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message