]> git.vpit.fr Git - perl/modules/CPANPLUS-Dist-Gentoo.git/blob - README
Point the repository to the gitweb instead of the bare repo
[perl/modules/CPANPLUS-Dist-Gentoo.git] / 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