Changes between Version 49 and Version 50 of ReleaseProcedure


Ignore:
Timestamp:
Nov 15, 2009, 10:55:23 PM (14 years ago)
Author:
Peter
Comment:

updated RP (refs #574)

Legend:

Unmodified
Added
Removed
Modified

  • ReleaseProcedure

    v49 v50  
    4242m4_define([YAT_LT_VERSION_INFO], [c:r:a])
    4343}}}
     44 1. Add a line in NEWS
     45{{{
     46See the end for copyrights and conditions.
     47
     48+yat A.B.x series from http://dev.thep.lu.se/yat/svn/branches/A.B-stable
     49+
     50Version A.B (released NOT YET)
     51}}}
     52 commit the changes with `svn ci -m "preparing branch A.B-stable"`[[br]][[br]]
    4453 1. Update copyright statements with command:
    4554{{{
    4655svndigest --copyright --no-report -v
    4756}}}
    48  (The `--no-report` option works with svndigest 0.7 and later, for earlier version omit the option.) Examine the updates and commit changes with `svn ci -m "updating copyright statements"`.
    49  For this step [http://dev.thep.lu.se/svndigest svndigest] is obviously needed.[[br]][[br]]
     57 (The `--no-report` option works with svndigest 0.7 and later, for
     58 earlier version omit the option.) Examine the updates and commit
     59 changes with `svn ci -m "updating copyright statements"`.  For this
     60 step [http://dev.thep.lu.se/svndigest svndigest] is obviously
     61 needed.[[br]][[br]]
     62 1. Make a copy of trunk WC including svndigest cache
     63{{{
     64cp /path/to/yat-trunk /path/to/yat-A.B.x
     65}}}
    5066 1. Create a new minor branch using a one liner like
    5167{{{
    … …  
    5470    -m "New minor version A.B branch"
    5571}}}
     72 1. Switch the new WC to follow new branch
     73{{{
     74cd /path/to/yat-A.B.x/
     75svn switch http://dev.thep.lu.se/yat/svn/branches/A.B-stable
     76cd /path/to/yat-trunk/
     77}}}
    5678 1. Prepare the trunk for the next minor release [[br]][[br]]
    5779  i. Update version number in `m4/version.m4`. Locate and change the
    … …  
    6385  i. Add an entry in `NEWS`
    6486{{{
    65 version A.[B+1] (released DATE)
     87version A.[B+1] (released NOT YET)
    6688}}}
    6789     The date is set when version A.[B+1] is released. [[br]][[br]]
    6890  i. Commit changes to the repository,
    69      `svn ci -m "Changes for future release A.[B+1]"` [[br]][[br]]
     91     `svn ci -m "Bumping VERSION to A.[B+1]"` [[br]][[br]]
    7092 1. When someone with access to documentation site has time available,
    7193 they will upgrade to the new branch. This person is usually not the
    … …  
    89111m4_define([YAT_LT_VERSION_INFO], [c:r:a])
    90112}}}
    91      appropriately. Refer to the interface version list in `m4/version.m4` to figure out the settings of c, r, and a. c should increase with 1 if the interface has changed. If the interface is changed, r should be set to zero and a should be set to reflect backward compatibility level of this version. If interface was not changed just increase r with 1. See `m4/version.m4` and the [http://www.gnu.org/software/libtool/manual/html_node/Versioning.html#Versioning libtool manual] for details.[[br]][[br]]
     113     appropriately. Refer to the interface version list in
     114     `m4/version.m4` to figure out the settings of c, r, and a. c
     115     should increase with 1 if the interface has changed. If the
     116     interface is changed, r should be set to zero and a should be set
     117     to reflect backward compatibility level of this version. If
     118     interface was not changed just increase r with 1. See
     119     `m4/version.m4` and the
     120     [http://www.gnu.org/software/libtool/manual/html_node/Versioning.html#Versioning
     121     libtool manual] for details.[[br]][[br]]
    92122  i. Update `THANKS`. Remember, ego and vanity is the currency of open
    93123     source projects. Well, there are other reasons for open source
    … …  
    113143    Run
    114144{{{
     145make all
    115146make release
    116147}}}
    117     If everything is OK, attach the new package to the DownloadPage, else start over.[[br]][[br]]
    118  1. Create a tag, but first check that you are synchronized with repository
     148    Fix potential problems.[[br]][[br]]
     149 1. Check that you are synchronized with repository
    119150{{{
    120151svn status -q -u
    … …  
    135166  i. Add an entry in `NEWS`
    136167{{{
    137 version A.B.1 (released DATE)
     168version A.B.1 (released NOT YET)
    138169}}}
    139170     The date is set when version A.B.1 is released. [[br]][[br]]
    140171  i. Commit changes to the repository,
    141      `svn ci -m "Changes for future release A.B.1"` [[br]][[br]]
     172     `svn ci -m "Bumping VERSION to A.B.1"` [[br]][[br]]
     173 1. Upload `yat-A.B.tar.gz` and md5 file to Downloadpage [[br]][[br]]
    142174 1. Update DownloadPage and [wiki:WikiStart WikiStart][[br]][[br]]
    143175  i. Update the section '''Latest stable release''' to reflect the new
    … …  
    174206    minimize the risk of loosing fixes, this step is only performed by
    175207    the ''Merge Master''. [[br]][[br]]
    176   i. Switch to the trunk or checkout a pristine version of the trunk.
    177 {{{
    178 svn switch http://dev.thep.lu.se/yat/svn/trunk
    179 
    180 }}}
    181      or
    182 {{{
    183 svn checkout http://dev.thep.lu.se/yat/svn/trunk trunk_merge
    184 cd trunk_merge
     208  i. Go to a pristine trunk WC
     209{{{
     210cd /path/to/yat-trunk/
     211svn update
     212svn status -q
    185213}}}
    186214  i. Merge changes into trunk. In this example the difference between a
    … …  
    197225  i. Commit changes to the trunk branch.
    198226{{{
    199 svn commit -m "Merged patch release A.B to the trunk. Delta A.B - A.B@fork_revision"
    200 }}}
    201     Remove `trunk_merge` if it was created. [[br]][[br]]
     227svn commit -m "Merged release A.B to the trunk. Delta A.B - A.B@fork_revision"
     228}}}
    202229
    203230
    … …  
    236263    Run
    237264{{{
     265make all
    238266make release
    239267}}}
    240     If everything is OK, attach the new package to the DownloadPage, else start over.[[br]][[br]]
     268    Fix potential problems.[[br]][[br]]
    241269 1. Create a tag, but first check that you are synchronized with repository
    242270{{{
    … …  
    261289m4_define([YAT_LT_VERSION_INFO], [c:r+1:a])
    262290}}}
    263      i.e., only raise the revision number since the interface will not change. See the [http://www.gnu.org/software/libtool/manual/html_node/Versioning.html#Versioning libtool manual] for details.[[br]][[br]]
     291     i.e., only raise the revision number since the interface will not
     292     change. See the
     293     [http://www.gnu.org/software/libtool/manual/html_node/Versioning.html#Versioning
     294     libtool manual] for details.[[br]][[br]]
    264295  i. Add an entry in `NEWS`
    265296{{{
    … …  
    268299     The date is set when version A.B.[C+1] is released. [[br]][[br]]
    269300  i. Commit changes to the repository,
    270      `svn ci -m "Changes for future release A.B.[C+1]"` [[br]][[br]]
     301     `svn ci -m "Bumping VERSION to A.B.[C+1]"` [[br]][[br]]
     302 1. Upload `yat-A.B.C.tar.gz` and md5 file to DownloadPage [[br]][[br]]
    271303 1. Update DownloadPage and [wiki:WikiStart WikiStart][[br]][[br]]
    272304  i. Update the section '''Latest stable release''' to reflect the new
    … …  
    298330    minimize the risk of loosing fixes, this step is only performed by
    299331    the ''Merge Master''. [[br]][[br]]
    300   i. Switch to the trunk or checkout a pristine version of the trunk.
    301 {{{
    302 svn switch http://dev.thep.lu.se/yat/svn/trunk
    303 }}}
    304      or
    305 {{{
    306 svn checkout http://dev.thep.lu.se/yat/svn/trunk trunk_merge
    307 cd trunk_merge
     332  i. cd to a pristine trunk WC
     333{{{
     334cd /path/to/yat-trunk/
     335svn update
     336svn status -q
    308337}}}
    309338  i. Merge changes into trunk. In this example the diffence between a
    … …  
    322351svn commit -m "Merged patch release A.B.1 to the trunk. Delta A.B.1 - A.B"
    323352}}}
    324     Remove `trunk_merge` if it was created. [[br]][[br]]
     353