Merge pull request #3508 from Bolpat/patch-13

Better wording for `ref` functions

Signed-off-by: Nicholas Wilson <[email protected]>
Merged-on-behalf-of: Nicholas Wilson <[email protected]>

Author: dlang-bot

spec/function.dd

@@ -598,9 +598,11 @@ $(H2 $(LNAME2 nothrow-functions, Nothrow Functions))
 
 $(H2 $(LNAME2 ref-functions, Ref Functions))
 
-        $(P Ref functions allow functions to return by reference,
-        meaning that the return value must be an lvalue, and
-        the lvalue is returned, not the rvalue.
+        $(P A `ref` function returns by reference (instead of by value).
+        The return value of a `ref` function must be an lvalue
+        (whereas the return value of a non-`ref` function can be an rvalue, too).
+        An expression formed by calling a `ref` function is an lvalue
+        (whereas an expression formed by calling a non-`ref` function is an rvalue).
         )
 
 ---