in reply to Re: Section Dividers - What are your thoughts
in thread Section Dividers - What are your thoughts

> but using POD for this is better than what you have

The debugger is a good counterexample to this thesis.

It has a big command loop where the users input is read and the documentation for each command is interspersed for each command section.

The documentation will show up in the same order like programmed and must stay at this chronological position.

This makes refactoring the code extremely difficult. Frankly it's a PITA.

I'm a fan of interspersed function docs with POD, but

Cheers Rolf
(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery