dh-make-pecl - Create debian source packages from pecl extensions
dh-make-pecl [--help ] [--version ] [--arch any | all]
[--depends DEPENDS] [--build-depends DEPENDS]
[--maintainer MAINTAINER] [--prefix PREFIX]
[--package-name NAME] [--templatedir TEMPLATEDIR]
[--only 4|5] [--dont-use-confd] [PACKAGE]
This manual page documents briefly the dh-make-pecl command.
dh-make-pecl creates the files required to build a debian source
package from a PHP extension as it is distributed through PECL.
The last parameter passed to dh-make-pecl can be either the .tgz
archive containing the php extension or the name of the extension. In
the second case dh-make-pecl will first download the archive from
http://pecl.php.net. If dh-make-pecl downloads the archive itself, it
will always take the most recent version.
dh-make-pecl will by default create a directory named
php-<pecl-package-name>-<pecl-package-version> which will contain the
debian files and the unpacked files from the extension. It will also
create a symlink php-<pecl-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. This will (by default) create php4-<pecl-package-name> and
php5-<pecl-package-name> binary packages.
dh-make-pecl tries to extract as much information about the package
from the file package.xml which is part of the pecl extension.
Debian source packages created by dh-make-pecl can later easily be
updated with uscan.
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.
Show summary of options.
Show version of program.
Set architecture of created debian source package to 'any' or
'all'. Defaults to 'any'.
Adds more packages to Depends: beside php4|php5.
Adds more packages to Build-Depends: beside php4-dev, php5-dev,
debhelper and dh-make-php.
Sets prefix of debian source package name. Each name ends in
'<pecl-package-name>'. Defaults to 'php'.
Explicitly sets the maintainer. In most cases it will be propperly
guessed by reading some of the environment variables.
Overwrite package name in package.xml. This name will be prefixed
with ‘php-'. Do not use this function unless you know what you are
Use a different directory with templates for the debian files.
Defaults to /usr/share/dh-make-php/pecl.template.
Set this to 4 or 5 in order to produce a debian package which
creates a binary package for php4 or php5 only, but not for both.
This is mostly useful if a pecl package does not compile for all
Some time between Sarge and Etch, the debian php packages has moved
its configuration into its own ini file in /etc/php/conf.d and
no longer modify the global configuration in
/etc/php/<sapi>/php.ini. Since Version 0.2.1 of dh-make-php
this is the default behaviour when creating packages. If you prefer
the old way of creating php pecl packages use this option.
dh-make-pecl evaluates the following environment variables:
DEBFULLNAME - the real name of the maintainer
LOGNAME or USER - the username
DEBEMAIL or EMAIL - the email address of the user
UWE STEINMANN <firstname.lastname@example.org>
Wrote this manpage for the Debian system.
Copyright © 2004-2010 Uwe Steinmann
This manual page was written for the Debian system (and may be used by
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
On Debian systems, the complete text of the GNU General Public License
can be found in /usr/share/common-licenses/GPL.