Re: Inline docs

["Matthias Clasen" <matthiasc poet de>]

One more gtk-doc buglet I noticed while regenerating glib reference docs:

The gtk-doc scripts generate SGML ids from C symbols without
taking care of the NAMELEN parameter of the docbook SGML declaration.

Since docbook has NAMELEN 44, this starts to be problematic
for some long symbols:

g-main-context-find-source-by-funcs-user-data
g-win32-get-package-installation-subdirectory

I see two approaches for fixing this:

1) change CreateValidSGMLID to truncate ids to 44 chars 
2) Ship a custom SGML declaration with a larger NAMELEN parameter

But it is currently not a critical problem, since jade continues after
complaining about this (it would become a problem if there were lots of
these long symbols, since jade will give up after 100 errors or so)

Matthias