From 51c248a7d2c17c6b009183dc1a283ce0fa83a23a Mon Sep 17 00:00:00 2001
From: Jakub Vrana <vrana@php.net>
Date: Sat, 7 Aug 2004 16:18:12 +0000
Subject: [PATCH] Mode parameter (bug #24722)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@165650 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../domxml/functions/domxml-open-file.xml     | 21 ++++++++++++++++++-
 .../domxml/functions/domxml-open-mem.xml      | 15 ++++++++++++-
 2 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/reference/domxml/functions/domxml-open-file.xml b/reference/domxml/functions/domxml-open-file.xml
index 681130c7a3..c7cc6e8902 100644
--- a/reference/domxml/functions/domxml-open-file.xml
+++ b/reference/domxml/functions/domxml-open-file.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/domxml.xml, last change in rev 1.1 -->
   <refentry id="function.domxml-open-file">
    <refnamediv>
@@ -11,6 +11,8 @@
     <methodsynopsis>
      <type>object</type><methodname>domxml_open_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+     <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
+     <methodparam choice="opt"><type>array</type><parameter>&amp;error</parameter></methodparam>
     </methodsynopsis>
     <para>
      The function parses the XML document in the file named
@@ -18,6 +20,23 @@
      "Dom document", having the properties as listed above.
      The file is accessed read-only.
     </para>
+    <para>
+     Optional parameter <parameter>mode</parameter> can be used to change the
+     behavior of this function. It was added in PHP 4.3.0. You can use one of
+     <constant>DOMXML_LOAD_PARSING</constant> (default),
+     <constant>DOMXML_LOAD_VALIDATING</constant> or
+     <constant>DOMXML_LOAD_RECOVERING</constant> for it.
+     You can add to it also <constant>DOMXML_LOAD_DONT_KEEP_BLANKS</constant>,
+     <constant>DOMXML_LOAD_SUBSTITUTE_ENTITIES</constant> and
+     <constant>DOMXML_LOAD_COMPLETE_ATTRS</constant> by
+     <link linkend="language.operators.bitwise">bitwise or</link>.
+    </para>
+    <para>
+     If the <parameter>error</parameter> parameter is used, it will contain the
+     error messages. <parameter>error</parameter> must be passed in by
+     <link linkend="language.references">reference</link>. The parameter was
+     added in PHP 4.3.0.
+    </para>
     <para>
      <example>
       <title>Opening an XML document from a file</title>
diff --git a/reference/domxml/functions/domxml-open-mem.xml b/reference/domxml/functions/domxml-open-mem.xml
index 00c601dce5..7830f0a56c 100644
--- a/reference/domxml/functions/domxml-open-mem.xml
+++ b/reference/domxml/functions/domxml-open-mem.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/domxml.xml, last change in rev 1.1 -->
   <refentry id="function.domxml-open-mem">
    <refnamediv>
@@ -11,6 +11,8 @@
     <methodsynopsis>
      <type>object</type><methodname>domxml_open_mem</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
+     <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
+     <methodparam choice="opt"><type>array</type><parameter>&amp;error</parameter></methodparam>
     </methodsynopsis>
     <para>
      The function parses the XML document in
@@ -19,6 +21,17 @@
      <function>domxml_open_file</function> or <function>domxml_new_doc</function>
      must be called before any other function calls.
     </para>
+    <para>
+     Optional parameter <parameter>mode</parameter> can be used to change the
+     behavior of this function. It was added in PHP 4.3.0. See
+     <function>domxml_open_file</function> for possible values.
+    </para>
+    <para>
+     If the <parameter>error</parameter> parameter is used, it will contain the
+     error messages. <parameter>error</parameter> must be passed in by
+     <link linkend="language.references">reference</link>. The parameter was
+     added in PHP 4.3.0.
+    </para>
     <para>
      <example>
       <title>Opening an XML document in a string</title>