Package: flex Version: 2.5.35-2 Severity: normal Tags: patch The generated C file is not correct for doxygen. Doxugen then complaints with: tokenparser.c:1555: Warning: argument 'bytes' of command @param is not found in the argument list of tp_scan_bytes(yyconst char *yybytes, int _yybytes_len) tokenparser.c:1555: Warning: argument 'len' of command @param is not found in the argument list of tp_scan_bytes(yyconst char *yybytes, int _yybytes_len) tokenparser.c:1555: Warning: The following parameters of tp_scan_bytes(yyconst char *yybytes, int _yybytes_len) are not documented: parameter 'yybytes' parameter '_yybytes_len'
This bug is similar to #320134 I reported 3 years ago. The names used in Doxygen documentation are not the same as the function parameter names. Change bytes in bytes Change len in _yybytes_len Proposed patch: --- flex-2.5.35.orig/skel.c +++ flex-2.5.35/skel.c @@ -2559,8 +2559,8 @@ "%if-c-only", "/** Setup the input buffer state to scan the given bytes. The next call to yylex() will", " * scan from a @e copy of @a bytes.", - " * @param bytes the byte buffer to scan", - " * @param len the number of bytes in the buffer pointed to by @a bytes.", + " * @param yybytes the byte buffer to scan", + " * @param _yybytes_len the number of bytes in the buffer pointed to by @a bytes.", " * M4_YY_DOC_PARAM", " * @return the newly allocated buffer state object.", " */", Thanks -- System Information: Debian Release: lenny/sid APT prefers testing APT policy: (990, 'testing'), (500, 'unstable') Architecture: amd64 (x86_64) Kernel: Linux 2.6.25-trunk-amd64 (SMP w/2 CPU cores) Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/bash Versions of packages flex depends on: ii debconf [debconf-2.0] 1.5.22 Debian configuration management sy ii libc6 2.7-12 GNU C Library: Shared libraries ii m4 1.4.11-1 a macro processing language Versions of packages flex recommends: ii gcc [c-compiler] 4:4.3.1-1 The GNU C compiler ii gcc-4.1 [c-compiler] 4.1.2-22 The GNU C compiler ii gcc-4.2 [c-compiler] 4.2.4-2+b1 The GNU C compiler ii gcc-4.3 [c-compiler] 4.3.1-2 The GNU C compiler -- debconf information: flex/upgrade/pre_2.5.5: false -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
