Rearranges examples in closes, rephrases and reindents.

Author: JJ

doc/Type/IO/Handle.pod6

@@ -812,11 +812,17 @@ Defined as:
     method close(IO::Handle:D: --> Bool:D)
     multi sub close(IO::Handle $fh)
 
-Closes an open filehandle. It's not an error to call C<close> on an
-already-closed filehandle. Returns C<True> on success. If you close
-one of the standard filehandles (by default: C<$*IN>, C<$*OUT>, or C<$*ERR>),
-that is any handle with L<native-descriptor|/routine/native-descriptor> C<2> or lower, you won't be
-able to re-open such a handle.
+Closes an open filehandle, returning C<True> on success, and not erroring if the
+filehandle is already closed, although if you close one of the standard
+filehandles (by default: C<$*IN>, C<$*OUT>, or C<$*ERR>), that is any handle
+with L<native-descriptor|/routine/native-descriptor> C<2> or lower, you won't be
+able to re-open them.
+
+=for code
+given "foo/bar".IO.open(:w) {
+    .spurt: "I ♥ Raku!";
+    .close;
+}
 
 It's a common idiom to use L«C<LEAVE> phaser|/language/phasers#LEAVE» for
 closing the handles, which ensures the handle is closed regardless of how the
@@ -838,11 +844,6 @@ sub do-stuff-with-the-file (IO $path-to-file) {
 
   # ... do stuff with the file
 }
-
-given "foo/bar".IO.open(:w) {
-    .spurt: "I ♥ Raku!";
-    .close;
-}
 =end code
 
 B<Note:> unlike some other languages, Raku does not use reference counting,