From: Rico Tzschichholz Date: Tue, 26 May 2020 08:03:16 +0000 (+0200) Subject: vala: Improve source documentation X-Git-Tag: 0.46.11~18 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0d6f0608127b7183da65f967597aa29fded18c93;p=thirdparty%2Fvala.git vala: Improve source documentation --- diff --git a/vala/valaaddressofexpression.vala b/vala/valaaddressofexpression.vala index 4948a46c2..5f5da6a84 100644 --- a/vala/valaaddressofexpression.vala +++ b/vala/valaaddressofexpression.vala @@ -23,7 +23,9 @@ using GLib; /** - * Represents an address-of expression in the source code, e.g. `&foo`. + * Represents an address-of expression. + * + * {{{ &foo }}} */ public class Vala.AddressofExpression : Expression { /** diff --git a/vala/valaarraycreationexpression.vala b/vala/valaarraycreationexpression.vala index ebd7aa19e..71683cf4e 100644 --- a/vala/valaarraycreationexpression.vala +++ b/vala/valaarraycreationexpression.vala @@ -25,7 +25,9 @@ using GLib; /** - * Represents an array creation expression e.g. {{{ new int[] {1,2,3} }}}. + * Represents an array creation expression. + * + * {{{ new int[] { 1, 2, 3 } }}} */ public class Vala.ArrayCreationExpression : Expression { /** diff --git a/vala/valabaseaccess.vala b/vala/valabaseaccess.vala index ed8193507..450c87601 100644 --- a/vala/valabaseaccess.vala +++ b/vala/valabaseaccess.vala @@ -22,7 +22,7 @@ /** - * Represents an access to base class members in the source code. + * Represents an access to base type member in the source code. */ public class Vala.BaseAccess : Expression { /** diff --git a/vala/valadeletestatement.vala b/vala/valadeletestatement.vala index eb1d92150..8d8996725 100644 --- a/vala/valadeletestatement.vala +++ b/vala/valadeletestatement.vala @@ -21,7 +21,9 @@ */ /** - * Represents a delete statement e.g. "delete a". + * Represents a delete statement. + * + * {{{ delete foo; }}} */ public class Vala.DeleteStatement : CodeNode, Statement { /** diff --git a/vala/valaelementaccess.vala b/vala/valaelementaccess.vala index 08844e0f7..7c1f01b2e 100644 --- a/vala/valaelementaccess.vala +++ b/vala/valaelementaccess.vala @@ -25,7 +25,9 @@ using GLib; /** - * Represents an array access expression e.g. "a[1,2]". + * Represents an array access expression. + * + * {{{ foo[1,2] }}} */ public class Vala.ElementAccess : Expression { /** diff --git a/vala/valaenumvalue.vala b/vala/valaenumvalue.vala index 1352e6b03..e0129d2a7 100644 --- a/vala/valaenumvalue.vala +++ b/vala/valaenumvalue.vala @@ -23,7 +23,7 @@ using GLib; /** - * Represents an enum member in the source code. + * Represents an enum value member in the source code. */ public class Vala.EnumValue : Constant { /** diff --git a/vala/valaerrorcode.vala b/vala/valaerrorcode.vala index 3e3c57b37..525fb7d55 100644 --- a/vala/valaerrorcode.vala +++ b/vala/valaerrorcode.vala @@ -23,7 +23,7 @@ using GLib; /** - * Represents an enum member in the source code. + * Represents an error value member in the source code. */ public class Vala.ErrorCode : TypeSymbol { /** diff --git a/vala/valaforeachstatement.vala b/vala/valaforeachstatement.vala index 5159c2b3f..1ae237cf7 100644 --- a/vala/valaforeachstatement.vala +++ b/vala/valaforeachstatement.vala @@ -22,8 +22,9 @@ /** - * Represents a foreach statement in the source code. Foreach statements iterate - * over the elements of a collection. + * Represents a foreach statement in the source code. + * + * Foreach statements iterate over the elements of a collection. */ public class Vala.ForeachStatement : Block { /** diff --git a/vala/valainterface.vala b/vala/valainterface.vala index 3a3a28cad..190a48ca5 100644 --- a/vala/valainterface.vala +++ b/vala/valainterface.vala @@ -23,7 +23,7 @@ using GLib; /** - * Represents a class declaration in the source code. + * Represents an interface declaration in the source code. */ public class Vala.Interface : ObjectTypeSymbol { private List prerequisites = new ArrayList (); diff --git a/vala/valalambdaexpression.vala b/vala/valalambdaexpression.vala index d47e7f0e3..abf490b29 100644 --- a/vala/valalambdaexpression.vala +++ b/vala/valalambdaexpression.vala @@ -23,8 +23,9 @@ using GLib; /** - * Represents a lambda expression in the source code. Lambda expressions are - * anonymous methods with implicitly typed parameters. + * Represents a lambda expression in the source code. + * + * Lambda expressions are anonymous methods with implicitly typed parameters. */ public class Vala.LambdaExpression : Expression { private static int next_lambda_id = 0; diff --git a/vala/valalockstatement.vala b/vala/valalockstatement.vala index e64d4a206..c9cc96e7c 100644 --- a/vala/valalockstatement.vala +++ b/vala/valalockstatement.vala @@ -26,11 +26,13 @@ using GLib; /** - * Represents a lock statement e.g. {{{ lock (a); }}} or {{{ lock (a) { f(a); } }}}. + * Represents a lock statement. * - * If the statement is empty, the mutex remains locked until a corresponding UnlockStatement - * occurs. Otherwise it's translated into a try/finally statement which unlocks the mutex - * after the block is finished. + * {{{ lock (foo); }}} or {{{ lock (foo) { ... } }}} + * + * If the statement is empty, the mutex remains locked until a corresponding + * {@link Vala.UnlockStatement} occurs. Otherwise it's translated into a + * try/finally statement which unlocks the mutex after the block is finished. */ public class Vala.LockStatement : CodeNode, Statement { /** diff --git a/vala/valapointerindirection.vala b/vala/valapointerindirection.vala index 5e99b9dc0..156194cb8 100644 --- a/vala/valapointerindirection.vala +++ b/vala/valapointerindirection.vala @@ -22,7 +22,9 @@ /** - * Represents a pointer indirection in the source code, e.g. `*pointer`. + * Represents a pointer indirection. + * + * {{{ *foo }}} */ public class Vala.PointerIndirection : Expression { /** diff --git a/vala/valareferencetransferexpression.vala b/vala/valareferencetransferexpression.vala index f9b428997..35dd9b982 100644 --- a/vala/valareferencetransferexpression.vala +++ b/vala/valareferencetransferexpression.vala @@ -22,7 +22,9 @@ /** - * Represents a reference transfer expression in the source code, e.g. `#foo`. + * Represents a reference transfer expression. + * + * {{{ (owned) foo }}} */ public class Vala.ReferenceTransferExpression : Expression { /** diff --git a/vala/valasliceexpression.vala b/vala/valasliceexpression.vala index 563733031..83acd69d7 100644 --- a/vala/valasliceexpression.vala +++ b/vala/valasliceexpression.vala @@ -25,7 +25,9 @@ using GLib; /** - * Represents an array slice expression e.g "a[1:5]". + * Represents an array slice expression. + * + * {{{ foo[1:5] }}} */ public class Vala.SliceExpression : Expression { public Expression container { diff --git a/vala/valaunlockstatement.vala b/vala/valaunlockstatement.vala index d60d5706c..b40d80057 100644 --- a/vala/valaunlockstatement.vala +++ b/vala/valaunlockstatement.vala @@ -22,7 +22,9 @@ */ /** - * Represents an unlock statement e.g. {{{ unlock (a); }}}. + * Represents an unlock statement. + * + * {{{ unlock (foo); }}} */ public class Vala.UnlockStatement : CodeNode, Statement { /** diff --git a/vala/valayieldstatement.vala b/vala/valayieldstatement.vala index 91d8e7f9f..7148f3b74 100644 --- a/vala/valayieldstatement.vala +++ b/vala/valayieldstatement.vala @@ -27,7 +27,6 @@ public class Vala.YieldStatement : CodeNode, Statement { /** * Creates a new yield statement. * - * @param yield_expression the yield expression * @param source_reference reference to source code * @return newly created yield statement */