vrana Sat Aug 7 12:18:12 2004 EDT
Modified files:
/phpdoc/en/reference/domxml/functions domxml-open-file.xml
domxml-open-mem.xml
Log:
Mode parameter (bug #24722)
http://cvs.php.net/diff.php/phpdoc/en/reference/domxml/functions/domxml-open-file.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/domxml/functions/domxml-open-file.xml
diff -u phpdoc/en/reference/domxml/functions/domxml-open-file.xml:1.5
phpdoc/en/reference/domxml/functions/domxml-open-file.xml:1.6
--- phpdoc/en/reference/domxml/functions/domxml-open-file.xml:1.5 Tue Apr 27
20:07:33 2004
+++ phpdoc/en/reference/domxml/functions/domxml-open-file.xml Sat Aug 7 12:18:12
2004
@@ -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,12 +11,31 @@
<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>&error</parameter></methodparam>
</methodsynopsis>
<para>
The function parses the XML document in the file named
<parameter>filename</parameter> and returns an object of class
"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>
http://cvs.php.net/diff.php/phpdoc/en/reference/domxml/functions/domxml-open-mem.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/domxml/functions/domxml-open-mem.xml
diff -u phpdoc/en/reference/domxml/functions/domxml-open-mem.xml:1.5
phpdoc/en/reference/domxml/functions/domxml-open-mem.xml:1.6
--- phpdoc/en/reference/domxml/functions/domxml-open-mem.xml:1.5 Tue Apr 27
20:07:33 2004
+++ phpdoc/en/reference/domxml/functions/domxml-open-mem.xml Sat Aug 7 12:18:12
2004
@@ -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>&error</parameter></methodparam>
</methodsynopsis>
<para>
The function parses the XML document in
@@ -18,6 +20,17 @@
document", having the properties as listed above. This function,
<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>
