[valadoc] libvaladoc/api: Add API documentation for Struct



commit 1f69e63a14ef9df43c2c197d87f159f781005b1d
Author: Florian Brosch <flo brosch gmail com>
Date:   Mon Feb 28 12:17:39 2011 +0100

    libvaladoc/api: Add API documentation for Struct

 src/libvaladoc/api/struct.vala |   30 ++++++++++++++++++++++++++++++
 1 files changed, 30 insertions(+), 0 deletions(-)
---
diff --git a/src/libvaladoc/api/struct.vala b/src/libvaladoc/api/struct.vala
index 0e01c17..9df0a6f 100644
--- a/src/libvaladoc/api/struct.vala
+++ b/src/libvaladoc/api/struct.vala
@@ -23,27 +23,51 @@
 using Gee;
 using Valadoc.Content;
 
+
+/**
+ * Represents a struct declaration.
+ */
 public class Valadoc.Api.Struct : TypeSymbol {
 	public Struct (Vala.Struct symbol, Node parent) {
 		base (symbol, parent);
 	}
 
+	/**
+	 * Specifies the base struct.
+	 */
 	public TypeReference? base_type { private set; get; }
 
+
+	/**
+	 * Returns the name of this struct as it is used in C.
+	 */
 	public string? get_cname () {
 		return ((Vala.Struct) symbol).get_cname();
 	}
 
+	/**
+	 * Returns the C function name that duplicates instances of this data
+	 * type.
+	 */
 	public string? get_dup_function_cname () {
 		return ((Vala.Struct) symbol).get_dup_function ();
 	}
 
+	/**
+	 * Returns the C function name that frees instances of this data type.
+	 */
 	public string? get_free_function_cname () {
 		return ((Vala.Struct) symbol).get_free_function ();
 	}
 
+	/**
+	 * { inheritDoc}
+	 */
 	public override NodeType node_type { get { return NodeType.STRUCT; } }
 
+	/**
+	 * { inheritDoc}
+	 */
 	public override void accept (Visitor visitor) {
 		visitor.visit_struct (this);
 	}
@@ -57,12 +81,18 @@ public class Valadoc.Api.Struct : TypeSymbol {
 		this.base_type.resolve_type_references (root);
 	}
 
+	/**
+	 * { inheritDoc}
+	 */
 	internal override void resolve_type_references (Tree root) {
 		this.set_parent_references (root);
 
 		base.resolve_type_references (root);
 	}
 
+	/**
+	 * { inheritDoc}
+	 */
 	protected override Inline build_signature () {
 		var signature = new SignatureBuilder ();
 



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