perldiver: correct usage documentation

* remove --pager documentation, this is not actually used yet
* indicate that --editor takes a string
* put short options before long as suggested in perlpodstyle

Signed-off-by: Andrew Gregory <andrew.gregory.8@gmail.com>
Local: do not run pod_find in '.'

pod_find recursively scans the entire directory.

Signed-off-by: Andrew Gregory <andrew.gregory.8@gmail.com>