Changes between Version 12 and Version 13 of pm-svn-externals


Ignore:
Timestamp:
Mar 21, 2011 11:47:35 AM (9 years ago)
Author:
stefan
Comment:

update to reflect changed meaning of Dependencies files

Legend:

Unmodified
Added
Removed
Modified
  • pm-svn-externals

    v12 v13  
    1414
    1515'''Our policy for managing externals in COIN-OR is that we put a file called {{{Dependencies}}} into a directory.'''
    16 In the {{{Dependencies}}} file, for each required COIN-OR package, a stable branch or point release is specified.
     16'''In the {{{Dependencies}}} file''', for each required COIN-OR package, '''a stable branch should be specified'''.
     17It is encouraged, that both development versions (''e.g.'', trunk) and stable branches of a project list either stable branches or point releases in the {{{Dependencies}}} file. For point releases, it is mandatory to do so.
     18For example, the [https://projects.coin-or.org/Clp/browser/releases/1.13.3/Dependencies Dependencies file in the base directory for the 1.13.3 point release of the Clp package] looks like this:
     19{{{
     20BuildTools  https://projects.coin-or.org/svn/BuildTools/stable/0.6
     21Data/Sample https://projects.coin-or.org/svn/Data/Sample/stable/1.1/
     22CoinUtils   https://projects.coin-or.org/svn/CoinUtils/stable/2.7/CoinUtils
     23Osi         https://projects.coin-or.org/svn/Osi/stable/0.104/Osi
     24}}}
     25The first entry in each row specifies the directory (relative to the current directory) into which the external is to be placed (this can specify several levels of subdirectories).  After this, one can optionally specify the revision number of the dependency code that is to be obtained using the {{{-rN}}} flag, where {{{N}}} is the revision number.  The last column is the URL that specifies the location of the dependency in a repository.[[BR]]
    1726
    18 '''Point releases of a project always list point releases of other projects''' in the {{{Dependencies}}} file.
    19 For example, the [https://projects.coin-or.org/Clp/browser/releases/1.13.2/Dependencies Dependencies file in the base directory for the 1.13.2 point release of the Clp package] looks like this:
     27'''In the {{{svn:externals}}} property''', however, for each required COIN-OR package, '''a point release is specified'''.
     28For example, the {{{svn:externals}}} property of the [https://projects.coin-or.org/Clp/browser/releases/1.13.2 1.13.2 point release of the Clp package] looks like this:
    2029{{{
    2130BuildTools  https://projects.coin-or.org/svn/BuildTools/releases/0.6.3/
     
    2433Osi         https://projects.coin-or.org/svn/Osi/releases/0.104.2/Osi
    2534}}}
    26 The first entry in each row specifies the directory (relative to the current directory) into which the external is to be placed (this can specify several levels of subdirectories).  After this, one can optionally specify the revision number of the dependency code that is to be obtained using the {{{-rN}}} flag, where {{{N}}} is the revision number.  The last column is the URL that specifies the location of the dependency in a repository.
    2735
    28 For development versions (''e.g.'', trunk) and stable branches of a project, it is encouraged to list either stable branches or point releases in the {{{Dependencies}}} file.
    29 For example, the [https://projects.coin-or.org/Clp/browser/stable/1.13/Dependencies Dependencies file in the base directory for the 1.13 stable branch of the Clp package] looks like this:
    30 {{{
    31 BuildTools  https://projects.coin-or.org/svn/BuildTools/stable/0.6/
    32 Data/Sample https://projects.coin-or.org/svn/Data/Sample/stable/1.1/
    33 CoinUtils   https://projects.coin-or.org/svn/CoinUtils/stable/2.7/CoinUtils
    34 Osi         https://projects.coin-or.org/svn/Osi/stable/0.104/Osi
    35 }}}
    36 Here, stable branches of other projects are listed.
    37 However, the {{{svn:externals}}} property of the Clp stable/1.13 directory is set to point to releases as in the 1.13.2 point releases depicted above.
    3836
    3937== Important Considerations For Externals ==