missing space while munging CCFLAGS for PERL_CAPI
[p5sagit/p5-mst-13.2.git] / pod / perldelta.pod
index 4ec71c8..afe29e6 100644 (file)
 =head1 NAME
 
-perldelta - what's new for perl5.005
+perldelta - what's new for perl5.006 (as of 5.005_54)
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.004 release and this one.
+This document describes differences between the 5.005 release and this one.
 
 =head1 Incompatible Changes
 
+=head2 Perl Source Incompatibilities
+
+None known at this time.
+
+=head2 C Source Incompatibilities
+
+=over 4
+
+=item C<PERL_POLLUTE>
+
+Release 5.005 grandfathered old global symbol names by providing preprocessor
+macros for extension source compatibility.  As of release 5.006, these
+preprocessor definitions are not available by default.  You need to explicitly
+compile perl with C<-DPERL_POLLUTE> in order to get these definitions.
+
+=item C<PL_na> and C<dTHR> Issues
+
+The C<PL_na> global is now thread local, so a C<dTHR> declaration is needed
+in the scope in which it appears.  XSUBs should handle this automatically,
+but if you have used C<PL_na> in support functions, you either need to
+change the C<PL_na> to a local variable (which is recommended), or put in
+a C<dTHR>.
+
+=back
+
+=head2 Binary Incompatibilities
+
+This release is not binary compatible with the 5.005 release and its
+maintenance versions.
+
 =head1 Core Changes
 
-=head1 Modules
+Binary numbers are now supported as literals, in s?printf formats, and
+C<oct()>:
+
+       $answer = 0b101010;
+       printf "The answer is: %b\n", oct("0b101010");
+
+The length argument of C<syswrite()> is now optional.
+
+Better 64-bit support -- but full support still a distant goal.  One
+must Configure with -Duse64bits to get Configure to probe for the
+extent of 64-bit support.  Depending on the platform (hints file) more
+or less 64-awareness becomes available.  As of 5.005_54 at least
+somewhat 64-bit aware platforms are HP-UX 11 or better, Solaris 2.6 or
+better, IRIX 6.2 or better.  Naturally 64-bit platforms like Digital
+UNIX and UNICOS also have 64-bit support.
+
+=head1 Supported Platforms
+
+VM/ESA is now supported.
+
+Siemens BS200 is now supported.
+
+The Mach CThreads (NeXTstep) are now supported by the Thread extension.
+
+=head1 New tests
+
+=over 4
+
+=item  op/io_const
+
+IO constants (SEEK_*, _IO*).
+       
+=item  op/io_dir
+
+Directory-related IO methods (new, read, close, rewind, tied delete).
+
+=item  op/io_multihomed
+
+INET sockets with multi-homed hosts.
+
+=item  op/io_poll
+
+IO poll().
 
-=head2 Required Updates
+=item  op/io_unix
 
-    XXX Any???
+UNIX sockets.
+
+=item  op/filetest
+
+File test operators.
+
+=item  op/lex_assign
+
+Guard against lexicals leaking (internal stuff).
+
+=back
+
+=head1 Modules and Pragmata
+
+=head2 Modules
+
+Dumpvalue module provides screen dumps of Perl data.
+
+=head2 Pragmata
+
+Lexical warnings pragma, "use warning;", to control optional warnings.
+
+Filetest pragma, to control the behaviour of filetests (C<-r> C<-w> ...).
+Currently only one subpragma implemented, "use filetest 'access';",
+that enables the use of access(2) or equivalent to check the
+permissions instead of using stat(2) as usual.  This matters
+in filesystems where there are ACLs (access control lists), the
+stat(2) might lie, while access(2) knows better.
+
+Todo.
 
 =head1 Utility Changes
 
-=head1 C Language API Changes
+Todo.
 
 =head1 Documentation Changes
 
+perlopentut, tutorial on opening things in Perl, was added.
+
+perlreftut, tutorial on references, was added.
+
+=head1 New Diagnostics
+
+=item /%s/: Unrecognized escape \\%c passed through
+
+(W) You used a backslash-character combination which is not recognized
+by Perl.  This combination appears in an interpolated variable or a 
+C<'>-delimited regular expression.
+
+=item Unrecognized escape \\%c passed through
+
+(W) You used a backslash-character combination which is not recognized
+by Perl.
+
+=item Missing command in piped open
+
+(W) You used the C<open(FH, "| command")> or C<open(FH, "command |")>
+construction, but the command was missing or blank.
+
+=head1 Obsolete Diagnostics
+
+Todo.
+
 =head1 BUGS
 
 If you find what you think is a bug, you might check the headers of
@@ -46,3 +173,10 @@ The F<README> file for general stuff.
 The F<Artistic> and F<Copying> files for copyright information.
 
 =head1 HISTORY
+
+Written by Gurusamy Sarathy <F<gsar@umich.edu>>, with many contributions
+from The Perl Porters.
+
+Send omissions or corrections to <F<perlbug@perl.com>>.
+
+=cut