GNOME Bugzilla – Bug 532395
inline function parsing problems (e.g. in glib api docs)
Last modified: 2009-01-26 08:35:41 UTC
gtkdoc-mkdb --module=glib --source-dir=../../.. --output-format=xml --expand-content-files="" --main-sgml-file=glib-docs.sgml --sgml-mode --output-format=xml Use of uninitialized value in concatenation (.) or string at /opt/gnome2/share/gtk-doc/data/gtkdoc-common.pl line 326. Use of uninitialized value in concatenation (.) or string at /opt/gnome2/share/gtk-doc/data/gtkdoc-common.pl line 326. :: warning: Parameter description for Returns is missing in source code comment block. ./tmpl/types.sgml:182: warning: Can't parse args for function guint64: *g_thread_gettime) (void ./tmpl/macros_misc.sgml:370: warning: Can't parse args for function G_LIKELY: g_atomic_pointer_get ((void*volatile*) value_location) != NULL)return FALSE;elsereturn g_once_init_enter_impl (value_location Use of uninitialized value in concatenation (.) or string at /opt/gnome2/share/gtk-doc/data/gtkdoc-common.pl line 326. Use of uninitialized value in concatenation (.) or string at /opt/gnome2/share/gtk-doc/data/gtkdoc-common.pl line 326. :: warning: Field description for closure_callback is missing in source code comment block.
gtk-doc: Rebuilding template files cd . && gtkdoc-mktmpl --module=glib ###Can't parse args for function guint64: *g_thread_gettime) (void ###Can't parse args for function G_LIKELY: g_atomic_pointer_get ((void*volatile*) value_location) != NULL)return FALSE;elsereturn g_once_init_enter_impl (value_location WARNING: No declaration found for: tm WARNING: No declaration found for: g_test_config_vars
Regarding comment #1. will cehck those, should be easy to fix. Regarding comment #2 it seems to identify function pointer declarations as functions. will check that too.
svn should be improved now. Atleast those "Use of uninitialized value in concatenation (.) or string at" mentioned in comment #1 should be fixed. the parsing issues are a different story.
hmmpf, not very nice things: Problem 1: find . -type f -exec grep -Hn "*g_thread_gettime) (void" {} \; ./gthread.c:87:guint64 (*g_thread_gettime) (void) = gettime; ./gthread.h:120:GLIB_VAR guint64 (*g_thread_gettime) (void); find . -type f -exec grep -Hn "__builtin_clzl(number)) + 1" {} \; ./gutils.h:350: ((GLIB_SIZEOF_LONG * 8 - 1) ^ __builtin_clzl(number)) + 1 : 1;
Adding SCAN_OPTIONS=--ignore-decorators="GLIB_VAR" glib's Makefile.am to fix Problem 1 (duplicate of Bug #477532).
2009-01-26 Stefan Kost <ensonic@users.sf.net> * gtkdoc-scan.in: * tests/bugs/docs/tester-sections.txt: * tests/bugs/src/tester.c: * tests/bugs/src/tester.h: Handle inline functions in headers. Fixes #532395.