Your message dated Mon, 27 Oct 2008 06:02:17 +0000
with message-id <[EMAIL PROTECTED]>
and subject line Bug#488272: fixed in flex 2.5.35-3
has caused the Debian Bug report #488272,
regarding doxygen: Warning: argument 'bytes' of command @param is not found in 
the argument list of tp_scan_bytes(yyconst char *yybytes, int _yybytes_len)
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [EMAIL PROTECTED]
immediately.)


-- 
488272: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=488272
Debian Bug Tracking System
Contact [EMAIL PROTECTED] with problems
--- Begin Message ---
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



--- End Message ---
--- Begin Message ---
Source: flex
Source-Version: 2.5.35-3

We believe that the bug you reported is fixed in the latest version of
flex, which is due to be installed in the Debian FTP archive:

flex-doc_2.5.35-3_all.deb
  to pool/main/f/flex/flex-doc_2.5.35-3_all.deb
flex_2.5.35-3.diff.gz
  to pool/main/f/flex/flex_2.5.35-3.diff.gz
flex_2.5.35-3.dsc
  to pool/main/f/flex/flex_2.5.35-3.dsc
flex_2.5.35-3_amd64.deb
  to pool/main/f/flex/flex_2.5.35-3_amd64.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to [EMAIL PROTECTED],
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Manoj Srivastava <[EMAIL PROTECTED]> (supplier of updated flex package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [EMAIL PROTECTED])


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.8
Date: Sun, 26 Oct 2008 15:40:54 -0500
Source: flex
Binary: flex flex-doc
Architecture: source amd64 all
Version: 2.5.35-3
Distribution: unstable
Urgency: low
Maintainer: Manoj Srivastava <[EMAIL PROTECTED]>
Changed-By: Manoj Srivastava <[EMAIL PROTECTED]>
Description: 
 flex       - A fast lexical analyzer generator.
 flex-doc   - Documentation for flex (a fast lexical analyzer generator).
Closes: 485095 488272 501960
Changes: 
 flex (2.5.35-3) unstable; urgency=low
 .
   * Bug fix: "debian dir contains *.so", thanks to Raphael Hertzog
     This is a simple rname of a file used purely in packaging, and has low
     risk, but would allow compiling the flex source package with squeeze's
     packaging tools.                                     (Closes: #485095).
   * [88bb2fc] Fix generation of broken output on ia64 when input is piped in
 .
     On ia64, flex appears to generate a completely different (and broken)
     output depending on whether the input file is specified using shell
     redirection or via a pipe.
 .
     This was traced back commit 3971e1a917548977cff71418a7c3575ffbc9571f,
     by Alex Nixon <[EMAIL PROTECTED]>: VFS: increase pseudo-filesystem
     block size to PAGE_SIZE. PAGE_SIZE on ia64 kernels is larger than most
     architectures - 16K is what most distributions (including Debian)
     use. An effect of the above changeset, as verified by strace, is that
     the read() and write() system calls issued by flex on a pipe will use
     this bigger size. fread() appears to be properly hiding the actual
     read size and is returning 8192 byte buffers to flex upon request. I
     verified by this by instrumenting YY_INPUT to compare the fread data
     with the original input file.
 .
     Its probably useful to note that the corruption happening here is that
     the last 382 lines of the input file is being prefixed to the output
     file. The only differences in the remainder of the file are the #line
     numbers. I've also found that bumping YY_READ_BUF_SIZE up to 16384
     seems to workaround the problem - but that may just be putting it back
     into hiding.
 .
     The tradeoff here is between correct operation, by making flex's
     buffer at least as big as the system buffer -- and not bigger, so that
     we do not waste memory. At this point, fixing the isue seems more
     important than worrying that flex consumes and additional 8KB of
     memory.
 .
    This fix unblocks RC bugs on other packages.
 .
     Bug fix: "Generates broken output on ia64 when input is piped vs. shell
     redirection", thanks to Chris Lamb. Fix based on comments by Dann
     Frazier and Michael Casadevall.                         (Closes: #501960)
   * [56ec97d] Fix doxygen comments to reflect actual argument name
     Fix the comments to reflect the actual name of the function
     arguments. This is a pure documentation fix.
     Bug fix: "argument &#39;bytes&#39; of command @param is not found in
     the argument list of tp_scan_bytes(yyconst char *yybytes, int
     _yybytes_len)", thanks to Ludovic Rousseau              (Closes: #488272).
Checksums-Sha1: 
 a5738736917d12457bf6347dc722f95ac4fdf464 1138 flex_2.5.35-3.dsc
 9d76a5de60209a2e326eeb3546cf59788fd3f8e0 37438 flex_2.5.35-3.diff.gz
 622d33fe3c452c13733d7a4cdf0a3b93d442088b 327738 flex_2.5.35-3_amd64.deb
 c235a05048af7b80b017c024d2b03ec1f5d113f8 202136 flex-doc_2.5.35-3_all.deb
Checksums-Sha256: 
 35bfdc513c24c9d4ac733422d41230657fc69c8d258a92b13c9c18a3b2265067 1138 
flex_2.5.35-3.dsc
 445b306bd65fd7e2df48fc16aa7103133a58e6ad0169294135b9dc7991f3f6d4 37438 
flex_2.5.35-3.diff.gz
 b4c5d477d08e432d7ca5d6aab0c11704a02b73927af63d6060931a4e86166558 327738 
flex_2.5.35-3_amd64.deb
 ee950a7ecc1ae343fd357632ded89ad976438a7e6f35ab10a23096ae4e8adbba 202136 
flex-doc_2.5.35-3_all.deb
Files: 
 57f454c515dc8bb2f8fbbf03bc3d6acb 1138 devel standard flex_2.5.35-3.dsc
 d2bd70df72a0b905f5fbe74bc39b95dc 37438 devel standard flex_2.5.35-3.diff.gz
 deb5c13ee161390f52b0ee2233ec9a8a 327738 devel standard flex_2.5.35-3_amd64.deb
 dda3699aa78caa8ce7f8c9be203760de 202136 doc optional flex-doc_2.5.35-3_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYFAkkFVagACgkQIbrau78kQkzNdwCg8k9PN0SohYABKHPv02sHH4XI
YhIAn2LYjCJliAadbE9/Ra0UX1iTEKCI
=6z1+
-----END PGP SIGNATURE-----



--- End Message ---

Reply via email to