[gxml] Removed conflicting valadoc tags
- From: Daniel Espinosa Ortiz <despinosa src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gxml] Removed conflicting valadoc tags
- Date: Wed, 28 Oct 2015 19:32:35 +0000 (UTC)
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 {{{<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]