Cleanup of cmakefaq.

- Get rid of \\ at end of paragraphs
- Fix various misspellings
- add some convenience macros
- add myself as co-author
- break long lines which were modified anyway

(cherry picked from commit 8d2ee549)
Signed-off-by: Carsten Gräser <graeser@dune-project.org>