README

   1 NAME
   2     CPANPLUS::Dist::Gentoo - CPANPLUS backend generating Gentoo ebuilds.
   3
   4 VERSION
   5     Version 0.08
   6
   7 SYNOPSIS
   8         cpan2dist --format=CPANPLUS::Dist::Gentoo \
   9                   --dist-opts overlay=/usr/local/portage \
  10                   --dist-opts distdir=/usr/portage/distfiles \
  11                   --dist-opts manifest=yes \
  12                   --dist-opts keywords=x86 \
  13                   --dist-opts header="# Copyright 1999-2008 Gentoo Foundation" \
  14                   --dist-opts footer="# End" \
  15                   Any::Module You::Like
  16
  17 DESCRPITON
  18     This module is a CPANPLUS backend that recursively generates Gentoo
  19     ebuilds for a given package in the specified overlay (defaults to
  20     /usr/local/portage), updates the manifest, and even emerges it (together
  21     with its dependencies) if the user requires it. You need write
  22     permissions on the directory where Gentoo fetches its source files
  23     (usually /usr/portage/distfiles). The valid "KEYWORDS" for the generated
  24     ebuilds are by default those given in "ACCEPT_KEYWORDS", but you can
  25     specify your own with the "keywords" dist-option.
  26
  27     The generated ebuilds are placed into the "perl-gcpanp" category. They
  28     favour depending on a "virtual", on "perl-core", "dev-perl" or
  29     "perl-gcpan" (in that order) rather than "perl-gcpanp".
  30
  31 INSTALLATION
  32     After installing this module, you should append "perl-gcpanp" to your
  33     /etc/portage/categories file.
  34
  35 METHODS
  36     This module inherits all the methods from CPANPLUS::Dist::Base. Please
  37     refer to its documentation for precise information on what's done at
  38     each step.
  39
  40   "intuit_license"
  41     Returns an array reference to a list of Gentoo licences identifiers
  42     under which the current distribution is released.
  43
  44   "update_manifest"
  45     Updates the Manifest file for the ebuild associated to the current dist
  46     object.
  47
  48   "ebuild_source"
  49     Returns the source of the ebuild for the current dist object, or "undef"
  50     when one of the dependencies couldn't be mapped to an existing ebuild.
  51
  52 DEPENDENCIES
  53     Gentoo (<http://gentoo.org>).
  54
  55     CPANPLUS, IPC::Cmd (core modules since 5.9.5), Parse::CPAN::Meta (since
  56     5.10.1).
  57
  58     Cwd, Carp (since perl 5), File::Path (5.001), File::Copy (5.002),
  59     File::Spec (5.00405), List::Util (5.007003).
  60
  61 SEE ALSO
  62     cpan2dist.
  63
  64     CPANPLUS::Dist::Base, CPANPLUS::Dist::Deb, CPANPLUS::Dist::Mdv.
  65
  66 AUTHOR
  67     Vincent Pit, "<perl at profvince.com>", <http://www.profvince.com>.
  68
  69     You can contact me by mail or on "irc.perl.org" (vincent).
  70
  71 BUGS
  72     Please report any bugs or feature requests to "bug-cpanplus-dist-gentoo
  73     at rt.cpan.org", or through the web interface at
  74     <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPANPLUS-Dist-Gentoo>. I
  75     will be notified, and then you'll automatically be notified of progress
  76     on your bug as I make changes.
  77
  78 SUPPORT
  79     You can find documentation for this module with the perldoc command.
  80
  81         perldoc CPANPLUS::Dist::Gentoo
  82
  83 ACKNOWLEDGEMENTS
  84     The module was inspired by CPANPLUS::Dist::Deb and CPANPLUS::Dist::Mdv.
  85
  86     Kent Fredric, for testing and suggesting improvements.
  87
  88 COPYRIGHT & LICENSE
  89     Copyright 2008-2009 Vincent Pit, all rights reserved.
  90
  91     This program is free software; you can redistribute it and/or modify it
  92     under the same terms as Perl itself.
  93