blob: 03ee1815a953e6b0655590ba0a5b990e9fda6f67 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
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.
|
