From Fedora Project Wiki
Each of these examples shows a versioning scenario. The sequence of versions used
Ideally there will be at least one example here for every tricky versioning scenario.
Things to add which we don't currently have examples for:
- Upstream just uses random words as names: "spectacled", "cinnamon", "polar", "kodiak".
- Upstream uses negative numbers. "1.-1.7", "1.-1.8", "1.0.0". (I sure hope nobody ever does this, but I don't actually know how we would handle it.)
Simple versioning examples
Some basic examples.
| Upstream | Version: | Release: | Explanation |
|---|---|---|---|
| 1.0 | 1.0 | 1%{?dist} | The first release. |
| 1.1 | 1.1 | 1%{?dist} | An upstream update. |
| 1.1 | 1.1 | 2%{?dist} | You made a change to the package but the upstream version didn't change. |
| 1.2 | 1.2 | 1%{?dist} | The upstream version changed, so Release: goes back to 1. |
| 1.2.1 | 1.2.1 | 1%{?dist} | Extra levels of versioning are OK. |
| 1.3 | 1.3 | 1%{?dist} | They can come and go without problems. |
| Upstream | Version: | Release: | Explanation |
|---|---|---|---|
| 5.2 | 5.2 | 1%{?dist} | |
| 5.2a | 5.2a | 1%{?dist} | Upstream introduced a letter to indicate a patch release. You trust upstream to use letters in alphabetical order, so it's OK to use the version as is. |
| 5.2b | 5.2b | 1%{?dist} | |
| 5.2b.1 | 5.2b.1 | 1%{?dist} | Even this is OK as long as the sequence increases. |
| 5.3 | 5.3 | 1%{?dist} |
Complex versioning examples
Example (post-release cvs):
pkg-1.0-1%{?dist} (this is the formal release of pkg 1.0)
pkg-1.0-2%{?dist} (this is a bugfix build to the 1.0 release)
pkg-1.0-3.20050515cvs%{?dist} (move to a post-release cvs checkout)
pkg-1.0-4.20050515cvs%{?dist} (bugfix to the post-release cvs checkout)
pkg-1.0-5.20050517cvs%{?dist} (new cvs checkout, note the increment of %{X})
| Source Archive | Description |
|---|---|
pkg-1.4a.tar.gz |
(this is a pre-release, version 1.4a of pkg) |
pkg-1.4.tar.gz |
(this is what the 1.4 release will actually look like) |
| Release Tag | Explanation |
pkg-1.4-0.1.a%{?dist} |
(so, this is the acceptable Fedora %{name}-%{version}-%{release})
|
pkg-1.4-1%{?dist} |
(and this is what the 1.4 release Fedora %{name}-%{version}-%{release} should be)
|
| Source Archive | Description |
|---|---|
pkg-0.9.2beta1.tar.gz |
(this is a beta release of pkg, version 0.9.2beta1) |
| Release Tag | Explanation |
pkg-0.9.2-0.1.beta1%{?dist} |
(this is the correct Fedora %{name}-%{version}-%{release})
|
pkg-0.9.2-0.2.beta1%{?dist} |
(this is an incremented Fedora %{name}-%{version}-%{release}. Note that the first 0 is not incremented.)
|
| Release Tag | Explanation |
|---|---|
pkg-0-0.1.20040110svn%{?dist} |
(this is a pre-release, svn checkout of pkg) |
pkg-0-0.2.20040110svn%{?dist} |
(this is a bugfix to the previous package) |
pkg-0-0.3.20040204svn%{?dist} |
(this is a new svn checkout, note the increment of %{X})
|
pkg-1.0-1%{?dist} |
(this is the formal release of pkg 1.0) |
| Release Tag | Explanation |
|---|---|
pkg-1.4-0.1.a%{?dist} |
(this is the Fedora package for 1.4a, as above) |
pkg-1.4-0.2.a%{?dist} |
(this is the first patch on top of 1.4a) |
pkg-1.4-0.3.a%{?dist} |
(this is another new patch on top of 1.4a) |
pkg-1.4-0.4.b%{?dist} |
(this is the first build after upgrade to 1.4b) |
pkg-1.4-0.5.b%{?dist} |
(this is a new patch on top of 1.4b) |
pkg-1.4-1%{?dist} |
(this is after moving to 1.4 "final", and to a normal version) |
pkg-1.4-2%{?dist} |
(this is a new patch on top of 1.4 "final") |
| Release Tag | Explanation |
|---|---|
pkg-0.9.2-0.1.beta1%{?dist} |
(this is the Fedora package for 0.9.2beta1, as above) |
pkg-0.9.2-0.2.beta1%{?dist} |
(this is a new patch on top of 0.9.2beta1) |
pkg-0.9.2-0.3.beta2%{?dist} |
(this is after upgrading to 0.9.2beta2) |
pkg-0.9.2-0.4.beta3%{?dist} |
(this is after upgrading to 0.9.2beta3) |
pkg-0.9.2-0.5.beta3%{?dist} |
(this is a new patch on top of 0.9.2beta3) |
pkg-0.9.2-0.6.rc1%{?dist} |
(this is after upgrading to 0.9.2rc1) |
pkg-0.9.2-0.7.rc2%{?dist} |
(this is after upgrading to 0.9.2rc2) |
pkg-0.9.2-1%{?dist} |
(this is after upgrading to 0.9.2 "final", version becomes normal) |
pkg-0.9.2-2%{?dist} |
(this is a new patch on top of 0.9.2 "final") |
Example (complicated post-release):
pkg-1.1.0-0.1.BETA%{?dist} (this is a prerelease, first beta)
pkg-1.1.0-0.2.BETA1%{?dist} (this is a prerelease, second beta)
pkg-1.1.0-0.3.BETA2%{?dist} (this is a prerelease, third beta)
pkg-1.1.0-0.4.CR1%{?dist} (this is a prerelease, candidate release 1)
pkg-1.1.0-0.5.CR2%{?dist} (this is a prerelease, candidate release 2)
pkg-1.1.0-1%{?dist} (final release)
pkg-1.1.0-2.GA1%{?dist} (post release, GA1)
pkg-1.1.0-3.CP1%{?dist} (post release, CP1, after GA1)
pkg-1.1.0-4.CP2%{?dist} (post release, CP2, after CP1)
pkg-1.1.0-5.SP1%{?dist} (post release, SP1, after CP2)
pkg-1.1.0-6.SP1_CP1%{?dist} (post release, SP1_CP1, after SP1)
| Upstream version | Description | Version: | Release: | Explanation |
|---|