[spec] Add links to scope class variable (#3637)

Author: ntrel

spec/class.dd

@@ -482,6 +482,8 @@ $(H3 $(LNAME2 class-instantiation, Class Instantiation))
         A a = new A(3);
         ------
 
+        $(P A $(DDSUBLINK spec/attribute, scope-class-var, `scope` object) can be allocated on the stack.)
+
         $(P The following steps happen:)
 
     $(OL
@@ -700,8 +702,10 @@ $(GNAME Destructor):
     $(D ~ this ( )) $(GLINK2 function, MemberFunctionAttributes)$(OPT) $(GLINK2 function, FunctionBody)
 )
 
-        $(P The garbage collector calls the destructor function when the object
-        is deleted. The syntax is:)
+        $(P The destructor function is called when the object
+        is deleted by the garbage collector, or when a
+        $(DDSUBLINK spec/attribute, scope-class-var, `scope` object) goes out of scope.
+        The syntax is:)
 
         ------
         class Foo
@@ -1022,7 +1026,8 @@ $(GNAME Invariant):
 
 
 $(H2 $(LNAME2 auto, Scope Classes))
-$(B Note): Scope classes have been $(DDSUBLINK deprecate, scope as a type constraint, recommended for deprecation).
+$(NOTE Scope classes have been $(DDSUBLINK deprecate, scope as a type constraint,  deprecated). See also
+$(DDSUBLINK spec/attribute, scope-class-var, `scope` objects).)
 
         $(P A scope class is a class with the $(D scope) attribute, as in:)
 

spec/expression.dd

@@ -2550,9 +2550,9 @@ $(GNAME ArgumentList):
     $(GLINK AssignExpression) $(D ,) $(GSELF ArgumentList)
 )
 
-    $(P $(I NewExpression)s are used to allocate memory on the
+    $(P $(I NewExpression)s allocate memory on the
         $(DDLINK spec/garbage, Garbage Collection, garbage
-        collected) heap.
+        collected) heap by default.
     )
 
     $(P The `new` *Type* form constructs an instance of a type and default-initializes it.)