pod update for package() event
[app-cpan2pkg.git] / README
blob4d4132bd623cbc6ceafaead2e8c6f17a23ab0c3d
1 App-CPAN2Pkg
2 ============
4 cpan2pkg is an application that aims at producing native linux packages
5 from cpan distributions.
7 Yes, i know of cpan2dist - i've even created the CPANPLUS::Dist::Mdv
8 backend for Mandriva. However, cpan2dist is "just" creating the package.
10 But creating a package is more than that:
11     - checking if package is already provided by your linux distribution
12     - installing the package on the local system
13     - importing newly created package in the distribution build system
14     - building & distributing the new package in the distribution
15     - and this, taking the module prerequisites into account...
16       recursively!
18 So, cpan2pkg is an application that does all that. It uses cpan2dist at
19 its heart to generate the package, but interacts with the distribution
20 infrastructure to really provide the new package to the final
21 distribution users.
24 INSTALLATION
25 ============
27 To install this module, run the following commands:
29         perl Build.PL
30         ./Build
31         ./Build test
32         ./Build install
35 SUPPORT AND DOCUMENTATION
36 =========================
38 After installing, you can find documentation for this module with the
39 perldoc command.
41     perldoc App::CPAN2Pkg
43 You can also look for information at:
45     RT, CPAN's request tracker
46         http://rt.cpan.org/NoAuth/Bugs.html?Dist=App-CPAN2Pkg
48     AnnoCPAN, Annotated CPAN documentation
49         http://annocpan.org/dist/App-CPAN2Pkg
51     CPAN Ratings
52         http://cpanratings.perl.org/d/App-CPAN2Pkg
54     Search CPAN
55         http://search.cpan.org/dist/App-CPAN2Pkg
58 AUTHOR
59 ======
61 Jerome Quelin, <jquelin@cpan.org>
64 COPYRIGHT & LICENSE
65 ===================
67 Copyright (c) 2009 Jerome Quelin, all rights reserved.
69 This program is free software; you can redistribute it and/or modify it
70 under the same terms as Perl itself.