You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by tn...@apache.org on 2002/02/04 20:57:15 UTC
cvs commit: xml-xerces/c/src/xercesc/dom DOM_Attr.hpp DOM_Document.hpp DOM_DocumentType.hpp DOM_DOMImplementation.hpp DOM_NamedNodeMap.hpp DOM_NodeFilter.hpp DOM_Text.hpp
tng 02/02/04 11:57:15
Modified: c/src/xercesc/dom DOM_Attr.hpp DOM_Document.hpp
DOM_DocumentType.hpp DOM_DOMImplementation.hpp
DOM_NamedNodeMap.hpp DOM_NodeFilter.hpp
DOM_Text.hpp
Log:
Remove the phrase "Experimental".
Revision Changes Path
1.2 +41 -40 xml-xerces/c/src/xercesc/dom/DOM_Attr.hpp
Index: DOM_Attr.hpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/dom/DOM_Attr.hpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DOM_Attr.hpp 1 Feb 2002 22:21:44 -0000 1.1
+++ DOM_Attr.hpp 4 Feb 2002 19:57:15 -0000 1.2
@@ -1,37 +1,37 @@
/*
* The Apache Software License, Version 1.1
- *
- * Copyright (c) 1999-2000 The Apache Software Foundation. All rights
+ *
+ * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
* reserved.
- *
+ *
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
- *
+ *
* 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
+ * notice, this list of conditions and the following disclaimer.
+ *
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
- *
+ *
* 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
+ * if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
- *
+ *
* 4. The names "Xerces" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
- * software without prior written permission. For written
+ * software without prior written permission. For written
* permission, please contact apache\@apache.org.
- *
+ *
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
- *
+ *
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
@@ -45,7 +45,7 @@
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
- *
+ *
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation, and was
* originally based on software copyright (c) 1999, International
@@ -56,8 +56,11 @@
/*
* $Log: DOM_Attr.hpp,v $
- * Revision 1.1 2002/02/01 22:21:44 peiyongz
- * Initial revision
+ * Revision 1.2 2002/02/04 19:57:15 tng
+ * Remove the phrase "Experimental".
+ *
+ * Revision 1.1.1.1 2002/02/01 22:21:44 peiyongz
+ * sane_include
*
* Revision 1.7 2000/03/11 02:58:38 chchou
* Fix bug # 18, remove set method of readonly attributes
@@ -101,28 +104,28 @@
/**
* The <code>DOM_Attr</code> class refers to an attribute of an XML element.
*
-* Typically the allowable values for the
+* Typically the allowable values for the
* attribute are defined in a documenttype definition.
-* <p><code>DOM_Attr</code> objects inherit the <code>DOM_Node</code> interface, but
-* since attributes are not actually child nodes of the elements they are associated with, the
-* DOM does not consider them part of the document tree. Thus, the
-* <code>DOM_Node</code> attributes <code>parentNode</code>,
-* <code>previousSibling</code>, and <code>nextSibling</code> have a null
-* value for <code>DOM_Attr</code> objects. The DOM takes the view that
-* attributes are properties of elements rather than having a separate
-* identity from the elements they are associated with; this should make it
-* more efficient to implement such features as default attributes associated
-* with all elements of a given type. Furthermore, attribute nodes
-* may not be immediate children of a <code>DocumentFragment</code>. However,
-* they can be associated with <code>Element</code> nodes contained within a
-* <code>DocumentFragment</code>. In short, users of the DOM
-* need to be aware that <code>Attr</code> nodes have some things in common
-* with other objects inheriting the <code>Node</code> interface, but they
+* <p><code>DOM_Attr</code> objects inherit the <code>DOM_Node</code> interface, but
+* since attributes are not actually child nodes of the elements they are associated with, the
+* DOM does not consider them part of the document tree. Thus, the
+* <code>DOM_Node</code> attributes <code>parentNode</code>,
+* <code>previousSibling</code>, and <code>nextSibling</code> have a null
+* value for <code>DOM_Attr</code> objects. The DOM takes the view that
+* attributes are properties of elements rather than having a separate
+* identity from the elements they are associated with; this should make it
+* more efficient to implement such features as default attributes associated
+* with all elements of a given type. Furthermore, attribute nodes
+* may not be immediate children of a <code>DocumentFragment</code>. However,
+* they can be associated with <code>Element</code> nodes contained within a
+* <code>DocumentFragment</code>. In short, users of the DOM
+* need to be aware that <code>Attr</code> nodes have some things in common
+* with other objects inheriting the <code>Node</code> interface, but they
* also are quite distinct.
-*
+*
*/
class CDOM_EXPORT DOM_Attr: public DOM_Node {
-
+
public:
/** @name Constructors and assignment operators */
//@{
@@ -152,7 +155,7 @@
* @param other The source attribute object
*/
DOM_Attr & operator = (const DOM_Attr &other);
-
+
/**
* Assignment operator. This overloaded variant is provided for
* the sole purpose of setting a DOM_Node reference variable to
@@ -173,7 +176,7 @@
//@}
/** @name Destructor */
//@{
-
+
/**
* Destructor. The object being destroyed is a reference to the Attribute
* "node", not the underlying attribute itself.
@@ -181,11 +184,11 @@
*/
~DOM_Attr();
//@}
-
+
/** @name Getter functions */
//@{
/**
- * Returns the name of this attribute.
+ * Returns the name of this attribute.
*/
DOMString getName() const;
@@ -193,7 +196,7 @@
*
* Returns true if the attribute received its value explicitly in the
* XML document, or if a value was assigned programatically with
- * the setValue function. Returns false if the attribute value
+ * the setValue function. Returns false if the attribute value
* came from the default value declared in the document's DTD.
*/
bool getSpecified() const;
@@ -201,11 +204,11 @@
/**
* Returns the value of the attribute.
*
- * The value of the attribute is returned as a string.
+ * The value of the attribute is returned as a string.
* Character and general entity references are replaced with their values.
*/
DOMString getValue() const;
-
+
//@}
/** @name Setter functions */
//@{
@@ -223,8 +226,6 @@
/**
* The <code>DOM_Element</code> node this attribute is attached to or
* <code>null</code> if this attribute is not in use.
- *
- * <p><b>"Experimental - subject to change"</b></p>
*
*/
DOM_Element getOwnerElement() const;
1.2 +2 -18 xml-xerces/c/src/xercesc/dom/DOM_Document.hpp
Index: DOM_Document.hpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/dom/DOM_Document.hpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DOM_Document.hpp 1 Feb 2002 22:21:44 -0000 1.1
+++ DOM_Document.hpp 4 Feb 2002 19:57:15 -0000 1.2
@@ -1,7 +1,7 @@
/*
* The Apache Software License, Version 1.1
*
- * Copyright (c) 1999-2001 The Apache Software Foundation. All rights
+ * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
@@ -55,7 +55,7 @@
*/
/*
- * $Id: DOM_Document.hpp,v 1.1 2002/02/01 22:21:44 peiyongz Exp $
+ * $Id: DOM_Document.hpp,v 1.2 2002/02/04 19:57:15 tng Exp $
*/
#ifndef DOM_Document_HEADER_GUARD_
@@ -345,8 +345,6 @@
* use the <code>whatToShow</code> flags to show the entity reference node and set
* expandEntityReferences to false.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param root The root node of the DOM tree
* @param whatToShow This attribute determines which node types are presented via the iterator.
* @param filter The filter used to screen nodes
@@ -380,8 +378,6 @@
* <code>whatToShow</code> flags to show the entity reference node and set
* <code>expandEntityReferences</code> to false
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param root The root node of the DOM tree
* @param whatToShow This attribute determines which node types are presented via the tree-walker.
* @param filter The filter used to screen nodes
@@ -402,8 +398,6 @@
* This node if created gets attached to a document object or an entity node. There can be no child
* to this type of node.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param version The version data of the document. Currently possible value is 1.0
* @param encoding The encoding type specified in the document
* @param standalone The information whether the document is standalone or not
@@ -482,8 +476,6 @@
* node's <CODE>nodeName</CODE> and <CODE>nodeType</CODE>, plus the
* attributes related to namespaces (prefix and namespaces URI).
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param importedNode The node to import.
* @param deep If <CODE>true</CODE>, recursively import the subtree under the
* specified node; if <CODE>false</CODE>, import only the node itself,
@@ -500,8 +492,6 @@
* Creates an element of the given qualified name and
* namespace URI.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param namespaceURI The <em>namespace URI</em> of
* the element to create.
* @param qualifiedName The <em>qualified name</em>
@@ -525,8 +515,6 @@
* Creates an attribute of the given qualified name and namespace
* URI.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param namespaceURI The <em>namespace URI</em> of
* the attribute to create.
* @param qualifiedName The <em>qualified name</em>
@@ -558,8 +546,6 @@
* namespace URI in the order in which they would be encountered in a
* preorder traversal of the <code>DOM_Document</code> tree.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param namespaceURI The <em>namespace URI</em> of
* the elements to match on. The special value "*" matches all
* namespaces.
@@ -580,8 +566,6 @@
* type ID unless so defined. Implementations that do not know whether
* attributes are of type ID or not are expected to return
* <CODE>null</CODE>.</P>
- *
- * <p><b>"Experimental - subject to change"</b></p>
*
* @param elementId The unique <code>id</code> value for an element.
* @return The matching element.
1.2 +23 -26 xml-xerces/c/src/xercesc/dom/DOM_DocumentType.hpp
Index: DOM_DocumentType.hpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/dom/DOM_DocumentType.hpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DOM_DocumentType.hpp 1 Feb 2002 22:21:45 -0000 1.1
+++ DOM_DocumentType.hpp 4 Feb 2002 19:57:15 -0000 1.2
@@ -1,37 +1,37 @@
/*
* The Apache Software License, Version 1.1
- *
- * Copyright (c) 1999-2000 The Apache Software Foundation. All rights
+ *
+ * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
* reserved.
- *
+ *
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
- *
+ *
* 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
+ * notice, this list of conditions and the following disclaimer.
+ *
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
- *
+ *
* 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
+ * if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
- *
+ *
* 4. The names "Xerces" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
- * software without prior written permission. For written
+ * software without prior written permission. For written
* permission, please contact apache\@apache.org.
- *
+ *
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
- *
+ *
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
@@ -45,7 +45,7 @@
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
- *
+ *
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation, and was
* originally based on software copyright (c) 1999, International
@@ -56,8 +56,11 @@
/*
* $Log: DOM_DocumentType.hpp,v $
- * Revision 1.1 2002/02/01 22:21:45 peiyongz
- * Initial revision
+ * Revision 1.2 2002/02/04 19:57:15 tng
+ * Remove the phrase "Experimental".
+ *
+ * Revision 1.1.1.1 2002/02/01 22:21:45 peiyongz
+ * sane_include
*
* Revision 1.8 2000/03/10 02:14:39 chchou
* add null DOM_DocumentType constructor
@@ -103,8 +106,8 @@
class DocumentTypeImpl;
/**
- * Each <code>Document</code> has a <code>doctype</code> whose value
- * is either <code>null</code> or a <code>DocumentType</code> object.
+ * Each <code>Document</code> has a <code>doctype</code> whose value
+ * is either <code>null</code> or a <code>DocumentType</code> object.
*
* The <code>DOM_DocumentType</code> class provides access
* to the list of entities and notations that are defined for the document.
@@ -122,7 +125,7 @@
* assigned to refer to the actual DocumentType node.
* <p>
* A new DocumentType node for a document that does not already have one
- * can be created by DOM_Document::createDocumentType().
+ * can be created by DOM_Document::createDocumentType().
*
*/
DOM_DocumentType();
@@ -138,7 +141,7 @@
/**
* Copy constructor. Creates a new <code>DOM_Comment</code> that refers to the
- * same underlying node as the original.
+ * same underlying node as the original.
*
*
* @param other The object to be copied.
@@ -182,15 +185,15 @@
/** @name Getter functions. */
//@{
/**
- * The name of DTD; i.e., the name immediately following the
+ * The name of DTD; i.e., the name immediately following the
* <code>DOCTYPE</code> keyword in an XML source document.
*/
DOMString getName() const;
/**
- * This function returns a <code>NamedNodeMap</code> containing the general entities, both
+ * This function returns a <code>NamedNodeMap</code> containing the general entities, both
* external and internal, declared in the DTD. Parameter entities are not contained.
- * Duplicates are discarded.
+ * Duplicates are discarded.
* <p>
* Note: this functionality is not implemented in the initial release
* of the parser, and the returned NamedNodeMap will be empty.
@@ -214,8 +217,6 @@
/**
* Get the public identifier of the external subset.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @return The public identifier of the external subset.
*/
DOMString getPublicId() const;
@@ -223,16 +224,12 @@
/**
* Get the system identifier of the external subset.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @return The system identifier of the external subset.
*/
DOMString getSystemId() const;
/**
* Get the internal subset as a string.
- *
- * <p><b>"Experimental - subject to change"</b></p>
*
* @return The internal subset as a string.
*/
1.2 +33 -34 xml-xerces/c/src/xercesc/dom/DOM_DOMImplementation.hpp
Index: DOM_DOMImplementation.hpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/dom/DOM_DOMImplementation.hpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DOM_DOMImplementation.hpp 1 Feb 2002 22:21:45 -0000 1.1
+++ DOM_DOMImplementation.hpp 4 Feb 2002 19:57:15 -0000 1.2
@@ -1,37 +1,37 @@
/*
* The Apache Software License, Version 1.1
- *
- * Copyright (c) 1999-2000 The Apache Software Foundation. All rights
+ *
+ * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
* reserved.
- *
+ *
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
- *
+ *
* 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
+ * notice, this list of conditions and the following disclaimer.
+ *
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
- *
+ *
* 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
+ * if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
- *
+ *
* 4. The names "Xerces" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
- * software without prior written permission. For written
+ * software without prior written permission. For written
* permission, please contact apache\@apache.org.
- *
+ *
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
- *
+ *
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
@@ -45,7 +45,7 @@
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
- *
+ *
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation, and was
* originally based on software copyright (c) 1999, International
@@ -56,8 +56,11 @@
/*
* $Log: DOM_DOMImplementation.hpp,v $
- * Revision 1.1 2002/02/01 22:21:45 peiyongz
- * Initial revision
+ * Revision 1.2 2002/02/04 19:57:15 tng
+ * Remove the phrase "Experimental".
+ *
+ * Revision 1.1.1.1 2002/02/01 22:21:45 peiyongz
+ * sane_include
*
* Revision 1.8 2001/10/25 21:47:14 peiyongz
* Replace XMLDeleterFor with XMLRegisterCleanup
@@ -114,10 +117,10 @@
public:
/** @name Constructors and assignment operators */
-//@{
+//@{
/**
* Construct a DOM_Implementation reference variable, which should
- * be assigned to the return value from
+ * be assigned to the return value from
* <code>DOM_Implementation::getImplementation()</code>.
*/
DOM_DOMImplementation();
@@ -130,7 +133,7 @@
//@}
/** @name Destructor */
- //@{
+ //@{
/**
* Destructor. The object being destroyed is a reference to the DOMImplemenentation,
* not the underlying DOMImplementation object itself, which is owned by
@@ -147,28 +150,28 @@
/**
* Test if the DOM implementation implements a specific feature.
*
- * @param feature The string of the feature to test (case-insensitive). The legal
- * values are defined throughout this specification. The string must be
+ * @param feature The string of the feature to test (case-insensitive). The legal
+ * values are defined throughout this specification. The string must be
* an <EM>XML name</EM> (see also Compliance).
- * @param version This is the version number of the package name to test.
- * In Level 1, this is the string "1.0". If the version is not specified,
- * supporting any version of the feature will cause the method to return
- * <code>true</code>.
- * @return <code>true</code> if the feature is implemented in the specified
+ * @param version This is the version number of the package name to test.
+ * In Level 1, this is the string "1.0". If the version is not specified,
+ * supporting any version of the feature will cause the method to return
+ * <code>true</code>.
+ * @return <code>true</code> if the feature is implemented in the specified
* version, <code>false</code> otherwise.
*/
bool hasFeature(const DOMString &feature, const DOMString &version);
- /** Return a reference to a DOM_Implementation object for this
- * DOM implementation.
+ /** Return a reference to a DOM_Implementation object for this
+ * DOM implementation.
*
* Intended to support applications that may be
* using DOMs retrieved from several different sources, potentially
* with different underlying implementations.
*/
static DOM_DOMImplementation &getImplementation();
-
+
//@}
/** @name Functions introduced in DOM Level 2. */
@@ -180,8 +183,6 @@
* do not occur. It is expected that a future version of the DOM
* will provide a way for populating a <code>DOM_DocumentType</code>.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param qualifiedName The <em>qualified name</em>
* of the document type to be created.
* @param publicId The external subset public identifier.
@@ -201,8 +202,6 @@
* Creates an XML <code>DOM_Document</code> object of the specified type
* with its document element.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param namespaceURI The <em>namespace URI</em> of
* the document element to create, or <code>null</code>.
* @param qualifiedName The <em>qualified name</em>
@@ -216,9 +215,9 @@
* INVALID_CHARACTER_ERR: Raised if the specified qualified name
* contains an illegal character.
* <br>
- * NAMESPACE_ERR: Raised if the <CODE>qualifiedName</CODE> is
- * malformed, or if the <CODE>qualifiedName</CODE> has a prefix that is
- * "xml" and the <CODE>namespaceURI</CODE> is different from
+ * NAMESPACE_ERR: Raised if the <CODE>qualifiedName</CODE> is
+ * malformed, or if the <CODE>qualifiedName</CODE> has a prefix that is
+ * "xml" and the <CODE>namespaceURI</CODE> is different from
* "http://www.w3.org/XML/1998/namespace".
* <br>
* WRONG_DOCUMENT_ERR: Raised if <code>doctype</code> has already
@@ -231,7 +230,7 @@
// -----------------------------------------------------------------------
// Notification that lazy data has been deleted
// -----------------------------------------------------------------------
- static void reinitDOM_DOMImplementation();
+ static void reinitDOM_DOMImplementation();
};
#endif
1.2 +67 -70 xml-xerces/c/src/xercesc/dom/DOM_NamedNodeMap.hpp
Index: DOM_NamedNodeMap.hpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/dom/DOM_NamedNodeMap.hpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DOM_NamedNodeMap.hpp 1 Feb 2002 22:21:45 -0000 1.1
+++ DOM_NamedNodeMap.hpp 4 Feb 2002 19:57:15 -0000 1.2
@@ -1,37 +1,37 @@
/*
* The Apache Software License, Version 1.1
- *
- * Copyright (c) 1999-2000 The Apache Software Foundation. All rights
+ *
+ * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
* reserved.
- *
+ *
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
- *
+ *
* 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
+ * notice, this list of conditions and the following disclaimer.
+ *
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
- *
+ *
* 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
+ * if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
- *
+ *
* 4. The names "Xerces" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
- * software without prior written permission. For written
+ * software without prior written permission. For written
* permission, please contact apache\@apache.org.
- *
+ *
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
- *
+ *
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
@@ -45,7 +45,7 @@
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
- *
+ *
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation, and was
* originally based on software copyright (c) 1999, International
@@ -56,8 +56,11 @@
/*
* $Log: DOM_NamedNodeMap.hpp,v $
- * Revision 1.1 2002/02/01 22:21:45 peiyongz
- * Initial revision
+ * Revision 1.2 2002/02/04 19:57:15 tng
+ * Remove the phrase "Experimental".
+ *
+ * Revision 1.1.1.1 2002/02/01 22:21:45 peiyongz
+ * sane_include
*
* Revision 1.13 2000/06/07 22:49:40 andyh
* Memory usage reduction: DOM NamedNodeMaps for attributes are allocated
@@ -119,15 +122,15 @@
class NamedNodeMapImpl;
/**
-* <code>NamedNodeMap</code>s are used to
+* <code>NamedNodeMap</code>s are used to
* represent collections of nodes that can be accessed by name.
*
-* Note that <code>NamedNodeMap</code> does not inherit from <code>NodeList</code>;
-* <code>NamedNodeMap</code>s are not maintained in any particular order.
-* Nodes contained in a <code>NamedNodeMap</code> may
-* also be accessed by an ordinal index, but this is simply to allow
-* convenient enumeration of the contents, and
-* does not imply that the DOM specifies an order to these Nodes.
+* Note that <code>NamedNodeMap</code> does not inherit from <code>NodeList</code>;
+* <code>NamedNodeMap</code>s are not maintained in any particular order.
+* Nodes contained in a <code>NamedNodeMap</code> may
+* also be accessed by an ordinal index, but this is simply to allow
+* convenient enumeration of the contents, and
+* does not imply that the DOM specifies an order to these Nodes.
*/
class CDOM_EXPORT DOM_NamedNodeMap {
private:
@@ -136,7 +139,7 @@
static const unsigned short NNM_ELEMENT;
static const unsigned short NNM_OTHER;
-
+
public:
/** @name Constructors and assignment operator */
//@{
@@ -151,8 +154,8 @@
DOM_NamedNodeMap();
/**
- * Copy constructor. Creates a new <code>DOM_NamedNodeMap</code> reference object
- * that refers to the same underlying NamedNodeMap as the original.
+ * Copy constructor. Creates a new <code>DOM_NamedNodeMap</code> reference object
+ * that refers to the same underlying NamedNodeMap as the original.
*
* @param other The object to be copied.
*/
@@ -187,7 +190,7 @@
*
*/
~DOM_NamedNodeMap();
-
+
//@}
/** @Comparisons. */
@@ -237,28 +240,28 @@
//@{
/**
- * Adds a node using its <code>nodeName</code> attribute.
+ * Adds a node using its <code>nodeName</code> attribute.
*
- * <br>As the <code>nodeName</code> attribute is used to derive the name
- * which the node must be stored under, multiple nodes of certain types
- * (those that have a "special" string value) cannot be stored as the names
+ * <br>As the <code>nodeName</code> attribute is used to derive the name
+ * which the node must be stored under, multiple nodes of certain types
+ * (those that have a "special" string value) cannot be stored as the names
* would clash. This is seen as preferable to allowing nodes to be aliased.
- * @param arg A node to store in a named node map. The node will later be
- * accessible using the value of the <code>nodeName</code> attribute of
- * the node. If a node with that name is already present in the map, it
+ * @param arg A node to store in a named node map. The node will later be
+ * accessible using the value of the <code>nodeName</code> attribute of
+ * the node. If a node with that name is already present in the map, it
* is replaced by the new one.
* @return If the new <code>Node</code> replaces an existing node the
- * replaced <code>Node</code> is returned,
+ * replaced <code>Node</code> is returned,
* otherwise <code>null</code> is returned.
* @exception DOMException
- * WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a
- * different document than the one that created the
+ * WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a
+ * different document than the one that created the
* <code>NamedNodeMap</code>.
- * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this
+ * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this
* <code>NamedNodeMap</code> is readonly.
- * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an
- * <code>Attr</code> that is already an attribute of another
- * <code>Element</code> object. The DOM user must explicitly clone
+ * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an
+ * <code>Attr</code> that is already an attribute of another
+ * <code>Element</code> object. The DOM user must explicitly clone
* <code>Attr</code> nodes to re-use them in other elements.
*/
DOM_Node setNamedItem(DOM_Node arg);
@@ -268,14 +271,14 @@
//@{
/**
- * Returns the <code>index</code>th item in the map.
+ * Returns the <code>index</code>th item in the map.
*
- * If <code>index</code>
- * is greater than or equal to the number of nodes in the map, this returns
+ * If <code>index</code>
+ * is greater than or equal to the number of nodes in the map, this returns
* <code>null</code>.
* @param index Index into the map.
- * @return The node at the <code>index</code>th position in the
- * <code>NamedNodeMap</code>, or <code>null</code> if that is not a valid
+ * @return The node at the <code>index</code>th position in the
+ * <code>NamedNodeMap</code>, or <code>null</code> if that is not a valid
* index.
*/
DOM_Node item(unsigned int index) const;
@@ -284,17 +287,17 @@
* Retrieves a node specified by name.
*
* @param name The <code>nodeName</code> of a node to retrieve.
- * @return A <code>DOM_Node</code> (of any type) with the specified <code>nodeName</code>, or
- * <code>null</code> if it does not identify any node in
- * the map.
+ * @return A <code>DOM_Node</code> (of any type) with the specified <code>nodeName</code>, or
+ * <code>null</code> if it does not identify any node in
+ * the map.
*/
DOM_Node getNamedItem(const DOMString &name) const;
/**
- * The number of nodes in the map.
+ * The number of nodes in the map.
*
- * The range of valid child node indices is
- * 0 to <code>length-1</code> inclusive.
+ * The range of valid child node indices is
+ * 0 to <code>length-1</code> inclusive.
*/
unsigned int getLength() const;
@@ -305,13 +308,13 @@
/**
* Removes a node specified by name.
*
- * If the removed node is an
+ * If the removed node is an
* <code>Attr</code> with a default value it is immediately replaced.
* @param name The <code>nodeName</code> of a node to remove.
- * @return The node removed from the map or <code>null</code> if no node
+ * @return The node removed from the map or <code>null</code> if no node
* with such a name exists.
* @exception DOMException
- * NOT_FOUND_ERR: Raised if there is no node named <code>name</code> in
+ * NOT_FOUND_ERR: Raised if there is no node named <code>name</code> in
* the map.
* <br>
* NO_MODIFICATION_ALLOWED_ERR: Raised if this <code>NamedNodeMap</code>
@@ -326,8 +329,6 @@
/**
* Retrieves a node specified by local name and namespace URI.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param namespaceURI The <em>namespace URI</em> of
* the node to retrieve.
* @param localName The <em>local name</em> of the node to retrieve.
@@ -341,25 +342,23 @@
/**
* Adds a node using its <CODE>namespaceURI</CODE> and <CODE>localName</CODE>.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
- * @param arg A node to store in a named node map. The node will later be
- * accessible using the value of the <CODE>namespaceURI</CODE> and
- * <CODE>localName</CODE> attribute of the node. If a node with those
- * namespace URI and local name is already present in the map, it is
+ * @param arg A node to store in a named node map. The node will later be
+ * accessible using the value of the <CODE>namespaceURI</CODE> and
+ * <CODE>localName</CODE> attribute of the node. If a node with those
+ * namespace URI and local name is already present in the map, it is
* replaced by the new one.
* @return If the new <code>DOM_Node</code> replaces an existing node the
- * replaced <code>DOM_Node</code> is returned,
+ * replaced <code>DOM_Node</code> is returned,
* otherwise <code>null</code> is returned.
* @exception DOMException
- * WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a
- * different document than the one that created the
+ * WRONG_DOCUMENT_ERR: Raised if <code>arg</code> was created from a
+ * different document than the one that created the
* <code>DOM_NamedNodeMap</code>.
- * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this
+ * <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this
* <code>vNamedNodeMap</code> is readonly.
- * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an
- * <code>DOM_Attr</code> that is already an attribute of another
- * <code>DOM_Element</code> object. The DOM user must explicitly clone
+ * <br>INUSE_ATTRIBUTE_ERR: Raised if <code>arg</code> is an
+ * <code>DOM_Attr</code> that is already an attribute of another
+ * <code>DOM_Element</code> object. The DOM user must explicitly clone
* <code>DOM_Attr</code> nodes to re-use them in other elements.
*/
DOM_Node setNamedItemNS(DOM_Node arg);
@@ -367,8 +366,6 @@
/**
* Removes a node specified by local name and namespace URI.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
* @param namespaceURI The <em>namespace URI</em> of
* the node to remove.
* @param localName The <em>local name</em> of the
@@ -381,7 +378,7 @@
* @return The node removed from the map if a node with such a local name
* and namespace URI exists.
* @exception DOMException
- * NOT_FOUND_ERR: Raised if there is no node named <code>name</code> in
+ * NOT_FOUND_ERR: Raised if there is no node named <code>name</code> in
* the map.
* <br>
* NO_MODIFICATION_ALLOWED_ERR: Raised if this <code>DOM_NamedNodeMap</code>
1.2 +4 -5 xml-xerces/c/src/xercesc/dom/DOM_NodeFilter.hpp
Index: DOM_NodeFilter.hpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/dom/DOM_NodeFilter.hpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DOM_NodeFilter.hpp 1 Feb 2002 22:21:46 -0000 1.1
+++ DOM_NodeFilter.hpp 4 Feb 2002 19:57:15 -0000 1.2
@@ -1,7 +1,7 @@
/*
* The Apache Software License, Version 1.1
*
- * Copyright (c) 1999-2000 The Apache Software Foundation. All rights
+ * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
@@ -56,8 +56,11 @@
/*
* $Log: DOM_NodeFilter.hpp,v $
- * Revision 1.1 2002/02/01 22:21:46 peiyongz
- * Initial revision
+ * Revision 1.2 2002/02/04 19:57:15 tng
+ * Remove the phrase "Experimental".
+ *
+ * Revision 1.1.1.1 2002/02/01 22:21:46 peiyongz
+ * sane_include
*
* Revision 1.10 2000/10/20 22:03:04 andyh
* DOM NodeFileter - define values for FilterAction enum to match those in the DOM spec.
@@ -128,8 +131,6 @@
* One filter may be used with a number of different kinds of iterators, encouraging
* code reuse.
*
- * <p><b>"Experimental - subject to change"</b></p>
- *
*/
class CDOM_EXPORT DOM_NodeFilter
{
@@ -202,8 +203,6 @@
* or DOM_NodeIterator. This function will be called by the implementation of
* DOM_TreeWalker and DOM_NodeIterator; it is not intended to be called directly from user
* code.
- *
- * <p><b>"Experimental - subject to change"</b></p>
*
* @param node The node to check to see if it passes the filter or not.
* @return A constant to determine whether the node is accepted, rejected, or skipped.
1.2 +40 -39 xml-xerces/c/src/xercesc/dom/DOM_Text.hpp
Index: DOM_Text.hpp
===================================================================
RCS file: /home/cvs/xml-xerces/c/src/xercesc/dom/DOM_Text.hpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DOM_Text.hpp 1 Feb 2002 22:21:46 -0000 1.1
+++ DOM_Text.hpp 4 Feb 2002 19:57:15 -0000 1.2
@@ -1,37 +1,37 @@
/*
* The Apache Software License, Version 1.1
- *
- * Copyright (c) 1999-2000 The Apache Software Foundation. All rights
+ *
+ * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
* reserved.
- *
+ *
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
- *
+ *
* 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
+ * notice, this list of conditions and the following disclaimer.
+ *
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
- *
+ *
* 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
+ * if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
- *
+ *
* 4. The names "Xerces" and "Apache Software Foundation" must
* not be used to endorse or promote products derived from this
- * software without prior written permission. For written
+ * software without prior written permission. For written
* permission, please contact apache\@apache.org.
- *
+ *
* 5. Products derived from this software may not be called "Apache",
* nor may "Apache" appear in their name, without prior written
* permission of the Apache Software Foundation.
- *
+ *
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
@@ -45,7 +45,7 @@
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
- *
+ *
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation, and was
* originally based on software copyright (c) 1999, International
@@ -56,8 +56,11 @@
/*
* $Log: DOM_Text.hpp,v $
- * Revision 1.1 2002/02/01 22:21:46 peiyongz
- * Initial revision
+ * Revision 1.2 2002/02/04 19:57:15 tng
+ * Remove the phrase "Experimental".
+ *
+ * Revision 1.1.1.1 2002/02/01 22:21:46 peiyongz
+ * sane_include
*
* Revision 1.8 2000/07/28 01:33:31 aruna1
* DOM Level 2 Range feature introduced
@@ -100,24 +103,24 @@
/**
- * The <code>Text</code> interface represents the textual content (termed
- * character data in XML) of an <code>Element</code> or <code>Attr</code>.
- * If there is no markup inside an element's content, the text is contained
- * in a single object implementing the <code>Text</code> interface that is
- * the only child of the element. If there is markup, it is parsed into a
- * list of elements and <code>Text</code> nodes that form the list of
+ * The <code>Text</code> interface represents the textual content (termed
+ * character data in XML) of an <code>Element</code> or <code>Attr</code>.
+ * If there is no markup inside an element's content, the text is contained
+ * in a single object implementing the <code>Text</code> interface that is
+ * the only child of the element. If there is markup, it is parsed into a
+ * list of elements and <code>Text</code> nodes that form the list of
* children of the element.
- * <p>When a document is first made available via the DOM, there is only one
- * <code>Text</code> node for each block of text. Users may create adjacent
- * <code>Text</code> nodes that represent the contents of a given element
- * without any intervening markup, but should be aware that there is no way
- * to represent the separations between these nodes in XML, so they
- * will not (in general) persist between DOM editing sessions. The
- * <code>normalize()</code> method on <code>Element</code> merges any such
- * adjacent <code>Text</code> objects into a single node for each block of
- * text; this is recommended before employing operations that depend on a
- * particular document structure, such as navigation with
- * <code>XPointers.</code>
+ * <p>When a document is first made available via the DOM, there is only one
+ * <code>Text</code> node for each block of text. Users may create adjacent
+ * <code>Text</code> nodes that represent the contents of a given element
+ * without any intervening markup, but should be aware that there is no way
+ * to represent the separations between these nodes in XML, so they
+ * will not (in general) persist between DOM editing sessions. The
+ * <code>normalize()</code> method on <code>Element</code> merges any such
+ * adjacent <code>Text</code> objects into a single node for each block of
+ * text; this is recommended before employing operations that depend on a
+ * particular document structure, such as navigation with
+ * <code>XPointers.</code>
*/
class CDOM_EXPORT DOM_Text: public DOM_CharacterData {
@@ -180,19 +183,19 @@
//@{
/**
- * Breaks this node into two nodes at the specified
- * offset, keeping both in the tree as siblings.
+ * Breaks this node into two nodes at the specified
+ * offset, keeping both in the tree as siblings.
*
- * This node then only
- * contains all the content up to the <code>offset</code> point. And a new
- * node of the same nodeType, which is inserted as the next sibling of this
- * node, contains all the content at and after the <code>offset</code>
+ * This node then only
+ * contains all the content up to the <code>offset</code> point. And a new
+ * node of the same nodeType, which is inserted as the next sibling of this
+ * node, contains all the content at and after the <code>offset</code>
* point. When the <code>offset</code> is equal to the lenght of this node,
* the new node has no data.
* @param offset The offset at which to split, starting from 0.
* @return The new <code>Text</code> node.
* @exception DOMException
- * INDEX_SIZE_ERR: Raised if the specified offset is negative or greater
+ * INDEX_SIZE_ERR: Raised if the specified offset is negative or greater
* than the number of characters in <code>data</code>.
* <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
*/
@@ -203,8 +206,6 @@
//@{
/**
- *
- * <p><b>"Experimental - subject to change"</b></p>
*
* Return true if this node contains ignorable whitespaces only.
* @return True if this node contains ignorable whitespaces only.
---------------------------------------------------------------------
To unsubscribe, e-mail: xerces-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xerces-cvs-help@xml.apache.org