Try-Tiny-0.31
[p5sagit/Try-Tiny.git] / README.pod
index 3623442..bb04e5c 100644 (file)
@@ -8,7 +8,7 @@ Try::Tiny - Minimal try/catch with proper preservation of $@
 
 =head1 VERSION
 
-version 0.30
+version 0.31
 
 =head1 SYNOPSIS
 
@@ -76,7 +76,7 @@ Note that adding a C<finally> block without a preceding C<catch> block
 suppresses any errors. This behaviour is consistent with using a standalone
 C<eval>, but it is not consistent with C<try>/C<finally> patterns found in
 other programming languages, such as Java, Python, Javascript or C#. If you
-learnt the C<try>/C<finally> pattern from one of these languages, watch out for
+learned the C<try>/C<finally> pattern from one of these languages, watch out for
 this.
 
 =head1 EXPORTS
@@ -442,6 +442,13 @@ is unclear whether the new version 18 behavior is final.
 
 =over 4
 
+=item L<Syntax::Keyword::Try>
+
+Only available on perls >= 5.14, with a slightly different syntax (e.g. no trailing C<;> because
+it's actually a keyword, not a sub, but this means you can C<return> and C<next> within it). Use
+L<Feature::Compat::Try> to automatically switch to the native C<try> syntax in newer perls (when
+available). See also L<Try Catch Exception Handling|perlsyn/Try-Catch-Exception-Handling>.
+
 =item L<TryCatch>
 
 Much more feature complete, more convenient semantics, but at the cost of
@@ -503,7 +510,7 @@ Jesse Luehrs <doy@tozt.net>
 
 =head1 CONTRIBUTORS
 
-=for stopwords Karen Etheridge Peter Rabbitson Ricardo Signes Mark Fowler Graham Knop Lukas Mai Aristotle Pagaltzis Dagfinn Ilmari Mannsåker Paul Howarth Rudolf Leermakers anaxagoras awalker chromatic Alex cm-perl Andrew Yates David Lowe Glenn Hans Dieter Pearcey Jens Berthold Jonathan Yu Marc Mims Stosberg Pali
+=for stopwords Karen Etheridge Peter Rabbitson Ricardo Signes Mark Fowler Graham Knop Aristotle Pagaltzis Dagfinn Ilmari Mannsåker Lukas Mai Alex anaxagoras Andrew Yates awalker chromatic cm-perl David Lowe Glenn Hans Dieter Pearcey Jens Berthold Jonathan Yu Marc Mims Stosberg Pali Paul Howarth Rudolf Leermakers
 
 =over 4
 
@@ -529,10 +536,6 @@ Graham Knop <haarg@haarg.org>
 
 =item *
 
-Lukas Mai <l.mai@web.de>
-
-=item *
-
 Aristotle Pagaltzis <pagaltzis@gmx.de>
 
 =item *
@@ -541,11 +544,11 @@ Dagfinn Ilmari Mannsåker <ilmari@ilmari.org>
 
 =item *
 
-Paul Howarth <paul@city-fan.org>
+Lukas Mai <l.mai@web.de>
 
 =item *
 
-Rudolf Leermakers <rudolf@hatsuseno.org>
+Alex <alex@koban.(none)>
 
 =item *
 
@@ -553,15 +556,15 @@ anaxagoras <walkeraj@gmail.com>
 
 =item *
 
-awalker <awalker@sourcefire.com>
+Andrew Yates <ayates@haddock.local>
 
 =item *
 
-chromatic <chromatic@wgz.org>
+awalker <awalker@sourcefire.com>
 
 =item *
 
-Alex <alex@koban.(none)>
+chromatic <chromatic@wgz.org>
 
 =item *
 
@@ -569,10 +572,6 @@ cm-perl <cm-perl@users.noreply.github.com>
 
 =item *
 
-Andrew Yates <ayates@haddock.local>
-
-=item *
-
 David Lowe <davidl@lokku.com>
 
 =item *
@@ -603,6 +602,14 @@ Mark Stosberg <mark@stosberg.com>
 
 Pali <pali@cpan.org>
 
+=item *
+
+Paul Howarth <paul@city-fan.org>
+
+=item *
+
+Rudolf Leermakers <rudolf@hatsuseno.org>
+
 =back
 
 =head1 COPYRIGHT AND LICENCE