[DOC++] BUG: choke on strings like "/* foobar"
Brought to you by:
adragos
From: Sven H. <he...@in...> - 2003-02-04 13:00:59
|
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] |