Updated pod and readme

Let me know if you need to update the wording/pod style
@killerfish I think the "standard" for non-required arguments is square brackets.  So this should be like:

```shell
duckpan query [<Spice|Goodie>::<answer-name>]
```

Also, I'm not really a fan of that syntax, but that's hardly your fault. :grin: