X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/4b05bc8ea5a106c203e7154f3cbae72e133c9c80..78097f58205817e135d116e8f7fd21d4118c9b6e:/Porting/pumpkin.pod diff --git a/Porting/pumpkin.pod b/Porting/pumpkin.pod index a1fe675..e952fb2 100644 --- a/Porting/pumpkin.pod +++ b/Porting/pumpkin.pod @@ -35,15 +35,13 @@ interested in all the latest developments, you should definitely subscribe. The list is high volume, but generally has a fairly low noise level. -Subscribe by sending the message (in the body of your letter) +To subscribe to perl5-porters, send an email to - subscribe perl5-porters - -to perl5-porters-request@perl.org . + perl5-porters-subscribe@perl.org Archives of the list are held at: - http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/ + https://lists.perl.org/list/perl5-porters.html =head1 How are Perl Releases Numbered? @@ -292,41 +290,48 @@ F, and F files are all automatically generated by perl scripts. In general, don't patch these directly; patch the data files instead. -F and F are also automatically generated by -B. In general, you should patch the metaconfig units -instead of patching these files directly. However, very minor changes -to F may be made in between major sync-ups with the -metaconfig units, which tends to be complicated operations. But be -careful, this can quickly spiral out of control. Running metaconfig -is not really hard. - Also F is automatically produced from F. In general, look out for all F<*.SH> files. -Finally, the sample files in the F subdirectory are -generated automatically by the script F included -with the metaconfig units. See L<"run metaconfig"> below for -information on obtaining the metaconfig units. +Finally, the sample files F and F in the +F subdirectory are generated by the script F. -=head1 How to Make a Distribution +=head3 Files generated by metaconfig -This section has now been expanded and moved into its own file, -F. +F, F and F are generated by +B (see below for more information on how to use this system) +and direct changes to these files should in general not be pushed to blead. -I've kept some of the subsections here for now, as they don't directly -relate to building a release any more, but still contain what might be -useful information - DAPM 7/2009. +The exceptions are: + +=over 4 + +=item * + +security fixes -=head2 run metaconfig +=item * + +changes pre-approved by the metaconfig maintainers + +=back -If you need to make changes to Configure or config_h.SH, it may be best to -change the appropriate metaconfig units instead, and regenerate Configure. +Such changes should also be notified to the metaconfig maintainers by +creating an issue at . - metaconfig -m +Alternatively, do consider if the F<*ish.h> files or the hint files might +be a better place for your changes. -will regenerate F and F. Much more information -on obtaining and running metaconfig is in the F file -that comes with Perl's metaconfig units. +=head1 Working with metaconfig + +Information about how to use metaconfig can be found in the F +and F files in the metaconfig repository containing Perl's +metaconfig units: + + # anonymous clone + git clone https://github.com/Perl/metaconfig.git + # or using a registered github.com identity with ssh + git clone github.com:Perl/metaconfig.git Since metaconfig is hard to change, running correction scripts after this generation is sometimes needed. Configure gained complexity over @@ -335,16 +340,14 @@ when compiling perl. Therefor, you need to run Porting/config_h.pl after that generation. All that and more is described in the README files that come with the metaunits. -Perl's metaconfig units should be available on CPAN. A set of units -that will work with perl5.9.x is in a file with a name similar to -F under L. -The mc_units tar file should be unpacked in your main perl source directory. -Note: those units were for use with 5.9.x. There may have been changes since -then. Check for later versions or contact perl5-porters@perl.org to obtain a -pointer to the current version. +=head1 How to Make a Distribution -Alternatively, do consider if the F<*ish.h> files or the hint files might be -a better place for your changes. +This section has now been expanded and moved into its own file, +F. + +I've kept some of the subsections here for now, as they don't directly +relate to building a release any more, but still contain what might be +useful information - DAPM 7/2009. =head2 MANIFEST @@ -471,7 +474,7 @@ Let's not force people to keep changing it. =head2 PPPort -F needs to be synchronized to include all +F needs to be synchronized to include all new macros added to .h files (normally F and F, but others as well). Since chances are that when a new macro is added the committer will forget to update F, it's the best to diff for @@ -520,7 +523,7 @@ It is courteous to update that if necessary. I find the F utility quite handy for making patches. You can obtain it from any CPAN archive under -L. There are a couple +L. There are a couple of differences between my version and the standard one. I have mine do a @@ -1385,11 +1388,11 @@ copyrights alone. Doing more than that requires quite a bit of tracking. =head1 AUTHORS Original author: Andy Dougherty doughera@lafayette.edu . -Additions by Chip Salzenberg chip@perl.com and -Tim Bunce Tim.Bunce@ig.co.uk . +Additions by Chip Salzenberg chip@perl.com, Tim Bunce and the perl5 +development team. All opinions expressed herein are those of the authorZ<>(s). =head1 LAST MODIFIED -2009-07-08-01 Jesse Vincent +2017-10-13 Dominic Hargreaves