From: Johan Vromans <jvromans@squirrel.nl>
Date: Sat, 28 May 2011 02:57:58 +0000 (-0600)
Subject: feature.pm: Improve pod wording
X-Git-Tag: accepted/trunk/20130322.191538~4035
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=a3a91442a5b655a7a1aab2532214ecdae698a3e1;p=platform%2Fupstream%2Fperl.git

feature.pm: Improve pod wording
---

diff --git a/lib/feature.pm b/lib/feature.pm
index fd9e174..c322440 100644
--- a/lib/feature.pm
+++ b/lib/feature.pm
@@ -129,12 +129,22 @@ implemented until 5.13.8.
 It's possible to load a whole slew of features in one go, using
 a I<feature bundle>. The name of a feature bundle is prefixed with
 a colon, to distinguish it from an actual feature. At present, the
-only feature bundle is C<use feature ":5.10"> which is equivalent
-to C<use feature qw(switch say state)>.
+only feature bundles correspond to Perl releases, e.g. C<use feature
+":5.10"> which is equivalent to C<use feature qw(switch say state)>.
 
-Specifying sub-versions such as the C<0> in C<5.10.0> in feature bundles has
+By convention, the feature bundle for any given Perl release includes
+the features of previous releases, down to and including 5.10, the
+first official release to provide this facility. Since Perl 5.12
+only provides one new feature, C<unicode_strings>, and Perl 5.14
+provides none, C<use feature ":5.14"> is equivalent to C<use feature
+qw(switch say state unicode_strings)>.
+
+Specifying sub-versions such as the C<0> in C<5.14.0> in feature bundles has
 no effect: feature bundles are guaranteed to be the same for all sub-versions.
 
+Note that instead of using release-based feature bundles it is usually
+better, and shorter, to use implicit loading as described below.
+
 =head1 IMPLICIT LOADING
 
 There are two ways to load the C<feature> pragma implicitly :