Generate xmlreader methodsynopses based on stubs

Based on a patch contributed by Máté Kocsis <kocsismate@woohoolabs.com>.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@351468 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Christoph Michael Becker 2020-11-21 12:28:48 +00:00
parent 18303121bc
commit 9d3b35d2a8
12 changed files with 163 additions and 67 deletions

View file

@ -8,10 +8,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>DOMNode</type>
<methodname>XMLReader::expand</methodname>
<methodparam choice="opt"><type>DOMNode</type><parameter>basenode</parameter></methodparam>
<modifier>public</modifier> <type class="union"><type>DOMNode</type><type>false</type></type><methodname>XMLReader::expand</methodname>
<methodparam choice="opt"><type class="union"><type>DOMNode</type><type>null</type></type><parameter>baseNode</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
This method copies the current node and returns the appropriate DOM object.
@ -22,7 +20,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>basenode</parameter></term>
<term><parameter>baseNode</parameter></term>
<listitem>
<para>
A <classname>DOMNode</classname> defining the target <classname>DOMDocument</classname> for the created DOM object.
@ -40,7 +38,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -8,9 +8,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>XMLReader::getAttribute</methodname>
<modifier>public</modifier> <type class="union"><type>string</type><type>null</type></type><methodname>XMLReader::getAttribute</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
<para>
@ -33,6 +31,29 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
This function can longer return &false;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@ -51,7 +72,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -8,9 +8,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>XMLReader::getAttributeNo</methodname>
<modifier>public</modifier> <type class="union"><type>string</type><type>null</type></type><methodname>XMLReader::getAttributeNo</methodname>
<methodparam><type>int</type><parameter>index</parameter></methodparam>
</methodsynopsis>
<para>
@ -80,7 +78,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -8,9 +8,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>string</type><methodname>XMLReader::getAttributeNs</methodname>
<methodparam><type>string</type><parameter>localName</parameter></methodparam>
<methodparam><type>string</type><parameter>namespaceURI</parameter></methodparam>
<modifier>public</modifier> <type class="union"><type>string</type><type>null</type></type><methodname>XMLReader::getAttributeNs</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam><type>string</type><parameter>namespace</parameter></methodparam>
</methodsynopsis>
<para>
Returns the value of an attribute by name and namespace URI or an empty
@ -23,7 +23,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>localName</parameter></term>
<term><parameter>name</parameter></term>
<listitem>
<para>
The local name.
@ -31,7 +31,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>namespaceURI</parameter></term>
<term><parameter>namespace</parameter></term>
<listitem>
<para>
The namespace URI.
@ -47,7 +47,7 @@
<para>
The value of the attribute, or an empty string (before PHP 5.6) or &null;
(from PHP 5.6 onwards) if no attribute with the given
<parameter>localName</parameter> and <parameter>namespaceURI</parameter> is
<parameter>name</parameter> and <parameter>namespace</parameter> is
found or not positioned of element.
</para>
</refsect1>
@ -64,6 +64,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
This function can longer return &false;.
</entry>
</row>
<row>
<entry>5.6.0</entry>
<entry>
@ -87,7 +93,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -8,9 +8,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>XMLReader::lookupNamespace</methodname>
<modifier>public</modifier> <type class="union"><type>string</type><type>null</type></type><methodname>XMLReader::lookupNamespace</methodname>
<methodparam><type>string</type><parameter>prefix</parameter></methodparam>
</methodsynopsis>
<para>
@ -38,8 +36,30 @@
&return.success;
</para>
</refsect1>
</refentry>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
This function can longer return &false;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -8,11 +8,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>bool</type>
<methodname>XMLReader::moveToAttributeNs</methodname>
<methodparam><type>string</type><parameter>localName</parameter></methodparam>
<methodparam><type>string</type><parameter>namespaceURI</parameter></methodparam>
<modifier>public</modifier> <type>bool</type><methodname>XMLReader::moveToAttributeNs</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam><type>string</type><parameter>namespace</parameter></methodparam>
</methodsynopsis>
<para>
Positions cursor on the named attribute in specified namespace.
@ -23,7 +21,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>localName</parameter></term>
<term><parameter>name</parameter></term>
<listitem>
<para>
The local name.
@ -31,7 +29,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>namespaceURI</parameter></term>
<term><parameter>namespace</parameter></term>
<listitem>
<para>
The namespace URI.
@ -59,7 +57,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -8,10 +8,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>bool</type>
<methodname>XMLReader::next</methodname>
<methodparam choice="opt"><type>string</type><parameter>localname</parameter></methodparam>
<modifier>public</modifier> <type>bool</type><methodname>XMLReader::next</methodname>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>name</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Positions cursor on the next node skipping all subtrees.
@ -22,7 +20,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>localname</parameter></term>
<term><parameter>name</parameter></term>
<listitem>
<para>
The name of the next node to move to.
@ -38,6 +36,29 @@
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>name</parameter> is nullable now.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@ -49,7 +70,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -9,12 +9,10 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>bool</type>
<methodname>XMLReader::open</methodname>
<methodparam><type>string</type><parameter>URI</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
<modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>bool</type><type>XMLReader</type></type><methodname>XMLReader::open</methodname>
<methodparam><type>string</type><parameter>uri</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Set the URI containing the XML document to be parsed.
@ -26,7 +24,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>URI</parameter></term>
<term><parameter>uri</parameter></term>
<listitem>
<para>
URI pointing to the document.
@ -42,7 +40,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<term><parameter>flags</parameter></term>
<listitem>
<para>
A bitmask of the <link linkend="libxml.constants">LIBXML_*</link>
@ -64,7 +62,33 @@
<refsect1 role="errors">
&reftitle.errors;
&dom.allowstatic;
<para>
This method may be called statically, but prior to PHP 8.0.0, will issue an
<constant>E_DEPRECATED</constant> error in this case.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<methodname>XMLReader::open</methodname> is now declared as static method,
but can still be called on an <classname>XMLReader</classname> instance.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
@ -77,7 +101,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -8,10 +8,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>bool</type>
<methodname>XMLReader::setRelaxNGSchema</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<modifier>public</modifier> <type>bool</type><methodname>XMLReader::setRelaxNGSchema</methodname>
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Set the filename or URI for the RelaxNG Schema to use for validation.
@ -49,7 +47,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -8,10 +8,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>bool</type>
<methodname>XMLReader::setRelaxNGSchemaSource</methodname>
<methodparam><type>string</type><parameter>source</parameter></methodparam>
<modifier>public</modifier> <type>bool</type><methodname>XMLReader::setRelaxNGSchemaSource</methodname>
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>source</parameter></methodparam>
</methodsynopsis>
<para>
Set the data containing a RelaxNG Schema to use for validation.
@ -49,7 +47,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xml:id="xmlreader.setschema" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>XMLReader::setSchema</refname>
@ -11,7 +10,7 @@
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>XMLReader::setSchema</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Use W3C XSD schema to validate the document as it is processed. Activation
@ -101,7 +100,6 @@ Use a screen like we did below
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@ -122,4 +120,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -9,12 +9,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<modifier>public</modifier> <modifier>static</modifier>
<type>bool</type>
<methodname>XMLReader::xml</methodname>
<methodparam><type>string</type><parameter>source</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Set the data containing the XML to parse.
@ -42,7 +42,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<term><parameter>flags</parameter></term>
<listitem>
<para>
A bitmask of the <link linkend="libxml.constants">LIBXML_*</link>
@ -64,7 +64,33 @@
<refsect1 role="errors">
&reftitle.errors;
&dom.allowstatic;
<para>
This method may be called statically, but prior to PHP 8.0.0, will issue an
<constant>E_DEPRECATED</constant> error in this case.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<methodname>XMLReader::xml</methodname> is now declared as static method,
but can still be called on an <classname>XMLReader</classname> instance.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">