add interface documentation, use implicit namespace specification

2006-07-07  Jürg Billeter  <j@bitron.ch>

	* vala/valaconstructor.vala, vala/valacontinuestatement.vala,
	  vala/valadeclarationstatement.vala, vala/valadestructor.vala: add
	  interface documentation, use implicit namespace specification

svn path=/trunk/; revision=69

diff --git a/vala/ChangeLog b/vala/ChangeLog
index de43c0121b8c78169a5fbd73891cc9b4977c269d..fa2daee13c7ab8ef51bf72b1a3471813e6b5f8ff 100644 (file)
--- a/vala/ChangeLog
+++ b/vala/ChangeLog
@@ -1,3 +1,9 @@
+2006-07-07  Jürg Billeter  <j@bitron.ch>
+
+       * vala/valaconstructor.vala, vala/valacontinuestatement.vala,
+         vala/valadeclarationstatement.vala, vala/valadestructor.vala: add
+         interface documentation, use implicit namespace specification
+
 2006-07-07  Jürg Billeter  <j@bitron.ch>
 
        * vala/valacodecontext.vala: use continue statements to decrease

diff --git a/vala/vala/valaconstructor.vala b/vala/vala/valaconstructor.vala
index 1fbf94eaf3075ab64428494b97081a1f088bd9bb..6632453e018ea3c2d20cfc7260938bea957a06da 100644 (file)
--- a/vala/vala/valaconstructor.vala
+++ b/vala/vala/valaconstructor.vala
@@ -22,23 +22,46 @@
 
 using GLib;
 
