Skip Menu |

This queue is for tickets about the Encode-Punycode CPAN distribution.

Report information
The Basics
Id: 116796
Status: resolved
Priority: 0/
Queue: Encode-Punycode
People
Owner: CFAERBER [...] cpan.org
Requestors: dolmen [...] cpan.org
Cc:
AdminCc:
Bug Information
Severity: (no value)
Broken in: 1.001
Fixed in: 1.002

History Show all quoted text
  Tue Aug 09 11:16:37 2016 dolmen [...] cpan.org - Ticket created
Subject: Fix for SYNOPSIS
Contrary to what is written in the SYNOPSIS section of the POD, Encode::Punycode must be explicitely loaded.

Demo:
- this doesn't work:

        $ perl -MEncode -E 'say encode(Punycode => "xx")'
        Unknown encoding 'Punycode' at -e line 1.

- this works:
        $ perl -MEncode -MEncode::Punycode -E 'say encode(Punycode => "xx")'
        xx-


So a line "use Encode::Punycode;" must be added to the SYNOPSIS. See also the Test::Synopsis module that could be useful to check that the SYNOPSIS code works.

-- 
Olivier Mengué - http://perlresume.org/DOLMEN
  Tue Sep 13 16:02:47 2016 CFAERBER [...] cpan.org - Taken
  Tue Sep 13 16:05:06 2016 CFAERBER [...] cpan.org - Correspondence added
Thanks for your report. I'm a bit hesitant to release a new version just to update the documentation. Given that this module is (nearly) five years old, there's probably enough other areas where it's not up to the current practices.
  Tue Sep 13 16:05:07 2016 The RT System itself - Status changed from 'new' to 'open'
  Sun Jan 01 07:18:32 2017 CFAERBER [...] cpan.org - Fixed in 1.002 added
  Sun Jan 01 07:18:33 2017 CFAERBER [...] cpan.org - Status changed from 'open' to 'resolved'