gobject introspection annotations

[Iain Nicol <iain thenicols net>]

Hi,

I'm adding gobject introspection annotations to Epiphany, because it
needs some.  My problem is I don't know how to get gtk-doc to recognise
them.  Instead of gtk-doc understanding and describing the annotations,
gtk-doc creates links to FOLDOC; the symptoms are like in
<https://bugzilla.gnome.org/show_bug.cgi?id=598732>.

I've compiled gtk-doc from git.  In particular, the ``annotations'' test
that comes with gtk-doc works fine.  Yet I don't know how to get it to
work for Epiphany.

Is there any particular makefile or autofoo stuff or flags I should look
at?  Where could the problem lie? -mkdb?


Epiphany's doc build process seems fairly normal.  It has gtk-doc build
and run a scanner.  Then the templates are created:
  cd . && gtkdoc-mktmpl --module=epiphany
then:
  cd . && gtkdoc-mkdb --module=epiphany --source-dir=../.. \
                     --output-format=xml --sgml-mode --output-format=xml
and then:
  cd ./html && gtkdoc-mkhtml epiphany ../epiphany-docs.sgml
and finally:
  cd . && gtkdoc-fixxref --module-dir=html \
                         --html-dir=/usr/local/share/gtk-doc/html 

There's loads of output from all the commands, but the only relevant
thing I could see was the following warning from -mkhtml:

  In gtk-doc.xsl: For acronym (transfer none) no value found! 


Thanks,
-- 
Iain Nicol
<http://www.iainnicol.com./>