Re: gnome-libs/devel-docs et al (hello, and long)

[Damon Chaplin <damon karuna freeserve co uk>]

Steve Haslam wrote:

[snip]
> Copying in gnome-docs.sgml from CVS to devel-docs/gnome seems to
> remove the first jade error message, although I still have others :
> 
> jade:../sgml/gnome-config.sgml:103:6:E: document type does not allow element "SECT2" here
> jade:../sgml/gnome-config.sgml:157:6:E: document type does not allow element "SECT2" here
> jade:../sgml/gnome-i18n.sgml:54:29:E: character ":" is not allowed in the value of attribute "LINKEND"
> jade:../sgml/gnome-metadata.sgml:75:9:E: character ":" is not allowed in the value of attribute "LINKEND"
> jade:/usr/lib/sgml/stylesheet/dsssl/gtk-doc//gtk-doc.dsl:90:7:E: reference to undefined variable "$verbatim-content-with-linenumbers$"
> jade:/usr/lib/sgml/stylesheet/dsssl/gtk-doc//gtk-doc.dsl:91:7:E: reference to undefined variable "$verbatim-content$"
> jade:/usr/lib/dsssl/stylesheets/docbook/html/dbverb.dsl:162:24:E: too many arguments for function
> jade:/usr/lib/dsssl/stylesheets/docbook/html/dbverb.dsl:158:24:E: too many arguments for function
> jade:/usr/lib/dsssl/stylesheets/docbook/html/dbsynop.dsl:136:26:E: too many arguments for function
> jade:/usr/lib/dsssl/stylesheets/docbook/html/dbsynop.dsl:9:18:E: too many arguments for function

The last 6 errors here are due to recent changes in the DocBook stylesheets which messed
up the customizations used in gtk-doc. Its fixed in CVS gtk-doc.
The other 4 errors are just minor problems, I think. I'll check if its a problem in gtk-doc.


I think devel-docs/gdoc (and tools/gnome-doc) were used to generate the DocBook documentation
from comments in the source code, before switching to gtk-doc (which was originally just for GTK+).

I don't think they are used any more. Maybe they should be removed, together with the
devel-docs/libgnome.sgml & libgnomeui.sgml files which they generated, and the stuff
in devel-docs/Makefile.am which uses them.


Damon