add $*TMPDIR to S16; update S28 to distinguish IO::Handle/IO::Path

Author: labster

S16-io.pod

@@ -198,6 +198,13 @@ The variable is used in at least these cases:
  * When a subprocess is executed, it is executed with the current
    thread's $*CWD as its working directory.
 
+=head2 $*TMPDIR
+
+The global variable $*TMPDIR is an IO::Path object which points to the system's
+temporary directory.  It will check the usual places such a C<< %*ENVZ<><TMPDIR> >>, 
+C</tmp>, C<C:\Windows\temp>, etc (depending on the OS) for a writable directory.
+If a writable directory isn't found, it is set to $*CWD.
+
 =head1 Name Services
 
 =head2 User role

S28-special-names.pod

@@ -14,8 +14,8 @@
 
     Created: 23 Feb 2009, created by Tim Nelson from miscellaneous documents lying around
 
-    Last Modified: 17 Nov 2010
-    Version: 10
+    Last Modified: 11 Jun 2013
+    Version: 11
 
 =head1 Special Variables
 
@@ -74,26 +74,26 @@ be fleshed out in S26.
  $/                S05   Match        # Last match
  $0, $1, $2        S05   Str          # First captured value from match: $/[0]
  @*ARGS            S06   Array of Str # command-line arguments
- $*ARGFILES        S02   IO           # The magic command-line input handle
+ $*ARGFILES        S02   IO::Handle   # The magic command-line input handle
  &?BLOCK           S06   Block        # current block (itself)
  ::?CLASS          S12   Str          # current class (as package or type name)
  $?CLASS           S02   Class        # current class
  @=COMMENT        (S26)               # All the comment blocks in the file
  %?CONFIG                Hash of XXX  # configuration hash XXX What does this do?
- $*CWD                   Path         # current working directory
+ $*CWD             S16   IO::Path     # current working directory
  $=data           (S26)  IO           # data block handle (=begin data ... =end)
  %?DEEPMAGIC       S13   Hash of XXX  # Controls the mappings of magical names to sub definitions
  $?DISTRO          S02   Application  # Which OS distribution am I compiling under
  $*DISTRO          S02   Application  # Which OS distribution am I running under
  $*EGID                  Int          # effective group id
  %*ENV             S02   Hash of Str  # system environment variables
- $*ERR             S16   IO           # Standard error handle
+ $*ERR             S16   IO::Handle   # Standard error handle
  $*EUID                  Int          # effective user id
  $*EXECUTABLE_NAME       Str          # executable name
  $?FILE            S02   Str          # current filename of source file
  $?GRAMMAR         S02   Grammar      # current grammar
  $*GID                   Int          # group id
- $*IN              S16   IO           # Standard input handle; is an IO object
+ $*IN              S16   IO::Handle   # Standard input handle; is an IO object
  @*INC             S11                # where to search for user modules (but not std lib!)
  %?LANG            S02   Hash of Grammar # What is the current set of interwoven languages?
  $*LANG            S02   Str          # LANG variable from %*ENV that defines what human language is used
@@ -104,7 +104,7 @@ be fleshed out in S26.
  %*OPT...          S19   Hash of XXX  # Options from command line to be passed down
  $?KERNEL                Application  # operating system compiled for
  $*KERNEL                Application  # operating system running under
- $*OUT             S16   IO           # Standard output handle
+ $*OUT             S16   IO::Handle   # Standard output handle
  $?PACKAGE         S02   Package      # current package
  $?PERL            S02   Application  # Which Perl am I compiled for?
  $*PERL            S02   Application  # perl version running under
@@ -116,6 +116,7 @@ be fleshed out in S26.
  $?ROLE            S02   Role         # current role
  &?ROUTINE         S06   Routine      # current sub or method (itself)
  $?SCOPE           S02                # Current "my" scope (XXX unnecessary?)
+ $*TMPDIR          S16   IO::Path     # system temporary directory
  $*TZ              S32                # Local time zone
  $*UID                   Int          # system user id
  $?USAGE           S06   Str          # Default usage message generated at compile time