Re: How to create docs for signal prototypes

[Brian Cameron <Brian Cameron sun com>]

Gtk-doc experts:

Another problem that I am having is that when I am trying to build
my gtk-docs I get these warnings:

--gtk-doc warning start--

*** Building SGML ***
cd . && \
        gtkdoc-mkdb --module=atk --source-dir=../atk 
Cannot parse structure field G_CONST_RETURN gchar*   (*get_description)   
(AtkAction         *action,
                                                gint              i) at 
/sgnome/gnome2.0/sparc-solaris/bin/gtkdoc-mkdb line 2473, <INPUT> chunk 5.
Cannot parse structure field G_CONST_RETURN gchar*   (*get_keybinding)    
(AtkAction         *action,
                                                gint              i) at 
/sgnome/gnome2.0/sparc-solaris/bin/gtkdoc-mkdb line 2473, <INPUT> chunk 5.
Cannot parse structure field G_CONST_RETURN gchar* ( *get_image_description) 
(AtkImage              *image) at /sgnome/gnome2.0/sparc-solaris/bin/gtkdoc-mkdb 
line 2473, <INPUT> chunk 85.

--gtk-doc warning end--

Here is an example of the code that seems to be making it puke:

--example code start--

struct _AtkImageIface
{
  GTypeInterface parent;

  G_CONST_RETURN gchar* ( *get_image_description)
    (AtkImage		 *image);
  void			( *get_image_size)	  
    (AtkImage		 *image,
     gint			 *height,
     gint			 *width);
  gboolean		( *set_image_description) 
    (AtkImage		 *image,
    const gchar		 *description);
};

--example code stop--

It seems to hate the G_CONST_RETURN macro.  How do I fix this?

Brian