minor wording improvements made to Inout Functions

Author: WalterBright

spec/function.dd

@@ -423,9 +423,10 @@ $(H2 $(LNAME2 auto-ref-functions, Auto Ref Functions))
 
 $(H2 $(LNAME2 inout-functions, Inout Functions))
 
-    $(P Functions that deal with mutable, const, or immutable types with
-        equanimity often need to transmit their type to the return value:)
-
+    $(P Functions that differ only in whether the parameters are mutable, const or immutable
+        and have corresponding mutable, const or immutable return types can be combined
+        into one function with the $(D inout) type constructor.
+     )
         $(SPEC_RUNNABLE_EXAMPLE_COMPILE
         ---
         int[] f1(int[] a, int x, int y) { return a[x .. y]; }
@@ -437,7 +438,7 @@ $(H2 $(LNAME2 inout-functions, Inout Functions))
         )
 
     $(P The code generated by these three functions is identical.
-        To indicate that these can be one function, the $(D_KEYWORD inout)
+        To combine into one function, the $(D_KEYWORD inout)
         type constructor is employed:)
 
         $(SPEC_RUNNABLE_EXAMPLE_COMPILE
@@ -524,7 +525,7 @@ $(H2 $(LNAME2 inout-functions, Inout Functions))
         ---
         )
 
-    $(P $(B Note:) Shared types are not overlooked. Shared types cannot
+    $(P $(B Note:) Shared types cannot
         be matched with inout.
     )