Commit | Line | Data |
7277a900 |
1 | =head1 NAME |
2 | |
3 | release_managers_guide - Releasing a new version of perl 5.x |
4 | |
636a1918 |
5 | XXX as of Jul 2009, this file is still a work-in-progress. I think it |
6 | contains all the actions needed to build a release, but things may have |
7 | got skipped, and some things could do with polishing. Note that things |
8 | change each release, there may be new things not covered here, or |
9 | tools may need updating. DAPM |
f6af4394 |
10 | |
7277a900 |
11 | =head1 SYNOPSIS |
12 | |
f6af4394 |
13 | This document describes the series of tasks required - some automatic, some |
14 | manual - to produce a perl release of some description, be that a snaphot, |
8c35d285 |
15 | release candidate, or final, numbered release of maint or blead. |
f6af4394 |
16 | |
8c35d285 |
17 | The release process has traditionally been executed by the current |
18 | pumpking. |
7277a900 |
19 | |
8c35d285 |
20 | This document both helps as a check-list for the release engineer |
21 | and is a base for ideas on how the various tasks could be automated |
22 | or distributed. |
7277a900 |
23 | |
636a1918 |
24 | The outline of a typical release cycle is as follows: |
f6af4394 |
25 | |
636a1918 |
26 | (5.10.1 is released, and post-release actions have been done) |
f6af4394 |
27 | |
28 | ...time passes... |
29 | |
30 | an occasional snapshot is released, that still identifies itself as |
31 | 5.10.1 |
32 | |
33 | ...time passes... |
34 | |
35 | a few weeks before the release, a number of steps are performed, |
36 | including bumping the version to 5.10.2 |
636a1918 |
37 | |
38 | ...a few weeks passes... |
46743ef7 |
39 | |
f6af4394 |
40 | perl-5.10.2-RC1 is released |
41 | |
42 | perl-5.10.2 is released |
43 | |
44 | post-release actions are performed, including creating new |
45 | perl5103delta.pod |
46 | |
47 | ... the cycle continues ... |
7277a900 |
48 | |
49 | =head1 DETAILS |
50 | |
8c35d285 |
51 | Some of the tasks described below apply to all four types of |
52 | release of Perl. (snapshot, RC, final release of maint, final |
53 | release of blead). Some of these tasks apply only to a subset |
54 | of these release types. If a step does not apply to a given |
55 | type of release, you will see a notation to that effect at |
56 | the beginning of the step. |
57 | |
58 | =head2 Release types |
59 | |
60 | =over 4 |
61 | |
62 | =item Snapshot |
63 | |
64 | A snapshot is intended to encourage in-depth testing from time-to-time, |
65 | for example after a key point in the stabilisation of a branch. It |
66 | requires fewer steps than a full release, and the version number of perl in |
67 | the tarball will usually be the same as that of the previous release. |
68 | |
69 | =item Release Candidate (RC) |
70 | |
71 | XXX Describe me |
72 | |
73 | =item Stable/Maint release |
74 | |
75 | At this point you should have a working release candidate with few or no |
76 | changes since. |
77 | |
78 | It's essentially the same procedure as for making a release candidate, but |
79 | with a whole bunch of extra post-release steps. |
80 | |
81 | =item Blead release |
82 | |
83 | It's essentially the same procedure as for making a release candidate, but |
84 | with a whole bunch of extra post-release steps. |
85 | |
86 | =back |
7277a900 |
87 | |
fd838dcf |
88 | =head2 Prerequisites |
89 | |
90 | Before you can make an official release of perl, there are a few |
91 | hoops you need to jump through: |
92 | |
93 | =over 4 |
94 | |
8c35d285 |
95 | =item PAUSE account |
96 | |
97 | I<SKIP this step for SNAPSHOT> |
fd838dcf |
98 | |
99 | Make sure you have a PAUSE account suitable for uploading a perl release. |
100 | If you don't have a PAUSE account, then request one: |
101 | |
102 | https://pause.perl.org/pause/query?ACTION=request_id |
103 | |
104 | Check that your account is allowed to upload perl distros: goto |
105 | https://pause.perl.org/, login, then select 'upload file to CPAN'; there |
106 | should be a "For pumpkings only: Send a CC" tickbox. If not, ask Andreas |
107 | König to add your ID to the list of people allowed to upload something |
108 | called perl. You can find Andreas' email address at: |
109 | |
110 | https://pause.perl.org/pause/query?ACTION=pause_04imprint |
111 | |
8c35d285 |
112 | =item CPAN mirror |
113 | |
114 | Some release engineering steps require a full mirror of the CPAN. |
115 | Work to fall back to using a remote mirror via HTTP is incomplete |
116 | but ongoing. (No, a minicpan mirror is not sufficient) |
117 | |
118 | =item git checkout and commit bit |
fd838dcf |
119 | |
120 | You will need a working C<git> installation, checkout of the perl |
121 | git repository and perl commit bit. For information about working |
122 | with perl and git, see F<pod/perlrepository.pod>. |
123 | |
124 | If you are not yet a perl committer, you won't be able to make a |
125 | release. Have a chat with whichever evil perl porter tried to talk |
126 | you into the idea in the first place to figure out the best way to |
127 | resolve the issue. |
128 | |
f6af4394 |
129 | |
8c35d285 |
130 | =item Quotation for release announcement epigraph |
f6af4394 |
131 | |
8c35d285 |
132 | I<SKIP this step for SNAPSHOT and RC> |
f6af4394 |
133 | |
8c35d285 |
134 | For a numbered blead or maint release of perl, you will need a quotation |
135 | to use as an epigraph to your release announcement. (There's no harm |
136 | in having one for a snapshot, but it's not required). |
46743ef7 |
137 | |
f6af4394 |
138 | |
139 | =back |
140 | |
f6af4394 |
141 | |
8c35d285 |
142 | =head2 Building a release |
143 | |
144 | The work of building a release candidate for a numbered release of |
145 | perl generally starts several weeks before the first release candidate. |
146 | Some of these should be done regularly, but all I<must> be done in the |
147 | runup to a release. |
7277a900 |
148 | |
149 | =over 4 |
150 | |
f6af4394 |
151 | =item * |
152 | |
8c35d285 |
153 | I<You MAY SKIP this step for SNAPSHOT> |
154 | |
f6af4394 |
155 | Ensure that dual-life CPAN modules are synchronised with CPAN. Basically, |
156 | run the following: |
157 | |
db3f805e |
158 | $ ./perl -Ilib Porting/core-cpan-diff -a -o /tmp/corediffs |
7277a900 |
159 | |
f6af4394 |
160 | to see any inconsistencies between the core and CPAN versions of distros, |
161 | then fix the core, or cajole CPAN authors as appropriate. See also the |
162 | C<-d> and C<-v> options for more detail. You'll probably want to use the |
163 | C<-c cachedir> option to avoid repeated CPAN downloads. |
7277a900 |
164 | |
f6af4394 |
165 | To see which core distro versions differ from the current CPAN versions: |
7277a900 |
166 | |
db3f805e |
167 | $ ./perl -Ilib Porting/core-cpan-diff -x -a |
7277a900 |
168 | |
636a1918 |
169 | if you are making a maint release, run C<core-cpan-diff> on both blead and |
170 | maint, then diff the two outputs. Compare this with what you expect, and if |
171 | necessary, fix things up. For example, you might think that both blead |
172 | and maint are synchronised with a particular CPAN module, but one might |
173 | have some extra changes. |
174 | |
f6af4394 |
175 | =item * |
7277a900 |
176 | |
8c35d285 |
177 | I<You MAY SKIP this step for SNAPSHOT> |
178 | |
f6af4394 |
179 | Ensure dual-life CPAN modules are stable, which comes down to: |
7277a900 |
180 | |
181 | for each module that fails its regression tests on $current |
f6af4394 |
182 | did it fail identically on $previous? |
183 | if yes, "SEP" (Somebody Else's Problem) |
184 | else work out why it failed (a bisect is useful for this) |
7277a900 |
185 | |
186 | attempt to group failure causes |
187 | |
188 | for each failure cause |
f6af4394 |
189 | is that a regression? |
190 | if yes, figure out how to fix it |
191 | (more code? revert the code that broke it) |
192 | else |
193 | (presumably) it's relying on something un-or-under-documented |
194 | should the existing behaviour stay? |
195 | yes - goto "regression" |
196 | no - note it in perldelta as a significant bugfix |
197 | (also, try to inform the module's author) |
1aff5354 |
198 | |
f6af4394 |
199 | =item * |
7277a900 |
200 | |
8c35d285 |
201 | I<You MAY SKIP this step for SNAPSHOT> |
202 | |
f6af4394 |
203 | Similarly, monitor the smoking of core tests, and try to fix. |
7277a900 |
204 | |
f6af4394 |
205 | =item * |
7277a900 |
206 | |
8c35d285 |
207 | I<You MAY SKIP this step for SNAPSHOT> |
208 | |
636a1918 |
209 | Similarly, monitor the smoking of perl for compiler warnings, and try to |
210 | fix. |
211 | |
212 | =item * |
213 | |
8c35d285 |
214 | I<You MAY SKIP this step for SNAPSHOT> |
215 | |
f6af4394 |
216 | Run F<Porting/cmpVERSION.pl> to compare the current source tree with the |
217 | previous version to check for for modules that have identical version |
218 | numbers but different contents, e.g.: |
7277a900 |
219 | |
f6af4394 |
220 | $ cd ~/some-perl-root |
221 | $ ./perl -Ilib Porting/cmpVERSION.pl -xd ~/my_perl-tarballs/perl-5.10.0 . |
222 | |
223 | then bump the version numbers of any non-dual-life modules that have |
224 | changed since the previous release, but which still have the old version |
225 | number. If there is more than one maintenance branch (e.g. 5.8.x, 5.10.x), |
226 | then compare against both. |
227 | |
228 | Note that some of the files listed may be generated (e.g. copied from ext/ |
229 | to lib/, or a script like lib/lib_pm.PL is run to produce lib/lib.pm); |
230 | make sure you edit the correct file! |
231 | |
232 | Once all version numbers have been bumped, re-run the checks. |
233 | |
234 | Then run again without the -x option, to check that dual-life modules are |
235 | also sensible. |
236 | |
55878aed |
237 | =item * |
238 | |
239 | Check that files managed by F<regen.pl> and friends are up to date. From |
240 | within your working directory: |
241 | |
242 | |
ee56566f |
243 | $ git status |
55878aed |
244 | $ make regen |
245 | $ make regen_perly |
ee56566f |
246 | $ git status |
55878aed |
247 | |
248 | If any of the files managed by regen.pl have changed, then you should commit |
249 | the updated versions: |
250 | |
251 | $ git commit -m 'Updated files generated by regen tools for perl 5.x.y' <list of files> |
252 | |
f6af4394 |
253 | |
254 | =item * |
255 | |
8c35d285 |
256 | I<You MAY SKIP this step for SNAPSHOT> |
257 | |
f6af4394 |
258 | Get perldelta in a mostly finished state. |
db3f805e |
259 | |
636a1918 |
260 | Peruse F<Porting/how_to_write_a_perldelta.pod>, and try to make sure that |
261 | every section it lists is, if necessary, populated and complete. Copy |
262 | edit the whole document. |
f6af4394 |
263 | |
264 | =item * |
265 | |
8c35d285 |
266 | I<You MUST SKIP this step for SNAPSHOT> |
267 | |
f6af4394 |
268 | Bump the perl version number (e.g. from 5.10.0 to 5.10.1). |
269 | |
270 | There is a tool to semi-automate this process. It works in two stages. |
271 | First, it generates a list of suggested changes, which you review and |
272 | edit; then you feed this list back and it applies the edits. So, first |
273 | scan the source dir looking for likely candidates: |
274 | |
275 | $ Porting/bump-perl-version -s 5.10.0 5.10.1 > /tmp/scan |
276 | |
277 | This produces a file containing a list of suggested edits, eg: |
278 | |
279 | NetWare/Makefile |
280 | |
281 | 89: -MODULE_DESC = "Perl 5.10.0 for NetWare" |
282 | +MODULE_DESC = "Perl 5.10.1 for NetWare" |
283 | |
284 | i.e. in the file F<NetWare/Makefile>, line 89 would be changed as shown. |
285 | Review the file carefully, and delete any -/+ line pairs that you don't |
286 | want changing. Remember that this tool is largely just grepping for '5.10.0' |
287 | or whatever, so it will generate false positives. Be careful not change |
288 | text like "this was fixed in 5.10.0"! Then run: |
289 | |
290 | $ Porting/bump-perl-version -u < /tmp/scan |
291 | |
292 | which will update all the files shown; then commit the changes. |
293 | |
294 | Be particularly careful with F<INSTALL>, which contains a mixture of |
295 | C<5.10.0>-type strings, some of which need bumping on every release, and |
296 | some of which need to be left. Also note that this tool currently only |
297 | performs a single change per line, so in particular, this line in |
298 | README.vms needs special handling: |
299 | |
300 | rename perl-5^.10^.1.dir perl-5_10_1.dir |
7277a900 |
301 | |
dc0a62a1 |
302 | |
303 | =item * |
304 | |
8c35d285 |
305 | I<You MUST SKIP this step for SNAPSHOT> |
306 | |
dc0a62a1 |
307 | Review and update INSTALL to account for the change in version number; |
308 | in particular, the "Coexistence with earlier versions of perl 5" section. |
309 | |
f6af4394 |
310 | =item * |
7277a900 |
311 | |
8c35d285 |
312 | I<You MUST SKIP this step for SNAPSHOT> |
313 | |
f6af4394 |
314 | Update the F<Changes> file to contain the git log command which would show |
315 | all the changes in this release. You will need assume the existence of a |
316 | not-yet created tag for the forthcoming release; e.g. |
7277a900 |
317 | |
f6af4394 |
318 | git log ... perl-5.10.0..perl5.12.0 |
7277a900 |
319 | |
f6af4394 |
320 | Due to warts in the perforce-to-git migration, some branches require extra |
321 | exclusions to avoid other branches being pulled in. Make sure you have the |
322 | correct incantation: replace the not-yet-created tag with C<HEAD> and see |
323 | if git log produces roughly the right number of commits across roughly the |
324 | right time period. |
7277a900 |
325 | |
dc0a62a1 |
326 | |
f6af4394 |
327 | =item * |
7277a900 |
328 | |
f6af4394 |
329 | Check some more build configurations, e.g. |
7277a900 |
330 | |
f6af4394 |
331 | -Duseshrplib -Dd_dosuid |
332 | make suidperl |
7277a900 |
333 | |
f6af4394 |
334 | Check that setuid installs works (for < 5.11.0 only). |
335 | XXX any other configs? |
7277a900 |
336 | |
7277a900 |
337 | |
f6af4394 |
338 | =item * |
7277a900 |
339 | |
8c35d285 |
340 | I<You MAY SKIP this step for SNAPSHOT> |
341 | |
f6af4394 |
342 | Update F<AUTHORS>, using the C<Porting/checkAUTHORS.pl> script, and if |
343 | necessary, update the script to include new alias mappings. |
7277a900 |
344 | |
f6af4394 |
345 | XXX This script is currently broken (7/2009). It needs updating to work |
346 | with git and a lack of Changes files. |
347 | |
f6af4394 |
348 | |
8c35d285 |
349 | =item * |
f6af4394 |
350 | |
8c35d285 |
351 | I<You MAY SKIP this step for SNAPSHOT> |
f6af4394 |
352 | |
8c35d285 |
353 | As there are no regular smokes [ XXX yet - please fix?] find out about the |
354 | state of the current branch on VMS. If the branch you're releasing on |
355 | is failing tests on VMS, you may not want to do a release. |
356 | |
357 | =item * |
358 | |
359 | Configure and build perl so that you have a Makefile and porting tools: |
360 | |
361 | $ ./Configure -Dusedevel -des |
362 | $ make |
363 | |
364 | =item * |
365 | |
366 | Rebuild META.yml: |
367 | |
368 | $ rm META.yml |
369 | $ make META.yml |
370 | |
371 | Commit META.yml if it has changed: |
372 | |
373 | $ git commit -m 'Updating META.yml in preparation for release of 5.x.y' META.yml |
374 | |
375 | =item * |
376 | |
377 | Check that the manifest is sorted and correct: |
378 | |
379 | $ make manisort |
380 | $ make distclean |
381 | $ perl Porting/manicheck |
382 | |
383 | |
384 | Commit MANIFEST if it has changed: |
385 | |
386 | $ git commit -m 'Updating MANIFEST in preparation for release of 5.x.y' MANIFEST |
387 | |
388 | |
389 | |
390 | =item * |
391 | |
392 | I<You MUST SKIP this step for SNAPSHOT> |
393 | |
394 | A dd an entry to F<pod/perlhist.pod> with the current date: |
395 | |
396 | 5.8.9-RC1 2008-Nov-10 |
397 | |
398 | Make sure the correct pumpking is listed, and if this is the first release |
399 | under the stewardship of a new pumpking, make sure that his or her name |
400 | is listed in the section entitled C<THE KEEPERS OF THE PUMPKIN>. |
401 | |
402 | Be sure to commit your changes: |
403 | |
404 | $ git commit -m 'Updating perlhist in preparation for release of 5.x.y pod/perlhist.pod |
405 | |
406 | |
407 | =item * |
408 | |
409 | Build perl, then make sure it passes its own test suite, and installs: |
410 | |
411 | $ ./Configure -des -Dusedevel -Dprefix=/tmp/perl-5.x.y-pretest |
412 | $ make test install |
413 | |
414 | =item * |
415 | |
416 | Create a tarball. Use the C<-s> option to specify a suitable suffix for |
417 | the tarball and directory name: |
418 | |
419 | $ cd root/of/perl/tree |
420 | $ make distclean |
421 | $ git clean -xdf # make sure perl and git agree on files |
422 | |
423 | $ perl Porting/makerel -b -s `git describe` # for a snapshot |
424 | $ perl Porting/makerel -b -s RC1 # for a release candidate |
425 | $ perl Porting/makerel -b # for a final release |
426 | |
427 | This creates the directory F<../perl-x.y.z-RC1> or similar, copies all |
428 | the MANIFEST files into it, sets the correct permissions on them, |
429 | adds DOS line endings to some, then tars it up as |
430 | F<../perl-x.y.z-RC1.tar.gz>. With C<-b>, it also creates a C<tar.bz2> file. |
431 | |
432 | XXX if we go for extra tags and branches stuff, then add the extra details |
433 | here |
434 | |
435 | =item * |
436 | |
437 | Copy the tarballs (.gz and possibly .bz2) to a web server somewhere you |
438 | have access to. |
439 | |
440 | =item * |
441 | |
442 | Download the tarball to some other machine. For a release candidate, |
443 | you really want to test your tarball on two or more different platforms |
444 | and architectures. The #p5p IRC channel on irc.perl.org is a good place |
445 | to find willing victims. |
446 | |
447 | =item * |
448 | |
449 | Check that basic configuration and tests work on each test machine: |
450 | |
451 | $ ./Configure -des && make all test |
f6af4394 |
452 | |
453 | =item * |
454 | |
8c35d285 |
455 | Check that the test harness and install work on each test machine: |
456 | |
457 | $ ./Configure -des -Dprefix=/install/path && make all test_harness install |
458 | |
459 | =item * |
460 | |
461 | Check that the output of C<perl -v> and C<perl -V> are as expected, |
462 | especially as regards version numbers, patch and/or RC levels, and @INC |
463 | paths. |
464 | |
465 | Note that the results may be different without a F<.git/> directory, |
466 | which is why you should test from the tarball. |
467 | |
468 | =item * |
469 | |
470 | Bootstrap the CPAN client on the clean install: |
471 | |
472 | $ ./bin/perl -MCPAN -e'shell' |
473 | |
474 | =item * |
475 | |
476 | Install Inline.pm |
477 | |
478 | $ ./bin/perl -MCPAN -e'install Inline' |
479 | |
480 | Check that your perl can run this: |
481 | |
482 | $ ./bin/perl -lwe 'use Inline C => "int answer() { return 42;} "; print answer' |
483 | |
484 | =item * |
485 | |
486 | Bootstrap the CPANPLUS client on the clean install: |
487 | |
488 | $ ./bin/cpanp |
489 | |
490 | |
491 | =item * |
492 | |
493 | Install an XS module. |
494 | |
495 | =item * |
496 | |
497 | If all is well, announce the snapshot to p5p. (For a release candidate, |
498 | instead follow the further steps described later.) |
499 | |
500 | |
501 | =item * |
502 | |
503 | |
504 | I<You MAY SKIP this step for SNAPSHOT> |
505 | |
f6af4394 |
506 | Re-read the perldelta to try to find any embarrassing typos and thinkos; |
507 | remove any C<TODO> or C<XXX> flags; and run through pod and spell |
636a1918 |
508 | checkers, e.g. |
509 | |
510 | podchecker -warnings -warnings pod/perl5101delta.pod |
511 | spell pod/perl5101delta.pod |
f6af4394 |
512 | |
513 | =item * |
514 | |
8c35d285 |
515 | I<You MUST SKIP this step for SNAPSHOT> |
516 | |
f6af4394 |
517 | Update patchlevel.h to add a C<-RC1>-or-whatever string; or, if this is a |
518 | final release, remove it. [ XXX how now?? see 34813 for old way ] |
519 | |
520 | =item * |
521 | |
8c35d285 |
522 | I<You MUST SKIP this step for SNAPSHOT> |
523 | |
f6af4394 |
524 | Update C<Module::Corelist>. |
210de33e |
525 | |
ce4f4fe2 |
526 | Note that if this is a maint release, you should run the following actions |
210de33e |
527 | from the maint directory, but edit the C<Corelist.pm> in I<blead> and |
528 | subsequently cherry-pick it. |
529 | |
dc2f75c0 |
530 | corelist.pl uses ftp.funet.fi to verify information about dual-lifed |
531 | modules on CPAN. It can use a full, local CPAN mirror or fall back |
532 | to C<wget> or C<curl> to fetch only package metadata remotely. |
210de33e |
533 | |
dc2f75c0 |
534 | (If you'd prefer to have a full CPAN mirror, see |
535 | http://www.cpan.org/misc/cpan-faq.html#How_mirror_CPAN) |
210de33e |
536 | |
210de33e |
537 | |
dc2f75c0 |
538 | Then change to your perl checkout. |
210de33e |
539 | |
dc2f75c0 |
540 | If you have a local CPAN mirror, run: |
210de33e |
541 | |
dc2f75c0 |
542 | $ perl -Ilib Porting/corelist.pl ~/my-cpan-mirror |
210de33e |
543 | |
dc2f75c0 |
544 | Otherwise, run: |
210de33e |
545 | |
dc2f75c0 |
546 | $ perl -Ilib Porting/corelist.pl cpan |
210de33e |
547 | |
dc2f75c0 |
548 | This will chug for a while. Assuming all goes well, it will |
549 | update lib/Module/CoreList.pm. |
210de33e |
550 | |
dc2f75c0 |
551 | Check that file over carefully: |
210de33e |
552 | |
dc2f75c0 |
553 | $ git diff lib/Module/CoreList.pm |
554 | |
555 | |
556 | If necessary, bump C<$VERSION> (there's no need to do this for |
557 | every RC; in RC1, bump the version to a new clean number that will |
558 | appear in the final release, and leave as-is for the later RCs and final). |
210de33e |
559 | |
ce4f4fe2 |
560 | Edit the version number in the new C<< 'Module::CoreList' => 'X.YZ' >> |
210de33e |
561 | entry, as that is likely to reflect the previous version number. |
562 | |
8c35d285 |
563 | If this is a final release (rather than a release candidate): |
dc2f75c0 |
564 | |
8c35d285 |
565 | Update this version's entry in the C<%released> hash with today's date. |
210de33e |
566 | |
dc2f75c0 |
567 | Finally, commit the new version of Module::CoreList: |
568 | |
569 | $ git commit -m 'Updated Module::CoreList for the 5.x.y release' \ |
570 | lib/Module/Corelist.pm |
571 | |
7277a900 |
572 | |
f6af4394 |
573 | =item * |
574 | |
addebd58 |
575 | Disarm the patchlevel.h change [ XXX expand ] |
576 | |
577 | =item * |
578 | |
8c35d285 |
579 | I<You MAY SKIP this step for SNAPSHOT> |
580 | |
f6af4394 |
581 | Wait for the smoke tests to catch up with the commit which this release is |
582 | based on (or at least the last commit of any consequence). |
7277a900 |
583 | |
f6af4394 |
584 | Then check that the smoke tests pass (particularly on Win32). If not, go |
585 | back and fix things. |
7277a900 |
586 | |
7277a900 |
587 | |
f6af4394 |
588 | =item * |
7277a900 |
589 | |
8c35d285 |
590 | I<You MUST SKIP this step for SNAPSHOT> |
591 | |
f6af4394 |
592 | Once smoking is okay, upload it to PAUSE. This is the point of no return. |
db3f805e |
593 | If anything goes wrong after this point, you will need to re-prepare |
594 | a new release with a new minor version or RC number. |
595 | |
addebd58 |
596 | You may wish to create a .bz2 version of the tarball and upload that too. |
f6af4394 |
597 | |
210de33e |
598 | =item * |
599 | |
8c35d285 |
600 | I<You MUST SKIP this step for SNAPSHOT> |
601 | |
db3f805e |
602 | Create a tag for the exact git revsion you built the release from: |
210de33e |
603 | |
604 | $ git tag perl-5.10.1-RC1 -m'Release Candidate 1 of Perl 5.10.1' |
605 | $ git push origin tag perl-5.10.1-RC1 |
f6af4394 |
606 | |
607 | =item * |
608 | |
db3f805e |
609 | Mail p5p to announce your new release, with a quote you prepared earlier. |
f6af4394 |
610 | |
611 | =item * |
612 | |
8c35d285 |
613 | I<You MAY SKIP this step for SNAPSHOT> |
614 | |
f6af4394 |
615 | Wait 24 hours or so, then post the announcement to use.perl.org. |
addebd58 |
616 | (if you don't have access rights to post news, ask someone like Rafael to |
617 | do it for you.) |
f6af4394 |
618 | |
f6af4394 |
619 | =item * |
7277a900 |
620 | |
8c35d285 |
621 | I<You MUST SKIP this step for SNAPSHOT, RC, BLEAD> |
7277a900 |
622 | |
f6af4394 |
623 | Ask Jarkko to update http://www.cpan.org/src/README.html and |
624 | Rafael to update http://dev.perl.org/perl5/ |
7277a900 |
625 | |
f6af4394 |
626 | =item * |
7277a900 |
627 | |
8c35d285 |
628 | I<You MUST SKIP this step for SNAPSHOT, RC> |
629 | |
630 | |
f6af4394 |
631 | Create a new empty perlNNNdelta.pod file for the current release + 1; |
632 | see F<Porting/how_to_write_a_perldelta.pod>. |
633 | [ XXX Perhaps we should have an empty template file we can copy in. ] |
7277a900 |
634 | |
a2cba4bc |
635 | In addition, edit F<pod.lst>, adding the new entry as 'D', and unmark previous |
636 | entry as 'D', then run C<perl pod/buildtoc --build-all> to update the |
637 | following files: |
7277a900 |
638 | |
f6af4394 |
639 | MANIFEST |
f6af4394 |
640 | pod/perl.pod |
a2cba4bc |
641 | win32/pod.mak |
642 | vms/descrip_mms.template |
643 | |
644 | (F<vms/descrip_mms.template> still needs a manual edit to bump the |
645 | C<perldelta.pod> entry - it would be good for someone to figure out the fix.) |
7277a900 |
646 | |
f6af4394 |
647 | and change perlNNNdelta references to the new version in these files |
7277a900 |
648 | |
f6af4394 |
649 | INSTALL |
650 | win32/Makefile.mk |
651 | win32/Makefile |
652 | Makefile.SH |
653 | README |
7277a900 |
654 | |
f6af4394 |
655 | Also, edit the previous delta file to change the C<NAME> from C<perldelta> |
656 | to C<perlNNNdelta>. |
7277a900 |
657 | |
f6af4394 |
658 | These two lists of files probably aren't exhaustive; do a recursive grep |
659 | on the previous filename to look for suitable candidates. |
7277a900 |
660 | |
f6af4394 |
661 | (see 16410843ea for an example). |
7277a900 |
662 | |
f6af4394 |
663 | =item * |
7277a900 |
664 | |
8c35d285 |
665 | I<You MUST SKIP this step for SNAPSHOT, RC, BLEAD> |
dc0a62a1 |
666 | |
8c35d285 |
667 | If this was a maint release, then edit F<Porting/mergelog> to change |
668 | all the C<d> (deferred) flags to C<.> (needs review). |
addebd58 |
669 | |
8c35d285 |
670 | XXX - we should be able to use git to automate much of the role |
671 | previously filled by the mergelog. |
addebd58 |
672 | |
673 | =item * |
674 | |
8c35d285 |
675 | I<You MUST SKIP this step for SNAPSHOT, RC, BLEAD> |
addebd58 |
676 | |
8c35d285 |
677 | If this was a major release (5.x.0), then create a new maint branch |
678 | based on the commit tagged as the current release and bump the version |
679 | in the blead branch in git, e.g. 5.12.0 to 5.13.0. |
addebd58 |
680 | |
681 | [ XXX probably lots more stuff to do, including perldelta, |
f6af4394 |
682 | C<lib/feature.pm> ] |
7277a900 |
683 | |
8c35d285 |
684 | XXX need a git recipe |
addebd58 |
685 | |
686 | =item * |
687 | |
8c35d285 |
688 | I<You MUST SKIP this step for SNAPSHOT, RC, BLEAD> |
689 | |
f6af4394 |
690 | Copy the perlNNNdelta.pod for this release into the other branches, and |
691 | remember to update these files on those branches too: |
7277a900 |
692 | |
f6af4394 |
693 | MANIFEST |
694 | pod.lst |
695 | pod/perl.pod |
696 | vms/descrip_mms.template |
697 | win32/pod.mak |
7277a900 |
698 | |
f6af4394 |
699 | (see fc5be80860 for an example). |
7277a900 |
700 | |
f6af4394 |
701 | =item * |
7277a900 |
702 | |
8c35d285 |
703 | I<You MUST SKIP this step for SNAPSHOT> |
704 | |
f6af4394 |
705 | Make sure any recent F<pod/perlhist.pod> entries are copied to |
706 | F<perlhist.pod> on other branches; typically the RC* and final entries, |
707 | e.g. |
7277a900 |
708 | |
f6af4394 |
709 | 5.8.9-RC1 2008-Nov-10 |
710 | 5.8.9-RC2 2008-Dec-06 |
711 | 5.8.9 2008-Dec-14 |
7277a900 |
712 | |
6e40fbf9 |
713 | =item * |
714 | |
8c35d285 |
715 | I<You MUST SKIP this step for SNAPSHOT, RC> |
716 | |
6e40fbf9 |
717 | Remind the current maintainer of C<Module::CoreList> to push a new release |
718 | to CPAN. |
719 | |
8c35d285 |
720 | =item * |
721 | |
722 | I<You MUST RETIRE to your preferred PUB, CAFE or SEASIDE VILLA for some much-needed |
723 | rest and relaxation>. |
724 | |
725 | Thanks for releasing perl! |
726 | |
7277a900 |
727 | =back |
728 | |
729 | =head1 SOURCE |
730 | |
f6af4394 |
731 | Based on |
732 | http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/2009-05/msg00608.html, |
733 | plus a whole bunch of other sources, including private correspondence. |
7277a900 |
734 | |
735 | =cut |
736 | |