Package: flex
Version: 2.5.31-31
Severity: minor

flex generates a .c source code containing Doxygen documentation. One
field has a wrong documentation.

Patch proposed:

--- ./skel.c.orig       2005-07-27 11:22:44.566557986 +0200
+++ ./skel.c    2005-07-27 11:22:57.594918228 +0200
@@ -2450,7 +2450,7 @@
   "%if-c-only",
   "/** Setup the input buffer state to scan a string. The next call to yylex() 
will",
   " * scan from a @e copy of @a str.",
-  " * @param str a NUL-terminated string to scan",
+  " * @param yy_str a NUL-terminated string to scan",
   " * M4_YY_DOC_PARAM",
   " * @return the newly allocated buffer state object.",
   " * @note If you want to scan bytes that may contain NUL values, then use",


The doxygen warning is:
foo.c:1448: Warning: argument `str' of command @param is not found in the 
argument list of yy_scan_string(yyconst char *yy_str)
foo.c:1448: Warning: The following parameters of yy_scan_string(yyconst char 
*yy_str) are not documented: parameter yy_str

Thanks,


-- System Information:
Debian Release: 3.1
  APT prefers unstable
  APT policy: (50, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.8-2-686-smp
Locale: [EMAIL PROTECTED], [EMAIL PROTECTED] (charmap=ISO-8859-15)

Versions of packages flex depends on:
ii  libc6                       2.3.2.ds1-22 GNU C Library: Shared libraries an
ii  m4                          1.4.2-1      a macro processing language

-- debconf information:
  flex/upgrade/pre_2.5.5: false


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to