Re: patch to XML docbook output

["Matthias Clasen" <Matthias Clasen poet de>]

James,

seeing that you replaced   made me think of one little complication 
on
your way to entity-less xml: We need a way to escape the gtk-doc 
abbreviations
(#, %, ())  in a way which makes gtk-doc not recognize them, but still let 
them
come out as expected in the resulting document. So far, we used
&hash; &percent; and (<!-- -->)) for this purpose. If you want to eschew 
entities
completely, you'll have to invent some other mechanism for # and % 
suppression
and make all docs use it. We should probably also think about documenting
some of these conventions ...

Matthias