Re: Problem about secondly run "gtkdoc-mkdb"

2009/8/3 Stefan Kost <ensonic hora-obscura de>
cee1 schrieb:
> 2009/8/2 Stefan Kost <ensonic hora-obscura de>
>> hi,
>> cee1 schrieb:
>>> Hi all,
>>> I'm using gtk-doc(1.11) to manager documents of my small project. I
>>> encounter some problems like: "../xml/foo.xml:161: parser error : Entity
>>> 'ast' not defined", when secondly running gtk-doc.
>>> The steps are:
>>> 1) gtkdoc-scan --module=foo --source-dir=../../foo --ignore-headers="a.h
>>> b.h"
>>> 2) gtkdoc-mkdb --module=foo --source-dir=../../foo --output-format=xml
>>> --expand-content-files="" --main-sgml-file=foo-docs.sgml --sgml-mode
>>> --output-format=xml --ignore-files="a.c b.h"
>>> ...
>> Are you using the normal gtkdoc.make included in your makefile?
> Yes.
>>> I find in the second time, gtkdoc-mkdb generates XML files missing the
>>> following:
>>> <?xml version="1.0"?>
>>> <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
>>>                "">
>> The doctype is copied if the foo-docs.sgml or foo-docs.xml main document
>> has it.
>> Is the project publicly available somewhere?
> If the foo-docs.sgml already exists, rerunning gtkdoc-mkdb will generate
> doctype-missing XML files, hence cause the "../xml/foo.xml:161: parser error
> : Entity 'ast' not defined".

How come it does not exist earlier? gtkdoc creates a template on the very first
run, but you need to edit that to suit you and add it to your version control
After first run gtk-doc,  the foo-docs.sgml is there. Re-run gtkdoc-mkdb will generate doctype-missing XML files, unless delete the foo-docs.sgml.

The same problem exists in glib, when I do:

1) In the top-level directory of glib, run ./ --enable-gtk-doc

2) cd docs/reference/glib        # could see the glib-docs.sgml is shipped with glib

3) make                               # check files in XML directory, they are missing the "doctype"

4) rm -f glib-docs.sgml && make clean && make

5) now check files in XML directory, they are OK.

Could you also try with gtk-doc from - I'd like to release 1.12 in
september, would be good to see if its already fixed? Unfortunately I'll be on
vacation starting from tomorrow, so I won't be able to reply in august anymore.
Hopefully someone else on the list can help.

OK, thanks any way. 

> The project is not public yet, since the documents not ready.
>> Stefan
>>> Any suggestions?
>>> Thanks.

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