correct the documentation

There were numerous errors in the previous POD; this patch
minimally corrects the documentation.