view release on metacpan or  search on metacpan

lib/CPANPLUS/Dist/Gentoo.pm  view on Meta::CPAN

=item *

C<footer>

A chunk of text that is appended to every ebuild.

Defaults to nothing.

=back

L<cpan2dist> itself takes other options, most notably :

=over 4

=item *

C<--buildprereq> generates an ebuild for every dependency, even for those that are already up-to-date.
Setting this option is recommended.

=item *

C<--force> forcefully regenerates ebuilds even if they already exist.

=item *

C<--install> installs the ebuilds after generating them.

=item *

C<--skiptest> skips tests while building, which speeds up the building process.

=item *

C<--verbose> shows a lot more information.

=back

Please refer to L<cpan2dist> documentation for a complete coverage of its abilities.

=head1 INSTALLATION

Before installing this module, you should append C<perl-gcpanp> to your F</etc/portage/categories> file.

You have two ways for installing this module :

=over 4

=item *

Use the perl overlay located at L<http://git.overlays.gentoo.org/gitweb/?p=proj/perl-overlay.git>.
It contains an ebuild for L<CPANPLUS::Dist::Gentoo> which will most likely be up-to-date given the reactivity of Gentoo's Perl herd.

=item *

Bootstrap an ebuild for L<CPANPLUS::Dist::Gentoo> using itself.

First, make sure your system C<perl> is C<5.10> or greater, so that the L<CPANPLUS> toolchain is available.

    $ perl -v
    This is perl 5, version 12, subversion 2 (v5.12.2)...

C<perl> C<5.12> is the current stable Perl version in Gentoo.
If you still have C<perl> C<5.8.x>, you can upgrade it by running the following commands as root :

    # emerge -tv ">=dev-lang/perl-5.10"
    # perl-cleaner --all

Then, fetch the L<CPANPLUS::Dist::Gentoo> tarball :

    $ cd /tmp
    $ wget http://search.cpan.org/CPAN/authors/id/V/VP/VPIT/CPANPLUS-Dist-Gentoo-0.12.tar.gz

Log in as root and unpack it in e.g. your home directory :

    # cd
    # tar xzf /tmp/CPANPLUS-Dist-Gentoo-0.12.tar.gz
    # cd CPANPLUS-Dist-Gentoo-0.12

Bootstrap L<CPANPLUS::Dist::Gentoo> using the bundled shell script C<g-cpanp> :

    # perl Makefile.PL
    # make
    # PERL5LIB=blib/lib samples/g-cpanp CPANPLUS::Dist::Gentoo

Finally, emerge the C<CPANPLUS-Dist-Gentoo> ebuild you've just generated :

    # emerge -tv CPANPLUS-Dist-Gentoo

=back

=head1 METHODS

This module inherits all the methods from L<CPANPLUS::Dist::Base>.
Please refer to its documentation for precise information on what's done at each step.

=cut

use constant CATEGORY => 'perl-gcpanp';

my $overlays;
my $default_keywords;
my $default_distdir;
my $main_portdir;

my %dependencies;
my %forced;

my $unquote = sub {
 my $s = shift;
 $s =~ s/^["']*//;
 $s =~ s/["']*$//;
 return $s;
};

my $format_available;

sub format_available {
 return $format_available if defined $format_available;

 unless (IPC::Cmd->can_capture_buffer) {