gobject introspection annotations


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

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
  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 \

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! 

Iain Nicol

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]