Re: Inline docs
- From: "Matthias Clasen" <matthiasc poet de>
- To: <gtk-devel-list gnome org>
- Cc: <damon ximian com>
- Subject: Re: Inline docs
- Date: Tue, 25 Sep 2001 11:02:10 +0200
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
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]