Rod Adams skribis 2004-08-23 13:16 (-0500): > sub foo :doc("take an Foo::Bar, and foo it over.") (
Anything involving a string is not good for documentation, because in documenation it must be *easy* to add code examples. Besides that, ("") would make me want to put it all on one line, and that may be a little *too* concise for documentation. class Dog { sub bite ( Int $strength is validated { 0 < $_ =< 9 } # Do we have # something like this # yet? ) description { foo bar baz, demonstrated here: =verbatim { ... } In any case, {b:CAVE CANEM}. # Translated: beware of the dog. # And yes, that's a comment in POD, and should not be rendered. } { .mouth.open; .head.extend; .mouth.close $strength; } } Juerd