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 -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/releasing-openacs-core.html 27 Oct 2014 16:39:24 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/releasing-openacs-core.html 7 Aug 2017 23:47:52 -0000 1.21 @@ -1,7 +1,7 @@ -OpenACS Core and .LRN

OpenACS Core and .LRN

  1. Update Translations. the section called “How to Update the translations”

  2. Rebuild the Changelog. Rebuild the Changelog. I use a tool called cvs2cl. Run this command from the package root to automatically generate a Changelog file in the same dir. We generate two changelogs, one for the minor branch and one for the most recent release. The example below is for OpenACS 5.0.2:

    cd /var/lib/aolserver/$OPENACS_SERVICE_NAME
    +OpenACS Core and .LRN

    OpenACS Core and .LRN

    1. Update Translations. the section called “How to Update the translations”

    2. Rebuild the Changelog. Rebuild the Changelog. I use a tool called cvs2cl. Run this command from the package root to automatically generate a Changelog file in the same dir. We generate two changelogs, one for the minor branch and one for the most recent release. The example below is for OpenACS 5.0.2:

      cd /var/lib/aolserver/$OPENACS_SERVICE_NAME
       cvs2cl -F oacs-5-0 --delta openacs-5-0-0-final:oacs-5-0 -f ChangeLog
      -cvs2cl -F oacs-5-0 --delta openacs-5-0-1-final:oacs-5-0 -f ChangeLog-recent
    3. 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. +cvs2cl -F oacs-5-0 --delta openacs-5-0-1-final:oacs-5-0 -f ChangeLog-recent

  3. 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 @@ -28,9 +28,9 @@ for dir in *; do ( cd $dir && cvs tag dotlrn-2-0-2-final ); done for dir in *; do ( cd $dir && cvs tag -F openacs-5-0-compat ); done

      Note that for the compat tag we use the -F flag which will force the tag to the new version (just in - case someone has created the tag already on another version). Excercise care when doing this since + case someone has created the tag already on another version). Exercise care when doing this since you don't want to inadvertently move a prior release tag. Also if the tagging goes horribly wrong - for some reason you can delete the tag via "cvs tag -d <symbolic_tag>".

    6. Apply the final tag across the tree. First, check out the entire OpenACS tree, getting the most recent stable version of each package. This is most simply done on openacs.org:

      cd /var/tmp
      +          for some reason you can delete the tag via cvs tag -d <symbolic_tag>.

    7. Apply the final tag across the tree. First, check out the entire OpenACS tree, getting the most recent stable version of each package. This is most simply done on openacs.org:

      cd /var/tmp
       cvs -d /cvsroot checkout -r openacs-5-1-compat openacs-4
       cd openacs-4
       cvs tag openacs-5-1-2-final
  4. Make the tarball(s). 

    • openacs-core. 

      1. Go to a new working space and export the tagged files.

        mkdir /var/tmp/tarball
        @@ -41,7 +41,7 @@
         
    • dotlrn. 

      1. Go to a new working space and export the tagged files. (was getting errors here trying to use -d, so gave up and just moved things from openacs-4 to - openacs at the end)

        mkdir /var/tmp/dotlrn-tarball
        +                OpenACS at the end)

        mkdir /var/tmp/dotlrn-tarball
         cd /var/tmp/dotlrn-tarball
         cvs -d /cvsroot export -r openacs-5-0-0a1 acs-core
         cd /var/tmp/dotlrn-tarball/openacs-4/packages
        @@ -139,4 +139,4 @@
         
         # Clean up after ourselves...
         cd $BASE && rm -rf dotlrn-tarball tarball openacs-4 dotlrn-packages
        -
        ($Id$)
      View comments on this page at openacs.org
      +
      ($Id$)