New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

expand_as_defined macro does not properly work (Origin: bugzilla #719591) #5367

Closed
doxygen opened this Issue Jul 2, 2018 · 0 comments

Comments

Projects
None yet
1 participant
@doxygen
Owner

doxygen commented Jul 2, 2018

status RESOLVED severity normal in component general for ---
Reported in version 1.8.5 on platform Other
Assigned to: Dimitri van Heesch

Original attachment names and IDs:

On 2013-11-30 09:47:58 +0000, Anton wrote:

Created attachment 263198
Self-explained sample for demonstration

EXPAND_AS_DEFINED tag shall (according to the documentation) expand macro (with definition taken from sources) but it doesn't.

Self-explaining sample (with minimal doxyfile) are attached as gzipped tarball.

On 2013-12-08 13:32:47 +0000, Dimitri van Heesch wrote:

Doxygen assumes your header files are guarded against multiple inclusion and are self-contained (i.e. can be placed at the top of a .c file without causing compilation problems).

This is usually good programming practice.

Your example does not adhere to these assumptions. It uses a header file as a poor man's template that is expanded differently based on the inclusion context. So this will not work with doxygen, and it is also not clear what output doxygen should produce in such case.

I'll add a note about this limitation in the documentation.

On 2013-12-08 18:48:35 +0000, Kevin McBride wrote:

Adding "documentation" keyword per comment # 1.

@doxygen doxygen closed this Jul 2, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment