UPDATE: Merlyn's code above out does what I say here! Listen to merlyn.

I know of no secret pod tags, but you could use a pod hack like the following. I wouldn't recommend it, but it does allow for you to hide at least one line from the pod. The basic premise is -- use a bogus tag and the the perl parser will treat it like but pod parser will ignore it. Anything on the same line as that bogus tag will also get ignored. Not good in wide practice. 
#!/usr/bin/perl -w

=head1

  Some function or other

=cut

sub foo {

}

=bogustag1

  Yet Another function 1

=cut

sub foo2 {

}

=bogustag2  Yet Another function

=cut

sub foo3 {

}

[download]

What was wrong with using "#"'s again?

my @a=qw(random brilliant braindead); print $a[rand(@a)];

In reply to Re: Secret POD docs by Rhandom
in thread Secret POD docs by petdance

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • 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! —
  • 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:
    & &amp;
    < &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.