aboutsummaryrefslogtreecommitdiff
path: root/devel/p5-Sub-Name/pkg-descr
diff options
context:
space:
mode:
Diffstat (limited to 'devel/p5-Sub-Name/pkg-descr')
-rw-r--r--devel/p5-Sub-Name/pkg-descr9
1 files changed, 9 insertions, 0 deletions
diff --git a/devel/p5-Sub-Name/pkg-descr b/devel/p5-Sub-Name/pkg-descr
new file mode 100644
index 000000000000..80f30b6d0b73
--- /dev/null
+++ b/devel/p5-Sub-Name/pkg-descr
@@ -0,0 +1,9 @@
+The subname() function exported by this module allows one to assign new
+names to Perl subroutine. This is different from glob-assignment, since
+the name is only used for informational purposes (caller, Carp, etc.).
+
+Note that for anonymous closures (subs that reference lexicals declared
+outside the sub itself) one can name each instance of the closure
+differently, which can be very useful for debugging.
+
+WWW: http://search.cpan.org/dist/Sub-Name/