doc: initial revision of man pages
docs: add an initial buxton-api man page

Individual man pages for each library function, with minimal code
samples, will follow later.