OK. It's been bugging me for a good long while now. I've always wanted to create a "commentable" version of the Perl Documentation. Those other guys have it. Why shouldn't Perl?

I'd have done it the moment it crossed my mind. But I didn't like the way it was implemented in the others, nor did I like the way "other" commenting systems worked. So I tried to figure out a way to implement it in the way I thought would be more useful (threaded). Time, and other projects kept getting in the way. But today, after reading the Meditation: Yet another XS tutorial, I was reminded of it, and decided, enough, was enough. I'm going to do it now. So I took the liberty of posting to SOPW, asking for ideas/recommendations on a "Commenting System". kcott chimed in with exactly the type I would have implemented, had I built it myself. Amazing, the first suggestion. Anyway. It's AnnoCPAN. While it's a little over 8yrs. old. It provides a perfect foundation for me to build from.

So. Given that I haven't really seen anyone else do it effectively with Perl. I'd like to give it a go.

Anyone have any thoughts, ideas, complaints, {...}?

Thanks for your time, and consideration.

--Chris

#!/usr/bin/perl -Tw
use Perl::Always or die;
my $perl_version = (5.12.5);
print $perl_version;

In reply to Why not a "living" PerlDoc? Others have it, why not Perl? by taint

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.