In perl.git, the branch maint-5.22 has been updated <http://perl5.git.perl.org/perl.git/commitdiff/ed2f49a88d2b963fb6a5930d0f6bd09765ce929a?hp=55b9cfd964014d3efee12e80d7a375542f1cf75e>
- Log ----------------------------------------------------------------- commit ed2f49a88d2b963fb6a5930d0f6bd09765ce929a Author: David Golden <[email protected]> Date: Sun Dec 20 21:19:47 2015 -0500 Add alternate email address for dagolden to checkAUTHORS.pl (cherry picked from commit 6fb5c52dcc07b3a8ded9556c5db57384e493ae18) M Porting/checkAUTHORS.pl commit bead6fb6eaf53a665244a5e25eb2d24319984607 Author: Steve Hay <[email protected]> Date: Mon Apr 4 13:35:55 2016 +0100 epigraphs.pod - Add missing link, plus minor formatting corrections (cherry picked from commit da44b70c4102d945d69b12cd6f1852ed80e0e8d8) M Porting/epigraphs.pod commit d112720465b9cac36c087ea10ee6479cc5e01eed Author: Abigail <[email protected]> Date: Sun Mar 20 17:56:57 2016 +0100 Epigraph for 5.23.9. The missing capital in the book title is not a typo. The book is titled using lowercase letters only. (cherry picked from commit e68a8dd225220ca91bf3e741c9593f7155acb1cd) M Porting/epigraphs.pod commit 4a0b06f71c79cc6b173f1516db4ec3cadfe67a7b Author: Sawyer X <[email protected]> Date: Sat Feb 20 23:21:11 2016 +0100 add 5.23.8 epigraph (cherry picked from commit 9cefda87d848cd62945f53c7992133997086cc41) M Porting/epigraphs.pod commit 0f403813f041823f47791cbca340a914e6671e76 Author: Stevan Little <[email protected]> Date: Mon Apr 4 13:20:46 2016 +0100 updating the epigraph (manually cherry picked from commit 9c92e3718a6d9876f74ec38958c2f6fd3de8a901) M Porting/epigraphs.pod commit 99fb86d1149fd5dea08f15e77f2882be3e94953e Author: David Golden <[email protected]> Date: Mon Dec 21 17:58:32 2015 -0500 Updated Porting/epigraphs.pod for v5.23.6 (cherry picked from commit 411a38f08701d7a28f82baa55b54b6e1a628ded0) M Porting/epigraphs.pod commit ed0e5b6fb27a339fab0415a18d5a800db17f38e1 Author: Abigail <[email protected]> Date: Sun Mar 20 14:53:00 2016 +0100 Add new release to perlhist (cherry picked from commit 8f6d78186d3cbb6ae14697aeb3f10a2273fcbd6f) M pod/perlhist.pod commit e77ba33756cda8dc30c798b05e056d4d7ff9f71d Author: Sawyer X <[email protected]> Date: Sat Feb 20 21:09:58 2016 +0100 add new release to perlhist (cherry picked from commit 0d316f7c6263594f0d3ceabf61cf4089beadc4f5) M pod/perlhist.pod commit 8df61a2e27580b0a314de33794e70f588d512ca2 Author: Stevan Little <[email protected]> Date: Wed Jan 20 20:51:59 2016 +0100 Adding the new version to Perl history (cherry picked from commit 595fe05cdd46f27164da64bfe5f05f7776ae56e3) M pod/perlhist.pod commit 3aaf18b63475ad3502f7831bd2dd99c043905f0f Author: David Golden <[email protected]> Date: Mon Dec 21 13:37:03 2015 -0500 add new release to perlhist (cherry picked from commit 8d0cd0d3781e9e7b4f459b7edda0ccf6cf9e7576) M pod/perlhist.pod commit 467470737a9f2471d535b3c4f33105921a4e1282 Author: Abigail <[email protected]> Date: Fri Mar 25 13:36:28 2016 +0100 Suggest having the previous release ready. Each time I do a release, I find myself scrambling to download the tarball of the previous release, and install it so it can be compared to the release that's worked on. Added a paragraph as a reminder to that before the day of the release. (cherry picked from commit c282dc5ebef25e8b002cd913928f847fab339716) M Porting/release_managers_guide.pod commit a3a361c3440a7cc843278ad6decafd4357ff6b58 Author: Matthew Horsfall <[email protected]> Date: Tue Mar 22 20:12:12 2016 -0400 List perl.develop-help.com in the RMG regarding smoke reports. (cherry picked from commit a66bda92c7bdd515ba8b572a123e215718a89f10) M Porting/release_managers_guide.pod commit 584a34e993bea13b2124b97b145c48cbdaa288db Author: Abigail <[email protected]> Date: Mon Mar 21 17:56:51 2016 +0100 Point out that at some stage, porting tests will fail. This trips me each and every time I make a release. Whenever the release manager guide calls for a compile/make test cycle, I run "make test_harness", and this fails at this stage, because Module::CoreList has not been updated yet (the next action described in the release managers guide is updating Module::CoreList). I also removed some suboptimal advice I've written here in the past. (cherry picked from commit 2c1c14b5e997d921bc4d9510fbe1db2d662a5346) M Porting/release_managers_guide.pod commit 3275546b3a03a1bc14af8f5979cf4778a3af93d9 Author: Abigail <[email protected]> Date: Sun Mar 20 13:21:42 2016 +0100 Mention (relative) path to Module::CoreList's Changes file. So we can easily copy-and-paste it. (cherry picked from commit f8804d605a2aadae7a86f90a5f09dd1cb4477142) M Porting/release_managers_guide.pod commit 6a1032ad4854384cd2c3932f8ce48594a27a73b0 Author: Abigail <[email protected]> Date: Thu Mar 17 12:30:32 2016 +0100 The public_html directory on dromedary is working again. So, I removed the references that it wasn't working in December 2015. (cherry picked from commit 405350d5a880c875cd450beac2a60417ebc58f01) M Porting/release_managers_guide.pod commit 6a6141ecb17eac2001821e8a1d0d17047650073e Author: H.Merijn Brand <[email protected]> Date: Thu Feb 11 08:33:40 2016 +0100 Updated outdated link to smoke reports for HP-UX (cherry picked from commit c06527b22e13cfa21cd9f27439bb61b1402e2425) M Porting/release_managers_guide.pod commit 3b92901941c37a041b23ceaa360d374c2aa32c79 Author: Sawyer X <[email protected]> Date: Tue Feb 9 19:57:58 2016 +0100 Remove outdated task in release: I checked with Graham Barr, who said the list of PAUSE accounts that can upload perl distributions is automated and taken from: http://pause.perl.org/pause/query?ACTION=who_pumpkin;OF=YAML This means that if you're already on the list, you do not need to check again on search.cpan.org or to bug Graham. :) (cherry picked from commit be467f9538c4793cb78ccd9b0ea18d98faae50e3) M Porting/release_managers_guide.pod commit 109ec1c9980f8de2af45e937e3b198ca50652243 Author: Karen Etheridge <[email protected]> Date: Sun Dec 20 21:22:08 2015 -0800 RMG: fix typo, clarify instructions a bit (cherry picked from commit 812ce6dc8769e877223ed3af52762de412ddde87) M Porting/release_managers_guide.pod commit 214527a6ff518838d45cabdac3b30a20ad1cbe58 Author: David Golden <[email protected]> Date: Tue Dec 22 15:49:17 2015 -0500 Update release manager's guide (cherry picked from commit 96644a2c903dd02546994c154d580ce95f830f3b) M Porting/release_managers_guide.pod ----------------------------------------------------------------------- Summary of changes: Porting/checkAUTHORS.pl | 1 + Porting/epigraphs.pod | 96 +++++++++++++++++++++++++++++++++++++- Porting/release_managers_guide.pod | 74 +++++++++++++++++++++-------- pod/perlhist.pod | 4 ++ 4 files changed, 154 insertions(+), 21 deletions(-) diff --git a/Porting/checkAUTHORS.pl b/Porting/checkAUTHORS.pl index c4002d2..38c7bd7 100755 --- a/Porting/checkAUTHORS.pl +++ b/Porting/checkAUTHORS.pl @@ -586,6 +586,7 @@ crt\100kiski.net perl\100ctweten.amsite.com dairiki\100dairiki.org dairiki at dairiki.org dagolden\100cpan.org xdaveg\100gmail.com ++ xdg\100xdg.me damian\100conway.org damian\100cs.monash.edu.au dan\100sidhe.org sugalsd\100lbcc.cc.or.us + sugalskd\100osshe.edu diff --git a/Porting/epigraphs.pod b/Porting/epigraphs.pod index e1fb55e..38af273 100644 --- a/Porting/epigraphs.pod +++ b/Porting/epigraphs.pod @@ -17,6 +17,100 @@ Consult your favorite dictionary for details. =head1 EPIGRAPHS +=head2 v5.23.9 - Tom Kitchin, "from nature to plate" + +L<Announced on 2016-03-20 by Abigail|http://www.nntp.perl.org/group/perl.perl5.porters/2016/03/msg235251.html> + +Spring + +Spring is the proper beginning of my kitchen and a season that I +look forward to with great anticipation. By the time spring arrives +I am desperate to welcome all the spring produce into my kitchen +and I long to work with fresh green vegetables again. As much as I +love root vegetables, such as celeriac and parsnips, and the heaver +meat and game dishes, I'm ready to leave those behind with winter +and begin a new adventure. + +Somehow spring always gives me a little bit of bounce in my feet +-- I feel like I want to kick off my shoes and dance around in my +kitchen. Not that I do, of course, but I feel lighter somehow. My +adrenalin kicks in with spring and so does the level of excitement, +as I think about all the produce that is about to come in. + +The moment spring arrives I'm eager to cook peas, broad beans, green +asparagus and other fresh vegetables! I want to create lighter, +brighter dishes and I can't wait to get my hands on the first greens +and the first morels, not to mention the first wild Scottish salmon. +Thanks to my network of trusted suppliers, I always get to first +produce of the season delivered to my restaurant as soon as it is +possible. I want my customers to experience and understand the +beauty of locally grown produce and to try things the minute they +are available so they can taste how incredibly fresh the ingredients +are. I also want them to understand the relationship between +seasonality and flavours. One of the most important things to +remember is to allow the seasons to inspire your dishes and help +you make natural matches. Wild spring herbs, such as sorrel, sweet +cicely and wild garlic, as well as spring salad leaves and green +lettuce served with wild salmon, wild sea trout, lamb or rabbit are +marriages made in heaven. + + +=head2 v5.23.8 - Patrick Rothfuss, "The Wise Man's Fear (The Kingkiller's Chronicle: Day Two)" + +L<Announced on 2016-02-20 by Sawyer X|http://www.nntp.perl.org/group/perl.perl5.porters/2016/02/msg234535.html> + +Denna, on the other hand, had never been trained. She knew nothing +of shortcuts. You'd think she'd be forced to wander the city, lost and +helpless, trapped in a twisting maze of mortared stone. + +But instead, she simply walked throught the walls. She didn't know +any better. Nobody had ever told her she couldn't. Because of this, +she moved through the city like some faerie creature. She walked roads +no one else could see, and it made her music wild and strange and +free. + +=head2 v5.23.7 - William Gibson, "Neuromancer" + +L<Announced on 2016-01-20 by Stevan|http://www.nntp.perl.org/group/perl.perl5.porters/2016/01/msg233856.html> + +A year here and he still dreamed of cyberspace, hope fading +nightly. All the speed he took, all the turns he'd taken and +the corners he cut in Night City, and he'd still see the matrix +in his dreams, bright lattices of logic unfolding across that +colourless void...The Sprawl was a long, strange way home now +over the Pacific, and he was no Console Man, no cyberspace +cowboy. Just another hustler, trying to make it through. But +the dreams came on in the Japanese night like livewire voodoo, +and he'd cry for it, cry in his sleep, and wake alone in the +dark, curled in his capsule in some coffin hotel, hands clawed +into the bedslab, temper foam bunched between his fingers, +trying to reach the console that wasn't there. + +=head2 v5.23.6 - 5.23 Episode VII + + A long time ago in microseconds, in a galaxy not very far away... + + 5.23 Episode VII + THE FUZZ AWAKENS + + It is a period of + unrest as separatists + announce their intentions + to fork PERL and return the + galaxy to speed and stability. + + Chancellor Rik Hoolian struggles + to hold together the remains of the + once mighty Republic against a tide of + incivility and the depredations of a new + foe, the FUZZ RAIDERS. + + Meanwhile, after 15 years of preparation and + high expectations, Supreme Leader Toady prepares + to unleash a devastating new weapon, PERL SIXDOTOH, + that could splinter the Republic forever and usher in + a new Empire of gradual typing.... + =head2 v5.23.5 - utastro!nather (Ed Nather), "The Story of Mel", in net.jokes, May 21, 1983. L<Announced on 2015-11-20 by Abigail|http://www.nntp.perl.org/group/perl.perl5.porters/2015/11/msg232758.html> @@ -190,7 +284,7 @@ L<Announced on 2015-07-20 by Matthew Horsfall|http://www.nntp.perl.org/group/per Will chase the sun into the morning Beyond the sky, beyond the sea. -=head2 v5.23.0 - Bob Dylan, Maggie's Farm +=head2 v5.23.0 - Bob Dylan, "Maggie's Farm" L<Announced on 2015-06-20 by Ricardo Signes|http://www.nntp.perl.org/group/perl.perl5.porters/2015/06/msg228807.html> diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod index c13d3fb..6d67d0b 100644 --- a/Porting/release_managers_guide.pod +++ b/Porting/release_managers_guide.pod @@ -141,12 +141,6 @@ Andreas' email address at: https://pause.perl.org/pause/query?ACTION=pause_04imprint -=head3 search.cpan.org pumpkin status - -Make sure that search.cpan.org knows that you're allowed to upload -perl distros. Contact Graham Barr to make sure that you're on the right -list. - =head3 rt.perl.org update access Make sure you have permission to close tickets on L<http://rt.perl.org/> @@ -165,6 +159,20 @@ release. Have a chat with whichever evil perl porter tried to talk you into the idea in the first place to figure out the best way to resolve the issue. +=head3 web-based file share + +You will need to be able to share tarballs with #p5p members for +pre-release testing, and you may wish to upload to PAUSE via URL. +Make sure you have a way of sharing files, such as a web server or +file-sharing service. + +Porters have access to the "dromedary" server (users.perl5.git.perl.org), +which has a F<public_html> directory to share files with. +(L<http://users.perl5.git.perl.org/~username/perl-5.xx.y.tar.gz>) + +If you use Dropbox, you can append "raw=1" as a parameter to their usual +sharing link to allow direct download (albeit with redirects). + =head3 git clone of https://github.com/perlorg/perlweb For updating the L<http://dev.perl.org> web pages, either a Github account or @@ -175,6 +183,13 @@ is only needed on the day of the release or shortly afterwards. You will need a quotation to use as an epigraph to your release announcement. +=head3 Install the previous version of perl + +During the testing phase of the release you have created, you will be +asked to compare the installed files with a previous install. Save yourself +some time on release day, and have a (clean) install of the previous +version ready. + =head2 Building a release - advance actions The work of building a release candidate for an even numbered release @@ -249,7 +264,7 @@ C<git checkout .gitignore> in the F<cpan/Distro> directory. =item * Remove files we do not need. That is, remove any files that match the -entries in C<@IGNORABLE> in F<Porting/Maintainer.pl>, and anything that +entries in C<@IGNORABLE> in F<Porting/Maintainers.pl>, and anything that matches the C<EXCLUDED> section of the distro's entry in the C<%Modules> hash. @@ -292,7 +307,7 @@ Run the tests for the package. =item * -Run the tests in F<t/porting>. +Run the tests in F<t/porting> (C<make test_porting>). =item * @@ -342,8 +357,8 @@ Ensure dual-life CPAN modules are stable, which comes down to: =head3 monitor smoke tests for failures Similarly, monitor the smoking of core tests, and try to fix. See -L<http://doc.procura.nl/smoke/index.html> and L<http://perl5.test-smoke.org/> -for a summary. See also +L<http://smoke.procura.nl/index.html>, L<http://perl5.test-smoke.org/> +and L<http://perl.develop-help.com> for a summary. See also L<http://www.nntp.perl.org/group/perl.daily-build.reports/> which has the raw reports. @@ -421,10 +436,6 @@ You may also need to regen opcodes: $ ./perl -Ilib regen/opcode.pl -You may have to add stub entries in C<%Module::CoreList::version>, -C<%Module::CoreList::deprecated> and C<%Module::CoreList::Utils::delta>. -If so, you must up their version numbers as well. - Test your changes: $ git clean -xdf # careful if you don't have local files to keep! @@ -432,6 +443,9 @@ Test your changes: $ make $ make test +Do note that at this stage, porting tests will fail. They will continue +to fail until you've updated Module::CoreList, as described below. + Commit your changes: $ git status @@ -465,7 +479,9 @@ release in the previous development cycle (so for example, for a 5.14.x release, this would be 5.13.11). For BLEAD-POINT releases, it needs to refer to the previous BLEAD-POINT -release (so for 5.15.3 this would be 5.15.2). +release (so for 5.15.3 this would be 5.15.2). If the last release manager +followed instructions, this should have already been done after the last +blead release, so you may find nothing to do here. =head3 Check copyright years @@ -634,6 +650,7 @@ Check those files over carefully: =head4 Bump version in Module::CoreList F<Changes> Also edit Module::CoreList's new version number in its F<Changes> file. +This file is F<dist/Module-CoreList/Changes>. =head4 Add Module::CoreList version bump to perldelta @@ -882,6 +899,11 @@ utility is included with most modern UNIX-type operating systems and is available for Cygwin. A Windows port is available from L<http://tukaani.org/xz/>. +B<IMPORTANT>: if you are on OS X, you must export C<COPYFILE_DISABLE=1> +to prevent OS X resource files from being included in your tarball. After +creating the tarball following the instructions below, inspect it to ensure +you don't have files like F<._foobar>. + Create a tarball. Use the C<-s> option to specify a suitable suffix for the tarball and directory name: @@ -920,12 +942,20 @@ Once you have a tarball it's time to test the tarball (not the repository). Copy the tarballs (.gz and possibly .bz2 and .xz) to a web server somewhere you have access to. -=head4 Download the tarball to another machine +=head4 Download the tarball to another machine and unpack it Download the tarball to some other machine. For a release candidate, you really want to test your tarball on two or more different platforms -and architectures. The #p5p IRC channel on irc.perl.org is a good place -to find willing victims. +and architectures. + +=head4 Ask #p5p to test the tarball on different platforms + +Once you've verified the tarball can be downloaded and unpacked, +ask the #p5p IRC channel on irc.perl.org for volunteers to test the +tarballs on whatever platforms they can. + +If you're not confident in the tarball, you can defer this step until after +your own tarball testing, below. =head4 Check that F<Configure> works @@ -1056,10 +1086,14 @@ high-reliability connection to the Internet, you should probably use the new release from wherever you put it for testers to find it. This will eliminate anxious gnashing of teeth while you wait to see if your 15 megabyte HTTP upload successfully completes across your slow, twitchy -cable modem. You can make use of your home directory on dromedary for +cable modem. + +You can make use of your home directory on dromedary for this purpose: F<http://users.perl5.git.perl.org/~USERNAME> maps to F</home/USERNAME/public_html>, where F<USERNAME> is your login account -on dromedary. I<Remember>: if your upload is partially successful, you +on dromedary. + +I<Remember>: if your upload is partially successful, you may need to contact a PAUSE administrator or even bump the version of perl. Upload the .gz, .xz, and .bz2 versions of the tarball. diff --git a/pod/perlhist.pod b/pod/perlhist.pod index ecbec1a..a688859 100644 --- a/pod/perlhist.pod +++ b/pod/perlhist.pod @@ -572,6 +572,10 @@ the strings?). Peter 5.23.3 2015-Sep-20 Steve 5.23.4 2015-Oct-20 Abigail 5.23.5 2015-Nov-20 + David G 5.23.6 2015-Dec-21 + Stevan 5.23.7 2016-Jan-20 + Sawyer X 5.23.8 2016-Feb-20 + Abigail 5.23.9 2016-Mar-20 =head2 SELECTED RELEASE SIZES -- Perl5 Master Repository
