From 762529d178413dd395a9c3b3f78a740a53b21d58 Mon Sep 17 00:00:00 2001 From: Erica Douglass Date: Fri, 4 Oct 2002 08:20:20 +0000 Subject: [PATCH] Fixed grammatical errors. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@98112 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/domxml/reference.xml | 66 +++++++++++++++++----------------- 1 file changed, 33 insertions(+), 33 deletions(-) diff --git a/reference/domxml/reference.xml b/reference/domxml/reference.xml index 0a6a0c195a..f9090d7fdb 100644 --- a/reference/domxml/reference.xml +++ b/reference/domxml/reference.xml @@ -1,5 +1,5 @@ - + DOM XML functions DOM XML @@ -9,32 +9,32 @@ &reftitle.intro; &warn.experimental; - The domxml extension has been overhauled in PHP 4.3.0 to provide - a better compliance with the DOM standard. The extension still contains - many old functions, but they should not be used anymore. Especially those - non object oriented functions should be avoided. + The DOM XML extension has been overhauled in PHP 4.3.0 to better comply with + the DOM standard. The extension still contains + many old functions, but they should no longer be used. In particular, functions + that are not object-oriented should be avoided. The extension allows you to operate on an XML document with the DOM API. It also provides a function domxml_xmltree to turn the - complete XML document into a tree of PHP objects. Currently this - tree should be considered read-only - you can modify it but this + complete XML document into a tree of PHP objects. Currently, this + tree should be considered read-only — you can modify it, but this would not make any sense since DomDocument_dump_mem cannot be applied to it. Therefore, if you want to read an XML file and write - a modified version use the DomDocument_create_element, + a modified version, use DomDocument_create_element, DomDocument_create_text_node, - set_attribute, etc. and finally - DomDocument_dump_mem functions. + set_attribute, etc. and finally the + DomDocument_dump_mem function.
&reftitle.required; - This extension make use of the - GNOME xml library. Download - and install this library. You will need at least libxml-2.4.14 + This extension makes use of the + GNOME XML library. Download + and install this library. You will need at least libxml-2.4.14.
@@ -50,10 +50,10 @@ Deprecated functions There are quite a few functions that do not fit into the DOM standard and - should not be used anymore as listed in the following table. + should no longer be used. These functions are listed in the following table. The function DomNode_append_child has changed its - behaviour. It now actually adds a child and not a sibling. If this - breaks your application use the non DOM function + behaviour. It now adds a child and not a sibling. If this + breaks your application, use the non-DOM function DomNode_append_sibling. @@ -130,14 +130,14 @@ DomNode_new_child Create a new node with e.g. - DomDocument_create_element und add it with + DomDocument_create_element and add it with DomNode_append_child. DomNode_set_content Create a new node with e.g. - DomDocument_create_text_node und add it with + DomDocument_create_text_node and add it with DomNode_append_child. @@ -164,27 +164,27 @@
Classes - The API of the module follows the DOM Level 2 standard as close - as possible. Consequently the API is fully object oriented. + The API of the module follows the DOM Level 2 standard as closely + as possible. Consequently, the API is fully object-oriented. It is a good idea to have the DOM standard available when using this module. - Though the API is object oriented there are many functions which can - be called in a non-object oriented way by passing the object to operate - on as the first argument. These function are mainly to retain compatibilty - to older versions of the extension but are not encouraged to use anymore - in new developments. + Though the API is object-oriented, there are many functions which can + be called in a non-object-oriented way by passing the object to operate + on as the first argument. These functions are mainly to retain compatibilty + to older versions of the extension, and should not be used when creating new + scripts. - This API differs from the official DOM API in two points. First, all - class attributes are implemented as functions with the same name and - secondly the function names follow the PHP naming convention. This means + This API differs from the official DOM API in two ways. First, all + class attributes are implemented as functions with the same name. + Secondly, the function names follow the PHP naming convention. This means that a DOM function lastChild() will be written as last_child(). This module defines a number of classes, which are listed — including their method — in the following tables. Classes with an equivalent in the - DOM Standard are named DOMxxx. + DOM standard are named DOMxxx. @@ -693,7 +693,7 @@ The classes DomDtd is derived from DomNode. DomComment is derived from - DomCData + DomCData.
@@ -701,9 +701,9 @@ &reftitle.examples; Many examples in this reference require an XML string. Instead of - repeating this string in any example it will be put into a file - and be included by each example. This include file is shown in the - following example section. You could also create an XML document + repeating this string in every example, it will be put into a file + which will be included by each example. This include file is shown in the + following example section. Alternatively, you could create an XML document and read it with DomDocument_open_file.