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

[Florian Brosch <flobrosch src gnome org>]

commit db68bc0dfae4e03242b7eb8fd49f06bb9d449d74
Author: Florian Brosch <flo brosch gmail com>
Date:   Mon Feb 28 01:45:51 2011 +0100

    libvaladoc/api: Add API documentation for Field

 src/libvaladoc/api/field.vala |   30 ++++++++++++++++++++++++++++++
 1 files changed, 30 insertions(+), 0 deletions(-)
---
diff --git a/src/libvaladoc/api/field.vala b/src/libvaladoc/api/field.vala
index d94d26e..85b84c8 100644
--- a/src/libvaladoc/api/field.vala
+++ b/src/libvaladoc/api/field.vala
@@ -23,18 +23,33 @@
 using Gee;
 using Valadoc.Content;
 
+
+/**
+ * Represents a field.
+ */
 public class Valadoc.Api.Field : Member {
 	public Field (Vala.Field symbol, Node parent) {
 		base (symbol, parent);
 		field_type = new TypeReference (symbol.variable_type, this);
 	}
 
+	/**
+	 * Returns the name of this field as it is used in C.
+	 */
 	public string? get_cname () {
 		return ((Vala.Field) symbol).get_cname();
 	}
 
+	/**
+	 * The field type.
+	 *
+	 * @return The field type or null for void
+	 */
 	public TypeReference? field_type { private set; get; }
 
+	/**
+	 * Specifies whether the field is static.
+	 */
 	public bool is_static {
 		get {
 			if (this.parent is Namespace) {
@@ -45,18 +60,27 @@ public class Valadoc.Api.Field : Member {
 		}
 	}
 
+	/**
+	 * Specifies whether the field is volatile.
+	 */
 	public bool is_volatile {
 		get {
 			return ((Vala.Field) symbol).is_volatile;
 		}
 	}
 
+	/**
+	 * { inheritDoc}
+	 */
 	internal override void resolve_type_references (Tree root) {
 		field_type.resolve_type_references (root);
 
 		base.resolve_type_references (root);
 	}
 
+	/**
+	 * { inheritDoc}
+	 */
 	protected override Inline build_signature () {
 		var signature = new SignatureBuilder ();
 
@@ -73,8 +97,14 @@ public class Valadoc.Api.Field : Member {
 		return signature.get ();
 	}
 
+	/**
+	 * { inheritDoc}
+	 */
 	public override NodeType node_type { get { return NodeType.FIELD; } }
 
+	/**
+	 * { inheritDoc}
+	 */
 	public override void accept (Visitor visitor) {
 		visitor.visit_field (this);
 	}