From 5ecb9d04afaa0d95ded05a3cb4208d671ebaa900 Mon Sep 17 00:00:00 2001
From: Philip Olson <philip@php.net>
Date: Sat, 3 Mar 2007 22:31:02 +0000
Subject: [PATCH] Removed 'pear install' in favor of 'pecl install', and used
 entities to describe how to install (pecl.info) and how to download
 (url.pecl).

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@231097 c90b9560-bf6c-de11-be94-00142212c4b1
---
 internals/pdo/building.xml         |  4 ++--
 internals/pdo/packaging.xml        | 10 ++++-----
 internals/pdo/prerequisites.xml    |  4 ++--
 reference/fileinfo/configure.xml   |  9 +++-----
 reference/net_gopher/configure.xml | 34 +++++++-----------------------
 reference/oggvorbis/configure.xml  | 26 +++++------------------
 reference/paradox/configure.xml    | 10 ++++-----
 reference/yaz/configure.xml        | 31 ++++++++++++---------------
 8 files changed, 44 insertions(+), 84 deletions(-)

diff --git a/internals/pdo/building.xml b/internals/pdo/building.xml
index 29c316f48d..702043265f 100644
--- a/internals/pdo/building.xml
+++ b/internals/pdo/building.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <sect1 id="internals.pdo.building">
  <title>Building</title>
  <para>
@@ -20,7 +20,7 @@
  </para>
  
  <screen><![CDATA[
-$ sudo pear install PDO
+$ sudo pecl install PDO
 ]]></screen>
  
  <para>
diff --git a/internals/pdo/packaging.xml b/internals/pdo/packaging.xml
index 7e31e3b5c0..c5a3c5686e 100644
--- a/internals/pdo/packaging.xml
+++ b/internals/pdo/packaging.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <sect1 id="internals.pdo.packaging">
  <title>Packaging and distribution</title>
  <sect2>
@@ -10,7 +10,7 @@
    <filename>package.xml</filename> file and then running:
   </para>
   <screen><![CDATA[
-$ pear package
+$ pecl package
 ]]></screen>
   <para>
    This will create a tarball named <filename>PDO_SKEL-X.Y.Z.tgz</filename>.
@@ -23,14 +23,14 @@ $ pear package
    following invocation:
   </para>
   <screen><![CDATA[
-$ pear build package.xml
+$ pecl build package.xml
 ]]></screen>
   <para>
    Once this is proven to work, you can test installation:
   </para>
   <screen><![CDATA[
-$ pear package
-$ sudo pear install PDO_SKEL-X.Y.X.tgz
+$ pecl package
+$ sudo pecl install PDO_SKEL-X.Y.X.tgz
 ]]></screen>
 
   <para>
diff --git a/internals/pdo/prerequisites.xml b/internals/pdo/prerequisites.xml
index e18f25c86a..75352b60d1 100644
--- a/internals/pdo/prerequisites.xml
+++ b/internals/pdo/prerequisites.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <sect1 id="internals.pdo.prerequisites">
  <title>Prerequisites</title>
  <para>
@@ -31,7 +31,7 @@
      <para>A working PHP environment version 5.0.3 or higher with a working PEAR extension version 1.3.5 or higher;</para>
    </listitem>
    <listitem>
-     <para>A working PDO environment (can be installed using 'sudo pear install PDO'), including the headers which will be needed to access the PDO type definitions and function declarations;</para>
+     <para>A working PDO environment (can be installed using 'sudo pecl install PDO'), including the headers which will be needed to access the PDO type definitions and function declarations;</para>
    </listitem>
    <listitem>
      <para>A good working knowledge of the 'C' programming language;</para>
diff --git a/reference/fileinfo/configure.xml b/reference/fileinfo/configure.xml
index ecd3049b00..d7fcd3de30 100644
--- a/reference/fileinfo/configure.xml
+++ b/reference/fileinfo/configure.xml
@@ -1,13 +1,10 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <section id="fileinfo.installation">
  &reftitle.install;
  <para>
-  A short installation note: just type
-  <screen>
-$ pear install fileinfo
-  </screen>
-  in your console. 
+  &pecl.info;
+  <ulink url="&url.pecl;fileinfo">&url.pecl;fileinfo</ulink>
  </para>
 </section>
 
diff --git a/reference/net_gopher/configure.xml b/reference/net_gopher/configure.xml
index af419e9afc..6dfaf2ec73 100644
--- a/reference/net_gopher/configure.xml
+++ b/reference/net_gopher/configure.xml
@@ -1,32 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->   
+<!-- $Revision: 1.2 $ -->   
 <section id="net-gopher.install">
  &reftitle.install;
