LWN.net Logo

Re: RFC: Perl manual pages -- update to follow the perlstyle.pod guidelines

From:  Tom Christiansen <tchrist-AT-perl.com>
To:  Dilbert <dilbert1999-AT-gmail.com>
Subject:  Re: RFC: Perl manual pages -- update to follow the perlstyle.pod guidelines
Date:  Sat, 03 Apr 2010 19:16:30 -0600
Cc:  perl5-porters-AT-perl.org
Archive-link:  Article, Thread

In-Reply-To: Message from Diblert <dilbert1999@gmail.com>
   of "Sat, 03 Apr 2010 01:31:05 PDT." 
   <1c3ff9e3-b493-4a57-9bff-e50723199f4b@5g2000yqj.googlegroups.com>

> Putting parens into complex expressions is recommended style, I
> believe we all (beginners and experts) agree on that.

> For simple expressions, however, teaching beginners to put parens is
> in my view bad practice. Therefore we should update the manual pages
> for simple expressions to reflect that.

I don't know what you mean.  Please supply concrete examples.

 Q: O Great Rabbi, Perl has so many precedence laws I feel I shall never
    learn them all.  Which is the most important of these commandments?

 A: As it was in the beginning, is now, and ever shall be, the First
    Commandment is the Law of Algebraic Precedence:

      #1  MULTIPLICATIVE OPERATORS BIND MORE TIGHTLY THAN ADDITIVE ONES.

    The Second Commandment is to think of those who come after you, 
    most preferably before they do so: 

      #2  DON'T BE A DAMNED FOOL: OTHERWISE USE PARENTHESES!

    Follow these two Commandments and all the days of your life will be
    blessed, for your code shall be ever right[eous] and all shall love
    you for it.

Happy Easter, and good night. :)

--tom



(Log in to post comments)

Copyright © 2010, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds