I looked at the perldoc and pod2man man pages and it was not clear to me as to how to make perldoc ignore the POD embedded inside the heredoc. How can I do that?

I'm not aware of any way to do so. Creating a parser that could ignore POD in quoted text would require a way to recognize quoted text, which would require parsing Perl source. Even if one succeeded in such an effort, it would only work for tools that used it. Syntax highlighting in most text editors would still barf, as would most any other POD-aware tool. I personally wouldn't want to maintain a source file with two or more sets of POD in it, either.

What I would suggest is to store the POD file as an external template and use Text::Template for easy flexible interpolation.

---

---

Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!

Titles consisting of a single word are discouraged, and in most cases are disallowed outright.

Read Where should I post X? if you're not absolutely sure you're posting in the right place.

Please read these before you post! —

• How do I compose an effective node title?
• How do I post a question effectively?
• Markup in the Monastery

Posts may use any of the Perl Monks Approved HTML tags:

a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr

You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)

	For:		Use:
	&		&
	<		&lt;
	>		&gt;
	[		&#91;
	]		&#93;

Link using PerlMonks shortcuts! What shortcuts can I use for linking?

See Writeup Formatting Tips and other pages linked from there for more info.