After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 672620 - Improper terminology: no such thing as a "define" -- it's called "macro"
Improper terminology: no such thing as a "define" -- it's called "macro"
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
unspecified
Other All
: Normal minor
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2012-03-22 12:59 UTC by pilot_pirx
Modified: 2012-11-18 11:12 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description pilot_pirx 2012-03-22 12:59:04 UTC 
One of the messages produced by doxygen is

file.c:32: warning: Member FOOBAR (define) of file file.c is not documented.

There is no such thing as a "define" in the C and C++ programming languages.
The International C89/C99/C++ Standards all call it "macro".
The language authors Kernighan & Ritchie (and Stroustrup) call it "macro".
All the C and C++ books I ever read call it "macro".
The proper terminology is "macro", not "define".
Only newbie programmers and those unaware of proper terminology would
ever refer to macros as "defines". We don't call a loop a "for",
we don't call an addition a "plus". 

Doxygen should stop promoting and spreading improper terminology.
It's easy to use the correct terminology, so please start doing so.
Comment 1 Dimitri van Heesch 2012-03-22 19:56:30 UTC 
Indeed. Should be corrected in the next subversion update.
Comment 2 Dimitri van Heesch 2012-05-19 12:26:22 UTC 
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.1. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.