Good suggestions all. OTOH---I can't help but think that it wouldn't hurt to have a few more documentation tools, for both old and new authors. I'm working on a script using B::Deparse that will when done at least generate a skeleton document framework for subs and globals.
Pod::Coverage might be usefull. I think it provides a way to list all undocumented subs which in the case of the script you're talking about would be all non-private subs. Using it would guarantee that the pod generated by your script would rate as 100% covered.
Randy.
