hholzgra Tue Mar 11 12:46:32 2003 EDT
Modified files:
/phpdoc/en/reference/xml reference.xml
/phpdoc/en/reference/xml/functions xml-parser-create-ns.xml
xml-parser-create.xml
Log:
- xml parser resources explained
- xml_parser_create_ns documented
- xml_parser_create slightly rewritten
Index: phpdoc/en/reference/xml/reference.xml
diff -u phpdoc/en/reference/xml/reference.xml:1.8
phpdoc/en/reference/xml/reference.xml:1.9
--- phpdoc/en/reference/xml/reference.xml:1.8 Mon Jan 27 21:58:18 2003
+++ phpdoc/en/reference/xml/reference.xml Tue Mar 11 12:46:31 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
<reference id="ref.xml">
<title>XML parser functions</title>
<titleabbrev>XML</titleabbrev>
@@ -62,7 +62,16 @@
<section id="xml.resources">
&reftitle.resources;
- &no.resource;
+ <section id="xml.resources.xml">
+ <title><literal>xml</literal></title>
+ <para>
+ The <literal>xml</literal> resource as returned by
+ <function>xml_parser_create</function> and
+ <function>xml_parser_create_ns</function> references an xml
+ parser instance to be used with the functions provided by this
+ extension.
+ </para>
+ </section>
</section>
&reference.xml.constants;
Index: phpdoc/en/reference/xml/functions/xml-parser-create-ns.xml
diff -u phpdoc/en/reference/xml/functions/xml-parser-create-ns.xml:1.3
phpdoc/en/reference/xml/functions/xml-parser-create-ns.xml:1.4
--- phpdoc/en/reference/xml/functions/xml-parser-create-ns.xml:1.3 Fri Apr 19
07:11:21 2002
+++ phpdoc/en/reference/xml/functions/xml-parser-create-ns.xml Tue Mar 11 12:46:32
2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.24 -->
<refentry id='function.xml-parser-create-ns'>
<refnamediv>
@@ -13,10 +13,30 @@
<methodsynopsis>
<type>resource</type><methodname>xml_parser_create_ns</methodname>
<methodparam
choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
- <methodparam
choice="opt"><type>string</type><parameter>sep</parameter></methodparam>
+ <methodparam
choice="opt"><type>string</type><parameter>separator</parameter></methodparam>
</methodsynopsis>
<para>
- &warn.undocumented.func;
+ <function>xml_parser_create_ns</function> creates a new XML parser
+ with XML namespace support and returns a reousurce handle referencing
+ it to be used by the other XML functions.
+ </para>
+ <para>
+ With a namespace aware parser tag parameters passed to the
+ various handler functions will consist of namespace and tag name
+ seperated by the string specified in
+ <parameter>seperator</parameter> or <literal>':'</literal> by
+ default.
+ </para>
+ <para>
+ The optional <parameter>encoding</parameter> specifies the
+ character encoding of the XML input to be parsed. Supported
+ encodings are <literal>"ISO-8859-1"</literal>, wich is also
+ the default if no <parameter>encoding</parameter> is specified,
+ <literal>"UTF-8"</literal> and <literal>"US-ASCII"</literal>.
+ </para>
+ <para>
+ See also <function>xml_parser_create</function> and
+ <function>xml_parser_free</function>.
</para>
</refsect1>
</refentry>
Index: phpdoc/en/reference/xml/functions/xml-parser-create.xml
diff -u phpdoc/en/reference/xml/functions/xml-parser-create.xml:1.3
phpdoc/en/reference/xml/functions/xml-parser-create.xml:1.4
--- phpdoc/en/reference/xml/functions/xml-parser-create.xml:1.3 Fri Apr 19 07:11:21
2002
+++ phpdoc/en/reference/xml/functions/xml-parser-create.xml Tue Mar 11 12:46:32
2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-parser-create">
<refnamediv>
@@ -13,24 +13,20 @@
<methodparam
choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
</methodsynopsis>
<para>
- <variablelist>
- <varlistentry>
- <term><parameter>encoding</parameter> (optional)</term>
- <listitem>
- <para>
- Which character encoding the parser should use. The following
- character encodings are supported:
- <simplelist>
- <member><literal>ISO-8859-1</literal> (default)</member>
- <member><literal>US-ASCII</literal></member>
- <member><literal>UTF-8</literal></member>
- </simplelist>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- This function creates an XML parser and returns a handle for use by other
- XML functions. Returns &false; on failure.
+ <function>xml_parser_create</function> creates a new XML parser
+ and returns a reousurce handle referencing it to be used by the
+ other XML functions.
+ </para>
+ <para>
+ The optional <parameter>encoding</parameter> specifies the
+ character encoding of the XML input to be parsed. Supported
+ encodings are <literal>"ISO-8859-1"</literal>, wich is also
+ the default if no <parameter>encoding</parameter> is specified,
+ <literal>"UTF-8"</literal> and <literal>"US-ASCII"</literal>.
+ </para>
+ <para>
+ See also <function>xml_parser_create_ns</function> and
+ <function>xml_parser_free</function>.
</para>
</refsect1>
</refentry>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
