Unify documentation source and generate docs
with a man page, readme, changelog, licence, debian and other package requirements, all the documentation strings should come from a unified source.
perhaps configured using cmake, perhaps generated from markdown or latex.
The README, should be generated if the source files are changed, and pre-commit hooks notify