Front page | perl.perl6.language |
Postings from June 2007
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/
Thread Previous
|
Thread Next