unsubscribe -----Original Message----- From: Juerd [mailto:[EMAIL PROTECTED] Sent: Monday, August 23, 2004 12:01 PM To: Rod Adams Cc: [EMAIL PROTECTED] Subject: Re: Progressively Overhauling Documentation
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