Merge pull request #1028 from perl6/consistent-return-types

Consistent return types

Author: AlexDaniel

doc/Type/Any.pod6

@@ -150,7 +150,7 @@ occur over C<(SELF,)> (if C<:$item> is set) or C<SELF>.
 
 Defined as:
 
-    method deepmap(&block -->List) is nodal
+    method deepmap(&block) returns List is nodal
 
 C<deepmap> will apply C<&block> to each element and return a new C<List> with
 the return values of C<&block>, unless the element does the C<Iterable> role.

doc/Type/Bag.pod6

@@ -97,7 +97,7 @@ with detailed explanations.
 
 =head2 sub bag
 
-    sub bag(*@args --> Bag)
+    sub bag(*@args) returns Bag
 
 Creates a new C<Bag> from C<@args>.
 

doc/Type/Date.pod6

@@ -218,7 +218,7 @@ Converts the invocant to L«C<DateTime>|/type/DateTime»
 
 =head2 sub sleep
 
-    sub sleep($seconds = Inf --> Nil)
+    sub sleep($seconds = Inf) returns Nil
 
 Attempt to sleep for the given number of C<$seconds>.  Returns C<Nil> on
 completion.  Accepts C<Int>, C<Num>, C<Rat>, or C<Duration> types as an
@@ -246,7 +246,7 @@ seconds and C<sleep 5.2> sleeps for 5.2 seconds:
 
 =head2 sub sleep-timer
 
-    sub sleep-timer(Real $seconds = Inf --> Duration)
+    sub sleep-timer(Real $seconds = Inf) returns Duration
 
 This function is just like C<sleep>, but returns the amount of time
 remaining to sleep as a C<Duration> (which will be 0 if the call was not
@@ -256,7 +256,7 @@ interrupted).
 
 =head2 sub sleep-until
 
-    sub sleep-until(Instant $until --> Bool)
+    sub sleep-until(Instant $until) returns Bool
 
 Works just like C<sleep> but checks the current time and goes back to sleep
 if accidentally woken up early, to guarantee waiting until the specified

doc/Type/IO.pod6

@@ -293,8 +293,8 @@ sub spurt($where, $what,
     Str  :$enc        = 'utf8',
     Bool :$bin        = False,
     Bool :$append      = False,
-    Bool :$createonly = False,
-    --> Bool ) is export
+    Bool :$createonly = False
+    ) returns Bool
 
 Writes the indicated contents (2nd positional parameter, C<$what>) to the
 location indicated by the first positional parameter, C<$where> (which can

doc/Type/IO/Handle.pod6

@@ -52,67 +52,67 @@ Returns C<True> if the read operations have exhausted the content of the file.
 
 =head2 method e
 
-    method e(--> Bool)
+    method e returns Bool
 
 Returns C<Bool::True> if the invocant is a valid path that exists.
 
 =head2 method d
 
-    method d(--> Bool)
+    method d returns Bool
 
 Returns C<Bool::True> if the invocant is a path and the directory exists.
 
 =head2 method f
 
-    method f(--> Bool)
+    method f returns Bool
 
 Returns C<Bool::True> if the invocant is a path and the file exists.
 
 =head2 method s
 
-    method s(--> Bool)
+    method s returns Bool
 
 Returns C<Bool::True> if the invocant is a path and the size is bigger then 0.
 
 =head2 method l
 
-    method l(--> Bool)
+    method l returns Bool
 
 Returns C<Bool::True> if the invocant is a path and a symlink.
 
 =head2 method r
 
-    method r(--> Bool)
+    method r returns Bool
 
 Returns C<Bool::True> if the invocant is a path and accessible.
 
 =head2 method w
 
-    method w(--> Bool)
+    method w returns Bool
 
 Returns C<Bool::True> if the invocant is a path and writable.
 
 =head2 method rw
 
-    method rw(--> Bool)
+    method rw returns Bool
 
 Returns C<Bool::True> if the invocant is a path, read and writable.
 
 =head2 method x
 
-    method x(--> Bool)
+    method x returns Bool
 
 Returns C<Bool::True> if the invocant is a path and executable.
 
 =head2 method rwx
 
-    method rwx(--> Bool)
+    method rwx returns Bool
 
 Returns C<Bool::True> if the invocant is a path, executable, read and writable.
 
 =head2 method z
 
-    method z(--> Bool)
+    method z returns Bool
 
 Returns C<Bool::True> if the invocant is a path and the size is 0.
 
@@ -175,7 +175,7 @@ $fn.comb(3, close => True); # Comb file contents by 3 characters and close after
 
 =head2 method print
 
-    method print(*@text --> Bool)
+    method print(*@text) returns Bool
 
 Text writing; writes the given C<@text> to the filehandle.  See L<write>
 to write bytes.
@@ -229,13 +229,13 @@ $fh.close;
 
 =head2 method read
 
-    method read(IO::Handle:D: Int(Cool:D) $bytes --> Blob)
+    method read(IO::Handle:D: Int(Cool:D) $bytes) returns Blob
 
 Binary reading; reads and returns up to C<$bytes> bytes from the filehandle.
 
 =head2 method readchars
 
-    method readchars(IO::Handle:D: Int(Cool:D) $chars --> Str)
+    method readchars(IO::Handle:D: Int(Cool:D) $chars) returns Str
 
 Reading chars; reads and returns up to C<$chars> chars (graphemes) from the
 filehandle.
@@ -271,14 +271,14 @@ offset if you want to position before the end of the file.
 
 =head2 method tell
 
-    method tell(IO::Handle:D: --> Int)
+    method tell(IO::Handle:D:) returns Int
 
 Return the current position of the file pointer in bytes.
 
 =head2 method slurp-rest
 
-    multi method slurp-rest(IO::Handle:D: :$bin!, :$close --> Buf)
-    multi method slurp-rest(IO::Handle:D: :$enc, :$close --> Str)
+    multi method slurp-rest(IO::Handle:D: :$bin!, :$close) returns Buf
+    multi method slurp-rest(IO::Handle:D: :$enc, :$close) returns Str
 
 Returns the remaining content of the file from the current file position
 (which may have been set by previous reads or by C<seek>.)  If the
@@ -294,7 +294,7 @@ my $rest-of-file = $fh.slurp-rest(:close);
 
 =head2 method Supply
 
-    multi method Supply(IO::Handle:D: :$size = 65536, :$bin --> Supply)
+    multi method Supply(IO::Handle:D: :$size = 65536, :$bin) returns Supply
 
 Returns a C<Supply> that will emit the contents of the handle in chunks.
 The size of the chunks is determined by the optional C<:size> named parameter
@@ -335,13 +335,13 @@ argument such as C<fcntl> or C<ioctl>.
 
 =head2 method opened
 
-    method opened(IO::Handle:D: --> Bool)
+    method opened(IO::Handle:D:) returns Bool
 
 Returns C<True> if the handle is open.
 
 =head2 method t
 
-    method t(IO::Handle:D: --> Bool)
+    method t(IO::Handle:D:) returns Bool
 
 Returns C<True> if the handle is opened to a tty.