NAME
CPANPLUS::Dist::Arch - CPANPLUS backend for building Archlinux pacman
packages
SYNOPSIS
(First, setup cpan to use us automatically)
$ setupdistarch
(Install the module as a pacman package)
$ cpanp -i Perl::Module::Here
(Use cpan2dist to make a package, but don't install it)
$ cpan2dist Acme::Bleach
(Use our included cpan2aur to make a source package in current dir)
$ cpan2aur CPANPLUS::Dist::Arch
(In case we need to customize our package build, create a directory
with a template we can use for future versions.)
$ cpan2aur -d CPANPLUS::Dist::Arch
==> Creating new directory for CPANPLUS::Dist::Arch...
-> Looking up module for CPANPLUS::Dist::Arch on CPAN...
Running [/usr/bin/perl /usr/bin/perlbin/core/cpanp-run-perl /home/juster/.cpanplus/5.10.1/build/CPANPLUS-Dist-Arch-0.16/Makefile.PL INSTALLDIRS=site]...
Writing Makefile for CPANPLUS::Dist::Arch
-> Creating new PKGBUILD.tt template file...
==> Created perl-cpanplus-dist-arch source package directory.
(Customize the template... add a optdepends, library depends, etc.
Just leave the rest of it alone.)
$ cd perl-cpanplus-dist-arch
$ ed PKGBUILD.tt
(Submit it to AUR! Will ask for a login username/password or remember
the last one used)
$ cpan2aur -u
DESCRIPTION
This module is used as a plugin of CPANPLUS to transparently package
CPAN distribution files into pacman packages as they are installed. This
module can also be used by programmers to build packages in more complex
ways. For example, it can create source packages for the AUR by using
the included cpan2aur program.
REQUIREMENTS
You will need to have pacman installed, of course, to create package and
to install these new packages. Pacman is included with Archlinux but can
even be used on other Linux distributions. (see
SETUP
Type setupdistarch at the command line to install CPAN modules as
packages by default.
WHERE IS THE PACKAGE
By default, packages are stored under the user's home directory in the
*.cpanplus* directory. Two seperate directories are created for building
packages and for storing the resulting package file.
*5.10.1* represents the version of perl you used to build the package
and *~/.cpanplus* represents the base directory chosen in your CPANPLUS
config.
* Build Directory: `~/.cpanplus/5.10.1/pacman/build'
* Package Directory: `~/.cpanplus/5.10.1/pacman/pkg'
CUSTOMIZATION
You can change defaults settings machine-wide (for every user) or for
one user or package. The machine-wide settings are set in the
*/etc/makepkg.conf* file. The user/package customizations are set using
environment variables.
PKGDEST
Override where the package files end up.
PACKAGER
Override the Contributor comment line at the top of the PKGBUILD.
SUPPORT
Email me at `<juster at cpan dot org>' or message me as *juster* on the
To check why the build process failed, read the build logs CPANPLUS
keeps in `~/.cpanplus/install_logs/'. The problem may be specific to the
module you're building and not this module.
ACKNOWLEDGEMENTS
This module was inspired by the perl-cpanplus-pacman package and
CPANPLUS::Dist::Pacman by Firmicus which is available at
This mostly started from CPANPLUS::Dist::RPM which is on Google Code at
starting point to try to understand the internals of CPANPLUS.
CONTRIBUTORS
Contributors are credited in detail in the ChangeLog file. The following
people have been kind enough to submit bug reports:
* Xenoterracide
* IsaacG
*Thank you for your help!*
SEE ALSO
* AUR Package: perl-cpanplus-dist-arch
* Git Repository
* Archlinux Perl Package Guidelines
* pacman
* makepkg
* CPANPLUS
AUTHOR
Justin Davis `<juster at cpan dot org>'
COPYRIGHT & LICENSE
Copyright 2010 Justin Davis, all rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.