debpear(1) [debian man page]
debpear(1) General Commands Manual debpear(1) 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 Specify the URL channel of the PEAR package. Currently not implemented: please contribute! --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". 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 pack- age 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)
Check Out this Related Man Page
DH-MAKE-PEAR(1) dh-make-pear User Manual DH-MAKE-PEAR(1) NAME
dh-make-pear - Create debian source packages from pear modules SYNOPSIS
dh-make-pear [--help ] [--version ] [--rename ] [--arch any | all] [--state STATE] [--depends DEPENDS] [--maintainer MAINTAINER] [--prefix PREFIX] [--templatedir TEMPLATEDIR] [PACKAGE] DESCRIPTION
This manual page documents briefly the dh-make-pear command. dh-make-pear creates the files required to build a debian source package from a PHP extension as it is distributed through PEAR. The last parameter passed to dh-make-pear can be either the .tgz archive containing the php extension or the name of the extension. In the second case dh-make-pear will first download the archive from http://pear.php.net. If dh-make-pear downloads the archive itself, it will always take the most recent version. dh-make-pear will by default create a directory named php-<pear-package-name> which will contain the debian files and the unpacked files from the extension. It will also create a symlink php-<pear-package-name>_<version>.orig.tar.gz pointing towards the original source. After creating the files you can go into then new directory and build the debian package with dpkg-buildpackage -rfakeroot. dh-make-pear tries to extract as much information about the package from the file package.xml which is part of the pear extension. Debian source packages created by dh-make-pear can later easily be updated with uscan. OPTIONS
These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the Info files. -h --help Show summary of options. -v --version Show version of program. --rename Do not link orig.tar.gz but move the source into .orig.tar.gz. --arch Set architecture of created debian source package to 'any' or 'all'. Defaults to 'all'. --state Set preferred state for downloaded package. Defaults to 'stable'. --depends Adds more packages to Depends: beside php-pear. --prefix Sets prefix of debian source package name. Each name ends in '<pear-package-name>'. Defaults to 'php-'. --maintainer Explicitly sets the maintainer. In most cases it will be propperly guessed by reading some of the environment variables. --templatedir Use a different directory with templates for the debian files. Defaults to /usr/share/dh-make-php/pear.template. ENVIRONMENT
DEBFULLNAME - get the real name of the maintainer LOGNAME or USER - get the username DEBEMAIL or EMAIL - get the email address of the user SEE ALSO
dh-make-pecl (1). AUTHOR
UWE STEINMANN <steinm@debian.org> Wrote this manpage for the Debian system. COPYRIGHT
Copyright (C) 2004-2010 Uwe Steinmann This manual page was written for the Debian system (and may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. dh-make-pear 09/01/2010 DH-MAKE-PEAR(1)