From: Hans van Kranenburg Date: Sun, 29 Jul 2018 12:44:39 +0000 (+0200) Subject: README.source: update doc about changelog versions X-Git-Tag: archive/raspbian/4.11.1-1+rpi1~1^2~83 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=664bf61e48edc5c2b2c498f7cd4a06173c8a677c;p=xen.git README.source: update doc about changelog versions Let's just mention the available options in here. --- diff --git a/debian/README.source.md b/debian/README.source.md index f3bc5ef0e2..c1d52d52a8 100644 --- a/debian/README.source.md +++ b/debian/README.source.md @@ -29,8 +29,14 @@ from the RELEASE-4.10.0 tag in upstream git: -$ debian/bin/genorig.py /path/to/xen.git Generate tarball ../orig/xen_4.10.0.orig.tar.xz -For now, see commit 55129e390c in this repository, "debian/lib/python: -Recognize pre / rc versions" for additional information about package versions. +| **Recognized patterns** | example | uses treeish | +|--------|------|------| +| Regular release | 4.10.2 | RELEASE-4.10.2 | +| Pre version in between stable releases with explicit commit | 4.10.2~pre+1.25e0657e00-1 | 25e0657e00 | +| Explicit commit while in rc | 4.11.0~rc6+1.35fcb982ea-1~exp1 | 35fcb982ea | +| Release candidate | 4.11.0~rc7-1~exp1 | 4.11.0-rc7 | + +When a version contains an explicit commit hash, it has to be 10 characters long. Since commit ids do not sort, the +1 serves that purpose, and is incremented to +2 etc when switching to another commit. Step 2: Combine the upstream source and packaging -------------------------------------------------