'\" t .\" Title: DH-MAKE-PECL .\" Author: UWE STEINMANN .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: 02/01/2014 .\" Manual: dh-make-pecl User Manual .\" Source: dh-make-pecl .\" Language: English .\" .TH "DH\-MAKE\-PECL" "1" "02/01/2014" "dh-make-pecl" "dh-make-pecl User Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" dh-make-pecl \- Create debian source packages from pecl extensions .SH "SYNOPSIS" .HP \w'\fBdh\-make\-pecl\fR\ 'u \fBdh\-make\-pecl\fR [\fB\-\-help\ \fR] [\fB\-\-version\ \fR] [\fB\-\-arch\ \fR\fB\fIany\ |\ all\fR\fR] [\fB\-\-depends\ \fR\fB\fIDEPENDS\fR\fR] [\fB\-\-build\-depends\ \fR\fB\fIDEPENDS\fR\fR] [\fB\-\-maintainer\ \fR\fB\fIMAINTAINER\fR\fR] [\fB\-\-prefix\ \fR\fB\fIPREFIX\fR\fR] [\fB\-\-package\-name\ \fR\fB\fINAME\fR\fR] [\fB\-\-templatedir\ \fR\fB\fITEMPLATEDIR\fR\fR] [\fB\-\-only\ \fR\fB\fI4|5\fR\fR] [\fB\-\-phpversion\ \fR\fB\fI4\ 5\fR\fR] [\fB\-\-dont\-use\-confd\fR] [\fB\-\-php55\-conf\fR] [\fB\-\-no\-php55\-conf\fR] [PACKAGE] .SH "DESCRIPTION" .PP This manual page documents briefly the \fBdh\-make\-pecl\fR command\&. .PP \fBdh\-make\-pecl\fR creates the files required to build a debian source package from a PHP extension as it is distributed through PECL\&. .PP The last parameter passed to \fBdh\-make\-pecl\fR can be either the \&.tgz archive containing the php extension or the name of the extension\&. In the second case \fBdh\-make\-pecl\fR will first download the archive from http://pecl\&.php\&.net\&. If \fBdh\-make\-pecl\fR downloads the archive itself, it will always take the most recent version\&. .PP \fBdh\-make\-pecl\fR will by default create a directory named php\-\- which will contain the debian files and the unpacked files from the extension\&. It will also create a symlink php\-_\&.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 \fBdpkg\-buildpackage \-rfakeroot\fR\&. This will (for version 0\&.2\&.x) create php4\- and php5\- binary packages\&. Since version 0\&.3\&.x only the binary package for php5 will be build anymore\&. .PP \fBdh\-make\-pecl\fR tries to extract as much information about the package from the file package\&.xml which is part of the pecl extension\&. Though, there is some information like depends on other debian packages, which must be given by options, e\&.g\&. \fB\-\-depends\fR or \fB\-\-build\-depends\fR\&. .PP Debian source packages created by \fBdh\-make\-pecl\fR can later easily be updated with \fBuscan\fR\&. .SH "OPTIONS" .PP These programs follow the usual GNU command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&. For a complete description, see the Info files\&. .PP \fB\-h\fR \fB\-\-help\fR .RS 4 Show summary of options\&. .RE .PP \fB\-v\fR \fB\-\-version\fR .RS 4 Show version of program\&. .RE .PP \fB\-\-arch\fR .RS 4 Set architecture of created debian source package to \*(Aqany\*(Aq or \*(Aqall\*(Aq\&. Defaults to \*(Aqany\*(Aq\&. .RE .PP \fB\-\-depends\fR .RS 4 Adds more packages to Depends: beside php4|php5\&. .RE .PP \fB\-\-build\-depends\fR .RS 4 Adds more packages to Build\-Depends: beside php4\-dev, php5\-dev, debhelper and dh\-make\-php\&. .RE .PP \fB\-\-prefix\fR .RS 4 Sets prefix of debian source package name\&. Each name ends in \*(Aq\*(Aq\&. Defaults to \*(Aqphp\*(Aq\&. .RE .PP \fB\-\-maintainer\fR .RS 4 Explicitly sets the maintainer\&. In most cases it will be propperly guessed by reading some of the environment variables\&. .RE .PP \fB\-\-package\-name\fR .RS 4 Overwrite package name in package\&.xml\&. This name will be prefixed with `php\-\*(Aq\&. Do not use this function unless you know what you are doing\&. .RE .PP \fB\-\-templatedir\fR .RS 4 Use a different directory with templates for the debian files\&. Defaults to /usr/share/dh\-make\-php/pecl\&.template\&. .RE .PP \fB\-\-only\fR .RS 4 This option is deprecated\&. Use \-\-phpversion\&. .sp 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\&. .RE .PP \fB\-\-phpversion\fR .RS 4 Set this to 4, 5 or both separated by a space in order to produce a debian package which creates a binary package for the given php major versions\&. This is mostly useful if you want to create a pecl package for php4, which is not created by default anymore since \fBdh\-make\-pecl\fR 0\&.3\&.0\&. .RE .PP \fB\-\-dont\-use\-confd\fR .RS 4 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]//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\&. .RE .PP \fB\-\-php55\-conf\fR .RS 4 PHP 5\&.5 has introduced a new configuration schema for pecl extensions\&. This is used by default, if /etc/php5/mods\-available is found on the system wher dh\-make\-pecl runs\&. This option is provided to explicity turn on PHP 5\&.5 configuration even if the default is off\&. .RE .PP \fB\-\-no\-php55\-conf\fR .RS 4 This option is provided to explicity turn off PHP 5\&.5 configuration even if the default is on\&. .RE .SH "ENVIRONMENT" .PP \fBdh\-make\-pecl\fR evaluates the following environment variables: .PP DEBFULLNAME \- the real name of the maintainer .PP LOGNAME or USER \- the username .PP DEBEMAIL or EMAIL \- the email address of the user .SH "SEE ALSO" .PP dh\-make\-pear (1)\&. .SH "AUTHOR" .PP \fBUWE STEINMANN\fR <\&steinm@debian\&.org\&> .RS 4 Wrote this manpage for the Debian system\&. .RE .SH "COPYRIGHT" .br Copyright \(co 2004-2010 Uwe Steinmann .br .PP This manual page was written for the Debian system (and may be used by others)\&. .PP 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\&. .PP On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL\&. .sp