Bug #72889 for libnet: Net::FTP message method documentation

Fri Dec 02 07:52:27 2011 smylers [...] cpan.org - Ticket created

Subject:

Net::FTP message method documentation

The synopsis of Net::FTP shows a ->message function being used, but this isn't actually documented anywhere.

Fri Dec 02 10:10:18 2011 gbarr [...] pobox.com - Correspondence added

Subject:	Re: [rt.cpan.org #72889] Net::FTP message method documentation
Date:	Fri, 2 Dec 2011 09:10:03 -0600
To:	bug-libnet [...] rt.cpan.org
From:	Graham Barr <gbarr [...] pobox.com>

It is documented in the documentation for Net::Cmd. Net::FTP documentation does state that Net::FTP inherits from Net::Cmd so methods defined in Net::Cmd may be used Graham.

Fri Dec 02 10:10:20 2011 The RT System itself - Status changed from 'new' to 'open'

Fri Dec 02 10:22:37 2011 Smylers [...] stripey.com - Correspondence added

Subject:	Re: [rt.cpan.org #72889] Net::FTP message method documentation
Date:	Fri, 2 Dec 2011 15:22:25 +0000
To:	Graham Barr via RT <bug-libnet [...] rt.cpan.org>
From:	Smylers <Smylers [...] stripey.com>

Hi Graham. Thanks for such a speedy response. Graham Barr via RT writes: Show quoted text

> It is documented in the documentation for Net::Cmd. Net::FTP > documentation does state that Net::FTP inherits from Net::Cmd so > methods defined in Net::Cmd may be used

Ah, so it does. I hadn't spotted that, and searching the page for 'method' didn't throw up anything. Unfortunately that Net::FTP inherits from Net::Cmd is only mentioned in the 'Methods for the adventurous' section, which I'd skipped because I wasn't feeling very adventurous. Since seeing appropriate error messages is something that everybody should be doing, however unadventurous they are, it would help if either that note is moved to somewhere more prominent (or, if ->message is the only non-adventurous method it makes sense to use from Net::Cmd, that ->message is called out separately). Cheers. Smylers

Thu Jan 30 09:09:01 2014 shay [...] cpan.org - Correspondence added

Apologies for the somewhat slower response from me! This is now fixed in the forthcoming libnet-1.25, which moves the note about Net::Cmd inheritance to the start of the METHODS documentation, and does likewise in Net::NNTP/POP3/SMTP too. Thanks for the suggestion.

Thu Jan 30 09:09:02 2014 shay [...] cpan.org - Status changed from 'open' to 'patched'

Tue Feb 04 13:41:45 2014 shay [...] cpan.org - Correspondence added

Thanks again, now fixed in libnet-1.25.

Tue Feb 04 13:41:46 2014 shay [...] cpan.org - Status changed from 'patched' to 'resolved'

Tue Feb 04 13:41:46 2014 shay [...] cpan.org - Fixed in 1.25 added