No, the comment block is listing the functions that are defined in the file. And yes I understand that there might actually be a use in doing that, but it's still funny to think of it along the lines of telling the user "Well if ENABLE_FOO isn't defined, then block it out of your head that function foo exists." Kind of like the episode of The Simpsons where Lisa found "Area 51A" and the map plaqard in front of the place had a red dot and said, "You are here. We are not"
W
WTFDan
@WTFDan
0
Reputation
2
Posts
24
Profile views
0
Followers
0
Following
Best posts made by WTFDan
This user hasn't posted anything yet.
Latest posts made by WTFDan
-
RE: Conditional comments
-
Conditional comments
Not really a WTF, but still funny. The C file begins with a long comment block that has a description of the functions it contains:
/*
....
* Internal Routines:
...
* bar
#ifdef ENABLE_FOO
* foo
#endif
* baz
...
*/
Because, after all, you wouldn't want "foo" to appear in the comments unless it's enabled.