Jelajahi Sumber

Merge pull request #114 from Vasily-Biryukov/doc

Small fixes in documentation
Lee Thomason 12 tahun lalu
induk
melakukan
392bcd2485
2 mengubah file dengan 30 tambahan dan 30 penghapusan
  1. 3 3
      readme.md
  2. 27 27
      tinyxml2.h

+ 3 - 3
readme.md

@@ -1,7 +1,7 @@
 TinyXML-2
 TinyXML-2
 =========
 =========
 
 
-TinyXML is a simple, small, efficient, C++ XML parser that can be 
+TinyXML-2 is a simple, small, efficient, C++ XML parser that can be 
 easily integrated into other programs.
 easily integrated into other programs.
 
 
 The master is hosted on github:
 The master is hosted on github:
@@ -15,7 +15,7 @@ Examples are in the "related pages" tab of the HTML docs.
 What it does.
 What it does.
 -------------
 -------------
 	
 	
-In brief, TinyXML parses an XML document, and builds from that a 
+In brief, TinyXML-2 parses an XML document, and builds from that a 
 Document Object Model (DOM) that can be read, modified, and saved.
 Document Object Model (DOM) that can be read, modified, and saved.
 
 
 XML stands for "eXtensible Markup Language." It is a general purpose
 XML stands for "eXtensible Markup Language." It is a general purpose
@@ -197,7 +197,7 @@ Or the XMLPrinter class:
 Printing to memory is supported by the XMLPrinter.
 Printing to memory is supported by the XMLPrinter.
 
 
 	XMLPrinter printer;
 	XMLPrinter printer;
-	doc->Print( &printer );
+	doc.Print( &printer );
 	// printer.CStr() has a const char* to the XML
 	// printer.CStr() has a const char* to the XML
 
 
 #### Print without an XMLDocument
 #### Print without an XMLDocument

+ 27 - 27
tinyxml2.h

@@ -402,7 +402,7 @@ private:
 	All flavors of Visit methods have a default implementation that returns 'true' (continue
 	All flavors of Visit methods have a default implementation that returns 'true' (continue
 	visiting). You need to only override methods that are interesting to you.
 	visiting). You need to only override methods that are interesting to you.
 
 
-	Generally Accept() is called on the TiXmlDocument, although all nodes support visiting.
+	Generally Accept() is called on the XMLDocument, although all nodes support visiting.
 
 
 	You should never change the document from a callback.
 	You should never change the document from a callback.
 
 
@@ -759,12 +759,12 @@ public:
     */
     */
     virtual bool ShallowEqual( const XMLNode* compare ) const = 0;
     virtual bool ShallowEqual( const XMLNode* compare ) const = 0;
 
 
-    /** Accept a hierarchical visit of the nodes in the TinyXML DOM. Every node in the
+    /** Accept a hierarchical visit of the nodes in the TinyXML-2 DOM. Every node in the
     	XML tree will be conditionally visited and the host will be called back
     	XML tree will be conditionally visited and the host will be called back
-    	via the TiXmlVisitor interface.
+    	via the XMLVisitor interface.
 
 
-    	This is essentially a SAX interface for TinyXML. (Note however it doesn't re-parse
-    	the XML for the callbacks, so the performance of TinyXML is unchanged by using this
+    	This is essentially a SAX interface for TinyXML-2. (Note however it doesn't re-parse
+    	the XML for the callbacks, so the performance of TinyXML-2 is unchanged by using this
     	interface versus any other.)
     	interface versus any other.)
 
 
     	The interface has been based on ideas from:
     	The interface has been based on ideas from:
@@ -776,7 +776,7 @@ public:
 
 
     	An example of using Accept():
     	An example of using Accept():
     	@verbatim
     	@verbatim
-    	TiXmlPrinter printer;
+    	XMLPrinter printer;
     	tinyxmlDoc.Accept( &printer );
     	tinyxmlDoc.Accept( &printer );
     	const char* xmlcstr = printer.CStr();
     	const char* xmlcstr = printer.CStr();
     	@endverbatim
     	@endverbatim
@@ -818,7 +818,7 @@ private:
 	A text node can have 2 ways to output the next. "normal" output
 	A text node can have 2 ways to output the next. "normal" output
 	and CDATA. It will default to the mode it was parsed from the XML file and
 	and CDATA. It will default to the mode it was parsed from the XML file and
 	you generally want to leave it alone, but you can change the output mode with
 	you generally want to leave it alone, but you can change the output mode with
-	SetCDATA() and query it with CDATA().
+	SetCData() and query it with CData().
 */
 */
 class XMLText : public XMLNode
 class XMLText : public XMLNode
 {
 {
@@ -891,7 +891,7 @@ private:
 		<?xml version="1.0" standalone="yes"?>
 		<?xml version="1.0" standalone="yes"?>
 	@endverbatim
 	@endverbatim
 
 
-	TinyXML2 will happily read or write files without a declaration,
+	TinyXML-2 will happily read or write files without a declaration,
 	however.
 	however.
 
 
 	The text of the declaration isn't interpreted. It is parsed
 	The text of the declaration isn't interpreted. It is parsed
@@ -922,12 +922,12 @@ protected:
 };
 };
 
 
 
 
