summaryrefslogtreecommitdiff
path: root/pod/modpods/Carp.pod
diff options
context:
space:
mode:
Diffstat (limited to 'pod/modpods/Carp.pod')
-rw-r--r--pod/modpods/Carp.pod22
1 files changed, 22 insertions, 0 deletions
diff --git a/pod/modpods/Carp.pod b/pod/modpods/Carp.pod
new file mode 100644
index 0000000000..b5439779ac
--- /dev/null
+++ b/pod/modpods/Carp.pod
@@ -0,0 +1,22 @@
+=head1 NAME
+
+carp - warn of errors (from perspective of caller)
+
+croak - die of errors (from perspective of caller)
+
+confess - die of errors with stack backtrace
+
+=head1 SYNOPSIS
+
+ use Carp;
+ croak "We're outta here!";
+
+=head1 DESCRIPTION
+
+The Carp routines are useful in your own modules because
+they act like die() or warn(), but report where the error
+was in the code they were called from. Thus if you have a
+routine Foo() that has a carp() in it, then the carp()
+will report the error as occurring where Foo() was called,
+not where carp() was called.
+