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)