[gxml] Removed conflicting valadoc tags



commit 89c850a7d348d5bc54dc5d256613a754061854ca
Author: Daniel Espinosa <esodan gmail com>
Date:   Sun Oct 25 16:36:48 2015 -0600

    Removed conflicting valadoc tags

 gxml/SerializableDouble.vala           |    2 ++
 gxml/libxml-Comment.vala               |    9 ---------
 gxml/libxml-Document.vala              |    8 --------
 gxml/libxml-Element.vala               |    7 +------
 gxml/libxml-NamespaceAttr.vala         |    2 +-
 gxml/libxml-Node.vala                  |    2 --
 gxml/libxml-ProcessingInstruction.vala |    4 ++--
 gxml/libxml-Text.vala                  |    3 +--
 8 files changed, 7 insertions(+), 30 deletions(-)
---
diff --git a/gxml/SerializableDouble.vala b/gxml/SerializableDouble.vala
index 4966f64..26e4142 100644
--- a/gxml/SerializableDouble.vala
+++ b/gxml/SerializableDouble.vala
@@ -24,6 +24,8 @@ using Gee;
 /**
  * Represent any boolean property to be added as a { link GXml.Attribute} to a { link GXml.Element}
  *
+ * This object can be used when the property could be removed from serialization, specially if missing
+ * on XML have some missing and avoidable.
  */
 public class GXml.SerializableDouble : SerializableObjectModel, SerializableProperty
 {
diff --git a/gxml/libxml-Comment.vala b/gxml/libxml-Comment.vala
index 9806569..ae55a04 100644
--- a/gxml/libxml-Comment.vala
+++ b/gxml/libxml-Comment.vala
@@ -30,15 +30,6 @@
  *
  * To create one, use { link GXml.xDocument.create_comment}.
  *
- * An XML example looks like:
- *
- * {{{
- *  <someNode>
- *    <!-- this is a comment -->
- *    text in the node
- *  </someNode>
- * }}}
- *
  * For more, see: [[http://www.w3.org/TR/DOM-Level-1/level-one-core.html#ID-1728279322]]
  */
 public class GXml.xComment : GXml.xCharacterData, GXml.Comment {
diff --git a/gxml/libxml-Document.vala b/gxml/libxml-Document.vala
index 90e18db..a0f3f46 100644
--- a/gxml/libxml-Document.vala
+++ b/gxml/libxml-Document.vala
@@ -720,14 +720,6 @@ namespace GXml {
                 * Its memory is freed when its owner document is
                 * freed.
                 *
-                * XML example:
-                * {{{ <?pi_target processing instruction data?>
-                * <?xml-stylesheet href="style.xsl" type="text/xml"?>}}}
-                *
-                * In the above example, the Processing Instruction's
-                * target is 'xml-stylesheet' and its content data is
-                * 'href="style.xsl" type="text/xml"'.
-                *
                 * Version: DOM Level 1 Core<<BR>>
                 * URL: 
[[http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createProcessingInstruction]]
                 *
diff --git a/gxml/libxml-Element.vala b/gxml/libxml-Element.vala
index 5ae0356..b8fdb9c 100644
--- a/gxml/libxml-Element.vala
+++ b/gxml/libxml-Element.vala
@@ -49,12 +49,7 @@ namespace GXml {
                // TODO: find out how to do double-spaces in Valadoc, so we can indent <img...
                /**
                 * The element's tag_name. Multiple elements can have
-                * the same tag name in a document. XML example:
-                * {{{<photos>
-                *   <img src="..." />
-                *   <img src="..." />
-                * </photos>}}}
-                * In this example, photos and img are tag names.
+                * the same tag name in a document.
                 *
                 * Version: DOM Level 1 Core<<BR>>
                 * URL: [[http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-104682815]]
diff --git a/gxml/libxml-NamespaceAttr.vala b/gxml/libxml-NamespaceAttr.vala
index c7fe439..3ec60fa 100644
--- a/gxml/libxml-NamespaceAttr.vala
+++ b/gxml/libxml-NamespaceAttr.vala
@@ -46,7 +46,7 @@ namespace GXml {
 
                /**
                 * The prefix that this xmlns attribute defines. So,
-                * if the element was like {{{&lt;Fish xmlns:foods="http://fishies.org/foods"; />}}}, the
+                * if the element was like {{{xmlns:foods="http://fishies.org/foods"}}}, the
                 * defined prefix would be foods.
                 */
                public string defined_prefix {
diff --git a/gxml/libxml-Node.vala b/gxml/libxml-Node.vala
index 48b03b9..1ad7adf 100644
--- a/gxml/libxml-Node.vala
+++ b/gxml/libxml-Node.vala
@@ -230,8 +230,6 @@ namespace GXml {
                 * A link to the parent_node of this node. For example,
                 * with elements, the immediate, outer element is the parent.
                 *
-                * XML example: {{{<parent><child></child></parent>}}}
-                *
                 * Do not free this.  It's memory will be released
                 * when the owning { link GXml.xDocument} is freed.
                 *
diff --git a/gxml/libxml-ProcessingInstruction.vala b/gxml/libxml-ProcessingInstruction.vala
index a907dcb..543aa12 100644
--- a/gxml/libxml-ProcessingInstruction.vala
+++ b/gxml/libxml-ProcessingInstruction.vala
@@ -34,10 +34,10 @@ namespace GXml {
         * To create one, use { link GXml.xDocument.create_processing_instruction}.
         *
         * For an example of a ProcessingInstruction, this one specifies a stylesheet:
-        * {{{<?xml-stylesheet href="style.xsl" type="text/xml"?>}}}
+        * {{{stylesheet href="style.xsl" type="text/xml"}}}
         *
         * The general form is
-        * {{{<?pi_target processing instruction data?>}}}
+        * {{{pi_target processing instruction data}}}
         * For more, see: [[http://www.w3.org/TR/DOM-Level-1/level-one-core.html#ID-1004215813]]
         */
        public class xProcessingInstruction : xNode, GXml.ProcessingInstruction {
diff --git a/gxml/libxml-Text.vala b/gxml/libxml-Text.vala
index cf602d8..80ca876 100644
--- a/gxml/libxml-Text.vala
+++ b/gxml/libxml-Text.vala
@@ -31,8 +31,7 @@ namespace GXml {
         * To create one, use { link GXml.xDocument.create_text_node}.
         *
         * Describes the text found as children of elements throughout
-        * an XML document, like "He who must not be named" in the
-        * XML: {{{<name>He who must not be named</name>}}}
+        * an XML document, like "He who must not be named" betwean two tags
         * With libxml2 as a backend, it should be noted that two
         * adjacent text nodes are always merged into one Text node,
         * so some functionality for Text, like split_text, will not


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]