IO &close: correct link, explain why close is necessary

Raku · Feb 14, 2015 · 8ba60b3 · 8ba60b3
1 parent 256ddd6
commit 8ba60b3
Showing 1 changed file with 4 additions and 1 deletion.
diff --git a/lib/Type/IO.pod b/lib/Type/IO.pod
@@ -121,7 +121,7 @@ C<.lines> and C<.get>.  Defaults to C<True>.
 =head2 method close
 
 To close an open file handle, simply call its
-L<close|/type/IO::Handle/close> method:
+L<close|/type/IO::Handle#method close> method:
 
     my $fh = open("path/to/file");
     # ... do stuff with the file
@@ -134,6 +134,9 @@ written equivalently like so:
     # ... do stuff with the file
     close $fh;
 
+When a file was opened for writing, closing it is important to ensure that all
+contents are actually written to the file.
+
 =head2 sub prompt
 
     sub prompt($msg)