# from A. Pagaltzis
# on Thursday 07 June 2007 10:25 pm:
>Documentation should form a coherent narrative. The myopic view
>of inlined local POD sections is a hindrance to that.
We need to be able to switch the folding between pod and not-pod, eh?
>Conversely,
>when I edit code, I occasionally want to shift big swathes of
>stuff around; having to carry along all the POD before I’m done
>would bog me down for no gain whatsoever, particularly in light
>of the fact that such changes generally result in a structucal
>revision to the docs.
=head1 Foo Stuff
...
=head2 foo_this
...
} # end sub
=head2 foo_that
...
} # end sub
=head1 Bar Stuff
...
Were you arguing against interspersed pod? If you're moving code into
the Foo section, the docs go with it. If you're swapping =head1
sections, the code goes with them. Pod at the end means finding your
cut points twice instead of once.
--Eric
--
The opinions expressed in this e-mail were randomly generated by
the computer and do not necessarily reflect the views of its owner.
--Management
---------------------------------------------------
http://scratchcomputing.com
---------------------------------------------------
