cvs: phpdoc /en/reference/dom/functions dom-domdocument-createentityreference.xml dom-domimplementation-createdocumenttype.xml
dom-domnode-removechild.xml dom-domnode-replacechild.xml

didou Sat Apr 2 17:46:41 2005 EDT Modified files: /phpdoc/en/reference/dom/functions dom-domdocument-createentityreference.xml dom-domimplementation-createdocumenttype.xml dom-domnode-removechild.xml dom-domnode-replacechild.xml Log: integrated user notes, examples, and wrapped text http://cvs.php.net/diff.php/phpdoc/en/reference/dom/functions/dom-domdocument-createentityreference.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/dom/functions/dom-domdocument-createentityreference.xml diff -u phpdoc/en/reference/dom/functions/dom-domdocument-createentityreference.xml:1.8 phpdoc/en/reference/dom/functions/dom-domdocument-createentityreference.xml:1.9 --- phpdoc/en/reference/dom/functions/dom-domdocument-createentityreference.xml:1.8 Mon Jan 17 03:41:33 2005 +++ phpdoc/en/reference/dom/functions/dom-domdocument-createentityreference.xml Sat Apr 2 17:46:41 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id="function.dom-domdocument-createentityreference"> <refnamediv> <refname>DOMDocument->createEntityReference()</refname> @@ -27,7 +27,9 @@ <term><parameter>name</parameter></term> <listitem> <para> - The content of the entity reference. + The content of the entity reference, e.g. the entity reference minus + the leading <literal>&amp;</literal> and the trailing + <literal>;</literal> characters. </para> </listitem> </varlistentry> @@ -37,7 +39,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - The new <classname>DOMEntityReference</classname> or &false; if an error occured. + The new <classname>DOMEntityReference</classname> or &false; if an error + occured. </para> </refsect1> <refsect1 role="exceptions"> http://cvs.php.net/diff.php/phpdoc/en/reference/dom/functions/dom-domimplementation-createdocumenttype.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/dom/functions/dom-domimplementation-createdocumenttype.xml diff -u phpdoc/en/reference/dom/functions/dom-domimplementation-createdocumenttype.xml:1.9 phpdoc/en/reference/dom/functions/dom-domimplementation-createdocumenttype.xml:1.10 --- phpdoc/en/reference/dom/functions/dom-domimplementation-createdocumenttype.xml:1.9 Mon Jan 17 03:41:33 2005 +++ phpdoc/en/reference/dom/functions/dom-domimplementation-createdocumenttype.xml Sat Apr 2 17:46:41 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <refentry id='function.dom-domimplementation-createdocumenttype'> <refnamediv> <refname>DOMImplementation->createDocumentType()</refname> @@ -62,6 +62,51 @@ <literal>ownerDocument</literal> set to &null;. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Creating a document with an attached DTD</title> + <programlisting role="php"> + <![CDATA[ +<?php + +// Creates an instance of the DOMImplementation class +$imp = new DOMImplementation; + +// Creates a DOMDocumentType instance +$dtd = $imp->createDocumentType('graph', '', 'graph.dtd'); + +// Creates a DOMDocument instance +$dom = $imp->createDocument("", "", $dtd); + +// Set other properties +$dom->encoding = 'UTF-8'; +$dom->standalone = false; + +// Create an empty element +$element = $dom->createElement('graph'); + +// Append the element +$dom->appendChild($element); + +// Retrieve and print the document +echo $dom->saveXML(); + +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<!DOCTYPE graph SYSTEM "graph.dtd"> +<graph/> +]]> + </screen> + </example> + </para> + </refsect1> <refsect1 role="exceptions"> &reftitle.exceptions; <para> http://cvs.php.net/diff.php/phpdoc/en/reference/dom/functions/dom-domnode-removechild.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/dom/functions/dom-domnode-removechild.xml diff -u phpdoc/en/reference/dom/functions/dom-domnode-removechild.xml:1.8 phpdoc/en/reference/dom/functions/dom-domnode-removechild.xml:1.9 --- phpdoc/en/reference/dom/functions/dom-domnode-removechild.xml:1.8 Mon Jan 17 03:41:33 2005 +++ phpdoc/en/reference/dom/functions/dom-domnode-removechild.xml Sat Apr 2 17:46:41 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id='function.dom-domnode-removechild'> <refnamediv> <refname>DOMNode->removeChild()</refname> @@ -90,7 +90,8 @@ <screen role="xml"> <![CDATA[ <?xml version="1.0" encoding="iso-8859-1"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> <book id="listing"> <title>My lists</title> http://cvs.php.net/diff.php/phpdoc/en/reference/dom/functions/dom-domnode-replacechild.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/dom/functions/dom-domnode-replacechild.xml diff -u phpdoc/en/reference/dom/functions/dom-domnode-replacechild.xml:1.9 phpdoc/en/reference/dom/functions/dom-domnode-replacechild.xml:1.10 --- phpdoc/en/reference/dom/functions/dom-domnode-replacechild.xml:1.9 Mon Jan 17 03:41:33 2005 +++ phpdoc/en/reference/dom/functions/dom-domnode-replacechild.xml Sat Apr 2 17:46:41 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <refentry id='function.dom-domnode-replacechild'> <refnamediv> <refname>DOMNode->replaceChild()</refname> @@ -21,8 +21,7 @@ This function replaces the child <parameter>oldnode</parameter> with the passed new node. If the new node is already a child it will not be added a second time. If the replacement succeeds the - old node - is returned. + old node is returned. </para> </refsect1> <refsect1 role="parameters"> @@ -33,7 +32,9 @@ <term><parameter>newnode</parameter></term> <listitem> <para> - The new node. + The new node. It must be a member of the target document, i.e. + created by one of the DOMDocument->createXXX() methods or imported in + the document by <xref linkend='function.dom-domdocument-importnode' />. </para> </listitem> </varlistentry>