On Wed, Dec 03, 2014 at 03:26:04PM -0500, Ted Unangst wrote: > On Wed, Dec 03, 2014 at 19:41, Jason McIntyre wrote: > > On Wed, Dec 03, 2014 at 07:12:06PM +0000, Yon wrote: > >> Hi, > >> > >> in the OPERATORS section of find(1) the non POSIX forms "-or" and "-and" > >> are described, but they should be replaced by the POSIX forms "-o" and > >> "-a" (which are used in the examples, but not documented). > >> > >> Perhaps a mention that "-or" and "-and" are the same as "-o" and "-a" > >> could then be added somewhere, as the STANDARDS section only says that > >> they are extensions. > >> > >> -- > >> Yon > >> > > > > i somehow thought we had fixed this, but it seems not. i have not > > replaced -or and -and, but have additionally documented -o and -a. > > oh. beat me to it. I would have slightly preferred a simpler diff like > below. >
i think in the past some developers expressed a desire to not demote -and and -or, as they are traditional bsd. i think we changed the examples as a desire to provide portable examples, but still wanted to keep the idea that -and and -or are perfectly acceptable. that's my understanding, and the reason why i made those changes in that way. if i have it wrong, or there is a sudden swing to pooh pooh -and and -or, i guess we could change it a bit. still, i dislike the idea of documenting that we support stuff but try to obfuscate it. it just makes it harder for the reader (and therefore still think my diff was better ;) jmc > Index: find.1 > =================================================================== > RCS file: /cvs/src/usr.bin/find/find.1,v > retrieving revision 1.88 > diff -u -p -r1.88 find.1 > --- find.1 20 Mar 2014 08:49:32 -0000 1.88 > +++ find.1 3 Dec 2014 20:22:10 -0000 > @@ -524,10 +524,10 @@ This is the unary > operator. > It evaluates to true if the expression is false. > .Pp > -.It Ar expression Cm -and Ar expression > +.It Ar expression Cm -a Ar expression > .It Ar expression expression > The > -.Cm -and > +.Cm -a > operator is the logical > .Tn AND > operator. > @@ -535,16 +535,22 @@ As it is implied by the juxtaposition of > have to be specified. > The expression evaluates to true if both expressions are true. > The second expression is not evaluated if the first expression is false. > +(The nonstandard spelling > +.Cm -and > +is also accepted.) > .Pp > .It Ar expression Cm -or Ar expression > The > -.Cm -or > +.Cm -o > operator is the logical > .Tn OR > operator. > The expression evaluates to true if either the first or the second expression > is true. > The second expression is not evaluated if the first expression is true. > +(The nonstandard spelling > +.Cm -or > +is also accepted.) > .El > .Pp > Operators, primaries, and arguments to primaries must be separate
