how to handle unsafe multihead functions ?

[Erwann Chenede <Erwann Chenede Sun COM>]

Hi,

I'm currently writing the documentation for new API
I've added while implementing multihead support for GTK+.

And I was wondering about the best way to add a note 
or a warning for all functions that are not multihead safe.

At first I thought about modifying gtk-doc in to
pick up automatically the functions that are marked 
as unsafe (as they are already marked in the source files).

Then I realized that this could be too gdk specific for 
gtk-doc (as It is used all across gnome).

What do you, experts, think ?
Should I add them manually or should I modify gtk-doc ?

Thanks.


Erwann

[ I speak for myself, not for my employer. ]
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  Erwann Chénedé, Sun Microsystems Ireland
  Desktop Applications & Middleware Group
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=