Beefy Boxes and Bandwidth Generously Provided by pair Networks
more useful options
 
PerlMonks  

Re^2: What makes a comment "obnoxious"?

by adrianh (Chancellor)
on Sep 09, 2007 at 16:55 UTC ( #637918=note: print w/replies, xml ) Need Help??


in reply to Re: What makes a comment "obnoxious"?
in thread What makes a comment "obnoxious"?

Your subs should be separated by meaningful comments that detail what the function does, what it expects as arguments, and what it returns

Or (even better!)

  • The function name should reveal what the function does. If it doesn't change it.
  • The name of the vars you rip out of @_ should reveal what the function takes. If they don't change them.

  • The name of the variable you a return() should reveal what is being returned. If it doesn't update it.

(guess who is thoroughly sick of lying comments in legacy code :-)

  • Comment on Re^2: What makes a comment "obnoxious"?

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://637918]
help
Chatterbox?
LanX googling for ones own childish humour has advantages ... see Pray for Paris
[LanX]: Moon not Mars
Corion updates his location info to "I'm needed everywhere"

How do I use this? | Other CB clients
Other Users?
Others chilling in the Monastery: (12)
As of 2017-03-27 15:34 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    Should Pluto Get Its Planethood Back?



    Results (320 votes). Check out past polls.