Beefy Boxes and Bandwidth Generously Provided by pair Networks
Welcome to the Monastery

Re: Inline POD vs. EOF POD

by tadman (Prior)
on Jul 09, 2001 at 18:03 UTC ( #94980=note: print w/replies, xml ) Need Help??

in reply to Inline POD vs. EOF POD

I'd say the inline version is more likely to be maintained because the "commute time" between the function and the associated documentation is much shorter. If things are on the same screen, even the lazy are inclined to keep things in sync. If it's at some obscure location in the file, things might drift apart.

BTW, here's a quick macro for 'vi' for skipping to the POD documentation in a file:      vi '+/^=pod'
You could make this into an alias, such as 'vipod'. When it enters each file it runs the command to find the first line that begins with '=pod'. If you don't always use that tag, you can just search for the equals sign.

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://94980]
[TCLion]: DateTime::Format:: Flexible seems to have a lot of dependents, taking a while to install
[1nickt]: yes.
[1nickt]: one of the largest distros

How do I use this? | Other CB clients
Other Users?
Others examining the Monastery: (9)
As of 2017-03-23 15:23 GMT
Find Nodes?
    Voting Booth?
    Should Pluto Get Its Planethood Back?

    Results (289 votes). Check out past polls.