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