aboutsummaryrefslogtreecommitdiff
path: root/perl/perl-Carp-Clan
diff options
context:
space:
mode:
authorB. Watson <yalhcru@gmail.com>2022-03-14 03:55:00 -0400
committerB. Watson <yalhcru@gmail.com>2022-03-14 03:55:00 -0400
commitaecbeedba73b951ada445a05c12753ccede7e757 (patch)
tree51823abf988511604f7cba0fbbb3f1d448ba195e /perl/perl-Carp-Clan
parent5d2cb106b78fea39b5baa9644a20aaa16ea4934d (diff)
perl/perl-Carp-Clan: Wrap README at 72 columns.
Signed-off-by: B. Watson <yalhcru@gmail.com>
Diffstat (limited to 'perl/perl-Carp-Clan')
-rw-r--r--perl/perl-Carp-Clan/README37
1 files changed, 21 insertions, 16 deletions
diff --git a/perl/perl-Carp-Clan/README b/perl/perl-Carp-Clan/README
index f74236ebc6435..49ebf4aa61973 100644
--- a/perl/perl-Carp-Clan/README
+++ b/perl/perl-Carp-Clan/README
@@ -1,20 +1,25 @@
-Carp::Clan - Report errors from perspective of caller of a "clan" of modules.
+Carp::Clan - Report errors from perspective of caller of a "clan"
+of modules.
-This module is based on "Carp.pm" from Perl 5.005_03. It has been modified to
-skip all package names matching the pattern given in the "use" statement
-inside the "qw()" term (or argument list).
-Suppose you have a family of modules or classes named "Pack::A", "Pack::B" and
-so on, and each of them uses "Carp::Clan qw(^Pack::);" (or at least the one in
-which the error or warning gets raised).
-Thus when for example your script "tool.pl" calls module "Pack::A", and module
-"Pack::A" calls module "Pack::B", an exception raised in module "Pack::B" will
-appear to have originated in "tool.pl" where "Pack::A" was called, and not in
-"Pack::A" where "Pack::B" was called, as the unmodified "Carp.pm" would try to
-make you believe :-).
-This works similarly if "Pack::B" calls "Pack::C" where the exception is
-raised, etcetera.
-In other words, this blames all errors in the "Pack::*" modules on the user of
-these modules, i.e., on you. ;-)
+This module is based on "Carp.pm" from Perl 5.005_03. It has been
+modified to skip all package names matching the pattern given in the
+"use" statement inside the "qw()" term (or argument list).
+
+Suppose you have a family of modules or classes named "Pack::A",
+"Pack::B" and so on, and each of them uses "Carp::Clan qw(^Pack::);"
+(or at least the one in which the error or warning gets raised).
+
+Thus when for example your script "tool.pl" calls module "Pack::A",
+and module "Pack::A" calls module "Pack::B", an exception raised in
+module "Pack::B" will appear to have originated in "tool.pl" where
+"Pack::A" was called, and not in "Pack::A" where "Pack::B" was called,
+as the unmodified "Carp.pm" would try to make you believe :-).
+
+This works similarly if "Pack::B" calls "Pack::C" where the exception
+is raised, etcetera.
+
+In other words, this blames all errors in the "Pack::*" modules on the
+user of these modules, i.e., on you. ;-)
For more informations, see:
https://metacpan.org/pod/distribution/Carp-Clan/lib/Carp/Clan.pod