Wieso werden nach leeren Makros Kommentare eingefügt?
Alle ausblendenAlle anzeigen
Wenn Sie eine Funktion haben:
PREFIX int test();
Und Sie definieren PREFIX als Leerzeichen und fügen es über die Option Macros auf der Seite [General Settings] > Source Parsing > C++ Options zum Projekt hinzu, dann wird Doc-O-Matic bei der Verwendung des Editors den Kommentartext zwischen "PREFIX" und "int test()", anstatt vor PREFIX einfügen.
Das Problem besteht darin, dass es keine Möglichkeit gibt, zu bestimmen, ob PREFIX ein Teil von test() sein soll oder nicht. Es könnte auch sein, dass PREFIX nicht zu test() gehört wie im folgenden Beispiel
SOME_DECL
int test();
wobei SOME_DECL in der Release Version zu empty erweitert wird, aber in der debug Version zu einer debug Funktion. In diesem Fall wäre es ein Fehler den Kommentar vor SOME_DECL einzufügen.
Wenn Sie ein leeres Makro verwenden möchten und wollen, dass Doc-O-Matic den Kommentar vor PREFIX einfügt, ändern Sie das Makro und lassen Sie es zu etwas erweitern, dass nicht-leer ist, wenn Sie den Sourcecode bearbeiten. Wenn Sie den Sourcecode fertig dokumentiert haben, können Sie das Makro wieder zu empty expandieren lassen.