Re: gtk-doc and preprocessor statements

[Philip Kovacs <kovacsp3 comcast net>]

Damon Chaplin wrote:
> gtk-doc doesn't do anything like that.
>
> I'm not sure how useful it would be anyway. Wouldn't it be more useful
> to include the function in the documentation and say that it is only
> available where FOO is installed? Otherwise developers may use the
> function and not realise it may not be available everywhere. Or if they
> don't have FOO installed they may not know the function is available at
> all.
>
> Damon
Yes, it is probably better to return some error, e.g. a GError "function
not available", back to the
caller of any library function that is not available on the
installation, rather than hiding the function
altogether.

Thanks for your reply.

Phil