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.