in reply to Preferred method of documentation?
...is a module about 1200 lines long....
If it's perl, and that is 1200 executable lines...
It's too damn big :)
Humour (hopefully) with a point. It's hard to believe that it takes 1200 lines to do any one thing in Perl, and a module ideally should do only one thing.
Breaking out a few sub-modules from the main, allows whatever documentation is included to concentrate on describing the function of that code, and not mix stuff up.
In Section
Meditations