NAME

       debpear - automatically builds and installs PEAR packages as Debian packages

SYNOPSIS

       debpear [options] <pear-package-name>

DESCRIPTION

       debpear  is  a tool to automatically create and build a Debian package out of a PHP PEAR package. It will
       download the PEAR package from pear.php.net, then by looking into it,  create  the  corresponding  Debian
       package, and eventually also installs it.

PARAMETERS

       <pear-package-name>

              Defines  the PEAR package name you want to install, as seen on the http://pear.php.net/ site. Make
              sure respect the case in the name of the package (for example: Package_NAME).

OPTIONS

       --build-dir|-b

              Specify the directory where the Debian package will be built.

       --verbose|-v

              Makes debpear more verbose.

       --channel|-c channel-alias

              Specify the channel-alias which provide from the pear-channels package, pear and pecl channel.

       --tarball|-t tarball --pkg-version|-pv pkg-version [ --wget|-w URL ]

              Do not use "pear download" to optain the PEAR package from upstream authors.  Instead, use tarball
              and use pkg-version when building the package.  Eventually also  download  the  tarball  from  URL
              using wget before building.

       --install|-i

              Install  the  resulting  debian  package  in  your  system. Note that you must be root to use this
              option. If you aren't root, then debpear will try to get root using sudo.

EXAMPLE

       debpear -i Auth_RADIUS

              This will create a php-auth-radius package in ./build-area, and automatically install it.  Because
              it's  written  in  the  package.xml shipped with Auth_RADIUS at pear.php.net, php-auth-radius will
              depend on php5-radius.

       debpear -t current.tgz -pv 1.3.1 -w http://downloads.jasig.org/cas-clients/php/current.tgz CAS

              Downloads cas-clients from http://downloads.jasig.org/cas-clients/php/current.tgz, as  current.tgz
              in  the  current  directory,  then  builds  it  as  if it was downloaded as CAS-1.3.1.tgz by "pear
              download".

       debpear -c pecl gnupg

              This will create a php-gnupg package from the pecl.php.net channel.

       debpear -c phpunit DbUnit

              This will create a php-dbunit package from the pear.phpunit.de channel.

IMPORTANT

              Note that the debian/copyright file generated by debpear isn't good enough for  redistribution  of
              the  created  packages. You should carefuly review the PEAR package license before doing so. Also,
              debpear has been created for convenience, but  it  will  never  replace  the  manual  work  of  an
              experienced  Debian  maintainer  for  creating PEAR packages. It can, however, be used to create a
              template package quickly, before a careful review, in order to save time building  a  Debian  PEAR
              package.

AUTHORS

              debpear has been written by Thomas Goirand <zigo@debian.org>, and is maintained inside the PKG PHP
              PEAR Debian team, that can be reached at: <pkg-php-pear@lists.alioth.debian.org>.

                                                                                                      debpear(1)