Numerous changes to document the RELEASE_0_9_0 version of the API for the XML DAS

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@207670 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Matthew Peters 2006-02-21 16:13:49 +00:00
parent edc22e9847
commit 71881dc287
17 changed files with 1052 additions and 1596 deletions

View file

@ -1,137 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-Document-getEncoding">
<refnamediv>
<refname>SDO_DAS_XML_Document::getEncoding</refname>
<refpurpose>
Returns encoding string
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>SDO_DAS_XML_Document::getEncoding</methodname>
<void/>
</methodsynopsis>
&warn.experimental.func;
<para>
Returns the encoding string for the SDO_DAS_XML_Document object.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the encoding string.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML_Document::getEncoding</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,136 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-Document-getNoNamespaceSchemaLocation">
<refnamediv>
<refname>SDO_DAS_XML_Document::getNoNamespaceSchemaLocation</refname>
<refpurpose>
Returns no namespace schema location
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>SDO_DAS_XML_Document::getNoNamespaceSchemaLocation</methodname>
<void/>
</methodsynopsis>
&warn.experimental.func;
<para>
Returns the no namespace schema location.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns no namespace schema location.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML_Document::getNoNamespaceSchemaLocation</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,137 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-Document-getSchemaLocation">
<refnamediv>
<refname>SDO_DAS_XML_Document::getSchemaLocation</refname>
<refpurpose>
Returns schema location
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>SDO_DAS_XML_Document::getSchemaLocation</methodname>
<void/>
</methodsynopsis>
&warn.experimental.func;
<para>
Returns schema location.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns schema location.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML_Document::getSchemaLocation</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,138 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-Document-getXMLDeclaration">
<refnamediv>
<refname>SDO_DAS_XML_Document::getXMLDeclaration</refname>
<refpurpose>
Returns whether the xml declaration is set or not
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>SDO_DAS_XML_Document::getXMLDeclaration</methodname>
<void/>
</methodsynopsis>
&warn.experimental.func;
<para>
Returns whether the xml declaration is set or not.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns whether the xml declaration is set or not.
TRUE If it is set and FALSE if it is not.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML_Document::getXMLDeclaration</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,137 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-Document-getXMLVersion">
<refnamediv>
<refname>SDO_DAS_XML_Document::getXMLVersion</refname>
<refpurpose>
Returns xml declaration string
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>SDO_DAS_XML_Document::getXMLVersion</methodname>
<void/>
</methodsynopsis>
&warn.experimental.func;
<para>
Returns xml declaration string.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns xml declaration string.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML_Document::getXMLVersion</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,149 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-Document-setNoNamespaceSchemaLocation">
<refnamediv>
<refname>SDO_DAS_XML_Document::setNoNamespaceSchemaLocation</refname>
<refpurpose>
Sets the given string as no namespace schema location
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>SDO_DAS_XML_Document::setNoNamespaceSchemaLocation</methodname>
<methodparam><type>string</type><parameter>nnschemaLocation</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
<para>
Sets the given string as no namespace schema location.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term>
<parameter>nnschemaLocation</parameter>
</term>
<listitem>
<para>
no namespace schema location.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
None.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML_Document::setNoNamespaceSchemaLocation</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,149 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-Document-setSchemaLocation">
<refnamediv>
<refname>SDO_DAS_XML_Document::setSchemaLocation</refname>
<refpurpose>
Sets the given string as schema location
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>SDO_DAS_XML_Document::setSchemaLocation</methodname>
<methodparam><type>string</type><parameter>schemaLocation</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
<para>
Sets the given string as schema location.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term>
<parameter>schemaLocation</parameter>
</term>
<listitem>
<para>
schema location.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
None.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML_Document::setSchemaLocation</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-Document-setXMLDeclaration">
<refnamediv>
@ -17,8 +17,9 @@
&warn.experimental.func;
<para>
Sets the given boolean value for xml declaration.
Pass TRUE to set it and FLASE to not to unset it.
Controls whether an XML declaration will be generated at the start of the
XML document. Set to <varname>true</varname> to generate the XML declaration,
or <varname>false</varname> to suppress it.
</para>
</refsect1>

