Replace man page configurations with the ones from README.md

* Merge man page's description to README
* Replace man page config section with the ones from README

/cc @mislav
This is basically the same code as `extract_examples` but with a different number? Maybe we can pass in an extra parameter to the lambda that is the section number so we can re-use the same code