Document TableGen classes with Doxygen?

Let's say I wanted to start writing a document on how to create a backend for TableGen. Such a document is suggested in "TableGen Backends." Should I describe the classes that are available to the backend in detail, or should I spend time updating the Doxygen comments in the class header files and simply present an overview in the document?

Hi Paul,

Let's say I wanted to start writing a document on how to create a backend for TableGen. Such a document is suggested in "TableGen Backends." Should I describe the classes that are available to the backend in detail, or should I spend time updating the Doxygen comments in the class header files and simply present an overview in the document?

Personally, I'd say the latter. The reason being simply that with
comments in the class header files, the chances that they will be kept
uptodate in the future is a little bit higher.

Cheers,
Nicolai

Sounds right to me, too. Then I can present a conceptual overview in the document.