perl.pod-people...Re: POD doesn't capture code semantics by Andy Armstrong- March 5, 2008 On 5 Mar 2008, at 18:06, Ian Malpass wrote:> Andy Armstrong wrote:>>> =head2 C<foo>>> foo is a method...>> =head2 C<bar>>> bar is a subroutine...>> why not>> =method foo>> =sub bar>> How about:>> =for method>> =head2 C<foo>>> Bit ugly, but it should work. Additional stuff after "method" could > provide more metadata, etc.Yeah, that could work. I wonder which is more...http://www.nntp.perl.org/group/perl.pod-people/2008/03/msg1320.html POD doesn't capture code semantics by Andy Armstrong- March 5, 2008 Last night, not for the first time, I found myself irritated that POD has no semantic concept of the code it describes. POD&39;s a great markup language but it&39;d be nice if it were possible to associate chunks of POD with bits of code. Instead of =head2 C<foo> foo is a method... =head2 C<bar>bar is a subroutine...why not =method foo =sub barFor formatting purposes =method and =sub could just be macros that expanded to =head2 C<$1> but it&39;d be far..http://www.nntp.perl.org/group/perl.pod-people/2008/03/msg1319.html |