On Thu 30 Dec 2004 12:11, Marcus Holland-Moritz <[EMAIL PROTECTED]> wrote: > On 2004-12-30, at 09:35:28 +0100, H.Merijn Brand wrote: > > > On Wed 29 Dec 2004 21:37, Stas Bekman <[EMAIL PROTECTED]> wrote: > > > Marcus Holland-Moritz wrote: > > > > On 2004-12-29, at 12:44:11 -0500, Stas Bekman wrote: > > > >>Marcus Holland-Moritz wrote: > > > >>>On 2004-12-29, at 14:45:44 +0100, Marcus Holland-Moritz wrote: > > > >> > I'll mention it in perlhack. Let me know if you have any suggestions. > > > >> > > > >>How about adding it at the top of perlapi.pod (or at least a pointer to > > > >>perlhack where the full details are given). > > > > > > > > > > > > Thinking about it, I guess something like perlxstut is a > > > > more appropriate place than perlhack. I wanted to add a > > > > section on Devel::PPPort to perlxstut anyway. > > > > > > I think perlguts is more appropriate, since not everybody > > > uses XS (e.g. embed perl) > > > > /me agrees on this > > What about this?
Sounds fine. Feel free to apply. > --- perlguts.pod.orig 2004-12-30 11:45:30.000000000 +0100 > +++ perlguts.pod 2004-12-30 12:06:08.000000000 +0100 > @@ -2283,6 +2283,19 @@ > Please try and supply some documentation if you add functions to the > Perl core. > > +=head2 Backwards compatibility > + > +The Perl API changes over time. New functions are added or the interfaces > +of existing functions are changed. The C<Devel::PPPort> module tries to > +provide compatibility code for some of these changes, so XS writers don't > +have to code it themselves when supporting multiple versions of Perl. > + > +C<Devel::PPPort> generates a C header file F<ppport.h> that can also > +be run as a Perl script. Besides checking existing XS code, this script > +can also be used to retrieve compatibility information for various API > +calls using the C<--api-info> command line switch. For details, see > +L<Devel::PPPort>. > + > =head1 Unicode Support > > Perl 5.6.0 introduced Unicode support. It's important for porters and XS > > -- H.Merijn Brand Amsterdam Perl Mongers (http://amsterdam.pm.org/) using perl-5.6.1, 5.8.5, & 5.9.x, and 809 on HP-UX 10.20 & 11.00, 11i, AIX 4.3, AIX 5.2, SuSE 9.1, and Win2k. http://www.cmve.net/~merijn/ http://archives.develooper.com/[email protected]/ [email protected] send smoke reports to: [EMAIL PROTECTED], QA: http://qa.perl.org
