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.

jmc

> 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
> 

Reply via email to