Update pod

I've updated the bin/catmandu and Catmandu.pm documentation with more recent syntax and expanded all the examples.

Didn't touch the README.md which is probably generated by some milla configuration?