I apologize if I'm too blunt. I think there's a point that needs to be made clearly here.

Let me ask a few questions, please. Have you tried POD? Have you found it lacking in some way? If POD is an issue, does your text editor not allow you to automatically insert hash signs at the beginning of a line?

Please don't take this the wrong way, but I'm honestly not sure if the quality of your code is all that important. Perl has both its own comment syntax and an expanded comments standard that can automatically be turned into documentation (POD).

While it's true that TIMTOWTDI, bringing in C, Pascal, C++, Basic, and COBOL methods of making comments and adding runtime complexity to projects in order to avoid becoming comfortable with Perl's own strengths and customs seems like overkill.

While I do think there could be a use for your module, I think that use would be simply to guide C programmers who are new to Perl into their own programming backwater that discourages them from using POD. They and the Perl community would be poorer for that happening.

Basically, not only are you trying to solve a solved problem, but your module could actually have a negative impact both on the projects using it and the programmers who find it before they take the minimal time involved in learning basic POD skills.

I applaud your desire to help out and the work you put into making this a CPAN module. I just think this particular module was a little misguided.

In reply to Re: RFC: Filter::Comment::C by mr_mischief
in thread RFC: Filter::Comment::C by kosmo

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.