caveat about error-silencing

diff --git a/lib/Try/Tiny.pm b/lib/Try/Tiny.pm
index 5055cc1..795272e 100644 (file)
--- a/lib/Try/Tiny.pm
+++ b/lib/Try/Tiny.pm
@@ -157,6 +157,9 @@ Try::Tiny - minimal try/catch with proper localization of $@
 
 =head1 SYNOPSIS
 
+You can use Try::Tiny's C<try> and C<catch> to expect and handle exceptional
+conditions, avoiding quirks in Perl and common mistakes:
+
        # handle errors with a catch handler
        try {
                die "foo";
@@ -164,6 +167,10 @@ Try::Tiny - minimal try/catch with proper localization of $@
                warn "caught error: $_"; # not $@
        };
 
+You can also use it like a stanalone C<eval> to catch and ignore any error
+conditions.  Obviously, this is an extreme measure not to be undertaken
+lightly:
+
        # just silence errors
        try {
                die "foo";