Provide docs via manpages

[jasonkarns]

1. [ ] Update functions to use docopt style docs via in-source comments.
2. [ ] Include markdown formatted details in comments for doxygen parsing.
3. [ ] Generate readme from the function docs.
4. [ ] Generate manpages from the function docs.