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

Resume
LinkedIn

RECENT ENTRIES

Interesting Modules 2010-09-03
36th Birthday
Book Blogging: Startide Rising
Android Tethering and Linux
Interesting Modules 2010-08-21
Moose Presentations
Time Spent In Sequoia
Good Perl Video Presentations
Time Spent In Yosemite
Yosemite and Sequoia National Parks 2010
Interesting Modules 2010-08-03
Several Months With A Smart Phone
Interesting Modules 2010-07-30
Recent Interesting Talks
Book Blogging: Bloodbrothers
Book Blogging: Fires of Freedom
Duck Duck Go
Yes, Yes, Yes
About That Lack of Blogging
Using A Smart Phone
Taking the Smart Phone Plunge (Maybe)
Book Blogging: Nemesis
Perl Not Going Away
OpenX Is Hiring Perl Developers
Perl Jobs vs Perl Programmers
Free Chapter From Effective Perl Programming
Perl On Android Progressing
Book Blogging: The Mote In God's Eye
Perldoc Is Important
The Second Age of Perl
A Description of Perl 5.12
Interesting Modules 2010-04-18
The Moral of This Story
Perl 5.12 Has Been Released
Packaging and Maintaining An Alternate Perl
Perl Moving Up?
Building Dependencies Like Make
Introduction To Plack
Defining Standard Testing Methodologies
Subversion Vision Released
Interesting Modules 2010-04-01
Perl Is Thriving
Interesting Modules 2010-03-29
Assign to $0
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
Search:
Entire Site This Topic Only
Match:
Any All
Partial Whole Words only

OTHER SITES