Hi !
doc++ (v3.4.8 and v3.4.10) seems to have a problem with character
strings as the following appearing somewhere in the source file:
--- snip --
buf = g_strdup_printf("count(/*/sls)");
--- snip --
It probably interprets the string "count(/*/sls)" ) as start of a
comment and threats the following lines as the comment itself. Thus
the documentation of following subroutine(s) will be ignored.
Example:
# cat /tmp/bar.c
/**
@memo parse a set of sls
@doc sls_local_parse
@return NULL on error
*/
gint *sls_local_parse() {
gchar *buf;
buf = g_strdup_printf("count(/*/sls)");
return array;
}
/**
@memo parse a set of sls
@doc sls_not_local_parse
@return NULL on error
*/
gint sls_notlocal_parse() {
gchar *buf;
buf = g_strdup_printf("count(/*/sls)");
return 0;
}
# doc++ --full-toc --private --filenames --no-define --dir /tmp/foo
/tmp/bar.c
There will be no documentation generated for the second sub function
"sls_not_local()".
Would be nice to get any feedback.
best regards,
Sven
--
"They expect nothing. They can no longer be surprised." [XP explained]
|
