[gxml] Attr.vala: rearrange description

[Richard Hans Schwarting <rschwart src gnome org>]

commit 2d3bdd9309dbcdf1c45b8540bcd39f9b175175b0
Author: Richard Schwarting <aquarichy gmail com>
Date:   Wed Oct 2 09:56:12 2013 -0400

    Attr.vala: rearrange description

 gxml/Attr.vala |   17 ++++++++++-------
 1 files changed, 10 insertions(+), 7 deletions(-)
---
diff --git a/gxml/Attr.vala b/gxml/Attr.vala
index c5ed1da..b7a8d6d 100644
--- a/gxml/Attr.vala
+++ b/gxml/Attr.vala
@@ -38,19 +38,22 @@
 [CCode (gir_namespace = "GXml", gir_version = "0.3")]
 namespace GXml {
        /**
-        * Represents an XML Attr node, a name=value pair.
+        * An XML Attr node, which represents a name="value" pair.
         *
-        * To create one, use { link GXml.Document.create_attribute}.
-        *
-        * These represent name=value attributes associated with XML
-        * { link GXml.Element}s. Values are often represented as strings but can
+        * These represent name="value" attributes associated with XML Elements
+        * (see { link GXml.Element}). Values are often represented as strings but can
         * also be more complex subtrees for some nodes.
         *
-        * XML Example: {{{<pie flavour="pumpkin" />}}} Here, we have
-        * an Attr with the name 'flavour' and the value 'pumpkin'.
+        * To create one, use { link GXml.Document.create_attribute}.
+        *
+        * XML Example: Here, we have an Attr with the name 'flavour'
+        * and the value 'pumpkin'. {{{<pie flavour="pumpkin" />}}}
         *
         * Version: DOM Level 1 Core
+        *
         * URL: [[http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-637646024]]
+        *
+        * @see GXml.Node
         */
        public class Attr : Node {
                /**