dh-make-pecl(1)
NAME
dh-make-pecl - Create debian source packages from pecl extensions
SYNOPSIS
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]
DESCRIPTION
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.
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.
- --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. - --only
- 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
php version. - --dont-use-confd
- Some time between sarge and edge, the debian php packages has moved
its configuration into its own ini file in /etc/php[45]/conf.d and
no longer modify the global configuration in
/etc/php[45]/<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.
ENVIRONMENT
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
SEE ALSO
dh-make-pear (1).
AUTHOR
This manual page was written by Uwe Steinmann <steinm@debian.org> for
the Debian(TM) 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.
AUTHOR
- UWE STEINMANN
- Author.
COPYRIGHT
- Copyright © 2004-2006 Uwe Steinmann