Re: [patch]rcs: rlog manpage typo

2015-06-18 Thread Fritjof Bornebusch
On Thu, Jun 18, 2015 at 10:49:32PM +0200, Pablo Méndez Hernández wrote:
Hi,
 
El 18/6/2015 22:46, Fritjof Bornebusch frit...@alokat.org escribiA^3:

 Hi tech@,

 *logins is omitted* sounds a little strange, doesn't it?
 
logins as a keyword?


Yes, but if you read it, it sounds wrong in some way.

Regards.
Pablo


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.1A  A  A  3 Sep 2010 11:09:29 -A  A  A  A 1.24
 +++ rlog.1A  A  A  18 Jun 2015 20:41:40 -
 @@ -145,7 +145,7 @@ Print information about revisions checke
 A in a comma-separated list.
 A If
 A .Ar logins
 -is omitted, the user's login is assumed.
 +are omitted, the user's login is assumed.
 A .It Fl x Ns Ar suffixes
 A Specifies the suffixes for RCS files.
 A Suffixes should be separated by the




[patch]rcs: rlog manpage typo

2015-06-18 Thread Fritjof Bornebusch
Hi tech@,

*logins is omitted* sounds a little strange, doesn't it?

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 -   1.24
+++ rlog.1  18 Jun 2015 20:41:40 -
@@ -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



Re: [patch]rcs: rlog manpage typo

2015-06-18 Thread Pablo Méndez Hernández
Hi,

El 18/6/2015 22:46, Fritjof Bornebusch frit...@alokat.org escribió:

 Hi tech@,

 *logins is omitted* sounds a little strange, doesn't it?

logins as a keyword?

Regards.
Pablo

 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 -   1.24
 +++ rlog.1  18 Jun 2015 20:41:40 -
 @@ -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



Re: [patch]rcs: rlog manpage typo

2015-06-18 Thread Jason McIntyre
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.13 Sep 2010 11:09:29 -   1.24
 +++ rlog.118 Jun 2015 20:41:40 -
 @@ -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
 



Re: [patch]rcs: rlog manpage typo

2015-06-18 Thread Fritjof Bornebusch
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 -   1.24
  +++ rlog.1  18 Jun 2015 20:41:40 -
  @@ -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