Your suggestions make a lot of sense. Documentation is a very good thing that I'm not very good at. I will have to get to grips with POD but it's something I have been putting off.</blocckquote>

I know this is mere proselytism, anyway in case you don't really get into POD you could give ROBODoc a try. It has a couple of advantages:

• It sucks up much less space than POD;
• It mixes up fine with code and comments (you can easily make documentation from your comments);
• It works with any language I know of, so you can ROBODoc your Java, your html, your C and your PHP too.
• ROBODoc can build a one-document digest from a whole code tree;
• You can anyway generate HTML, RTF, PDF... from ROBODoc as well as POD;
• Last, you can also generate POD with the ROBODoc to Pod translator script.

Comment on Re^3: Create and edit new scripts