Bug#631835: misleading documentation on the timeout parameter

[Christopher Wood]

Subject: libnet-stomp-perl: misleading documentation on the timeout parameter
Package: libnet-stomp-perl
Version: 0.38-1
Severity: normal

*** Please type your report below this line ***

Per the documentation, this should time out:

my $frame = $stomp->receive_frame( { timeout => $receive_timeout } );

However, it does not time out, blocking until there is a message to read. Strace has the script attempting to read the empty queue and nothing else.

The bug is either that the code doesn't time out the receive_frame, or that the documentation doesn't state that the timeout doesn't happen the way we think it might (timeout ends, read attempt ends too).

Other people have run into this:

http://www.perlmonks.org/?node_id=855264

Thanks for your work on packaging Perl in Debian.

-- System Information:
Debian Release: 6.0.2
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 2.6.32-5-486
Locale: LANG=en_CA.UTF8, LC_CTYPE=en_CA.UTF8 (charmap=UTF-8) (ignored: LC_ALL set to en_CA.UTF8)
Shell: /bin/sh linked to /bin/dash

Versions of packages libnet-stomp-perl depends on:
ii  libclass-accessor-perl 0.34-1            Perl module that automatically gen
ii  perl                   5.10.1-17squeeze1 Larry Wall's Practical Extraction 

libnet-stomp-perl recommends no packages.

libnet-stomp-perl suggests no packages.

-- no debconf information