diff options
author | B. Watson <yalhcru@gmail.com> | 2022-03-14 03:55:00 -0400 |
---|---|---|
committer | B. Watson <yalhcru@gmail.com> | 2022-03-14 03:55:00 -0400 |
commit | aecbeedba73b951ada445a05c12753ccede7e757 (patch) | |
tree | 51823abf988511604f7cba0fbbb3f1d448ba195e /perl/perl-Carp-Clan | |
parent | 5d2cb106b78fea39b5baa9644a20aaa16ea4934d (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/README | 37 |
1 files changed, 21 insertions, 16 deletions
diff --git a/perl/perl-Carp-Clan/README b/perl/perl-Carp-Clan/README index f74236ebc643..49ebf4aa6197 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 |