Index: openacs-4/packages/acs-core-docs/www/releasing-openacs-core.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/releasing-openacs-core.html,v diff -u -N -r1.11.2.6 -r1.11.2.7 --- openacs-4/packages/acs-core-docs/www/releasing-openacs-core.html 9 Jan 2006 01:28:54 -0000 1.11.2.6 +++ openacs-4/packages/acs-core-docs/www/releasing-openacs-core.html 16 Jan 2006 18:59:44 -0000 1.11.2.7 @@ -3,27 +3,12 @@ cvs2cl -F oacs-5-0 --delta openacs-5-0-1-final:oacs-5-0 -f ChangeLog-recent
  • Update Version Numbers.�The version numbers in the documentation and in the packages must be updated. This should only happen after a release candidate is approved.

    .LRN: this must be repeated for .LRN modules (dotlrn-core in the dotlrn cvs tree) and for any modified modules in the .LRN prerequisites (dotlrn-prereq in openacs cvs tree). My current working model is that I bulk-update .LRN and OpenACS core but that I don't touch dotlrn-prereq modules - I just use the most recent release and it's up to individual package developers to tag and release those packages when they change. This model is already broken because following it means that dotlrn-prereqs don't get new translations.

    1. Update /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/xml/variables.ent with the new version number.

    2. Add new section in /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml

    3. Regenerate all HTML docs

      cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/xml
      -make
    4. Update /var/lib/aolserver/$OPENACS_SERVICE_NAME/readme.txt with the new version number

    5. Update version number and release date in all of the core packages. Here's a bash/perl script which works but could be made easier to use. (It depends on all of the old versions and dates being identical.) Run it from /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages:

      #!/bin/sh
      -# run this file from ../packages to renumber all .info version numbers
      -
      -#---------------------------------------------------------------------
      -# here's what we're looking for
      -#---------------------------------------------------------------------
      -#   <version name="5.1.0d1" url="http:blahblah/acs-kernel-5.1.0d1.apm">
      -#      <provides url="acs-kernel" version="5.1.0d1"/>
      -#---------------------------------------------------------------------
      -# here's what we don't want to touch
      -#---------------------------------------------------------------------
      -#      <requires url="acs-kernel" version="5.0.0b4"/>
      -#---------------------------------------------------------------------
      -
      -for dir in `find -name *.info`
      -  do
      -  perl -p -i -e 's/name="5\.0\.0"/name="5\.1\.0d1"/' $dir
      -  perl -p -i -e 's/-5\.0\.0.apm"/-5\.1\.0d1.apm"/' $dir
      -  perl -p -i -e 's/(provides.*version)="5\.0\.0"/\1="5\.1\.0d1"/' $dir
      -  perl -p -i -e 's/2004-10-21/2004-11-26/' $dir
      -done
    6. Install a new site using the modified code and verify that the automated tests pass.

    7. Commit changes to CVS

  • Tag the files in CVS.�The steps to this point should have ensured that the head of the current branch contains the full set of code to release. Now we need to tag it as the code to be released.

    1. Check out OpenACS Core. The files must be checked +make

    2. Update /var/lib/aolserver/$OPENACS_SERVICE_NAME/readme.txt with the new version number

    3. Update version number and release date in all of the + core packages. Use + /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/update-info.sh + with the new version number and the release date as arguments. + Run it from /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages:

      cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages
      +       ./acs-core-docs/www/files/update-info 5.2.1 2006-01-16
    4. Install a new site using the modified code and verify that the automated tests pass.

    5. Commit changes to CVS

  • Tag the files in CVS.�The steps to this point should have ensured that the head of the current branch contains the full set of code to release. Now we need to tag it as the code to be released.

    1. Check out OpenACS Core. The files must be checked out through a cvs account with write access and should be a checkout from the release branch. In this example, we are assuming this is being done as a local user on openacs.org (which make the Index: openacs-4/packages/acs-core-docs/www/xml/releasing-openacs.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/releasing-openacs.xml,v diff -u -N -r1.19 -r1.19.2.1 --- openacs-4/packages/acs-core-docs/www/xml/releasing-openacs.xml 13 Jan 2005 13:55:16 -0000 1.19 +++ openacs-4/packages/acs-core-docs/www/xml/releasing-openacs.xml 16 Jan 2006 18:59:44 -0000 1.19.2.1 @@ -50,28 +50,13 @@ Update /var/lib/aolserver/$OPENACS_SERVICE_NAME/readme.txt with the new version number - Update version number and release date in all of the core packages. Here's a bash/perl script which works but could be made easier to use. (It depends on all of the old versions and dates being identical.) Run it from /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages: - #!/bin/sh -# run this file from ../packages to renumber all .info version numbers - -#--------------------------------------------------------------------- -# here's what we're looking for -#--------------------------------------------------------------------- -# <version name="5.1.0d1" url="http:blahblah/acs-kernel-5.1.0d1.apm"> -# <provides url="acs-kernel" version="5.1.0d1"/> -#--------------------------------------------------------------------- -# here's what we don't want to touch -#--------------------------------------------------------------------- -# <requires url="acs-kernel" version="5.0.0b4"/> -#--------------------------------------------------------------------- - -for dir in `find -name *.info` - do - perl -p -i -e 's/name="5\.0\.0"/name="5\.1\.0d1"/' $dir - perl -p -i -e 's/-5\.0\.0.apm"/-5\.1\.0d1.apm"/' $dir - perl -p -i -e 's/(provides.*version)="5\.0\.0"/\1="5\.1\.0d1"/' $dir - perl -p -i -e 's/2004-10-21/2004-11-26/' $dir -done + Update version number and release date in all of the + core packages. Use + /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/update-info.sh + with the new version number and the release date as arguments. + Run it from /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages: + cd /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages + ./acs-core-docs/www/files/update-info 5.2.1 2006-01-16 Install a new site using the modified code and verify that the automated tests pass.