Author: gozer Date: Fri Mar 23 13:03:34 2007 New Revision: 521890 URL: http://svn.apache.org/viewvc?view=rev&rev=521890 Log: Since no releases have been made in a while, there was some tidying up needed. Copied over and adapeted the RELEASE instructions from the 2.x branch as well.
Added: perl/modperl/branches/1.x/RELEASE Modified: perl/modperl/branches/1.x/Changes perl/modperl/branches/1.x/MANIFEST perl/modperl/branches/1.x/Makefile.PL perl/modperl/branches/1.x/lib/mod_perl.pm Modified: perl/modperl/branches/1.x/Changes URL: http://svn.apache.org/viewvc/perl/modperl/branches/1.x/Changes?view=diff&rev=521890&r1=521889&r2=521890 ============================================================================== --- perl/modperl/branches/1.x/Changes (original) +++ perl/modperl/branches/1.x/Changes Fri Mar 23 13:03:34 2007 @@ -8,7 +8,7 @@ =over 3 -=item 1.30_01-dev +=item 1.30-dev SECURITY: CVE-2007-1349 (cve.mitre.org) fix unescaped variable interpolation in Apache::PerlRun Modified: perl/modperl/branches/1.x/MANIFEST URL: http://svn.apache.org/viewvc/perl/modperl/branches/1.x/MANIFEST?view=diff&rev=521890&r1=521889&r2=521890 ============================================================================== --- perl/modperl/branches/1.x/MANIFEST (original) +++ perl/modperl/branches/1.x/MANIFEST Fri Mar 23 13:03:34 2007 @@ -37,13 +37,13 @@ Log/Log.pm Log/Makefile.PL MANIFEST -META.yml Makefile.PL ModuleConfig/Makefile.PL ModuleConfig/ModuleConfig.pm PerlRunXS/Makefile.PL PerlRunXS/PerlRunXS.pm README +RELEASE STATUS SUPPORT Server/Makefile.PL Modified: perl/modperl/branches/1.x/Makefile.PL URL: http://svn.apache.org/viewvc/perl/modperl/branches/1.x/Makefile.PL?view=diff&rev=521890&r1=521889&r2=521890 ============================================================================== --- perl/modperl/branches/1.x/Makefile.PL (original) +++ perl/modperl/branches/1.x/Makefile.PL Fri Mar 23 13:03:34 2007 @@ -69,8 +69,8 @@ local *FH; open FH, "Changes"; while (<FH>) { - if (/^=item.*-dev/) { - $VERSION .= "-dev"; + if (/^=item.*-(dev|rc\d+)/) { + $VERSION .= "-$1"; last; } last if /^=item/; Added: perl/modperl/branches/1.x/RELEASE URL: http://svn.apache.org/viewvc/perl/modperl/branches/1.x/RELEASE?view=auto&rev=521890 ============================================================================== --- perl/modperl/branches/1.x/RELEASE (added) +++ perl/modperl/branches/1.x/RELEASE Fri Mar 23 13:03:34 2007 @@ -0,0 +1,208 @@ +Instructions for mod_perl 1.x Release Manager + +0. make sure your public key is in the KEYS file in the mod_perl docs. + you should only need to do this if this is your first time playing + Release Manager + + $ cd mod_perl-docs + $ grep $USER src/dist/KEYS + + note that the KEYS file itself contains all the instructions you + need on how to add your key. if you need further help on gpg + (like how to create a key in the first place) you can look here + + http://people.apache.org/~geoff/gpghowto.html + + Copy the KEYS file into place: + % scp KEYS www.apache.org:/www/www.apache.org/dist/perl/KEYS + + If this is your first release, ask someone with APML karma on PAUSE + to verify you have the appropriate permissions. Likely someone on + the PMC can do this. + + a. login into https://pause.perl.org + b. menu click: Select Mailinglist/Action + c. choose APML and share_perms and click go + d. click 3.1 Make somebody else co-maintainer + e. choose the modules to give the perms to + type the username of the new co-maintainer + f. if you happen to know that packages were added this release, + make sure you give the correct permissions to them. + +1. 'make dist' - to make sure nothing is missing from the manifest, + etc. Now test this generated package mod_perl-1.30-dev.tar.gz (not + the current build) with as many + configurations as possible on as many platforms as possible, + unpacking the package each time afresh. + + a. edit ./Changes + - change -dev to -rc\d+ starting with -rc1 + + b. nuke any preinstalled mod_perl libs and run 'make test' + + c. test that you can 'make install' and then run 'make test' again + + e. build and test as root. double check that you have started from a + fresh source, without having any stale dirs from the previous + build laying around. + +2. once confident that the package is good, upload a release candidate + to people.apache.org/~username and post 24 hour-ish candidate alert + to the modperl/dev list (may be longer to give most people a chance + to catch up). no need to tag this package + + Subject: [RELEASE CANDIDATE]: mod_perl-1.30 RC\d+ + +2a. if problems are detected during stage 2, repeat stages 1 and 2. + +3. when the package has been reported to be good, prepare a new + package to be released + + a. edit ./Changes: + - remove -rc\d+ + - add release date + + b. rerun: + % perl Makefile.PL + make sure tag looks right + % make -n tag + + c. commit Changes README Makefile.PL + % svn ci Changes README Makefile.PL + + d. tag + % make tag + + e. create the final package + % make dist + + f. test the final package again at least once + +4. Release the package and update links (e.g. mod_perl-1.30.tar.gz) + + a. upload to www.apache.org:/www/perl.apache.org/dist/ + + % scp mod_perl-1.30.tar.gz perl.apache.org:/www/perl.apache.org/dist/ + + b. ssh to perl.apache.org, unpack the package, update symlinks to the + tar ball and unpacked distro: + + % ssh perl.apache.org + % cd /www/perl.apache.org/dist/ + % ln -sf mod_perl-1.30.tar.gz mod_perl-1.0-current.tar.gz + % tar -xzvf mod_perl-1.30.tar.gz + % rm /www/perl.apache.org/dist/mod_perl-1.0-current + % ln -sf mod_perl-1.30 mod_perl-1.0-current + + c. archive older releases (keep current + one prior release) + + % mv /www/perl.apache.org/dist/mod_perl-1.28.tar.gz \ + /www/perl.apache.org/dist/old + % mv /www/perl.apache.org/dist/mod_perl-1.29.tar.gz.asc \ + /www/perl.apache.org/dist/old + % rm -rf /www/perl.apache.org/dist/mod_perl-1.28 + + d. update the version and release date + modperl-docs/src/download/index_top.html and commit. It'll be + automatically updated within 6 hours. Alternatively you can do a + manual update by logging into www.apache.org and running: + + % /home/perlwww/apache.org/modperl-docs/bin/site_build + + e. update our projects.apache.org doap file with the new release + version and date + + % vi modperl-docs/doap_Perl.rdf + +5. Upload the package to CPAN + +6. Tarball signing + + (depending on whether you use GPG or PGP, pick the first or the + second set of the commands): + + a. sign your local copy of the tarball: + + % gpg --detach-sign --armor mod_perl-1.30.tar.gz + + % pgps -b --armor mod_perl-1.30.tar.gz + + b. upload the generated sig file to www.apache.org: + + % scp mod_perl-1.30.tar.gz.asc perl.apache.org:/www/perl.apache.org/dist/ + % ssh www.apache.org + % cd /www/perl.apache.org/dist/ + % chmod 0664 mod_perl-1.30.tar.gz.asc + % ln -sf mod_perl-1.30.tar.gz.asc mod_perl-1.0-current.tar.gz.asc + + c. ask one of the other developers to double check the signature file + and tarball: download both files and verify the signature: + + http://perl.apache.org/dist/mod_perl-1.30.tar.gz.asc + http://perl.apache.org/dist/mod_perl-1.30.tar.gz + + % gpg --verify mod_perl-1.30.tar.gz.asc + + % pgpv mod_perl-1.30.tar.gz.asc + + d. make sure that the files you just created are group rw so + all the dist admins can make changes: + + % find /www/perl.apache.org/dist/ -user $USER -type f -exec chmod 0664 {} \; + % find /www/perl.apache.org/dist/ -user $USER -type d -exec chmod 0775 {} \; + +7. Distribute to www.apache.org/dist/perl + and archive the old package under /www/archive.apache.org/dist/perl/ + + a. unpack the package, update symlinks to the tarball and unpacked distro: + + % cd /www/www.apache.org/dist/perl/ + % cp /www/perl.apache.org/dist/mod_perl-1.30.tar.gz* . + % tar -xzvf mod_perl-1.30.tar.gz + % mv mod_perl-1.29.tar.gz* /www/archive.apache.org/dist/perl/ + % rm -rf mod_perl-1.29 + + b. make sure that the files you just created are group rw so + + all the dist admins can make changes: + + % find /www/www.apache.org/dist/ -user $USER -type f -exec chmod 0664 {} \; + % find /www/www.apache.org/dist/ -user $USER -type d -exec chmod 0775 {} \; + +8. Announce the package + + a. post ... to the modperl, announce lists + Note, to post to announce@, you must be sending from an apache.org address. + Subject: [ANNOUNCE] mod_perl 1.30 + include + - link at perl.apache.org: + http://apache.org/dist/perl/mod_perl-1.30.tar.gz + http://apache.org/dist/perl/mod_perl-1.30.tar.gz.asc (pgp sig) + - MD5 sig (as it comes from CPAN upload announce). + - the latest Changes + +9. Prepare for the next cycle + + a. increment version in lib/mod_perl.pm + + b. edit ./Changes: + - start a new item with incremented version + '-dev' + + =item 1.31-dev + + c. add a release entry in STATUS + + d. update this file versions to make it easy to copy-n-paste things + on the next release: + + $ perl -pi -e 's/1\.(\d+)/join(".", 1, $1+1)/eg' RELEASE + + e. commit the changed files + + % svn ci -m "start 1.31-dev cycle" Changes lib/mod_perl.pm \ + STATUS RELEASE + +10. Old Versions + + Remind other Developers to delete versions older then the prior release + from CPAN. Old releases can always be found on BackPan. Modified: perl/modperl/branches/1.x/lib/mod_perl.pm URL: http://svn.apache.org/viewvc/perl/modperl/branches/1.x/lib/mod_perl.pm?view=diff&rev=521890&r1=521889&r2=521890 ============================================================================== --- perl/modperl/branches/1.x/lib/mod_perl.pm (original) +++ perl/modperl/branches/1.x/lib/mod_perl.pm Fri Mar 23 13:03:34 2007 @@ -4,7 +4,7 @@ use DynaLoader (); BEGIN { - $mod_perl::VERSION = "1.3001"; + $mod_perl::VERSION = "1.30"; } sub boot {