On 7 Jun 2007, at 23:16, Andy Lester wrote:
On Jun 7, 2007, at 5:13 PM, Andy Armstrong wrote:
So: Interleaved for the first draft, at the end for maintenance.
To me, this is the same as saying "I turn off warnings and strict
when I'm done writing the program."
It's a compromise. Nothing is compromised by leaving warnings and
strict turned on but - for me - ease of navigation is compromised by
inline documentation.
I think I'd like POD to support subroutines:
= def blah
=item C<< blah >>
C<< blah >> is cute.
= cut
sub blah { }
... later ...
=head1 INTERFACE
=call blah
Then I could have a little program that either inlined the POD subs
or distributed them through the code. Then we'd both be happy apart
from you looking over my shoulder and tutting :)
--
Andy Armstrong, hexten.net
