Skip Menu |

This queue is for tickets about the experimental CPAN distribution.

Report information
The Basics
Id: 96263
Status: resolved
Priority: 0/
Queue: experimental

People
Owner: Nobody in particular
Requestors: SJOHNSTON [...] cpan.org
Cc:
AdminCc:

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



Subject: Add 'switch' to documentation
Due to disparity in the core feature/warnings pragmas, "use experimental 'smartmatch'" hides warnings for given/when but does not actually enable the feature. The solution is 'switch' but this is not mentioned in the module's documentation. Alternately, 'smartmatch' could be updated to enable given/when and 'switch' removed.
Subject: Re: [rt.cpan.org #96263] Add 'switch' to documentation
Date: Fri, 6 Jun 2014 08:42:17 +0200
To: bug-experimental [...] rt.cpan.org
From: Leon Timmermans <leont [...] cpan.org>
On Fri, Jun 6, 2014 at 1:16 AM, Stuart A Johnston via RT < bug-experimental@rt.cpan.org> wrote: Show quoted text
> Thu Jun 05 19:15:52 2014: Request 96263 was acted upon. > Transaction: Ticket created by SJOHNSTON > Queue: experimental > Subject: Add 'switch' to documentation > Broken in: (no value) > Severity: (no value) > Owner: Nobody > Requestors: SJOHNSTON@cpan.org > Status: new > Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=96263 > > > > Due to disparity in the core feature/warnings pragmas, "use experimental > 'smartmatch'" hides warnings for given/when but does not actually enable > the feature. The solution is 'switch' but this is not mentioned in the > module's documentation. >
You're correct, this is a documentation bug. "switch" should be mentioned. Show quoted text
> Alternately, 'smartmatch' could be updated to enable given/when and > 'switch' removed. >
Given it's called 'switch' in feature.pm, that may not be logical. Unlike the 'smartmatch' warning it does not affect smartmatching per se, only given/when (this too is currently incorrectly described in the documentation). Leon