- <simpara>
-  Net_Gopher is installed through the usual PECL package installation process.
- </simpara>
- <itemizedlist>
-  <listitem>
-   <simpara>
-    Prerequisite: <literal>PHP 4.3.0</literal>.
-   </simpara>
-  </listitem>
-  <listitem>
-   <para>
-    <screen>
-$ pear install Net_Gopher
-    </screen> 
-   </para>
-  </listitem>
-  <listitem>
-   <simpara>
-    Copy the resulting <filename class="libraryfile">gopher.so</filename> to an appropriate location
-    and add <literal>extension=gopher.so</literal> to your &php.ini;
-    file or load it dynamically in your PHP script using 
-    <literal>dl(&quot;gopher.so&quot;);</literal>
-   </simpara>
-  </listitem>
- </itemizedlist>
+ <para>
+  Prerequisite: PHP 4.3.0 or higher.
+ </para>
+ <para>
+  &pecl.info;
+  <ulink url="&url.pecl;net_gopher">&url.pecl;net_gopher</ulink>
+ </para>
 </section>
 
 <!-- Keep this comment at the end of the file
diff --git a/reference/oggvorbis/configure.xml b/reference/oggvorbis/configure.xml
index 69f557ef6b..2a7cb15d25 100644
--- a/reference/oggvorbis/configure.xml
+++ b/reference/oggvorbis/configure.xml
@@ -1,27 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <section id="oggvorbis.installation">
  &reftitle.install;
- <simpara>
-  oggvorbis is installed through the usual PECL package installation process.
- </simpara>
- <itemizedlist>
-  <listitem>
-   <para>
-    <screen>
-$ pear install oggvorbis
-    </screen> 
-   </para>
-  </listitem>
-  <listitem>
-   <simpara>
-    Copy the resulting <literal>oggvorbis.so</literal> to an appropriate
-    location and add <literal>extension=oggvorbis.so</literal> to your
-    &php.ini; file or load it dynamically in your PHP script using 
-    <literal>dl('oggvorbis.so');</literal>
-   </simpara>
-  </listitem>
- </itemizedlist>
+ <para>
+  &pecl.info;
+  <ulink url="&url.pecl;oggvorbis">&url.pecl;oggvorbis</ulink>
+ </para>
 </section>
 
 
diff --git a/reference/paradox/configure.xml b/reference/paradox/configure.xml
index 5d6626c094..2822a2772d 100644
--- a/reference/paradox/configure.xml
+++ b/reference/paradox/configure.xml
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <section id="paradox.installation">
  &reftitle.install;  
  <para>
-  A short installation note: just type
-  <screen>
-$ pear install paradox
-  </screen>
+  &pecl.info;
+  <ulink url="&url.pecl;paradox">&url.pecl;paradox</ulink>
+ </para>
+ <para>
   in your console. Make sure you have pxlib installed before. If you install
   pxlib from an rpm or debian package, do not forget to install the development
   package as well.
diff --git a/reference/yaz/configure.xml b/reference/yaz/configure.xml
index b26f224597..981c202b6a 100644
--- a/reference/yaz/configure.xml
+++ b/reference/yaz/configure.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.14 $ -->
+<!-- $Revision: 1.15 $ -->
 <section id="yaz.installation">
  &reftitle.install;
  <para>
@@ -35,24 +35,21 @@ sudo make install
   For PHP 5, the YAZ extension is in <ulink url="&url.pecl;">PECL</ulink>
   and is installed as a shared object/dll.
   If you have pear installed the easiest way to download, configure and
-  install the YAZ extension is by using the <command>pear</command> command.
+  install the YAZ extension is by using the <command>pecl</command> command.
  </para>
- <example>
-  <title>Installation of PECL YAZ on GNU/Debian Linux</title>
-  <para>
-  </para>
-  <para>
-   On a Debian GNU/Linux system the following installs YAZ and PECL YAZ:
-  </para>
-  <programlisting role="shell">
-    <![CDATA[
-sudo apt-get install libyaz-dev
-sudo pear install yaz
-]]>
-  </programlisting>
- </example>
  <para>
-  On Windows, <filename>php_yaz.dll</filename> depend on
+  Installation of YAZ on Linux
+ </para>
+ <para>
+  &pecl.info;
+  <ulink url="&url.pecl;yaz">&url.pecl;yaz</ulink>
+ </para>
+ <para>
+  Installation on Windows systems
+ </para> 
+ <para>
+  &pecl.windows.download;
+  <filename>php_yaz.dll</filename> depends on 
   <filename>yaz.dll</filename>. The <filename>yaz.dll</filename>
   is part of the Win32 ZIP from the PHP site. It is also part 
   of the Windows YAZ install available from the