Updated pod and readme

Let me know if you need to update the wording/pod style
Seems like the proper way is to just wrap optional arguments in `[]` and separate the possibilities with `|`, i.e. `[spice_package | goodie_package]`

http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap12.html