cvs: php-src / README.RELEASE_PROCESS
| From: | Lukas Smith | Date: | Thu, 22 Nov 2007 08:58:32 +0000 |
| Subject: | cvs: php-src / README.RELEASE_PROCESS | ||
| Groups: | php.cvs | ||
| Request: | Send a blank email to php-cvs+get-47275@lists.php.net to get a copy of this message | ||
lsmith Thu Nov 22 08:58:32 2007 UTC
Added files:
/php-src README.RELEASE_PROCESS
Log:
- port from todo wiki to reST (http://wiki.pooteeweet.org/ReleaseChecklist)
http://cvs.php.net/viewvc.cgi/php-src/README.RELEASE_PROCESS?view=markup&rev=1.1
Index: php-src/README.RELEASE_PROCESS
+++ php-src/README.RELEASE_PROCESS
=======================
PHP Release Process
=======================
Rolling a release candidate
---------------------------
1. Check windows snapshot builder logs (http://snaps.php.net/win32/snapshot-STABLE.log f.e.)
2. Bumb the version numbers in `
main/php_version.h,
configure.in and possibly NEWS`.
3. Commit those changes
4. tag the repository with "`cvs tag php_4_4_1RC1`" (of course, you need to
change that to the version you're rolling an RC for). When making 5.X release, you need to tag
the Zend directory separately!!
5. Bumb up the version numbers in `main/php_version.h,
configure.in and possibly NEWS again, to the
**next** version. F.e. if the release candidate was "4.4.1RC1" then the new one should be
"4.4.1RC2-dev" - regardless if we get a new RC or not. This is to make sure
version_compare()` can correctly work.
6. Commit those changes
7. Log in onto the snaps box and go into the correct tree (f.e. the PHP_4_4 branch if you're
rolling 4.4.x releases).
8. You do not have to update the tree, but ofcourse you can with "`cvs up
-dP`".
9. run: `./makedist php 4.4.1RC1`, this will export the tree, create configure and
build two tarballs (one gz and one bz2).
10. Copy those two tarballs to www.php.net, in your homedir their should be a directory
"downloads/". Copy them into there, so that the system can generate MD5 sums. If you do
not have this directory, talk to Derick.
11. Now the RC can be found on http://downloads.php.net/yourname, f.e. http://downloads.php.net/derick/
12. Once the release has been tagged, contact Edin Kadribasic (edink @ usual php e-mail) so that
Windows binaries can be created. Once those are made, they should be placed into the same directory
as the source snapshots.
Getting the Release Candidate out there
---------------------------------------
1. Send an email (see example here: http://news.php.net/php.internals/19486) **To**
`internals@lists.php.net and php-general@lists.php.net` lists
pointing out "the location of the release" and "the possible release date of either
the next RC, or the final release".
2. Send an email (see example here http://news.php.net/php.qa/26069) **To**
`php-qa@lists.php.net` and **Bcc** everybody on the PhP4yz, PhP5yz or PhP6yz list
(depending on the PHP version). This email is to notify the selected projects about a new RC so that
they can make sure their projects keep working.
3. Update the MD5 sums in `qaweb/include/rc-md5sums.txt`.
4. Update in `qaweb/include/release-qa.php` constants with the new RC and commit this.
a. `$BUILD_TEST_RELEASES` = array("4.4.7RC1", "5.2.2RC1")
b. `$CURRENT_QA_RELEASE_4 = "4.4.7RC1"
($CURRENT_QA_RELEASE_5` for PHP5)
c. `$RELEASE_PROCESS` = array(4 => true, 5 => true)
1. Update in `php-bugs-web/include/functions.inc the
show_version_option` function to include the new RC and commit.
2. Run the bumpRelease script for phpweb
a. `php bin/bumpRelease 5 (or php bin/bumpRelease 4` for
PHP4)
3. Update `phpweb/include/version.inc` (x=major version number)
a. `$PHP_x_RC` = "5.3.0RC1"
b. `$PHP_x_RC_DATE` = "06 September 2007"
4. Commit those changes:
a. `cvs commit include/version.inc include/releases.inc`
Rolling a release
-----------------
1. Check windows snapshot builder logs (http://snaps.php.net/win32/snapshot-STABLE.log f.e.)
2. Bumb the version numbers in `main/php_version.h,
configure.in and possibly NEWS`.
3. **Merge** all related sections in NEWS (f.e. merge the 4.4.1RC1 and 4.4.0 sections)
4. Commit those changes
5. tag the repository with "`cvs tag php_4_4_1`" (of course, you need to
change that to the version you're rolling an RC for). When making 5.X release, you need to tag
the Zend directory separately!!
6. Bumb up the version numbers in `main/php_version.h,
configure.in and possibly NEWS again, to the
**next** version. F.e. if the release candidate was "4.4.1RC1" then the new one should be
"4.4.1RC2-dev" - regardless if we get a new RC or not. This is to make sure
version_compare()` can correctly work.
7. Commit those changes
8. Log in onto the snaps box and go into the correct tree (f.e. the PHP_4_4 branch if you're
rolling 4.4.x releases).
9. You do not have to update the tree, but ofcourse you can with "`cvs up
-dP`".
10. run: `./makedist php 4.4.1`, this will export the tree, create configure and build
two tarballs (one gz and one bz2).
11. Commit those two tarballs to CVS (phpweb/distributions)
12. Once the release has been tagged, contact Edin Kadribasic (edink @ usual php e-mail) so that
Windows binaries can be created. Once those are made, they should be committed to CVS too.
13. Check if the pear files are updated (phar for 5.1+ or run pear/make-pear-bundle.php with 4.4)
14. When making a final release, also remind Edin to ask John to prepare the installer packages for
Win32.
Getting the Release out there
-----------------------------
1. Run the bumpRelease script for phpweb
a. `php bin/bumpRelease 5 (or php bin/bumpRelease 4` for
PHP4)
2. Edit `phpweb/include/version.inc` and change (X=major release number):
a. `$PHP_X_VERSION` to the correct version
b. `$PHP_X_DATE` to the release date
c. `$PHP_X_MD5` array and update all the md5 sums
d. set `$PHP_X_RC` to false!
e. Make sure there are no outdated "notes" or edited "date" keys in the
`$RELEASES[X][$PHP_X_VERSION]["source"]` array
f. if the windows builds aren't ready yet prefix the "windows" key with a dot
(".windows")
3. Update the ChangeLog file `ChangeLog-4.php` from the NEWS file
a. go over the list and put every element on one line
b. check for &, < and > and escape them if necessary
c. remove all the names at the ends of lines
d. for marking up, you can do the following (with VI):
I. `s/^- /<li>/`
II. `s/$/<\/li>/`
III. `s/Fixed bug #\([0-9]\+\)/<?php bugfix(\1); ?>/`
4. `cp releases/4_4_0.php releases/4_4_1.php`
5. `cvs add releases/4_4_1.php`
6. Update the releases/*.php file with relevant data. The release announcement file should list in
detail:
a. security fixes,
b. changes in behaviour (whether due to a bug fix or not)
7. Add a short notice to phpweb stating that there is a new release, and highlight the major
important things (security fixes) and when it is important to upgrade.
a. php bin/createNewsEntry
8. Commit all the changes, do not release on Fridays, Saturdays or Sundays because the sysadmins can
not upgrade stuff then.
9. Wait an hour or two, then send a mail to php-announce@lists.php.net, php-general@lists.php.net
and internals@lists.php.net with a text similar to http://news.php.net/php.internals/17222.
10. Update `php-bugs-web/include/functions.php` to include the new version number, and
remove the RC from there.
11. Update `qaweb/include/release-qa.php`
a. Update the $BUILD_TEST_RELEASES array with the release name
b. Update $RELEASE_PROCESS array (set to false)
I. For PHP4: Set $CURRENT_QA_RELEASE_4 to false
II. For PHP5: Set $CURRENT_QA_RELEASE_5 to false
12. Rebuild the English and Japanese docs (ask Derick)