Document that setter expressions return their right-hand side.

pkg/kernel/lib/ast.dart

Index: pkg/kernel/lib/ast.dart
diff --git a/pkg/kernel/lib/ast.dart b/pkg/kernel/lib/ast.dart
index 40a305ffae302b36811a9f499b808849372595a7..d0c77da1d04d9a07b15daab00c708d2c1f0ac840 100644
--- a/pkg/kernel/lib/ast.dart
+++ b/pkg/kernel/lib/ast.dart
@@ -1306,6 +1306,8 @@ class VariableGet extends Expression {
 }
 
 /// Assign a local variable or function parameter.
+///
+/// Returns the value of [value].

[Kevin Millikin (Google), 2016/11/28 11:12:20]

As quibble, I wouldn't use 'returns' here or below because it doesn't
necessarily call anything.  I'd write 'evaluates to'.

'Returns' is still clear if you like it.

[asgerf, 2016/11/28 11:26:54]

Changed to "evaluates to".

 class VariableSet extends Expression {
   VariableDeclaration variable;
   Expression value;
@@ -1387,6 +1389,8 @@ class PropertyGet extends Expression {
 /// Expression of form `x.field = value`.
 ///
 /// This may invoke a setter or assign a field.
+///
+/// Returns the value of [value].
 class PropertySet extends Expression {
   Expression receiver;
   Name name;
@@ -1461,6 +1465,8 @@ class DirectPropertyGet extends Expression {
 }
 
 /// Directly assign a field, or call a setter.
+///
+/// Returns the value of [value].
 class DirectPropertySet extends Expression {
   Expression receiver;
   Member target;
@@ -1580,6 +1586,8 @@ class SuperPropertyGet extends Expression {
 /// Expression of form `super.field = value`.
 ///
 /// This may invoke a setter or assign a field.
+///
+/// Returns the value of [value].
 class SuperPropertySet extends Expression {
   Name name;
   Expression value;
@@ -1632,6 +1640,8 @@ class StaticGet extends Expression {
 }
 
 /// Assign a static field or call a static setter.
+///
+/// Returns the value of [value].
 class StaticSet extends Expression {
   /// A mutable static field or a static setter.
   Member target;