All the Perl that's Practical to Extract and Report
use Perl Log In
Ovid (2709)
(email not shown publicly)
http://publius-ovidius.livejournal.com/
AOL IM: ovidperl (Add Buddy, Send Message)
Stuff with the Perl Foundation. A couple of patches in the Perl core. A few CPAN modules. That about sums it up.
Comments
I'm writing a fairly long document in POD and I realized that I was including notes to myself in the document, even though it's meant for someone else. Those notes would not only distract the person reading the document, but it would also detract from the point of the document. It's long enough, however, that I have to have those notes.
I could keep the notes in a separate document, but I know I won't remember to keep them in synch. Perhaps I could tag them and delete them when I'm done? No, I'll forget to delete one. The answer was so simple, though, that it was staring right at me. I had forgotten about the =for syntax.
=head1 This is another section
=for comment But this won't be displayed
I just mark those notes as comments and use a POD converter as normal. No extra steps to forget about. It's the little touches that I always appreciate.
I pour myself a cup of strong coffee. :-)
-- Jarkko Hietaniemi
Yes, a good trick! (Score:4, Interesting)
Reply to This
Re:Yes, a good trick! (Score:2)
Oddly enough, the long document is a book proposal I've been asked to flesh out and the comments are detailed notes of examples I want in the text :)
Time for a shameless plug... (Score:1)
And before you get alarmed, no you wouldn't be the first to use it in production code