My take on this would be to:
- document all of the scripts extensively with POD
- create a CPAN distribution, use EXE_FILES in the call to ExtUtils::MakeMaker
- create script that will run through MANIFEST or <scripts/*> to create an overview POD
- install the distribution, you will have man files created from your POD!
- optionally, run pod2html and you'll have HTML documentation as well
That's what I would do. But then I'm used to creating CPAN distributions ;-)
Liz