Add generator for modern buildsystem documentation

Summary

The buildsystem documentation generator does not support multi-line comments, rst systax and modern CMake documentation commands as used in CMake itself. This MR adds some functionality and redirects to a python module to do the rest.