format documentation

This mainly converts the lists from literal (fix width font) to conventional POD style lists, and use fixed width C<> directives for things like paths and files.  I've also changed actions from =item to =head2 so that I can link to them with L<>.

I think this makes the documentation easier to read.