From 5e4671ab839f3eea6a2747c0295a1b76472412ac Mon Sep 17 00:00:00 2001 From: acolyer Date: Thu, 17 Apr 2003 19:01:19 +0000 Subject: [PATCH] Release checklist --- build/release-checklist.txt | 244 ++++++++++++++++++++++++++++++++++++ 1 file changed, 244 insertions(+) create mode 100644 build/release-checklist.txt diff --git a/build/release-checklist.txt b/build/release-checklist.txt new file mode 100644 index 000000000..59c4f8dc3 --- /dev/null +++ b/build/release-checklist.txt @@ -0,0 +1,244 @@ +================================================================================ + Checklist for Preparing an AspectJ Release +================================================================================ + +Create a fresh copy of this file, and then record your progress in the file and +save it as part of the release notes on completion. + +Before you begin... you will need: +================================================================================ + +* A JDK v1.4.x java -fullversion : [ ] +* A JDK v1.3.x java -fullversion : [ ] +* A 1.1.8 JRE version : [ ] +* A Windoze box OS version : [ ] +* A Linux box distribution : [ ] +* An iMac (nice-to-have) JDK 1.4.x : [ ] +* Eclipse version : [ ] + +* A pair of scissors (get an adult to help you with these) +* Some sticky-backed plastic + +OK, so the last two aren't strictly necessary, but they always seem to come in +useful on the telly. + +Extraction: +================================================================================ + +* Full CVS extract of org.aspectj/modules [ ] + date and time of extract : [ ] + +Preparation: +================================================================================ + +* Create a new directory under releases for this release [ ] + (e.g. releases/aspectj-1.1rc1) + +* Save a copy of this file there as package-and-test-notes.txt [ ] + +* Edit build/build-properties.xml and set the version properties for this + release [ ] + + e.g. + + + + + + +* Edit org.aspectj.ajdt.core/src/org.aspectj.ajdt.ajc/messages.properties and + set the version properties for this release [ ] + + e.g. + + ### AspectJ-specific messages + configure.version = AspectJ Compiler 1.1rc1 + configure.directoryNotExist = invalid option or directory does not exist: {0} + ## 3456789012345678901234567890123456789012345678901234567890123456789012345 + ### miscellaneous + misc.usage = AspectJ Compiler 1.1 release candidate 1\n\ + ... + +Build: +================================================================================ + +* Ensure JAVA_HOME is set to point to your 1.3 JDK [ ] + echo $JAVA_HOME [ ] + + (even when you "Run Ant..." from eclipse, the value of JAVA_HOME is + used rather than the JRE specified in your Eclipse settings). + +* Run ant on build/build.xml : + + - ant clean [ ] + - ant [ ] + - ant clean [ ] + - ant [ ] + + (we do this twice to ensure any changes to the build module itself made + in the first pass are used on the second pass). + +* Save the build output (console log) as build.log [ ] + (e.g. build1.1rc1.log) + +* Save the built jar as aspectj-.jar [ ] + +Pre-installation tests: +================================================================================ + +* run junitModules.xml tests + + - "Run Ant..." on tests/junitModules.xml, using the property tab to set + property "aspectjrt.path= + /workspace/aj-build/dist/tools/lib/aspectjrt.jar" + + -- target = clean [ ] + -- target = default [ ] + + - Record any failures here (should be none) + + - Save the test results as junitModules.report.zip [ ] + (zip of eclipse/workspace/tests/bin/junitXmlOutput/html) + + +* run Harness tests on the 1.3 vm (ajcTests.xml): + + - run org.aspectj.testing.drivers.Harness with args -logFail -release + ajcTests.xml [ ] + + -- save results in ajcTests-result-.txt [ ] + (e.g. ajcTests-result-1.1rc1.txt) + + -- record any failures (should be none) inline here. + + - run org.aspectj.testing.drivers.Harness with args + -logFail -release -emacssym ajcTests.xml [ ] + + -- save results in ajcTests-result--emacssym.txt [ ] + (e.g. ajcTests-result-1.1rc1.txt) + + -- record any failures (should be none) inline here. + +* run Harness tests on the 1.4 vm: + + - run org.aspectj.testing.drivers.Harness with args -logFail -release + ajcTests.xml [ ] + + -- save results in ajcTests-result--JDK14.txt [ ] + (e.g. ajcTests-result-1.1rc1.txt) + + -- record any failures (should be none) inline here. + + - run org.aspectj.testing.drivers.Harness with args + -logFail -release -emacssym ajcTests.xml [ ] + + -- save results in ajcTests-result--emacssym-JDK14.txt [ ] + (e.g. ajcTests-result-1.1rc1.txt) + + -- record any failures (should be none) inline here. + +* run Harness on ajcTestsFailing.xml + + - run org.aspectj.testing.drivers.Harness with args -logFail -release + ajcTestsFailing.xml [ ] + + -- save results in ajcTestsFailing-result-.txt [ ] + (e.g. ajcTestsFailing-result-1.1rc1.txt) + + -- record any failures inline here (should be none -ie ajcTestsFailing + should be empty for a final release, known exceptions are + permissible for a non-final release). + +Installation & Verification Tests +================================================================================ + +* install from aspectj-.jar as built above + + - verify version number and build date on splash screen [ ] + + - save screenshot of splash screen (not essential) as [ ] + Installer-Splash-Screen.bmp (file format may vary) + +* verify directory structure created ok [ ] + +* check version in README-AspectJ.html [ ] + +* check version in README-11.html [ ] + +* check license present and correct version (currently CPLv1.0) [ ] + +* run "ajc -version", verify version info [ ] + +* run "ajc", verify version info [ ] + +* from doc/examples, run "ant", verify spacewar builds and runs ok [ ] + +* in doc/examples, build ant targets as follows: + - bean [ ] + - intro [ ] + - intro-clone [ ] + - intro-compare [ ] + - intro-hash [ ] + - observer [ ] + - spacewar [ ] + - spacewar-demo [ ] + - telecom [ ] + - telecom-billing [ ] + - telecom-timing [ ] + - tjp [ ] + - tracing-1 [ ] + - tracing-2 [ ] + - tracing-3 [ ] + - tracing-bc [ ] + - tracing-none [ ] + +* run pre-compiled version of spacewar on a 1.1.8 vm [ ] + +* verify debug info included in class files + - "javap -l org.aspectj.tools.ajc.Main" under jdk 1.4 or later [ ] + +* verify ant-tasks.html has correct date and version info [ ] + +* verify manual dates correct in docs [ ] + +* verify api docs present and correct [ ] + +Cross-Platform Testing +================================================================================ + +(Assuming prior tests were done under windows) + +* Install, build and run spacewar on Linux [ ] + +* Install, build and run spacewar on Mac OS X [ ] + +Other Release Objectives +================================================================================ + +Record any other details or release specific objectives test results here. + +Release +================================================================================ + +Once developer consensus is reached on the build: + +* commit all releases/aspectj-/*.* files created during + this process [ ] + +* tag /home/technology/org.aspectj as vM_m_r_XX (e.g. v1_1_0_RC1) [ ] + +* post aspectj-.jar to + download.eclipse.org/technology/ajdt/aspectj-.jar [ ] + +* download from + http://download.eclipse.org/technology/ajdt/aspectj-.jar + and install [ ] + +* post news article on project home page [ ] + +* post link on download page [ ] + +* post announce message to aspectj-users, aspectj-announce, + aosd-discuss, aosd-announce [ ] + +* buy beer [ ] -- 2.39.5