view release on metacpan or  search on metacpan

lib/CPANPLUS/Dist/Arch.pod  view on Meta::CPAN

=pod

=head1 NAME

CPANPLUS::Dist::Arch - CPANPLUS backend for building Archlinux pacman packages

=head1 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/jnbek/.cpanplus/5.22.1/build/CPANPLUS-Dist-Arch-1.32/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

=head1 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 L<cpan2aur> program.

=head1 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 http://wiki.archlinux.org/index.php/Pacman)

=head1 SETUP

Type L<setupdistarch> at the command line to install CPAN modules
as packages by default.

=head1 WHERE IS THE PACKAGE

By default, packages are stored under the user's home directory in the
I<.cpanplus> directory.  Two seperate directories are created for
building packages and for storing the resulting package file.

I<5.10.1> represents the version of perl you used to build the package
and I<~/.cpanplus> represents the base directory chosen in your CPANPLUS
config.

=over 4

=item * Build Directory: C<~/.cpanplus/5.10.1/pacman/build>

=item * Package Directory: C<~/.cpanplus/5.10.1/pacman/pkg>

=back

=head1 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
I</etc/makepkg.conf> file.  The user/package customizations are set
using environment variables.

=over

=item B<PKGDEST>

Override where the package files end up.

=item B<PACKAGER>

Override the Contributor comment line at the top of the PKGBUILD.

=back

=for readme stop

=head2 EXAMPLE

Here is how you can use environment variables to put the package files
in our I<~/pkgs> directory for the L<ALPM> module. (along with any