aboutsummaryrefslogtreecommitdiff
path: root/devel/p5-Religion/pkg-descr
diff options
context:
space:
mode:
authorJames FitzGibbon <jfitz@FreeBSD.org>1996-10-24 13:46:37 +0000
committerJames FitzGibbon <jfitz@FreeBSD.org>1996-10-24 13:46:37 +0000
commitd25d9138f178ed4d4b79701ab169c72c347c1ba4 (patch)
treecccee75126507815944bb9069ca772b8a32724c0 /devel/p5-Religion/pkg-descr
parent9fab9a7c38c2e44330544e64672df502dca05632 (diff)
downloadports-d25d9138f178ed4d4b79701ab169c72c347c1ba4.tar.gz
ports-d25d9138f178ed4d4b79701ab169c72c347c1ba4.zip
Notes
Diffstat (limited to 'devel/p5-Religion/pkg-descr')
-rw-r--r--devel/p5-Religion/pkg-descr18
1 files changed, 18 insertions, 0 deletions
diff --git a/devel/p5-Religion/pkg-descr b/devel/p5-Religion/pkg-descr
new file mode 100644
index 000000000000..9033ea4b345e
--- /dev/null
+++ b/devel/p5-Religion/pkg-descr
@@ -0,0 +1,18 @@
+This is a second go at a module to simplify installing die() and warn()
+handlers, and to make such handlers easier to write and control.
+
+For most people, this just means that if use use Religion; then you'll get
+noticably better error reporting from warn() and die(). This is especially
+useful if you are using eval().
+
+Religion provides four classes, WarnHandler, DieHandler, WarnPreHandler, and
+DiePreHandler, that when you construct them return closures that can be
+stored in variables that in turn get invoked by $SIG{__DIE__} and
+$SIG{__WARN__}. Note that if Religion is in use, you should not modify
+$SIG{__DIE__} or $SIG{__WARN__}, unless you are careful about invoking
+chaining to the old handler.
+
+Religion also provides a TraceBack function, which is used by a DieHandler
+after you die() to give a better handle on the current scope of your
+situation, and provide information about where you were, which might
+influence where you want to go next, either returning back to where