doc return statement

Author: gfldex

doc/Language/control.pod6

@@ -694,7 +694,9 @@ All these forms may produce a return value the same way C<loop> does.
 
 =head1 X<return|control flow>
 
-=comment TODO
+The routine C<return> will stop execution of a subroutine or method, run all relevant L<phasers|/language/phasers#Block_Phasers> and provide the given return value to the caller. The default return value is C<Nil>. If a return L<type constraint|/type/Signature#Constraining_Return_Types> is provided it will be checked unless the return value is C<Nil>. A control exception is raised and can be caught with L<CONTROL|/language/phasers#CONTROL>.
+
+=comment TODO add link to section in /language/function that shows how return values are produces/handled
 
 =head1 X<return-rw|control flow>