README

   1 NAME
   2     CPANPLUS::Dist::Gentoo - CPANPLUS backend generating Gentoo ebuilds.
   3
   4 VERSION
   5     Version 0.04
   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). You also need to specify the correct
  24     keyword for your architecture if it differs from the default "x86".
  25
  26     The generated ebuilds are placed into the "perl-gcpanp" category. They
  27     favour depending on "perl-core", "dev-perl" or "perl-gcpan" (in that
  28     order) rather than "perl-gcpanp".
  29
  30 INSTALLATION
  31     After installing this module, you should append "perl-gcpanp" to your
  32     /etc/portage/categories file.
  33
  34 METHODS
  35     All the methods are inherited from CPANPLUS::Dist::Base. Please refer to
  36     its documentation for precise information on what's done at each step.
  37
  38 DEPENDENCIES
  39     Gentoo (<http://gentoo.org>).
  40
  41     CPANPLUS, IPC::Cmd (core modules since 5.9.5).
  42
  43     File::Path (since 5.001), File::Copy (5.002), File::Spec::Functions
  44     (5.00504).
  45
  46 SEE ALSO
  47     cpan2dist.
  48
  49     CPANPLUS::Dist::Base, CPANPLUS::Dist::Deb, CPANPLUS::Dist::Mdv.
  50
  51 AUTHOR
  52     Vincent Pit, "<perl at profvince.com>", <http://www.profvince.com>.
  53
  54     You can contact me by mail or on "irc.perl.org" (vincent).
  55
  56 BUGS
  57     Please report any bugs or feature requests to "bug-cpanplus-dist-gentoo
  58     at rt.cpan.org", or through the web interface at
  59     <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CPANPLUS-Dist-Gentoo>. I
  60     will be notified, and then you'll automatically be notified of progress
  61     on your bug as I make changes.
  62
  63 SUPPORT
  64     You can find documentation for this module with the perldoc command.
  65
  66         perldoc CPANPLUS::Dist::Gentoo
  67
  68 ACKNOWLEDGEMENTS
  69     The module is to some extend cargo-culted from CPANPLUS::Dist::Deb and
  70     CPANPLUS::Dist::Mdv.
  71
  72     Kent Fredric, for testing and suggesting improvements.
  73
  74 COPYRIGHT & LICENSE
  75     Copyright 2008 Vincent Pit, all rights reserved.
  76
  77     This program is free software; you can redistribute it and/or modify it
  78     under the same terms as Perl itself.
  79