updating docs with the uid flag

- no current docs document this flag, which works on 0.11.0 (and probably earlier)
- found in #82 and referenced in #497
fixing a small typo in the 'e.g.' portion of request, whoops.
Merge pull request #553 from andrewmartin/master

updating docs with the uid flag