aboutsummaryrefslogtreecommitdiff
path: root/perl/perl-namespace-clean/README
diff options
context:
space:
mode:
Diffstat (limited to 'perl/perl-namespace-clean/README')
-rw-r--r--perl/perl-namespace-clean/README13
1 files changed, 13 insertions, 0 deletions
diff --git a/perl/perl-namespace-clean/README b/perl/perl-namespace-clean/README
new file mode 100644
index 0000000000000..ffae2670abbe9
--- /dev/null
+++ b/perl/perl-namespace-clean/README
@@ -0,0 +1,13 @@
+When you define a function, or import one, into a Perl package, it will
+naturally also be available as a method. This does not per se cause
+problems, but it can complicate subclassing and, for example, plugin
+classes that are included via multiple inheritance by loading them as
+base classes.
+
+The namespace::clean pragma will remove all previously declared or
+imported symbols at the end of the current package's compile cycle.
+Functions called in the package itself will still be bound by their
+name, but they won't show up as methods on your class or instances.
+
+By unimporting via no you can tell namespace::clean to start collecting
+functions for the next use namespace::clean; specification.