Date: Fri, 31 May 2002 19:38:40 +1000 (EST) From: Bruce Evans <bde@zeta.org.au> To: Ruslan Ermilov <ru@FreeBSD.org> Cc: Giorgos Keramidas <keramida@FreeBSD.org>, <cvs-committers@FreeBSD.org>, <cvs-all@FreeBSD.org> Subject: Re: cvs commit: src/sbin/ffsinfo ffsinfo.8 Message-ID: <20020531191722.D32208-100000@gamplex.bde.org> In-Reply-To: <20020531060844.GB6953@sunbay.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, 31 May 2002, Ruslan Ermilov wrote: > On Fri, May 31, 2002 at 03:11:13AM +0300, Giorgos Keramidas wrote: > > On 2002-05-29 09:39 -0700, Ruslan Ermilov wrote: > > > ru 2002/05/29 09:39:40 PDT > > > > > > Revision Changes Path > > > 1.11 +4 -2 src/sbin/ffsinfo/ffsinfo.8 > > > > -.Nd "dump all meta information of an existing ufs filesystem > > +.Nd "dump all meta information of an existing ufs filesystem" > > > > <ignorant question> > > Are the quotes really necessary? > > > info --file=groff --node='Request Arguments' > > Also, from the groff(7) manpage: > > : REQUESTS > [...] > : Most requests take one or more arguments. The arguments > : are separated by space characters (no tabs!); there is no > : inherent limit for their length or number. An argument There used to be an inherent limit of 9 arguments. > : can be enclosed by a pair of double quotes: This is very > : handy if an argument contains space characters, e.g., > : "arg with space" denotes a single argument. > > Although in groff(1) the closing double quote is not necessary for > request (macro) arguments, it's still a good idea to supply one, > at least to make the input look "canonical". I've noticed strange quoting for .Cd more than for .Nd. Most .Cd's for device lines in section 4 man pages have quoted args. This because most device lines used to have more than 9 args, and no one removed the quotes when compl^Wsimplification of device configuration using the hints mechanism moved most of the configuration from the device lines to undocumented places. I think we don't really care how the spaces are formatted for .Nd or .Cd, so quoting of args for .Nd and .Cd is unimportant. The quotes just make the source code uglier, and makes one wonder why quotes are used :-). Bruce 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?20020531191722.D32208-100000>