This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[patch Porting/pumpkin.pod] trying to ensure that PPPort is up-to-date on each new...
authorStas Bekman <stas@stason.org>
Sun, 14 Dec 2003 15:12:40 +0000 (07:12 -0800)
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>
Sun, 14 Dec 2003 22:53:43 +0000 (22:53 +0000)
Message-ID: <3FDCEE68.3080509@stason.org>

p4raw-id: //depot/perl@21914

Porting/pumpkin.pod

index 18c34f6..41310f0 100644 (file)
@@ -575,6 +575,19 @@ about them first.  If possible, we should provide
 backwards-compatibility stubs.  There's a lot of XS code out there.
 Let's not force people to keep changing it.
 
+=head2 PPPort
+
+F<ext/Devel/PPPort/PPPort.pm> needs to be synchronized to include all
+new macros added to .h files (normally perl.h and XSUB.h, but others
+as well). Since chances are that when a new macro is added the
+committer will forget to update F<PPPort.pm>, it's the best to diff for
+changes in .h files when making a new release and making sure that
+F<PPPort.pm> contains them all.
+
+The pumpking can delegate the synchronization responsibility to anybody
+else, but the release process is the only place where we can make sure
+that no new macros fell through the cracks.
+
 =head2 Changes
 
 Be sure to update the F<Changes> file.  Try to include both an overall