summaryrefslogtreecommitdiff
path: root/perl/perl-Sub-Exporter-Progressive/README
diff options
context:
space:
mode:
Diffstat (limited to 'perl/perl-Sub-Exporter-Progressive/README')
-rw-r--r--perl/perl-Sub-Exporter-Progressive/README13
1 files changed, 13 insertions, 0 deletions
diff --git a/perl/perl-Sub-Exporter-Progressive/README b/perl/perl-Sub-Exporter-Progressive/README
new file mode 100644
index 0000000000..b61aab1b16
--- /dev/null
+++ b/perl/perl-Sub-Exporter-Progressive/README
@@ -0,0 +1,13 @@
+Sub::Exporter is an incredibly powerful module, but with that
+power comes great responsibility, as well as some runtime
+penalties. This module is a Sub::Exporter wrapper that will
+let your users just use Exporter if all they are doing is
+picking exports, but use Sub::Exporter if your users try to
+use Sub::Exporter's more advanced features features,
+like renaming exports, if they try to use them.
+
+Note that this module will export @EXPORT, @EXPORT_OK and
+%EXPORT_TAGS package variables for Exporter to work.
+Additionally, if your package uses advanced Sub::Exporter
+features like currying, this module will only ever use
+Sub::Exporter, so you might as well use it directly.