View file

@ -1,26 +1,28 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.1 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-saveDataObjectToFile">
<refentry id="function.SDO-DAS-XML-addTypes">
<refnamediv>
<refname>SDO_DAS_XML::saveDataObjectToFile</refname>
<refname>SDO_DAS_XML::addTypes</refname>
<refpurpose>
Saves the SDO_DataObject object to File
To load a second or subsequent schema file to a SDO_DAS_XML object
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>SDO_DAS_XML::saveDataObjectToFile</methodname>
<methodparam><type>SDO_DataObject</type><parameter>do</parameter></methodparam>
<methodparam><type>string</type><parameter>root_uri</parameter></methodparam>
<methodparam><type>string</type><parameter>root_name</parameter></methodparam>
<methodparam><type>string</type><parameter>xml_file</parameter></methodparam>
<type>SDO_DAS_XML</type><methodname>SDO_DAS_XML::addTypes</methodname>
<methodparam><type>string</type><parameter>xsd_file</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
<para>
Saves the SDO_DataObject object as an XML File.
Load a second or subsequent schema file to an XML DAS that has already
been created with the static method <function>create</function>.
Although the file may be any valid schema file, a likely reason for
using this method is to add a schema file containing definitions of
extra complex types, hence the name. See Example 4 of the parent document
for an example.
</para>
</refsect1>
@ -30,53 +32,62 @@
<variablelist>
<varlistentry>
<term>
<parameter>do</parameter>
<parameter>xsd_file</parameter>
</term>
<listitem>
<para>
DataObject, which needs to be saves as an XML File.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>root_uri</parameter>
</term>
<listitem>
<para>
URI string for the root DataObject.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>root_name</parameter>
</term>
<listitem>
<para>
Type name of the root DataObject.
Path to XSD Schema file.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
None.
None if successful, otherwise throws an exception as described below.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
<variablelist>
<varlistentry>
<term>
<parameter>SDO_TypeNotFoundException</parameter>
</term>
<listitem>
<para>
Thrown if a type is not defined in the underlying model.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>SDO_DAS_XML_ParserException</parameter>
</term>
<listitem>
<para>
Thrown for any problems while parsing the given XSD File.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>SDO_DAS_XML_FileException</parameter>
</term>
<listitem>
<para>
Thrown if the specified file cannot be found.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
@ -108,7 +119,7 @@
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML::saveDataObjectToFile</function> example</title>
<title>A <function>SDO_DAS_XML::create</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-create">
<refnamediv>
@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<type>SDO_DAS_XML</type><methodname>SDO_DAS_XML::create</methodname>
<methodparam><type>string</type><parameter>xsd_file</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>xsd_file</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
@ -32,7 +32,9 @@
</term>
<listitem>
<para>
Path to XSD Schema file.
Path to XSD Schema file. This is optional. If omitted a DAS will be created
that only has the SDO base types defined. Schema files can then be loaded
with the <function>addTypes</function> method.
</para>
</listitem>
</varlistentry>
@ -66,7 +68,17 @@
</term>
<listitem>
<para>
Thrown for any symantical problems while parsing the given XSD File.
Thrown for any problems while parsing the given XSD File.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>SDO_DAS_XML_FileException</parameter>
</term>
<listitem>
<para>
Thrown if the specified file cannot be found.
</para>
</listitem>
</varlistentry>

View file

