Re: gtk-doc xml patch (take 3)

[Matthias Clasen <maclas gmx de>]

> > 
> > Conversion of the driver docs to use xinclude instead of entities was
> > straightforward except for gdk-pixbuf, where we're hurt by the inability
> > to define &gdk-pixbuf; and &imlib; for the whole document. I had to
> > expand the references in all included docs. One possibility to improve
> > this situation would be to copy the internal subset from the main file
> > to the generated files.
> 
> Pretend I'm stupid. I don't understand this paragraph at all ... can you
> elaborate on what the problem is, please.
> 

The gdk-pixbuf.sgml driver starts with

<DOCTYPE book PUBLIC "..." [
<!ENTITY gdk-pixbuf "<application>gdk-pixbuf</application>">
<!ENTITY imlib "<application>imlib</application>">
]>

and then throughout the document, &gdk-pixbuf; and  &imlib; are used
whenever these applications are mentioned. This doesn't work any longer
when the entities are converted to xincluded separate documents, since
James patch adds a doctype declaration without an internal subset
to the generated documents (ie <!DOCTYPE refentry PUBLIC "...">), so 
the &gdk-pixbuf; and &imlib; entities are simply not known in the generated
documents. The proposed solution is to not hardcode the doctype declaration
which gets prepended to the generated docs, but rather read the one from
the driver file, s/book/refentry/ and use that. 

Matthias

-- 
GMX - Die Kommunikationsplattform im Internet.
http://www.gmx.net