=head1 VERSION
-Version 0.01
+Version 0.02
=cut
our $VERSION;
BEGIN {
- $VERSION = '0.01';
+ $VERSION = '0.02';
}
=head1 SYNOPSIS
This module builds an L<Acme::CPANAuthors> class by listing all the modules that are installed on the current C<perl> and then retrieving the name and the PAUSE id of their corresponding authors.
-It may take some time to load since it has to get CPAN indexes at C<BEGIN> time.
+It may take some time to load since it has to search all the directory trees given by your C<@INC> for modules, but also to get and parse CPAN indexes.
+
+=head1 FUNCTIONS
+
+=head2 C<register>
+
+Fetches and registers the names into L<Acme::CPANAuthors::Register>.
+This function is automatically called when you C<use> this module, unless you have set the package variable C<$Acme::CPANAuthors::You're_using::SKIP> to true beforehand.
=cut
-BEGIN {
+BEGIN { require Acme::CPANAuthors::Register; }
+
+sub register {
+ return if shift;
+
my %authors;
my $pkgs = Acme::CPANAuthors::Utils::cpan_packages();
$authors{$cpanid} = defined $name ? $name : $cpanid;
}
- require Acme::CPANAuthors::Register;
Acme::CPANAuthors::Register->import(%authors);
}
+our $SKIP;
+
+BEGIN { register($SKIP) }
+
=head1 DEPENDENCIES
L<Carp>, L<ExtUtils::Installed>, L<Acme::CPANAuthors>.