@ -0,0 +1,201 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-createDocument">
<refnamediv>
<refname>SDO_DAS_XML::createDocument</refname>
<refpurpose>
Creates an XML Document object from scratch, without the need to load a document from a file or string.
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>
There are three forms for this method call.
</para>
<methodsynopsis>
<type>SDO_DAS_XML_Document</type><methodname>SDO_DAS_XML::createDocument</methodname>
<void/>
</methodsynopsis>
<methodsynopsis>
<type>SDO_DAS_XML_Document</type><methodname>SDO_DAS_XML::createDocument</methodname>
<methodparam><type>string</type><parameter>document element name</parameter></methodparam>
</methodsynopsis>
<methodsynopsis>
<type>SDO_DAS_XML_Document</type><methodname>SDO_DAS_XML::createDocument</methodname>
<methodparam><type>string</type><parameter>document element name</parameter></methodparam>
<methodparam><type>string</type><parameter>document element namespace URI</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
<para>
Creates an XML Document object. This will contain just one empty root element
on which none of the properties will have been set.
The purpose of this call is to allow an application to create
an XML document from scratch without the need to load a
document from a file or string. The document that is created
will be as if a document had been loaded that contained just a single
empty document element with no attributes set or elements within it.
</para>
<para>
<function>createDocument</function>
may need to be told what the document element is.
This will not be necessary in simple cases.
When there is no ambiguity then no parameter need be passed to the
method.
However it is possible to load more than one schema file into the same XML DAS
and in this case there may be more than one possible document element defined:
furthermore it is even possible that there are two possible document elements that
differ only in the namespace.
To cope with these cases it is possible to specify either the document element
name, or both the document element name and namespace to the method.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term>
<parameter>document element name</parameter>
</term>
<listitem>
<para>
The name of the document element. Only needed if there
there is more than one possibility.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>document element namespace URI</parameter>
</term>
<listitem>
<para>
The namespace part of the document element name. Only needed if there is more
than one possible document element with the same name.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns an SDO_XML_DAS_Document object on success.
</para>
</refsect1>
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
<variablelist>
<varlistentry>
<term>
<parameter>SDO_UnsupportedOperationException</parameter>
</term>
<listitem>
<para>
Thrown if an element name or element name and namespace URI is passed,
but not found in the underlying model.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML::createDataObject</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.1 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-loadFromFile">
<refentry id="function.SDO-DAS-XML-loadFile">
<refnamediv>
<refname>SDO_DAS_XML::loadFromFile</refname>
<refname>SDO_DAS_XML::loadFile</refname>
<refpurpose>
Returns SDO_DAS_XML_Document object for a given path to xml instance document
</refpurpose>
@ -11,7 +11,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>SDO_XMLDocument</type><methodname>SDO_DAS_XML::loadFromFile</methodname>
<type>SDO_XMLDocument</type><methodname>SDO_DAS_XML::loadFile</methodname>
<methodparam><type>string</type><parameter>xml_file</parameter></methodparam>
</methodsynopsis>
@ -82,10 +82,21 @@
</term>
<listitem>
<para>
Thrown for any symantical problems while parsing the given XSD File.
Thrown for any problems while parsing the given XSD File.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>SDO_DAS_XML_FileException</parameter>
</term>
<listitem>
<para>
Thrown if the specified file cannot be found.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

View file

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.1 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-loadFromString">
<refentry id="function.SDO-DAS-XML-loadString">
<refnamediv>
<refname>SDO_DAS_XML::loadFromString</refname>
<refname>SDO_DAS_XML::loadString</refname>
<refpurpose>
Returns SDO_DAS_XML_Document for a given xml instance string
</refpurpose>
@ -11,7 +11,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>SDO_DAS_XML_Document</type><methodname>SDO_DAS_XML::loadFromString</methodname>
<type>SDO_DAS_XML_Document</type><methodname>SDO_DAS_XML::loadString</methodname>
<methodparam><type>string</type><parameter>xml_string</parameter></methodparam>
</methodsynopsis>

View file

