X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=lib%2FCPANPLUS%2FDist%2FGentoo.pm;h=fb54d76303c0e2d8444697a792f05c0bed49fa76;hb=ace21f357ef35a3f55f75362ed0d991fc83f22e6;hp=55a51cf3115ad688b4eca9c1f1a15d6fcc705ad1;hpb=ba772ef86983b0403d1aa6de8cfd47935e5bc6b2;p=perl%2Fmodules%2FCPANPLUS-Dist-Gentoo.git diff --git a/lib/CPANPLUS/Dist/Gentoo.pm b/lib/CPANPLUS/Dist/Gentoo.pm index 55a51cf..fb54d76 100644 --- a/lib/CPANPLUS/Dist/Gentoo.pm +++ b/lib/CPANPLUS/Dist/Gentoo.pm @@ -3,20 +3,21 @@ package CPANPLUS::Dist::Gentoo; use strict; use warnings; -use Cwd qw/abs_path/; -use List::Util qw/reduce/; +use Cwd (); +use List::Util qw; use File::Copy (); use File::Path (); use File::Spec; -use IPC::Cmd qw/run can_run/; +use IPC::Cmd (); use Parse::CPAN::Meta (); use CPANPLUS::Error (); -use base qw/CPANPLUS::Dist::Base/; +use base qw; use CPANPLUS::Dist::Gentoo::Atom; +use CPANPLUS::Dist::Gentoo::Guard; use CPANPLUS::Dist::Gentoo::Maps; =head1 NAME @@ -25,98 +26,171 @@ CPANPLUS::Dist::Gentoo - CPANPLUS backend generating Gentoo ebuilds. =head1 VERSION -Version 0.09 +Version 0.11 =cut -our $VERSION = '0.09'; +our $VERSION = '0.11'; =head1 SYNOPSIS + # Using default values from your make.conf + cpan2dist --format=CPANPLUS::Dist::Gentoo --buildprereq Some::Module + + # Specifying your own options cpan2dist --format=CPANPLUS::Dist::Gentoo \ --dist-opts overlay=/usr/local/portage \ --dist-opts distdir=/usr/portage/distfiles \ --dist-opts manifest=yes \ --dist-opts keywords=x86 \ - --dist-opts header="# Copyright 1999-2008 Gentoo Foundation" \ + --dist-opts header="# Begin" \ --dist-opts footer="# End" \ Any::Module You::Like -=head1 DESCRPITON +=head1 DESCRIPTION -This module is a CPANPLUS backend that recursively generates Gentoo ebuilds for a given package in the specified overlay (defaults to F), updates the manifest, and even emerges it (together with its dependencies) if the user requires it. -You need write permissions on the directory where Gentoo fetches its source files (usually F). -The valid C for the generated ebuilds are by default those given in C, but you can specify your own with the C dist-option. +This module is a CPANPLUS backend that recursively generates Gentoo ebuilds for a given package in the default overlay, updates the manifest, and even emerges it (together with its dependencies) if the user requires it. The generated ebuilds are placed into the C category. They favour depending on a C, on C, C or C (in that order) rather than C. +Existing ebuilds will be searched into the main C portage tree and then into the overlays listed in C. -=head1 INSTALLATION +=head1 OPTIONS -Before installing this module, you should append C to your F file. +You can pass specific options to L by using the C<--dist-opts> command-line argument followed by a C pair, where C is the option name and C is what it is set to. +C<--dist-opts> can be used several times. -You have two ways for installing this module : +The valid option Cs are : =over 4 =item * -Use the perl overlay located at L. -It contains an ebuild for L. +C + +A boolean that indicates whether the F file should be generated by running C onto the generated ebuilds. + +Defaults to C. =item * -Bootstrap an ebuild for L using itself. -Note that if your Gentoo system C is C<5.8.x>, L and its dependencies are not installed and not even available in the main portage tree. -So you need to bootstrap them as well. +C -First, fetch tarballs for L and L : +The path of the overlay in which the generated ebuilds will be written. - $ cd /tmp - $ wget http://search.cpan.org/CPAN/authors/id/B/BI/BINGOS/CPANPLUS-0.9003.tar.gz - $ wget http://search.cpan.org/CPAN/authors/id/V/VP/VPIT/CPANPLUS-Dist-Gentoo-0.09.tar.gz +Defaults to the first overlay listed in C (as returned by C) or F if this variable is empty. + +=item * -Log in as root and unpack them in e.g. your home directory : +C - # cd - # tar xzf /tmp/CPANPLUS-0.9003.tar.gz - # tar xzf /tmp/CPANPLUS-Dist-Gentoo-0.09.tar.gz +The directory where C expects to find the source tarballs. +You need write permissions on this directory. + +Defaults to the value of C (as returned by C) or F if this variable is empty. + +=item * + +C + +The valid C for the generated ebuilds. + +Defaults to the value of C (as returned by C) or C<'x86'> if this variable is empty. + +=item * + +C
+ +A chunk of text that is prepended to every ebuild. + +Defaults to the generic Gentoo Foundation header. + +=item * + +C