I think that if this tool just documents all the "normal" subs, classes, modules and globals, it will be of great aid. I won't cry if it won't handle subroutines created on the fly, and things like this. It's enough to cover the 99% frequent usage constructs.