steinm Tue Apr 23 10:25:45 2002 EDT
Added files:
/phpdoc/en/reference/domxml/functions DomNode-replace-child.xml
Modified files:
/phpdoc/en/reference/domxml functions.xml
/phpdoc/en/reference/domxml/functions DomNode-replace-node.xml
Log:
- added missing documentation for DomNode->replace_child()
- update DomNode->replace_node()
Index: phpdoc/en/reference/domxml/functions.xml
diff -u phpdoc/en/reference/domxml/functions.xml:1.2
phpdoc/en/reference/domxml/functions.xml:1.3
--- phpdoc/en/reference/domxml/functions.xml:1.2 Tue Apr 16 01:14:49 2002
+++ phpdoc/en/reference/domxml/functions.xml Tue Apr 23 10:25:43 2002
@@ -52,6 +52,7 @@
&reference.domxml.functions.DomNode-prefix;
&reference.domxml.functions.DomNode-previous-sibling;
&reference.domxml.functions.DomNode-remove-child;
+&reference.domxml.functions.DomNode-replace-child;
&reference.domxml.functions.DomNode-replace-node;
&reference.domxml.functions.DomNode-set-content;
&reference.domxml.functions.DomNode-set-name;
Index: phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml
diff -u phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml:1.3
phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml:1.4
--- phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml:1.3 Tue Apr 23
01:29:54 2002
+++ phpdoc/en/reference/domxml/functions/DomNode-replace-node.xml Tue Apr 23
+10:25:44 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/domxml.xml, last change in rev 1.39 -->
<refentry id='function.DomNode-replace-node'>
<refnamediv>
@@ -18,9 +18,10 @@
<para>
This function replaces an existing node with the passed
new node. Before the replacement
- <parameter>newnode</parameter> is copied to make sure a node which is
+ <parameter>newnode</parameter> is copied if it has a parent to
+ make sure a node which is
already in the document will not be inserted a second time. This
- behaviour enforces to do all modifications on the node before the
+ behaviour enforces doing all modifications on the node before the
replacement or to refetch the inserted node afterwards with functions like
<function>DomNode_first_child</function>,
<function>DomNode_child_nodes</function> etc..
Index: phpdoc/en/reference/domxml/functions/DomNode-replace-child.xml
+++ phpdoc/en/reference/domxml/functions/DomNode-replace-child.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id='function.DomNode-replace-child'>
<refnamediv>
<refname>DomNode->replace_child</refname>
<refpurpose>
Replaces a child
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>object</type><methodname>DomNode->replace_child</methodname>
<methodparam><type>object</type><parameter>oldnode</parameter></methodparam>
<methodparam><type>object</type><parameter>newnode</parameter></methodparam>
<void/>
</methodsynopsis>
<para>
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 old node cannot be found
the function returns false. If the replacement succeds the old node
is returned.
</para>
<para>
See also <function>DomNode_append_child</function>
</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
-->