GNOME.org
 

[gxml] gxml/*.vala: fix examples in comments regarding line breaking

commit b94ae2d4871d1aea890fe774f01dad13a3e5baf9
Author: Richard Schwarting <aquarichy gmail com>
Date:   Mon Oct 14 03:06:33 2013 -0400

    gxml/*.vala: fix examples in comments regarding line breaking

 gxml/CDATASection.vala |    3 +--
 gxml/Comment.vala      |    3 +--
 gxml/DocumentType.vala |    8 +++-----
 gxml/Element.vala      |   16 +++++++++-------
 4 files changed, 14 insertions(+), 16 deletions(-)
---
diff --git a/gxml/CDATASection.vala b/gxml/CDATASection.vala
index 906b9e2..a27b8e3 100644
--- a/gxml/CDATASection.vala
+++ b/gxml/CDATASection.vala
@@ -33,8 +33,7 @@ namespace GXml {
         * To create one, use { link GXml.Document.create_cdata_section}.
         *
         * An XML example would be like:
-        * {{{ <![CDATA[Here contains non-XML data, like code, or something that
-        * requires a lot of special XML entities.]]>. }}}
+        * {{{ <![CDATA[Here contains non-XML data, like code, or something that requires a lot of special 
XML entities.]]>.}}}
         * It is a type of Text node. For more, see: 
[[http://www.w3.org/TR/DOM-Level-1/level-one-core.html#ID-667469212]]
         */
        public class CDATASection : Text {
diff --git a/gxml/Comment.vala b/gxml/Comment.vala
index f972026..b1a5148 100644
--- a/gxml/Comment.vala
+++ b/gxml/Comment.vala
@@ -30,8 +30,7 @@
  *
  * To create one, use { link GXml.Document.create_comment}.
  *
- * An XML example looks like: {{{
- * <someNode>
+ * An XML example looks like: {{{  <someNode>
  *    <!-- this is a comment -->
  *    text in the node
  *  </someNode> }}}
diff --git a/gxml/DocumentType.vala b/gxml/DocumentType.vala
index a7d56ba..4a6a182 100644
--- a/gxml/DocumentType.vala
+++ b/gxml/DocumentType.vala
@@ -49,11 +49,9 @@ namespace GXml {
                 * That which follows DOCTYPE in the XML doctype
                 * declaration, like 'xml' or 'html'. For example, the
                 * document type name is 'html' for a document with
-                * the XML doctype declaration of {{{ <!DOCTYPE
-                * HTML PUBLIC "-//W3C//DTD HTML 4.01
-                * Transitional//EN"
-                * "http://www.w3.org/TR/html4/loose.dtd";> }}}
-               */
+                * the XML doctype declaration of
+                * {{{ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";> }}}
+                */
                public string name {
                        get {
                                // TODO: is it possible for int_subset and ext_subset to have different names?
diff --git a/gxml/Element.vala b/gxml/Element.vala
index 8fa0c6c..70b5b64 100644
--- a/gxml/Element.vala
+++ b/gxml/Element.vala
@@ -48,10 +48,10 @@ namespace GXml {
                /**
                 * The element's tag_name. Multiple elements can have
                 * the same tag name in a document. XML example:
-                * {{{&lt;photos>
-                *   &lt;img src="..." />
-                *   &lt;img src="..." />
-                * &lt;/photos>}}}
+                * {{{<photos>
+                *   <img src="..." />
+                *   <img src="..." />
+                * </photos>}}}
                 * In this example, photos and img are tag names.
                 *
                 * Version: DOM Level 1 Core<<BR>>
@@ -542,9 +542,11 @@ namespace GXml {
                /**
                 * This is a convenience property for Elements, useful
                 * when you want to see Text descendents of an
-                * element. With the XML example {{{<shops><shop
-                * id="1">Eeylops Owl Emporium</shop><shop
-                * id="2">Obscurus Books</shop></shops>}}} taking the
+                * element. With the XML example
+                * {{{<shops>
+                *   <shop id="1">Eeylops Owl Emporium</shop>
+                *   <shop id="2">Obscurus Books</shop>
+                * </shops>}}} taking the
                 * node for the shop element with id 1 and using this
                 * method, you would get back "Eeylops Owl Emporiums".
                 * If you used it on the shops element, you'd get
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]