On Mon, May 4, 2009 at 12:30 PM, Charles Bailey
<bailey.char...@gmail.com> wrote:
> If the two can be made eqaully expressive (i.e. content is normal POD,
> and multiple lines merged logically), I think I favor the pod-comment
> form, since it allows one to place the doc close to the thing
> documented - in particular, to the head of the function definition.
> That's a convenience for the user puzzling out the signature, and a
> reminder to the author to update the doc when the signature changes.
>
If the #={ } form (or #=<>, #=«», etc) works like embedded comments (
#{ } ), what you're describing would work just fine since they can
span multiple lines. See
http://perlcabal.org/syn/S02.html#Whitespace_and_Comments
