I suppose that #={ } would work like a normal Pod block which does not allow implicit code. That way you could keep it properly indented by default:
class Foo; method bar ($x, $y) { #={Swaps $x and $y} ... } method baz ($a, @b) { #={ Takes $a, applies it to the values in @b Bla bla bla } ... } I remember reading that #{} comments are not allowed at the beginning of a line. Is that still true? Would that also apply to #={} ? If so, it would be easy to make a mistake: class Foo; #={ This class does something neat } <-- ILLEGAL method bar () { ...} Another issue is that Pod directives must be at the beginning of a line. That would mean having to break the indent in cases like: method baz ($a, @b) { #={ Takes $a, applies it to the values in @b Be mindful of the following: =item This =item That =item And the other thing } ... } Could Perl allow Pod blocks to be indented in #={ } comments? Maybe the "local" beginning-of-line in the comment could be considered to be at the position where the #={ appeared, or at the position of the first whitespace character after it.. If so, then maybe the "no implicit code blocks" restriction could be lifted, so the whole comment behaves just like an indented =pod block: method baz ($a, @b) { #={ Takes $a, applies it to the values in @b Be mindful of the following: =item This =item That =item And the other thing This is rendered as code, since it is more indented further than the initial #={ } ... } Thoughts?