Man Linux: Main Page and Category List

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 Etch, 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

       UWE STEINMANN <steinm@debian.org>
           Wrote this manpage for the Debian system.

COPYRIGHT

       Copyright © 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.