summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorMarcus Holland-Moritz <mhx-perl@gmx.net>2004-12-30 18:29:02 +0000
committerMarcus Holland-Moritz <mhx-perl@gmx.net>2004-12-30 18:29:02 +0000
commit0d098d33944e8ba673db0e919dabb29e6715bba2 (patch)
treea8f546d81df0aa2ff377b0566489413ea0cb1a40 /pod
parentbde30f852bc294abae9881d155ff4566fec5b034 (diff)
downloadperl-0d098d33944e8ba673db0e919dabb29e6715bba2.tar.gz
Mention ppport.h and its --api-info switch in perlguts.
p4raw-id: //depot/perl@23712
Diffstat (limited to 'pod')
-rw-r--r--pod/perlguts.pod20
1 files changed, 20 insertions, 0 deletions
diff --git a/pod/perlguts.pod b/pod/perlguts.pod
index 5eb46d2d0e..4d045318d3 100644
--- a/pod/perlguts.pod
+++ b/pod/perlguts.pod
@@ -2283,6 +2283,26 @@ source, like this:
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. To generate F<ppport.h>, run:
+
+ perl -MDevel::PPPort -eDevel::PPPort::WriteFile
+
+Besides checking existing XS code, the script can also be used to retrieve
+compatibility information for various API calls using the C<--api-info>
+command line switch. For example:
+
+ % perl ppport.h --api-info=sv_magicext
+
+For details, see C<perldoc ppport.h>.
+
=head1 Unicode Support
Perl 5.6.0 introduced Unicode support. It's important for porters and XS