-/** Any tag that tinyXml doesn't recognize is saved as an
+/** Any tag that TinyXML-2 doesn't recognize is saved as an
 	unknown. It is a tag of text, but should not be modified.
 	unknown. It is a tag of text, but should not be modified.
 	It will be written back to the XML, unchanged, when the file
 	It will be written back to the XML, unchanged, when the file
 	is saved.
 	is saved.
 
 
-	DTD tags get thrown into TiXmlUnknowns.
+	DTD tags get thrown into XMLUnknowns.
 */
 */
 class XMLUnknown : public XMLNode
 class XMLUnknown : public XMLNode
 {
 {
@@ -1005,52 +1005,52 @@ public:
         return _next;
         return _next;
     }
     }
 
 
-    /** IntAttribute interprets the attribute as an integer, and returns the value.
+    /** IntValue interprets the attribute as an integer, and returns the value.
         If the value isn't an integer, 0 will be returned. There is no error checking;
         If the value isn't an integer, 0 will be returned. There is no error checking;
-    	use QueryIntAttribute() if you need error checking.
+    	use QueryIntValue() if you need error checking.
     */
     */
     int		 IntValue() const				{
     int		 IntValue() const				{
         int i=0;
         int i=0;
         QueryIntValue( &i );
         QueryIntValue( &i );
         return i;
         return i;
     }
     }
-    /// Query as an unsigned integer. See IntAttribute()
+    /// Query as an unsigned integer. See IntValue()
     unsigned UnsignedValue() const			{
     unsigned UnsignedValue() const			{
         unsigned i=0;
         unsigned i=0;
         QueryUnsignedValue( &i );
         QueryUnsignedValue( &i );
         return i;
         return i;
     }
     }
-    /// Query as a boolean. See IntAttribute()
+    /// Query as a boolean. See IntValue()
     bool	 BoolValue() const				{
     bool	 BoolValue() const				{
         bool b=false;
         bool b=false;
         QueryBoolValue( &b );
         QueryBoolValue( &b );
         return b;
         return b;
     }
     }
-    /// Query as a double. See IntAttribute()
+    /// Query as a double. See IntValue()
     double 	 DoubleValue() const			{
     double 	 DoubleValue() const			{
         double d=0;
         double d=0;
         QueryDoubleValue( &d );
         QueryDoubleValue( &d );
         return d;
         return d;
     }
     }
-    /// Query as a float. See IntAttribute()
+    /// Query as a float. See IntValue()
     float	 FloatValue() const				{
     float	 FloatValue() const				{
         float f=0;
         float f=0;
         QueryFloatValue( &f );
         QueryFloatValue( &f );
         return f;
         return f;
     }
     }
 
 
