Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

Ovid (2709)

Ovid
  (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.

Journal of Ovid (2709)

Saturday May 17, 2003
02:25 PM

Comments

[ #12269 ]

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.

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.