[gxml] Attr.vala: update documentation, specifically references to spec (2)

[Richard Hans Schwarting <rschwart src gnome org>]

commit 40c6f6b0b12321d9ce26fdf8bff989a081ed7c0a
Author: Richard Schwarting <aquarichy gmail com>
Date:   Sun Jul 28 01:30:10 2013 -0400

    Attr.vala: update documentation, specifically references to spec (2)

 gxml/Attr.vala           |    6 +++---
 gxml/Document.vala       |    6 +++---
 gxml/DomNode.vala        |    7 ++++---
 gxml/Implementation.vala |    2 +-
 gxml/NodeList.vala       |    3 +++
 5 files changed, 14 insertions(+), 10 deletions(-)
---
diff --git a/gxml/Attr.vala b/gxml/Attr.vala
index 0cb197a..d441cd6 100644
--- a/gxml/Attr.vala
+++ b/gxml/Attr.vala
@@ -185,12 +185,12 @@ namespace GXml {
                 * underlying document. If the attribute is changed,
                 * it is set to false.
                 *
-                * @todo: this requires support from the DTD, and
-                * probably libxml2's xmlAttribute
-                *
                 * Version: DOM Level 1 Core
                 * URL: [[http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-862529273]]
                 */
+               /* @todo: this requires support from the DTD, and
+                * probably libxml2's xmlAttribute
+                */
                public bool specified {
                        // STUB
                        get;
diff --git a/gxml/Document.vala b/gxml/Document.vala
index 43590ad..bd0fda7 100644
--- a/gxml/Document.vala
+++ b/gxml/Document.vala
@@ -498,7 +498,7 @@ namespace GXml {
                /* Public Methods */
                /**
                 * Creates an empty Element node with the tag name
-                * tag_name, which must be a [[http://www.w3.org/TR/REC-xml/#NT-Name|valid XML name].
+                * tag_name, which must be a [[http://www.w3.org/TR/REC-xml/#NT-Name|valid XML name]].
                 *
                 * XML example: {{{<Person></Person>}}}
                 *
@@ -682,10 +682,10 @@ namespace GXml {
                 * only have one Element child, the root element, and
                 * one DocumentType.
                 *
-                * @return The newly added child.
-                *
                 * Version: DOM Level 1 Core
                 * URL: [[http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-appendChild]]
+                *
+                * @return The newly added child.
                 */
                public override DomNode? append_child (DomNode new_child) {
                        this.check_wrong_document (new_child);
diff --git a/gxml/DomNode.vala b/gxml/DomNode.vala
index 92a86c6..ba41e20 100644
--- a/gxml/DomNode.vala
+++ b/gxml/DomNode.vala
@@ -87,8 +87,8 @@ namespace GXml {
 
                /**
                 * The list of attributes that store namespace definitions.  This is not part of a DOM spec.
-                * #TODO: determine best API for exposing these, as it's not defined in the IDL
                 */
+               /* @TODO: determine best API for exposing these, as it's not defined in the IDL */
                public virtual NodeList? namespace_definitions {
                        get {
                                return null;
@@ -221,8 +221,9 @@ namespace GXml {
                 *
                 * Version: DOM Level 1 Core
                 * URL: [[http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#attribute-childNodes]]
-                *
-                * #todo: identify node types that use children for values, like attribute
+                */
+               /*
+                * @todo: identify node types that use children for values, like attribute
                 */
                public virtual NodeList? child_nodes {
                        // TODO: need to implement NodeList
diff --git a/gxml/Implementation.vala b/gxml/Implementation.vala
index 6daa496..7715ec9 100644
--- a/gxml/Implementation.vala
+++ b/gxml/Implementation.vala
@@ -102,7 +102,7 @@ namespace GXml {
                 * Reports whether we support a feature at a given version level.
                 *
                 * Version: DOM Level 1 Core
-                * URL: http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-hasFeature
+                * URL: [[http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-hasFeature]]
                 *
                 * TODO: implement more of this, using libxml2's parser.h's xmlGetFeature, xmlHasFeature, etc.
                 *
diff --git a/gxml/NodeList.vala b/gxml/NodeList.vala
index f02f076..c492b94 100644
--- a/gxml/NodeList.vala
+++ b/gxml/NodeList.vala
@@ -133,6 +133,9 @@ namespace GXml {
                 *
                 * @return The list as an XML string.
                 */
+               /*
+                * @todo: write a test
+                */
                public abstract string to_string (bool in_line);
        }