revised n*h headers

[wxWidgets.git] / interface / wx / xml / xml.h

diff --git a/interface/wx/xml/xml.h b/interface/wx/xml/xml.h
index c9f79375f22186450a38ca58d5e8a6e181fc1e2d..fccaf5341f76cc0089e873fd2654e8aab9cb8530 100644 (file)
--- a/interface/wx/xml/xml.h
+++ b/interface/wx/xml/xml.h
@@ -170,7 +170,7 @@ public:
         Be aware that for nodes of type @c wxXML_ELEMENT_NODE (the most used node type)
         the content is an empty string. See GetNodeContent() for more details.
     */
         Be aware that for nodes of type @c wxXML_ELEMENT_NODE (the most used node type)
         the content is an empty string. See GetNodeContent() for more details.
     */

-    wxString GetContent() const;
+    const wxString& GetContent() const;

 
     /**
         Returns the number of nodes which separe this node from @c grandparent.
 
     /**
         Returns the number of nodes which separe this node from @c grandparent.


@@ -191,7 +191,7 @@ public:
         Can be an empty string (e.g. for nodes of type @c wxXML_TEXT_NODE or
         @c wxXML_CDATA_SECTION_NODE).
     */
         Can be an empty string (e.g. for nodes of type @c wxXML_TEXT_NODE or
         @c wxXML_CDATA_SECTION_NODE).
     */

-    wxString GetName() const;
+    const wxString& GetName() const;

 
     /**
         Returns a pointer to the sibling of this node or @NULL if there are no
 
     /**
         Returns a pointer to the sibling of this node or @NULL if there are no


@@ -263,6 +263,8 @@ public:
         @return @true if @a precedingNode has been found and the @a child
                 node has been inserted.
 
         @return @true if @a precedingNode has been found and the @a child
                 node has been inserted.
 

+        @param child
+            The child to insert.

         @param precedingNode
             The node to insert @a child after. As a special case, this can be
             @NULL if this node has no children yet -- in that case, @a child
         @param precedingNode
             The node to insert @a child after. As a special case, this can be
             @NULL if this node has no children yet -- in that case, @a child


@@ -541,7 +543,7 @@ public:
         @note This is the encoding original file was saved in, @b not the
               encoding of in-memory representation!
     */
         @note This is the encoding original file was saved in, @b not the
               encoding of in-memory representation!
     */

-    wxString GetFileEncoding() const;
+    const wxString& GetFileEncoding() const;

 
     /**
         Returns the root node of the document.
 
     /**
         Returns the root node of the document.


@@ -555,7 +557,7 @@ public:
         If the version attribute was not explicitely given in the header, this function
         returns an empty string.
     */
         If the version attribute was not explicitely given in the header, this function
         returns an empty string.
     */

-    wxString GetVersion() const;
+    const wxString& GetVersion() const;

 
     /**
         Returns @true if the document has been loaded successfully.
 
     /**
         Returns @true if the document has been loaded successfully.