in reply to Perl source code documentation?
The source code has lots of good comments, and is not chaotic at all at a second glance. You just time to understand it.
Use gdb to step through the sections you are interested in.