dh-make-pecl - Create debian source packages from pecl extensions

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.

-h --help

Show summary of options.

-v --version

Show version of program.

--arch

Set architecture of created debian source package to 'any' or 'all'. Defaults to 'any'.

--depends

Adds more packages to Depends: beside php4|php5.

--build-depends

Adds more packages to Build-Depends: beside php4-dev, php5-dev, debhelper and dh-make-php.

--prefix

Sets prefix of debian source package name. Each name ends in '-<pecl-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.

--package-name

Overwrite package name in package.xml. This name will be prefixed with `php-'. Do not use this function unless you know what you are doing.

--templatedir

Use a different directory with templates for the debian files. Defaults to /usr/share/dh-make-php/pecl.template.

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

dh-make-pear (1).

This manual page was written by Uwe Steinmann <steinm@debian.org> for the Debian system (but 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 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.

UWE STEINMANN.