>> Now I understand better what you want (though still stay on my own :)

Yes, I think I'm beginning to understand what I wanted to ask as well. It's hard to state the exact question when one starts from a point of not knowing anything :)

.

I think the approach I will take is to write an emacs command in Perl (I only use Lisp once in a blue moon). The command will go through the functions in the buffer, and then reconcile those with the descriptions in the METHODS section beyond __END__. It'll allow one to re-run the command to add function descriptions (for functions you've left off), without altering what you've done (it'll do a diff of sorts), as well as flag functions you've deleted (which won't work perfectly for changing the names, but...). So by following some simple conventions I'll be able to keep the method documentation separate from the code (I'll probably put a line or two at the head of each function, but then extended docs below __END__).

This will let me have code that is both maintainable and more readable than the mix in way.

In reply to Re^4: POD using __END__ with function comments by zerohero
in thread POD using __END__ with function comments by zerohero

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.