Changes between Version 65 and Version 66 of BuildingDebianPackages


Ignore:
Timestamp:
12/11/11 17:44:53 (10 years ago)
Author:
solj
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • BuildingDebianPackages

    v65 v66  
    2424=== Install source code === 
    2525 
    26 Depending on which version of bcfg2 you want build, you can obtain the source code from [wiki:Download] or from the project's Subversion 
     26Depending on which version of bcfg2 you want build, you can obtain the source code from [wiki:Download] or from the project's git 
    2727repository.  To create a local anonymous working copy of the latest version of the bcfg2 source code, use a command like the following: 
    2828 
     
    4242The basic format of the package version string to use is this: 
    4343 
    44   {{{<UPSTREAM VER>~<UPSTREAM PRE-VER>+r<UPSTREAM SVN REV>-0.1+<LOCAL VER>}}} 
    45  
    46 '''NOTE: The '~', '+', and '-' characters have significance in determining when one package is newer than another.  The following format is believed to do the right thing in all common situations.''' 
     44  {{{<UPSTREAM VER>~<UPSTREAM PRE-VER>+<GIT-ID>-0.1+<LOCAL VER>}}} 
     45 
     46'''NOTE: The '+', and '-' characters have significance in determining when one package is newer than another.  The following format is believed to do the right thing in all common situations.''' 
    4747 
    4848The components of the package version string are explained below: 
     
    5050 `<UPSTREAM VER>`:: 
    5151   This is the version of the Bcfg source code you are working from. It will likely be something like `0.9.6` or `1.0`. 
    52  `~<UPSTREAM PRE-VER>`:: 
    53    If you are using a published pre-release of Bcfg2, it will have a name like `pre1` or `rc1`.  Use that string here, otherwise drop this component and the preceding tilde (`~`) character from the package version string. 
    54  `+<UPSTREAM SVN REV>`:: 
    55    If you are building from a local working copy of the Subversion repository, it is useful to include the repository revision in the package version.  It will be a number like '5464'. If you are building from a downloaded copy of the source, drop this component (including the preceding plus-sign (`+`) from the package version string. 
     52 `<UPSTREAM PRE-VER>`:: 
     53   If you are using a published pre-release of Bcfg2, it will have a name like `pre1` or `rc1`.  Use that string here, otherwise drop this component from the package version string. 
     54 `+<GIT-ID>`:: 
     55   If you are building from a local working copy of the git repository, it is useful to include the revision in the package version. If you are building from a downloaded copy of the source, drop this component (including the preceding plus-sign (`+`) from the package version string. 
    5656 `+<LOCAL VER>`:: 
    5757   This is a locally relevant name like your last name or your domain name, plus the digit `1`.  For example, if your family name is ''Smith'', you could use `smith1`.  If you work for ''Example Inc'', you could use `example1`. 
     
    5959Here are some examples: 
    6060 
    61  * If you are building packages for revision 5463 of the Subversion trunk, and the latest published version is 1.0pre5, the version string should be `1.0~pre5+r5463-0.1+example1`. 
    62  * If you are building packages for the published 1.0 rc1 version, the version string should be `1.0~rc1-0.1+example1`. 
     61 * If you are building packages for revision 6c681bd from git, and the latest published version is 1.2.0rc1, the version string should be `1.2.0rc1+6c681bd-0.1+example1`. 
     62 * If you are building packages for the published 1.0 rc1 version, the version string should be `1.0rc1-0.1+example1`. 
    6363 * If you are building packages for the published 1.0 version, the version string should be `1.0-0.1+example1`. 
    6464 
    65 If you are working on a Subversion working copy of 1.0 pre5 and have the `devscripts` package installed, the following command is a convenient way to create a well formatted changelog entry: 
    66  
    67 {{{ 
    68 REV=$(svn info|grep '^Revision' |cut -d' ' -f2) 
    69 debchange --force-bad-version --preserve --newversion "1.0~pre5+r${REV}-0.1+example1" SVN revision $REV 
     65If you are working on a git working copy of 1.0 pre5 and have the `devscripts` package installed, the following command is a convenient way to create a well formatted changelog entry: 
     66 
     67{{{ 
     68REV=$(git log --oneline | head -n 1 | cut -d' ' -f1) 
     69debchange --force-bad-version --preserve --newversion "1.0~pre5+${REV}-0.1+example1" git revision $REV 
    7070}}} 
    7171