sethd.org
this is not the blog you're looking for

Resume
LinkedIn

RECENT ENTRIES

Done With Blogging
MetaCPAN
I Am Now On Twitter. World Officially Ends.
More Info About Perl 5.14
Perl 5.14 has been released
The Year of Perl 5.10
PSGI is the Limit
Magical Moose
Accessor Benchmarks
Reviewing Perl Best Practices After 7 Years
Interesting Modules 2011-03-19
Book Blogging: The Uplift War
Book Blogging: Childhood's End
Interesting Modules 2011-02-20
Perl Programming Best Practices 2011
Modern Perl Available For Free
Bloated Perl Applications
Five Test::More Features You Might Not Be Using Yet
Perl.LA
How To Identify A Good Perl Programmer
Interesting Modules 2011-01-11
Hudson's Future
Moose Ecosystem
Shaking Up Subversion Responses
Dist::Zilla Walkthrough
Mailing Lists vs. IRC
Shaking Up Subversion
Module Count Shmodule Count
Book Blogging: The Definitive Guide To Catalyst
Book Blogging: Blackout / All Clear
Interesting Modules 2010-12-04
Book Blogging: Macroscope
Upcoming Perl Books
Use A String Like A Filehandle
Moose and Build
Running the Bases...Quickly
Pennant
Interesting Modules 2010-10-16
Went to Perl Mongers Last Night
Book Blogging: The Many Deaths of the Firefly Brothers
Book Blogging: Rainbows End
Interesting Modules 2010-09-03
36th Birthday
Book Blogging: Startide Rising
Mar 07, 2010

Perl and Inline POD

I've had co-workers that never wrote POD, and that was probably the worst. But the next worst are the people that inline their POD. I really cannot stand inline POD. Apparently I am not alone. Mike Friedman expresses it at least as well as I can so I'll leave it at that.

Well, almost. He says one odd thing:

  If someone's looking at your code, it's because they need more information 
  than the documentation or interface itself can provide.
I don't think this is even half true. I often look at Perl code that has perfectly good (and non-inline) POD. Almost always because I'm less interested in the public interface than I am interested in how that interface was written. What fun is software development if all you do is work with the public interface of blackbox libraries? It's much more interesting to see what's going on behind the scenes and actually learn something new, right?

Tags: , , .
[p] Posted @ 11:08 by Seth


This site uses the very simple and easy to use blosxom blogging software.


Advanced Search

PERL BLOGS

PERL RELATED OTHER SITES