pod/perldelta.pod

   1 =head1 NAME
   2
   3 perldelta - what's new for perl5.006 (as of 5.005_54)
   4
   5 =head1 DESCRIPTION
   6
   7 This document describes differences between the 5.005 release and this one.
   8
   9 =head1 Incompatible Changes
  10
  11 =head2 Perl Source Incompatibilities
  12
  13 None known at this time.
  14
  15 =head2 C Source Incompatibilities
  16
  17 =over 4
  18
  19 =item C<PERL_POLLUTE>
  20
  21 Release 5.005 grandfathered old global symbol names by providing preprocessor
  22 macros for extension source compatibility.  As of release 5.006, these
  23 preprocessor definitions are not available by default.  You need to explicitly
  24 compile perl with C<-DPERL_POLLUTE> in order to get these definitions.
  25
  26 =item C<PL_na> and C<dTHR> Issues
  27
  28 The C<PL_na> global is now thread local, so a C<dTHR> declaration is needed
  29 in the scope in which it appears.  XSUBs should handle this automatically,
  30 but if you have used C<PL_na> in support functions, you either need to
  31 change the C<PL_na> to a local variable (which is recommended), or put in
  32 a C<dTHR>.
  33
  34 =back
  35
  36 =head2 Binary Incompatibilities
  37
  38 This release is not binary compatible with the 5.005 release and its
  39 maintenance versions.
  40
  41 =head1 Core Changes
  42
  43 The length argument of C<syswrite()> is now optional.
  44
  45 Better 64-bit support -- but full support still a distant goal.  One
  46 must Configure with -Duse64bits to get Configure to probe for the
  47 extent of 64-bit support.  Depending on the platform (hints file) more
  48 or less 64-awareness becomes available.  As of 5.005_54 at least
  49 somewhat 64-bit aware platforms are HP-UX 11 or better, Solaris 2.6 or
  50 better, IRIX 6.2 or better.  Naturally 64-bit platforms like Digital
  51 UNIX and UNICOS also have 64-bit support.
  52
  53 =head1 Supported Platforms
  54
  55 VM/ESA is now supported.
  56
  57 Siemens BS200 is now supported.
  58
  59 The Mach CThreads (NeXTstep) are now supported by the Thread extension.
  60
  61 =head1 New tests
  62
  63 =over 4
  64
  65 =item   op/io_const
  66
  67 IO constants (SEEK_*, _IO*).
  68
  69 =item   op/io_dir
  70
  71 Directory-related IO methods (new, read, close, rewind, tied delete).
  72
  73 =item   op/io_multihomed
  74
  75 INET sockets with multi-homed hosts.
  76
  77 =item   op/io_poll
  78
  79 IO poll().
  80
  81 =item   op/io_unix
  82
  83 UNIX sockets.
  84
  85 =item   op/filetest
  86
  87 File test operators.
  88
  89 =item   op/lex_assign
  90
  91 Guard against lexicals leaking (internal stuff).
  92
  93 =back
  94
  95 =head1 Modules and Pragmata
  96
  97 Lexical warnings pragma, "use warning;", to control optional warnings.
  98
  99 Filetest pragma, to control the behaviour of filetests (C<-r> C<-w> ...).
 100 Currently only one subpragma implemented, "use filetest 'access';",
 101 that enables the use of access(2) or equivalent to check the
 102 permissions instead of using stat(2) as usual.  This matters
 103 in filesystems where there are ACLs (access control lists), the
 104 stat(2) might lie, while access(2) knows better.
 105
 106 Todo.
 107
 108 =head1 Utility Changes
 109
 110 Todo.
 111
 112 =head1 Documentation Changes
 113
 114 Todo.
 115
 116 =head1 New Diagnostics
 117
 118 =item /%s/: Unrecognized escape \\%c passed through
 119
 120 (W) You used a backslash-character combination which is not recognized
 121 by Perl.  This combination appears in an interpolated variable or a
 122 C<'>-delimited regular expression.
 123
 124 =item Unrecognized escape \\%c passed through
 125
 126 (W) You used a backslash-character combination which is not recognized
 127 by Perl.
 128
 129 =head1 Obsolete Diagnostics
 130
 131 Todo.
 132
 133 =head1 BUGS
 134
 135 If you find what you think is a bug, you might check the headers of
 136 recently posted articles in the comp.lang.perl.misc newsgroup.
 137 There may also be information at http://www.perl.com/perl/, the Perl
 138 Home Page.
 139
 140 If you believe you have an unreported bug, please run the B<perlbug>
 141 program included with your release.  Make sure you trim your bug down
 142 to a tiny but sufficient test case.  Your bug report, along with the
 143 output of C<perl -V>, will be sent off to <F<perlbug@perl.com>> to be
 144 analysed by the Perl porting team.
 145
 146 =head1 SEE ALSO
 147
 148 The F<Changes> file for exhaustive details on what changed.
 149
 150 The F<INSTALL> file for how to build Perl.
 151
 152 The F<README> file for general stuff.
 153
 154 The F<Artistic> and F<Copying> files for copyright information.
 155
 156 =head1 HISTORY
 157
 158 Written by Gurusamy Sarathy <F<gsar@umich.edu>>, with many contributions
 159 from The Perl Porters.
 160
 161 Send omissions or corrections to <F<perlbug@perl.com>>.
 162
 163 =cut