I don't know if this will help, but someone posted a question about analyzing a complicated (undocumented) set of inter-related perl files, and I was compelled to try my hand at it. The result is here: Tabulate sub defs, sub calls in Perl code.

You just give it a list of perl source code file names, and it gives you a fairly tidy listing of sub definitions by source file, and where various subs are called (which might be a good-enough starting point for standardized documentation). HTH.