Skip Menu |

This queue is for tickets about the IMAP-Client CPAN distribution.

Report information
The Basics
Id: 23213
Status: open
Priority: 0/
Queue: IMAP-Client

People
Owner: conteb [...] cpan.org
Requestors: ANDK [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: Normal
Broken in: 0.13
Fixed in: (no value)



Subject: doc buglet
Documentation says about select Finally, hash responses will have an ’OK’ key that will contain the current permissional status, either ’READ-WRITE’ or ’READ-ONLY’, if returned by the server. Returns an empty (undefined) hash on error. IMPORTANT! You should always check to see if an ALERT was issued. ALERTs should be relayed to the user if they exist! That should read "Returns undef on error". An undefined hash makes no sense. Also, it might be cheap to explain how one checks for an ALERT. I suppose $obj->error, but one never knows what the author thought. Thanks!
CC: ANDK [...] cpan.org
Subject: Re: [rt.cpan.org #23213] AutoReply: doc buglet
Date: Tue, 14 Nov 2006 22:55:27 +0100
To: bug-IMAP-Client [...] rt.cpan.org
From: andreas.koenig.gmwojprw [...] franz.ak.mind.de (Andreas J. Koenig)
Show quoted text
>>>>> On Tue, 14 Nov 2006 06:32:19 -0500, "Bugs in IMAP-Client via RT" <bug-IMAP-Client@rt.cpan.org> said:
Show quoted text
> That should read "Returns undef on error". An undefined hash makes no sense.
Show quoted text
> Also, it might be cheap to explain how one checks for an ALERT. I > suppose $obj->error, but one never knows what the author thought.
Apologies for the many tickets I sent ontheir way today. RT was broken somehow and responded with that many 500 Server Error to my requests before it accepted the bugreport unambiguously. Thanks, -- andreas
Thanks for the report. I will look into the documentation and adjust it for the next release.