diff options
Diffstat (limited to 'README')
-rw-r--r-- | README | 54 |
1 files changed, 54 insertions, 0 deletions
@@ -0,0 +1,54 @@ +NAME + Sub::Exporter::Progressive - Only use Sub::Exporter if you need it + +SYNOPSIS + package Syntax::Keyword::Gather; + + use Sub::Exporter::Progressive -setup => { + exports => [qw( break gather gathered take )], + groups => { + default => [qw( break gather gathered take )], + }, + }; + + # elsewhere + + # uses Exporter for speed + use Syntax::Keyword::Gather; + + # somewhere else + + # uses Sub::Exporter for features + use Syntax::Keyword::Gather 'gather', take => { -as => 'grab' }; + +DESCRIPTION + Sub::Exporter is an incredibly powerful module, but with that power + comes great responsibility, er- 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, 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. + +AUTHOR + frew - Arthur Axel Schmidt (cpan:FREW) <frioux+cpan@gmail.com> + +CONTRIBUTORS + ilmari - Dagfinn Ilmari Mannsåker (cpan:ILMARI) <ilmari@ilmari.org> + + mst - Matt S. Trout (cpan:MSTROUT) <mst@shadowcat.co.uk> + + leont - Leon Timmermans (cpan:LEONT) <leont@cpan.org> + +COPYRIGHT + Copyright (c) 2012 the Sub::Exporter::Progressive "AUTHOR" and + "CONTRIBUTORS" as listed above. + +LICENSE + This library is free software and may be distributed under the same + terms as perl itself. + |