[io grant] Minor formatting improvements in IO::Special

Author: zoffixznet

doc/Type/IO/Special.pod6

@@ -2,13 +2,12 @@
 
 =TITLE class IO::Special
 
-=SUBTITLE Represent a Standard I/O device
+=SUBTITLE Path to Special I/O device
 
-This provides a similar interface for the special standard input and output
-handles C<$*IN>, C<$*OUT> and C<$*ERR> to that of L<IO::Path|/type/IO::Path>
-for regular files.  It is typically returned by the L<path method|/type/IO::Handle#method_path>
-of those handles so that they can be used interchangeably with the handles of
-regular files.
+Used as a L«C<$.path>|/type/IO::Handle#method_path>» attribute in special
+standard input and output handles C<$*IN>, C<$*OUT> and C<$*ERR>. Provides
+abridged interface of L«C<IO::Handle>|/type/IO::Handle», mostly file tests
+and stringification.
 
 =head1 Methods
 
@@ -17,29 +16,28 @@ regular files.
 =for code :skip-test
 method new(:$!what!)
 
-The constructor has a single required named argument C<what> that will be
-'<STDIN>', '<STDOUT>' or '<STDERR>' as appropriate.  It is unlikely that you
-will ever need to construct one of these objects yourself however as it
+The constructor has a single required named argument C<:what> that will be
+C«'<STDIN>'», C«'<STDOUT>'», or C«'<STDERR>'», as appropriate. It is unlikely
+that you will ever need to construct one of these objects yourself however as it
 will be done for you when the special handles are initialised.
 
 =head2 method WHICH
 
     method WHICH(IO::Special:D: --> Str)
 
-This returns a string which identifies the object.
+This returns a string that identifies the object.
 
 =head2 method Str
 
     method Str(IO::Special:D:)
 
-This returns '<STDIN>', '<STDOUT>' or '<STDERR>' as appropriate.
+This returns C«'<STDIN>'», C«'<STDOUT>'», or C«'<STDERR>'» as appropriate.
 
 =head2 method IO
 
     method IO(IO::Special:D: --> IO::Special)
 
-This returns the C<IO::Special> object, it is provided for
-conformance to the C<IO::Path> interface.
+Returns the invocant.
 
 =head2 method e
 
@@ -63,7 +61,7 @@ The 'file' file test operator, always returns C<False>.
 
     method s(IO::Special:D: --> Int)
 
-The 'size' file test operator, always returns 0.
+The 'size' file test operator, always returns C<0>.
 
 =head2 method l
 
@@ -86,31 +84,32 @@ The 'write access' file test operator, returns C<True> if this is
 the standard output or standard error handle, C<False> if it is
 the standard input.
 
-
 =head2 method x
 
     method x(IO::Special:D: --> Bool)
 
 The 'execute access' file test operator, always returns C<False>.
 
-
 =head2 method modified
 
     method modified(IO::Special:D: --> Instant)
 
-The last modified time always returns an undefined L<Instant>.
+The last modified time always returns an L«C<Instant>|/type/Instant» type
+object.
 
 =head2 method accessed
 
     method accessed(IO::Special:D: --> Instant)
 
-The last accessed time always returns an undefined L<Instant>
+The last accessed time always returns an L«C<Instant>|/type/Instant» type
+object.
 
 =head2 method changed
 
     method changed(IO::Special:D: --> Instant)
 
-The last changed time always returns an undefined L<Instant>
+The last changed time always returns an L«C<Instant>|/type/Instant» type
+object.
 
 =head2 method mode