Thomas Wittek wrote: > Moritz Lenz: >> =begin pod >> >> =head3 C<method from_string(Str $s);> >> [..] >> =end pod >> >> method from_string(Str $s){ >> # implementation of that method here >> } >> >> Since method signatures are very expressive in Perl 6, there should be a >> way of accessing them in the POD without copy & paste. > > As I read "=head 3 method..." I also had the idea that semantically more > meaningful directives might be a good idea.
That may be my fault, I didn't care to look if there was a more semantic way to describe it. > I mean POD uses constructs like headlines, lists, blocks, italic etc. > which all describe _how it looks like_ and not _what it is_. Headlines, lists and blocks are IMHO semantic markup. If I'd say "Huge font in bold" that'd be descriptive rather than semantic markup. > A head3 might be the headline of a method documentation as well as one > introducing the contact information for the author of a module. > The directive doesn't have much semantics. That doesn't make a headline worthless. It just shouldn't be abused the way I did it ;) -- Moritz Lenz http://moritz.faui2k3.org/ | http://perl-6.de/
signature.asc
Description: OpenPGP digital signature