gtk-doc and preprocessor statements

[Philip Kovacs <kovacsp3 comcast net>]

I'm using gtk-doc 1.8.  Am I correct that gtk-doc cannot really
use preprocessor statements to conditionally build certain parts
of the documentation?  I am interested in forms such as this:

.h file:
-------

#ifdef HAVE_FOO
/**
 * Foo:
 * @param1: etc.
 * @param2: etc.
 *
 * Description of Foo.
 **/
typedef void (*FooCallback) (void *param1, void *param2);
#endif

(i.e. where the entire definition is omitted from the docs if HAVE_FOO
 isn't defined).

Phil

Attachment: pgpLPdRq1eFDR.pgp
Description: PGP signature