@ -1,171 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-saveDataObjectToString">
<refnamediv>
<refname>SDO_DAS_XML::saveDataObjectToString</refname>
<refpurpose>
Saves the SDO_DataObject object to string
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>SDO_DAS_XML::saveDataObjectToString</methodname>
<methodparam><type>SDO_DataObject</type><parameter>do</parameter></methodparam>
<methodparam><type>string</type><parameter>root_uri</parameter></methodparam>
<methodparam><type>string</type><parameter>root_name</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
<para>
Saves the SDO_DataObject object as an XML string.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term>
<parameter>do</parameter>
</term>
<listitem>
<para>
DataObject, which needs to be saves as an XML string.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>root_uri</parameter>
</term>
<listitem>
<para>
URI string for the root DataObject.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>root_name</parameter>
</term>
<listitem>
<para>
Type name of the root DataObject.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
xml string.
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>Enter the PHP version of change here
<entry>Description of change
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
-->
<!-- Use when examples exist
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>A <function>SDO_DAS_XML::saveDataObjectToString</function> example</title>
<para>
Any text that describes the purpose of the example, or
what goes on in the example should go here (inside the
<example> tag, not out
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
echo 'Use the PEAR Coding Standards';
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
</screen>
</example>
</para>
</refsect1>
-->
<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.1 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-saveDocumentToFile">
<refentry id="function.SDO-DAS-XML-saveFile">
<refnamediv>
<refname>SDO_DAS_XML::saveDocumentToFile</refname>
<refname>SDO_DAS_XML::saveFile</refname>
<refpurpose>
Saves the SDO_DAS_XML_Document object to a file
</refpurpose>
@ -11,9 +11,10 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>SDO_DAS_XML::saveDocumentToFile</methodname>
<type>void</type><methodname>SDO_DAS_XML::saveFile</methodname>
<methodparam><type>SDO_XMLDocument</type><parameter>xdoc</parameter></methodparam>
<methodparam><type>string</type><parameter>xml_file</parameter></methodparam>
<methodparam choice="opt"><type>integer</type><parameter>indent</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
@ -46,6 +47,20 @@
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>indent</parameter>
</term>
<listitem>
<para>
Optional argument to specify that the xml should be formatted. A non-negative integer is
the amount to indent each level of the xml. So, the integer 2, for example, will indent
the xml so that each contained element is two spaces further to the right than its
containing element. The integer 0 will cause the xml to be completely left-aligned.
The integer -1 means no formatting - the xml will come out on one long line.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
@ -56,14 +71,24 @@
</para>
</refsect1>
<!-- Use when EXCEPTIONS exist
<refsect1 role="exceptions">
&reftitle.exceptions;
<para>
When does this function throw exceptions?
<variablelist>
<varlistentry>
<term>
<parameter>SDO_DAS_XML_FileException</parameter>
</term>
<listitem>
<para>
Thrown if the specified file cannot be found.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
-->
<!-- Use when a CHANGELOG exists

View file

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.1 $ -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry id="function.SDO-DAS-XML-saveDocumentToString">
<refentry id="function.SDO-DAS-XML-saveString">
<refnamediv>
<refname>SDO_DAS_XML::saveDocumentToString</refname>
<refname>SDO_DAS_XML::saveString</refname>
<refpurpose>
Saves the SDO_DAS_XML_Document object to a string
</refpurpose>
@ -11,8 +11,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>SDO_DAS_XML::saveDocumentToString</methodname>
<type>string</type><methodname>SDO_DAS_XML::saveString</methodname>
<methodparam><type>SDO_XMLDocument</type><parameter>xdoc</parameter></methodparam>
<methodparam choice="opt"><type>integer</type><parameter>indent</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
@ -35,6 +36,20 @@
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>indent</parameter>
</term>
<listitem>
<para>
Optional argument to specify that the xml should be formatted. A non-negative integer is
the amount to indent each level of the xml. So, the integer 2, for example, will indent
the xml so that each contained element is two spaces further to the right than its
containing element. The integer 0 will cause the xml to be completely left-aligned.
The integer -1 means no formatting - the xml will come out on one long line.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

File diff suppressed because it is too large Load diff