-    /** QueryIntAttribute interprets the attribute as an integer, and returns the value
+    /** QueryIntValue interprets the attribute as an integer, and returns the value
     	in the provided parameter. The function will return XML_NO_ERROR on success,
     	in the provided parameter. The function will return XML_NO_ERROR on success,
     	and XML_WRONG_ATTRIBUTE_TYPE if the conversion is not successful.
     	and XML_WRONG_ATTRIBUTE_TYPE if the conversion is not successful.
     */
     */
     XMLError QueryIntValue( int* value ) const;
     XMLError QueryIntValue( int* value ) const;
-    /// See QueryIntAttribute
+    /// See QueryIntValue
     XMLError QueryUnsignedValue( unsigned int* value ) const;
     XMLError QueryUnsignedValue( unsigned int* value ) const;
-    /// See QueryIntAttribute
+    /// See QueryIntValue
     XMLError QueryBoolValue( bool* value ) const;
     XMLError QueryBoolValue( bool* value ) const;
-    /// See QueryIntAttribute
+    /// See QueryIntValue
     XMLError QueryDoubleValue( double* value ) const;
     XMLError QueryDoubleValue( double* value ) const;
-    /// See QueryIntAttribute
+    /// See QueryIntValue
     XMLError QueryFloatValue( float* value ) const;
     XMLError QueryFloatValue( float* value ) const;
 
 
     /// Set the attribute to a string value.
     /// Set the attribute to a string value.
@@ -1301,10 +1301,10 @@ public:
     const XMLAttribute* FindAttribute( const char* name ) const;
     const XMLAttribute* FindAttribute( const char* name ) const;
 
 
     /** Convenience function for easy access to the text inside an element. Although easy
     /** Convenience function for easy access to the text inside an element. Although easy
-    	and concise, GetText() is limited compared to getting the TiXmlText child
+    	and concise, GetText() is limited compared to getting the XMLText child
     	and accessing it directly.
     	and accessing it directly.
 
 
-    	If the first child of 'this' is a TiXmlText, the GetText()
+    	If the first child of 'this' is a XMLText, the GetText()
     	returns the character string of the Text node, else null is returned.
     	returns the character string of the Text node, else null is returned.
 
 
     	This is a convenient method for getting the text of simple contained text:
     	This is a convenient method for getting the text of simple contained text:
@@ -1431,7 +1431,7 @@ public:
 
 
     	You may optionally pass in the 'nBytes', which is
     	You may optionally pass in the 'nBytes', which is
     	the number of bytes which will be parsed. If not
     	the number of bytes which will be parsed. If not
-    	specified, TinyXML will assume 'xml' points to a
+    	specified, TinyXML-2 will assume 'xml' points to a
     	null terminated string.
     	null terminated string.
     */
     */
     XMLError Parse( const char* xml, size_t nBytes=(size_t)(-1) );
     XMLError Parse( const char* xml, size_t nBytes=(size_t)(-1) );
@@ -1507,7 +1507,7 @@ public:
     	Or you can use a printer to print to memory:
     	Or you can use a printer to print to memory:
     	@verbatim
     	@verbatim
     	XMLPrinter printer;
     	XMLPrinter printer;
-    	doc->Print( &printer );
+    	doc.Print( &printer );
     	// printer.CStr() has a const char* to the XML
     	// printer.CStr() has a const char* to the XML
     	@endverbatim
     	@endverbatim
     */
     */
@@ -1614,7 +1614,7 @@ private:
 
 
 /**
 /**
 	A XMLHandle is a class that wraps a node pointer with null checks; this is
 	A XMLHandle is a class that wraps a node pointer with null checks; this is
-	an incredibly useful thing. Note that XMLHandle is not part of the TinyXML
+	an incredibly useful thing. Note that XMLHandle is not part of the TinyXML-2
 	DOM structure. It is a separate utility class.
 	DOM structure. It is a separate utility class.
 
 
 	Take an example:
 	Take an example:
@@ -1829,7 +1829,7 @@ private:
 
 
 	@verbatim
 	@verbatim
 	XMLPrinter printer;
 	XMLPrinter printer;
-	doc->Print( &printer );
+	doc.Print( &printer );
 	SomeFunction( printer.CStr() );
 	SomeFunction( printer.CStr() );
 	@endverbatim
 	@endverbatim