in reply to Where to place POD

My preference is to have all of the code functions together -- that is, not alternating with POD. POD lives in a separate file, since that's one of the options.

I am known as a developer who includes lengthy comments, so there is documentation in my code. I just prefer to keep user information somewhere else -- that's not useful information for me, so I don't want to see it. And I'm aware that some IDEs allow you to hide POD -- that's wonderful, but I'll stick with plain vanilla vim. It's always available, and behaves consistently pretty much anywhere.

Alex / talexb / Toronto

Thanks PJ. We owe you so much. Groklaw -- RIP -- 2003 to 2013.

Replies are listed 'Best First'.
Re^2: Where to place POD
by Bod (Parson) on Jan 14, 2024 at 22:55 UTC
    POD lives in a separate file

    Thanks. I hadn't considered that a separate file would be a default choice but your explanation makes sense. Although, I don't think I'll be following your lead for my private module. I might move in that direction for CPAN modules perhaps.

    I'm very much looking forward to discovering what other people do and why they do it...