doc: flesh out the manual