On Thu, Jun 18, 2015 at 09:57:13PM +0100, Jason McIntyre wrote: > On Thu, Jun 18, 2015 at 10:44:07PM +0200, Fritjof Bornebusch wrote: > > Hi tech@, > > > > *logins is omitted* sounds a little strange, doesn't it? > > > > it does, because in your head you're thinking of logins as being the > plural of login (i.e. more than one login). but you can also - correctly - > think of logins as being the argument name. > > you could read the text below as: > > If [the argument] "logins" is omitted... > > sounds different now, eh? > > in the docs, there is often this overlap where we can think of the > argument name in more than one way. it creates ambiguities, but there > you go. it would be impractical to try and force one style, i think. > > still, for this reason i dislike argument names which take the plural > form. >
Yeah, this can cause some confusion. But if it's the style, I'm okay with it. ;) > jmc > Regards, --F. > > Regards, > > --F. > > > > > > Index: rlog.1 > > =================================================================== > > RCS file: /cvs/src/usr.bin/rcs/rlog.1,v > > retrieving revision 1.24 > > diff -u -p -r1.24 rlog.1 > > --- rlog.1 3 Sep 2010 11:09:29 -0000 1.24 > > +++ rlog.1 18 Jun 2015 20:41:40 -0000 > > @@ -145,7 +145,7 @@ Print information about revisions checke > > in a comma-separated list. > > If > > .Ar logins > > -is omitted, the user's login is assumed. > > +are omitted, the user's login is assumed. > > .It Fl x Ns Ar suffixes > > Specifies the suffixes for RCS files. > > Suffixes should be separated by the > > >