Q_OBJECT breaks qdoc

Whenever a header file contains q Q_OBJECT macro, most parts of the file are not included in the generated docs and I just can't figure out why. Given qdoc is used to generate documentation for Qt itself I assume I'm missing something, but at the very least the documentation on qdoc seems to lack information about this.

The issue I'm facing seems to be described here too: https://stackoverflow.com/questions/52739030/why-does-q-object-break-qdoc

But I can't believe that ifdefing the Q_OBJECT macro is the actual solution to this.