[lucy-commits] svn commit: r1159815 - /incubator/lucy/trunk/devel/bin/release_commands.pl

[ma...@apache.org]

Author: marvin
Date: Fri Aug 19 23:05:02 2011
New Revision: 1159815

URL: http://svn.apache.org/viewvc?rev=1159815&view=rev
Log:
Add some sections which had previously only been documented on the
ReleaseGuide wiki page (because they did not map to clean autogenerated
commands).

Modified:
    incubator/lucy/trunk/devel/bin/release_commands.pl

Modified: incubator/lucy/trunk/devel/bin/release_commands.pl
URL: http://svn.apache.org/viewvc/incubator/lucy/trunk/devel/bin/release_commands.pl?rev=1159815&r1=1159814&r2=1159815&view=diff
==============================================================================
--- incubator/lucy/trunk/devel/bin/release_commands.pl (original)
+++ incubator/lucy/trunk/devel/bin/release_commands.pl Fri Aug 19 23:05:02 2011
@@ -35,28 +35,34 @@ say qq|#################################
 say qq|# Commands needed to execute ReleaseGuide for Apache Lucy $x_y_z_version RC $rc|;
 say qq|#######################################################################\n|;
 
+say qq|# If your code signing key is not already available from pgp.mit.edu|;
+say qq|# and <http://www.apache.org/dist/incubator/lucy/KEYS>, publish it.|;
+say qq|[...]\n|;
+
 if ( $rc < 2 ) {
-    say qq|# Run update_version.|;
+    say qq|# Since this is the first RC, run update_version.|;
     say qq|./devel/bin/update_version $x_y_z_version\n|;
+    say qq|# Update the the CHANGES file and associate release $x_y_z_version with today's date.|;
+    say qq|[...]\n|;
     say qq|# Commit version bump and CHANGES.|;
     say qq|svn commit -m "Updating CHANGES and version number for release $x_y_z_version."\n|;
 }
 
 if ( $micro == 0 && $rc < 2) {
-    say qq|# Branch for non-bugfix release.|;
+    say qq|# Since this is the first release in a series (i.e. X.Y.0), create a branch.|;
     say qq|svn copy https://svn.apache.org/repos/asf/incubator/lucy/trunk |
         . qq|https://svn.apache.org/repos/asf/incubator/lucy/branches/$major.$minor |
         . qq|-m "Branching for $x_y_z_version release"\n|;
 }
 
-say qq|# Tag release candidate.|;
+say qq|# Create a tag for the release candidate.|;
 say
     qq|svn copy https://svn.apache.org/repos/asf/incubator/lucy/branches/$major.$minor |
     . qq|https://svn.apache.org/repos/asf/incubator/lucy/tags/apache-lucy-incubating-$full_rc_version |
     . qq|-m "Tagging release candidate $rc for $x_y_z_version."\n|;
 
 
-say qq|# Export pristine source tree.|;
+say qq|# Export a pristine copy of the source from the release candidate tag.|;
 say qq|svn export https://svn.apache.org/repos/asf/incubator/lucy/tags/apache-lucy-incubating-$full_rc_version |
  . qq|apache-lucy-incubating-$x_y_z_version\n|;
 
@@ -87,6 +93,10 @@ say qq|find . -type f -exec chmod 664 {}
 say qq|find . -type d -exec chmod 775 {} \\;|;
 say qq|chgrp -R incubator *\n|;
 
+say qq|# Perform whatever QC seems prudent on the tarball, installing it|;
+say qq|# on test systems, etc.|;
+say qq|[...]\n|;
+
 say qq|#######################################################################|;
 say qq|# Boilerplate VOTE email for lucy-dev\@incubator.a.o|;
 say qq|#######################################################################\n|;