On 8 Jun 2007, at 08:24, Adrian Howard wrote:
If I have a whole bunch of public subroutines that I can have in a
reasonable order for reading I'll inline the POD. I find it helps
to have it nearby. That Knuth bloke and his literate programming
wasn't completely nuts in my opinion :-)
Except that's not quite LP. LP (AFAIK) has the documentation form the
primary narrative and the code gets assembled into the correct order
by a preprocessor.
When I have a bunch of private subroutines, or the sensible code
order doesn't match the sensible reading order, I'll stick it all
at the end.
Sometimes I'll switch back and forth a few times as I refactor.
That's the key. Currently you have to decide which layout to use - it
should be easy to switch.
--
Andy Armstrong, hexten.net
