[perl #113064] Add for()/when() syntax in official Perl docs

# New Ticket Created by  Perl@ResonatorSoft.org 
# Please include the string:  [perl #113064]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org:443/rt3/Ticket/Display.html?id=113064 >



This is a bug report for perl from Perl@ResonatorSoft.org,
generated with the help of perlbug 1.39 running under perl 5.10.1.

-----------------------------------------------------------------
>From IRC:

Original topic: http://www.effectiveperlprogramming.com/blog/1333

Should we put this into the official Perl docs?  Otherwise, I
imagine the lifecycle of a programmer's use of given/when will be
this:

1. "Hey, this is great!  Finally, a switch/case type syntax."
2. "WTF?  My any { $_ stuff } doesn't work as expected."
3. "Wait, this is SUPPOSED to work like this?"
4. "Okay, I'm swearing off given/when."
5. "Oh wait, so you can actually still use it without all of the
    $_ problems?  Why isn't this in the Perl docs to begin with?"

With various programmers in various states of 1 thru 5.

[Please do not change anything below this line]
-----------------------------------------------------------------
---
Flags:
    category=docs
    severity=medium
---
Site configuration information for perl 5.10.1:

Configured by Debian Project at Thu Jun 30 19:24:11 UTC 2011.

Summary of my perl5 (revision 5 version 10 subversion 1) configuration:

TL;DR

• [perl #113064] Add for()/when() syntax in official Perl docs by Father Chrysostomos via RT
• [perl #113064] Add for()/when() syntax in official Perl docs by James E Keenan via RT
• [perl #113064] Add for()/when() syntax in official Perl docs by Perl @ ResonatorSoft . org