From f439cac0987f690542714476aaae2a2dcd67e160 Mon Sep 17 00:00:00 2001
From: Philip Olson <philip@php.net>
Date: Sat, 3 Oct 2009 17:30:55 +0000
Subject: [PATCH] Added installation (configure) documentation, and specified
 core exts that rely on ext/libxml

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@289134 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/libxml/book.xml  | 16 ++++++++++++----
 reference/libxml/setup.xml | 35 ++++++++++++++++++++++++++++++++++-
 2 files changed, 46 insertions(+), 5 deletions(-)

diff --git a/reference/libxml/book.xml b/reference/libxml/book.xml
index a94b47ae27..aab283b54f 100644
--- a/reference/libxml/book.xml
+++ b/reference/libxml/book.xml
@@ -10,11 +10,19 @@
  <preface xml:id="intro.libxml">
   &reftitle.intro;
   <para>
-   These functions/constants are available since PHP 5.1.0 and if you have
-   compiled one of the extensions based on libxml, like
+   These functions/constants are available as of PHP 5.1.0, and
+   the following core extensions rely on this libxml extension:
    <link linkend="book.dom">DOM</link>,
-   <link linkend="book.simplexml">SimpleXML</link> and
-   <link linkend="book.xslt">XSLT</link>.
+   <link linkend="book.libxml">libxml</link>,
+   <link linkend="book.simplexml">SimpleXML</link>,
+   <link linkend="book.soap">SOAP</link>,
+   <link linkend="book.wddx">WDDX</link>,
+   <link linkend="book.xsl">XSL</link>,
+   <link linkend="book.xslt">XSLT</link>,
+   <link linkend="book.xml">XML</link>,
+   <link linkend="book.xmlreader">XMLReader</link>,
+   <link linkend="book.xmlrpc">XMLRPC</link>&listendand;
+   <link linkend="book.xmlwriter">XMLWriter</link>.
   </para>
  </preface>
  <!-- }}} -->
diff --git a/reference/libxml/setup.xml b/reference/libxml/setup.xml
index 536156dc62..be83b5d509 100644
--- a/reference/libxml/setup.xml
+++ b/reference/libxml/setup.xml
@@ -17,7 +17,40 @@
  <!-- {{{ Installation -->
  <section xml:id="libxml.installation">
   &reftitle.install;
-  &no.install;
+  <para>
+   The libxml extension is enabled by default, although it may be disabled with
+   <option role="configure">--disable-libxml</option>. 
+  </para>
+  <para>
+   The optional <option role="configure">--with-libxml-dir</option>
+   directive is used to specify the location of <literal>libxml</literal>
+   on the system that PHP is being compiled on, otherwise only the
+   default locations are scanned. The configure process checks for libxml
+   (specifically, <literal>xml2-config</literal>) in the following order:
+  </para>
+  <orderedlist>
+   <listitem>
+    <para>
+     The location ([DIR]) specified with <option role="configure">--with-libxml-dir</option> 
+     (<filename>[DIR]/bin/xml2-config</filename>)
+    </para>
+   </listitem>
+   <listitem>
+    <para>
+     <filename>/usr/local/bin/xml2-config</filename>
+    </para>
+   </listitem>
+   <listitem>
+    <para>
+     <filename>/usr/bin/xml2-config</filename>
+    </para>
+   </listitem>
+  </orderedlist>
+  <para>
+   If configure cannot find <filename>xml2-config</filename> in the directory
+   specified by <option role="configure">--with-libxml-dir</option>, then
+   it'll continue on and check the default locations.
+  </para>
  </section>
  <!-- }}} -->