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