Es gibt zwei Teile von Doxygen, die qt spezifischen sind: der Qt Kommentar Stil und der QT_AUTOBRIEF doxyfile Konfigurations-Tag. Dies sind nur Teile von Doxygen, die von QT verwendet werden. Alle von QT verwendeten doxygen Kommentare sind reguläres Doxygen. Sie müssen also nur auf Doxygen nachlesen.
Oder vielleicht sind Sie wirklich für die Dokumentation von QT Interna suchen, wie zum Beispiel Informationen über d-Pointers wie in this blog entry
Qt-Art-Kommentare enthalten: Die \ *! text */ Kommentarstil wird als "Qt Style" von doxgyen comments bezeichnet. Das "!" markiert den gesamten Kommentarblock als doxygen Kommentarblock. Es ist ein standardmäßiger, optionaler Teil von Doxygen.
QT_AUTOBRIEF Einstellung: wenn die „QT_AUTOBRIEF“ -Tag auf TRUE in der Doxyfile gesetzt, die erste Zeile eines Kommentars Block Qt Stil automatisch als \ Kurzbeschreibung interpretiert wird.
Vom doygen GUI-Hilfe:
QT_AUTOBRIEF Tag auf YES gesetzt ist dann Doxygen werden die erste Linie (bis zum ersten Punkt) eines Qt-Stil Kommentar als kurze Beschreibung interpretieren. Wenn auf NO gesetzt, verhalten sich die Kommentare wie normale Qt-Stil Kommentare (also einen expliziten \ kurzen Befehl für eine kurze Beschreibung erfordern.)
Ich war auf der Suche nach http: //qt.gitorious .org/qt/pages/DocManual und http://qt.gitorious.org/qt/pages/DocMarkupCommands. Ohne zu wissen, wie es heißt (qdoc, wie?), Konnte ich es nicht googeln. Viele der Links scheinen jedoch tot zu sein. –
Jetzt sagen Sie, dass das qdoc * -Tool veraltet ist oder die gesamte qdoc * -Syntax * (einschließlich des Tools) veraltet ist? Nokia verwendet die qdoc-Syntax ausschließlich in Qt, ist das nur aus Gründen der Rückwärtskompatibilität oder sollte stattdessen ein anderer Stil (wie Javadoc-Kommentare) verwendet werden? Offensichtlich liegt es an einem Programmierer, aber ich möchte mit dem Rest von Qt oder dem, was Nokia empfiehlt, konsistent bleiben. –
Danke für die Info, das hat mir viel Zeit erspart. Ich ging für qdoc3 ... Narr! – karlphillip