view release on metacpan or  search on metacpan

README  view on Meta::CPAN

        The directory where "ebuild" expects to find the source tarballs.
        You need write permissions on this directory.

        Defaults to the value of "DISTDIR" (as returned by "emerge --info")
        or /usr/portage/distfiles if this variable is empty.

    *   "keywords"

        The valid "KEYWORDS" for the generated ebuilds.

        Defaults to the value of "ACCEPT_KEYWORDS" (as returned by "emerge
        --info") or 'x86' if this variable is empty.

    *   "header"

        A chunk of text that is prepended to every ebuild.

        Defaults to the generic Gentoo Foundation header.

    *   "footer"

        A chunk of text that is appended to every ebuild.

        Defaults to nothing.

    cpan2dist itself takes other options, most notably :

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

    *   "--force" forcefully regenerates ebuilds even if they already exist.

    *   "--install" installs the ebuilds after generating them.

    *   "--skiptest" skips tests while building, which speeds up the
        building process.

    *   "--verbose" shows a lot more information.

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

INSTALLATION
    Before installing this module, you should append "perl-gcpanp" to your
    /etc/portage/categories file.

    You have two ways for installing this module :

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

    *   Bootstrap an ebuild for CPANPLUS::Dist::Gentoo using itself.

        First, make sure your system "perl" is 5.10 or greater, so that the
        CPANPLUS toolchain is available.

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

        "perl" 5.12 is the current stable Perl version in Gentoo. If you
        still have "perl" "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 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 CPANPLUS::Dist::Gentoo using the bundled shell script
        "g-cpanp" :

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

        Finally, emerge the "CPANPLUS-Dist-Gentoo" ebuild you've just
        generated :

            # emerge -tv CPANPLUS-Dist-Gentoo

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

  "meta"
    Returns the contents of the META.yml or META.json files as parsed by
    Parse::CPAN::Meta.

  "intuit_license"
    Returns an array reference to a list of Gentoo licences identifiers
    under which the current distribution is released.

  "update_manifest"
    Updates the Manifest file for the ebuild associated to the current dist
    object.

  "ebuild_source"
    Returns the source of the ebuild for the current dist object, or "undef"
    when one of the dependencies couldn't be mapped to an existing ebuild.

DEPENDENCIES
    Gentoo (<http://gentoo.org>).

    CPANPLUS, IPC::Cmd (core modules since 5.9.5), Parse::CPAN::Meta (since
    5.10.1).

    Cwd, Carp (since perl 5), File::Path (5.001), File::Copy (5.002),
    File::Spec (5.00405), List::Util (5.007003).