perl/perl-namespace-clean: Added (Keep imports out of namespace).

Signed-off-by: David Spencer <idlemoor@slackbuilds.org>

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.