in reply to perldoc code only

I suspect I know just what you are looking for; after I posted a module last night, mkmcconn mentioned that he found the inline POD very hard to read, so I whipped up a quick-and-dirty little script that takes POD embedded in a file and moves it all down to the end. Not tested too extensively, but it basically seems to work:
die "Usage: SegregatePod filename\n" unless @ARGV == 1; open INPUT, $ARGV[0] or die "Unable to open $ARGV[0]: $!\n"; my @paragraphs = do {local $/ = ""; <INPUT>}; close INPUT; my $inside_pod = 0; my $extracted_pod = ''; my $leftover_code = ''; foreach my $this_paragraph (@paragraphs) { if (substr($this_paragraph,0,4) eq '=cut') { $inside_pod = 0; $this_paragraph = ''; # =cut no longer needed since POD sections w +ill be contiguous } elsif (substr($this_paragraph,0,1) eq '=') { $inside_pod = 1; } if ($inside_pod) { $extracted_pod .= $this_paragraph; } else { $leftover_code .= $this_paragraph; } } print "$leftover_code\n$extracted_pod\n";

Of course you could simply omit $extracted_pod from the last line if you didn't want to see it at all.

As for the inline code, I've learned my lesson, and future submissions will have the POD at the end ;-)