-namespace Vala {
-       public class Constructor : CodeNode {
-               public Statement body { get; construct; }
-               public bool instance = true;
-               
-               public static ref Constructor new (SourceReference source) {
-                       return (new Constructor (source_reference = source));
+/**
+ * Represents a class or instance constructor.
+ */
+public class Vala.Constructor : CodeNode {
+       /**
+        * The body of this constructor.
+        */
+       public Statement body { get; set; }
+       
+       private bool _instance = true;
+       
+       /**
+        * Specifies whether this is an instance or a class constructor.
+        */
+       public bool instance {
+               get {
+                       return _instance;
                }
+               set {
+                       _instance = value;
+               }
+       }
+       
+       /**
+        * Creates a new constructor.
+        *
+        * @param source reference to source code
+        * @return       newly created constructor
+        */
+       public static ref Constructor! new (SourceReference source) {
+               return (new Constructor (source_reference = source));
+       }
+       
+       public override void accept (CodeVisitor! visitor) {
+               visitor.visit_begin_constructor (this);
                
-               public override void accept (CodeVisitor visitor) {
-                       visitor.visit_begin_constructor (this);
-                       
-                       if (body != null) {
-                               body.accept (visitor);
-                       }
-
-                       visitor.visit_end_constructor (this);
+               if (body != null) {
+                       body.accept (visitor);
                }
+
+               visitor.visit_end_constructor (this);
        }
 }

diff --git a/vala/vala/valacontinuestatement.vala b/vala/vala/valacontinuestatement.vala
index fa7c8456f27b15a67fba1f7b9645dc8d9a546f95..a39edabde5e5afc0a04a16ea66f335ce309d492b 100644 (file)
--- a/vala/vala/valacontinuestatement.vala
+++ b/vala/vala/valacontinuestatement.vala
@@ -22,14 +22,21 @@
 
 using GLib;
 
-namespace Vala {
-       public class ContinueStatement : Statement {
-               public static ref ContinueStatement new (SourceReference source) {
-                       return (new ContinueStatement (source_reference = source));
-               }
-               
-               public override void accept (CodeVisitor visitor) {
-                       visitor.visit_continue_statement (this);
-               }
+/**
+ * Represents a continue statement in the source code.
+ */
+public class Vala.ContinueStatement : Statement {
+       /**
+        * Creates a new continue statement.
+        *
+        * @param source reference to source code
+        * @return       newly created continue statement
+        */
+       public static ref ContinueStatement! new (SourceReference source) {
+               return (new ContinueStatement (source_reference = source));
+       }
+       
+       public override void accept (CodeVisitor! visitor) {
+               visitor.visit_continue_statement (this);
        }
 }

diff --git a/vala/vala/valadeclarationstatement.vala b/vala/vala/valadeclarationstatement.vala
index 1339e57e445da3544da4cfac211f2bce173f20ae..ffcb748be36b918493d5b5a42200dae9d2e33908 100644 (file)
--- a/vala/vala/valadeclarationstatement.vala
+++ b/vala/vala/valadeclarationstatement.vala
@@ -22,18 +22,29 @@
 
 using GLib;
 
-namespace Vala {
-       public class DeclarationStatement : Statement {
-               public LocalVariableDeclaration declaration { get; construct; }
+/**
+ * Represents a local variable declaration statement in the source code.
+ */
+public class Vala.DeclarationStatement : Statement {
+       /**
+        * The local variable declaration.
+        */
+       public LocalVariableDeclaration! declaration { get; set construct; }
 
-               public static ref DeclarationStatement new (LocalVariableDeclaration decl, SourceReference source) {
-                       return (new DeclarationStatement (declaration = decl, source_reference = source));
-               }
-               
-               public override void accept (CodeVisitor visitor) {
-                       declaration.accept (visitor);
-               
-                       visitor.visit_declaration_statement (this);
-               }
+       /**
+        * Creates a new declaration statement.
+        *
+        * @param decl   local variable declaration
+        * @param source reference to source code
+        * @return       newly created declaration statement
+        */
+       public static ref DeclarationStatement! new (LocalVariableDeclaration! decl, SourceReference source) {
+               return (new DeclarationStatement (declaration = decl, source_reference = source));
+       }
+       
+       public override void accept (CodeVisitor! visitor) {
+               declaration.accept (visitor);
+       
+               visitor.visit_declaration_statement (this);
        }
 }

diff --git a/vala/vala/valadestructor.vala b/vala/vala/valadestructor.vala
index 04a590a754705ff176845e480627d73225d881d0..dc19e3a85c49fc6a92413effab91472183477177 100644 (file)
--- a/vala/vala/valadestructor.vala
+++ b/vala/vala/valadestructor.vala
@@ -22,23 +22,46 @@
 
 using GLib;
 
-namespace Vala {
-       public class Destructor : CodeNode {
-               public Statement body { get; construct; }
-               public bool instance = true;
-               
-               public static ref Destructor new (SourceReference source) {
-                       return (new Destructor (source_reference = source));
+/**
+ * Represents a class or instance destructor.
+ */
+public class Vala.Destructor : CodeNode {
+       /**
+        * The body of this constructor.
+        */
+       public Statement body { get; set; }
+       
+       private bool _instance = true;
+       
+       /**
+        * Specifies whether this is an instance or a class destructor.
+        */
+       public bool instance {
+               get {
+                       return _instance;
                }
+               set {
+                       _instance = value;
+               }
+       }
+       
+       /**
+        * Creates a new destructor.
+        *
+        * @param source reference to source code
+        * @return       newly created destructor
+        */
+       public static ref Destructor! new (SourceReference source) {
+               return (new Destructor (source_reference = source));
+       }
+       
+       public override void accept (CodeVisitor! visitor) {
+               visitor.visit_begin_destructor (this);
                
-               public override void accept (CodeVisitor visitor) {
-                       visitor.visit_begin_destructor (this);
-                       
-                       if (body != null) {
-                               body.accept (visitor);
-                       }
-
-                       visitor.visit_end_destructor (this);
+               if (body != null) {
+                       body.accept (visitor);
                }
+
+               visitor.visit_end_destructor (this);
        }
 }