in reply to I'm confused because perl is confused with POD

POD isn't really for inline comments, though it can make the intention of the source clearer if explanations are close to the code that provides the functionality described.

POD is used to provide a "man page" for the user, for inline explanations to someone reading the code the "#comment" is more appropriate.

  • Comment on Re: I'm confused because perl is confused with POD

Replies are listed 'Best First'.
Re^2: I'm confused because perl is confused with POD
by afoken (Chancellor) on Jul 01, 2009 at 14:11 UTC

    You are completely right, but in this case, the documentation of the hash pairs WAS the biggest part of the man page. I've changed the code a little so that I can mix POD and hash pairs properly.

    Alexander

    --
    Today I will gladly share my knowledge and experience, for there are no sweeter words than "I told you so". ;-)