From: Karen Etheridge Date: Tue, 23 Nov 2021 20:29:54 +0000 (-0800) Subject: Try-Tiny-0.31 X-Git-Tag: v0.31^0 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=0a844ed9d6f5a3b25dfffab1e9d2193120787fae;p=p5sagit%2FTry-Tiny.git Try-Tiny-0.31 - plug Syntax::Keyword::Try and Feature::Compat::Try in the docs --- diff --git a/CONTRIBUTING b/CONTRIBUTING index 833a639..4f07af6 100644 --- a/CONTRIBUTING +++ b/CONTRIBUTING @@ -21,8 +21,8 @@ However, you can run tests directly using the 'prove' tool: $ prove -lv t/some_test_file.t $ prove -lvr t/ -In most cases, 'prove' is entirely sufficient for you to test any -patches you have. +In most cases, 'prove' is entirely sufficient for you to test any patches you +have. You may need to satisfy some dependencies. The easiest way to satisfy dependencies is to install the last release -- this is available at @@ -72,13 +72,22 @@ Once installed, here are some dzil commands you might try: You can learn more about Dist::Zilla at http://dzil.org/. The code for this distribution is hosted at GitHub. The repository is: + https://github.com/p5sagit/Try-Tiny + You can submit code changes by forking the repository, pushing your code -changes to your clone, and then submitting a pull request. Detailed -instructions for doing that is available here: +changes to your clone, and then submitting a pull request. Please include a +suitable end-user-oriented entry in the Changes file describing your change. +Detailed instructions for doing that is available here: https://help.github.com/articles/creating-a-pull-request +All pull requests for this distribution will be automatically tested on Linux +by Travis at: https://travis-ci.com/p5sagit/Try-Tiny +Results will be visible in the pull request on GitHub. Follow the appropriate +links for details when tests fail. Changes will not be mergeable until all +tests pass. + If you have found a bug, but do not have an accompanying patch to fix it, you can submit an issue report here: https://rt.cpan.org/Public/Dist/Display.html?Name=Try-Tiny @@ -92,5 +101,5 @@ wish to be listed under a different name or address, you should submit a pull request to the .mailmap file to contain the correct mapping. -This file was generated via Dist::Zilla::Plugin::GenerateFile::FromShareDir 0.013 from a -template file originating in Dist-Zilla-PluginBundle-Author-ETHER-0.132. +This file was generated via Dist::Zilla::Plugin::GenerateFile::FromShareDir 0.015 +from a template file originating in Dist-Zilla-PluginBundle-Author-ETHER-0.161. diff --git a/Changes b/Changes index b1b78e1..8bc4935 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ Revision history for Try-Tiny -{{$NEXT}} +0.31 2021-11-23 20:29:12Z - plug Syntax::Keyword::Try and Feature::Compat::Try in the docs 0.30 2017-12-21 07:23:03Z diff --git a/INSTALL b/INSTALL index 98c01b2..93ff671 100644 --- a/INSTALL +++ b/INSTALL @@ -21,8 +21,11 @@ Alternatively, if your CPAN shell is set up, you should just be able to do: ## Manual installation -As a last resort, you can manually install it. Download the tarball, untar it, -then build it: +As a last resort, you can manually install it. If you have not already +downloaded the release tarball, you can find the download link on the module's +MetaCPAN page: https://metacpan.org/pod/Try::Tiny + +Untar the tarball, install configure prerequisites (see below), then build it: % perl Makefile.PL % make && make test @@ -31,13 +34,42 @@ Then install it: % make install +On Windows platforms, you should use `dmake` or `nmake`, instead of `make`. + If your perl is system-managed, you can create a local::lib in your home directory to install modules to. For details, see the local::lib documentation: https://metacpan.org/pod/local::lib +The prerequisites of this distribution will also have to be installed manually. The +prerequisites are listed in one of the files: `MYMETA.yml` or `MYMETA.json` generated +by running the manual build process described above. + +## Configure Prerequisites + +This distribution requires other modules to be installed before this +distribution's installer can be run. They can be found under the +"configure_requires" key of META.yml or the +"{prereqs}{configure}{requires}" key of META.json. + +## Other Prerequisites + +This distribution may require additional modules to be installed after running +Makefile.PL. +Look for prerequisites in the following phases: + +* to run make, PHASE = build +* to use the module code itself, PHASE = runtime +* to run tests, PHASE = test + +They can all be found in the "PHASE_requires" key of MYMETA.yml or the +"{prereqs}{PHASE}{requires}" key of MYMETA.json. + ## Documentation Try-Tiny documentation is available as POD. -You can run perldoc from a shell to read the documentation: +You can run `perldoc` from a shell to read the documentation: % perldoc Try::Tiny + +For more information on installing Perl modules via CPAN, please see: +https://www.cpan.org/modules/INSTALL.html diff --git a/README.pod b/README.pod index 3623442..bb04e5c 100644 --- a/README.pod +++ b/README.pod @@ -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 block without a preceding C block suppresses any errors. This behaviour is consistent with using a standalone C, but it is not consistent with C/C patterns found in other programming languages, such as Java, Python, Javascript or C#. If you -learnt the C/C pattern from one of these languages, watch out for +learned the C/C 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 + +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 and C within it). Use +L to automatically switch to the native C syntax in newer perls (when +available). See also L. + =item L Much more feature complete, more convenient semantics, but at the cost of @@ -503,7 +510,7 @@ Jesse Luehrs =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 =item * -Lukas Mai - -=item * - Aristotle Pagaltzis =item * @@ -541,11 +544,11 @@ Dagfinn Ilmari Mannsåker =item * -Paul Howarth +Lukas Mai =item * -Rudolf Leermakers +Alex =item * @@ -553,15 +556,15 @@ anaxagoras =item * -awalker +Andrew Yates =item * -chromatic +awalker =item * -Alex +chromatic =item * @@ -569,10 +572,6 @@ cm-perl =item * -Andrew Yates - -=item * - David Lowe =item * @@ -603,6 +602,14 @@ Mark Stosberg Pali +=item * + +Paul Howarth + +=item * + +Rudolf Leermakers + =back =head1 COPYRIGHT AND LICENCE