[Dh-make-php-commits] r346 - trunk/man

[Uwe Steinmann]

Author: steinm
Date: 2010-09-01 11:44:17 +0000 (Wed, 01 Sep 2010)
New Revision: 346

Modified:
   trunk/man/dh-make-pecl.xml
Log:
- added documentation for new option --phpversion


Modified: trunk/man/dh-make-pecl.xml
===================================================================
--- trunk/man/dh-make-pecl.xml	2010-02-12 20:06:49 UTC (rev 345)
+++ trunk/man/dh-make-pecl.xml	2010-09-01 11:44:17 UTC (rev 346)
@@ -104,6 +104,7 @@
 
       <arg><option>--templatedir <replaceable>TEMPLATEDIR</replaceable></option></arg>
       <arg><option>--only <replaceable>4|5</replaceable></option></arg>
+      <arg><option>--phpversion <replaceable>4 5</replaceable></option></arg>
       <arg><option>--dont-use-confd</option></arg>
       <arg>PACKAGE</arg>
     </cmdsynopsis>
@@ -133,13 +134,17 @@
       symlink php-&lt;pecl-package-name&gt;_&lt;version&gt;.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 <command>dpkg-buildpackage -rfakeroot</command>.  This will (by default)
-	  create php4-&lt;pecl-package-name&gt; and php5-&lt;pecl-package-name&gt;
-	  binary packages.</para>
+      with <command>dpkg-buildpackage -rfakeroot</command>.  This will (for
+      version 0.2.x)
+   	  create php4-&lt;pecl-package-name&gt; and php5-&lt;pecl-package-name&gt;
+	     binary packages. Since version 0.3.x only the binary package for php5 will
+      be build anymore.</para>
 
     <para><command>&dhpackage;</command> tries to extract as much information
       about the package from the file <filename>package.xml</filename> which
-      is part of the pecl extension.</para>
+      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.
+      <option>--depends</option> or <option>--build-depends</option>.</para>
 
     <para>Debian source packages created by <command>&dhpackage;</command>
       can later easily be updated with <command>uscan</command>.</para>
@@ -231,6 +236,7 @@
         <term><option>--only</option>
         </term>
         <listitem>
+          <para>This option is deprecated. Use --phpversion.</para>
           <para>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
@@ -239,6 +245,20 @@
         </listitem>
       </varlistentry>
       <varlistentry>
+        <term><option>--phpversion</option>
+        </term>
+        <listitem>
+          <para>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
+            <command>&dhpackage;</command> 0.3.0.
+            </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
         <term><option>--dont-use-confd</option>
         </term>
         <listitem>