Updated pod and readme

Let me know if you need to update the wording/pod style
@killerfish @moollaza Some of my recent complaints about the POD output have appeared to be related to my local terminal settings and/or the latest `perldoc`.  I get really ugly output from `perldoc` in general lately.  Output of `perldoc -V` on my system:

```
Perldoc v3.24, under perl v5.020000 for linux
```

The ugly output seems to persist no matter how the POD gets turned into troff and dumped to my screen.