Re: [perl #100364] exit doesn't match its documentation

On Sat, Oct 01, 2011 at 05:59:40AM -0400, Eric Brine wrote:
> On Sat, Oct 1, 2011 at 5:04 AM, Zefram <zefram@fysh.org> wrote:
> 
> > Eric Brine wrote:
> > >Anyway, 3+4 and 5 || 6 aren't terms,
> >
> > They are in the sense in which "term" is meant in the Perl grammar.
> > It refers to a term of a list.  See "term" and "listexpr" in perly.y,
> > and "parse_termexpr" in perlapi.
> >
> 
> In my experience, term refers to an expression in parens or a value literal.
> I shouldn't be expected to read perly.y to understand how to use exit.


It doesn't matter what it means.

The majority of the people reading the documentation will not know
what it means.

Documentation that is only understandable if you have more than a passing
knowledge of the implementation has little use to the average programmer.


I think it's far more important to have documentation that's
understandable by the general programmer, than have documentation
that cannot be nitpicked by someone with a deep knowledge of both Perl
and perl.

I strongly suggest to keep 'exit EXPR' in.


Abigail

• [perl #100364] exit doesn't match its documentation by Nicholas Clark
• Re: [perl #100364] exit doesn't match its documentation by David Golden
• Re: [perl #100364] exit doesn't match its documentation by Abigail
• Re: [perl #100364] exit doesn't match its documentation by David Golden
• Re: [perl #100364] exit doesn't match its documentation by Zefram
• Re: [perl #100364] exit doesn't match its documentation by Eric Brine
• Re: [perl #100364] exit doesn't match its documentation by Zefram
• Re: [perl #100364] exit doesn't match its documentation by Eric Brine
• Re: [perl #100364] exit doesn't match its documentation by Zefram
• Re: [perl #100364] exit doesn't match its documentation by Eric Brine
• Re: [perl #100364] exit doesn't match its documentation by Zefram
• Re: [perl #100364] exit doesn't match its documentation by Eric Brine
• Re: [perl #100364] exit doesn't match its documentation by Abigail
• Re: [perl #100364] exit doesn't match its documentation by Abigail
• Re: [perl #100364] exit doesn't match its documentation by Zefram
• Re: [perl #100364] exit doesn't match its documentation by Mark Overmeer
• Re: [perl #100364] exit doesn't match its documentation by Zefram
• Re: [perl #100364] exit doesn't match its documentation by Tom Christiansen
• Re: [perl #100364] exit doesn't match its documentation by H.Merijn Brand
• Re: [perl #100364] exit doesn't match its documentation by Tom Christiansen
• Re: [perl #100364] exit doesn't match its documentation by Zefram
• Re: [perl #100364] exit doesn't match its documentation by Tom Christiansen
• Re: [perl #100364] exit doesn't match its documentation by Nicholas Clark
• Re: [perl #100364] exit doesn't match its documentation by Zefram
• Re: [perl #100364] exit doesn't match its documentation by Tom Christiansen
• [perl #100364] exit doesn't match its documentation by Father Chrysostomos via RT
• Re: [perl #100364] exit doesn't match its documentation by Aristotle Pagaltzis