README

   1 NAME
   2     CPANPLUS::Dist::Gentoo - CPANPLUS backend generating Gentoo ebuilds.
   3
   4 VERSION
   5     Version 0.06
   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     All the methods are inherited from CPANPLUS::Dist::Base. Please refer to
  37     its documentation for precise information on what's done at each step.
  38
  39 DEPENDENCIES
  40     Gentoo (<http://gentoo.org>).
  41
  42     CPANPLUS, IPC::Cmd (core modules since 5.9.5).
  43
  44     Cwd, Carp (since perl 5), File::Path (5.001), File::Copy (5.002),
  45     File::Spec::Functions (5.00504).
  46
  47 SEE ALSO
  48     cpan2dist.
  49
  50     CPANPLUS::Dist::Base, CPANPLUS::Dist::Deb, CPANPLUS::Dist::Mdv.
  51
  52 AUTHOR
  53     Vincent Pit, "<perl at profvince.com>", <http://www.profvince.com>.
  54
  55     You can contact me by mail or on "irc.perl.org" (vincent).
  56
  57 BUGS
  58     Please report any bugs or feature requests to "bug-cpanplus-dist-gentoo
  59     at rt.cpan.org", or through the web interface at
  60     <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPANPLUS-Dist-Gentoo>. I
  61     will be notified, and then you'll automatically be notified of progress
  62     on your bug as I make changes.
  63
  64 SUPPORT
  65     You can find documentation for this module with the perldoc command.
  66
  67         perldoc CPANPLUS::Dist::Gentoo
  68
  69 ACKNOWLEDGEMENTS
  70     The module is to some extend cargo-culted from CPANPLUS::Dist::Deb and
  71     CPANPLUS::Dist::Mdv.
  72
  73     Kent Fredric, for testing and suggesting improvements.
  74
  75 COPYRIGHT & LICENSE
  76     Copyright 2008-2009 Vincent Pit, all rights reserved.
  77
  78     This program is free software; you can redistribute it and/or modify it
  79     under the same terms as Perl itself.
  80