C++ Parser Options

How to get here: In Settings on the General Settings tab, select [General Settings] > Source Parsing > C++ Options.

Doc-O-Matic includes a macro file that can be used in every project that uses MFC, ATL, OWL and other frameworks. Declarations in these frameworks often consist of function macros like the following macro

#define STDMETHOD(method) __stdcall method

along with declarations that look like

int STDMETHOD(GetCount)();

Without a proper macro file, Doc-O-Matic is unable to identify such methods correctly. Therefore we strongly recommend to use the macro files. The Doc-O-Matic macro definitions are contained in the file macros_reduced.hand macros_complete.h.

Default Setting

Doc-O-Matic does not parse system include files. For each function a prototype has to be declared in the project. Doc-O-Matic lists getter and setter functions as functions.

To add macros_reduced.h

Click Add.
Find the macros_reduced.h file in the support subdirectory in the Doc-O-Matic directory.

Notes

Doc-O-Matic resolves macros non-recursively. Therefore be sure to extend macro definitions contained in the macro files to the extend you want.

Terms

parse To break source code into smaller chunks so that source code symbols can be sorted and comments extracted.

include directive A statement within a source-code file that causes another source-code file to be read in at that spot.

property A method that has the appearance of an ordinary data member, but that is declared by declaring get and set methods that implement the property. This mechanism is provided by the Managed Extensions for C++.

macro An abstraction, whereby a certain textual pattern is replaced according to a defined set of rules.