From: "Perl6 RFC Librarian"
> This allows actual running code to be inserted directly into the
documentation
> for that code.
This (if I understand your aim here) points out The Difference between
comments and POD, and underlines why POD is not a good way to comment code.
Comments can always be assumed to be visible with the code they are about.
POD is sometimes visible with the code it is about, but only when viewed in
the source. However POD is intended to be viewed without its surrounding
code, using a pod-viewing application. You can't have it both ways. Either
POD is a comment or its not (and my position is that its not, its
documentation.).
This RFC would seem to address the issue quite neatly.
--Michael
