doc: refine autodoc comments chapter
doc: switch comments chapter to use subsections
doc: add subsection labels to comments chapter
doc: more tweaks
doc: change AutoDoc() docu into a doc comment