[Pkg-cli-apps-commits] [SCM] openbve branch, master, updated. debian/1.4.0.0-1-40-gdc78bc1

[Paul Sladen]

The following commit has been merged in the master branch:
commit dc78bc122ecae423d1ed0fa352ae2a582d4c5e6c
Author: Paul Sladen <debian at paul.sladen.org>
Date:   Tue Jan 24 00:23:10 2012 +0100

    debian/README.source: document rationale behind UNRELEASED (non-uploaded) entries in debian/changelog

diff --git a/debian/README.source b/debian/README.source
index 297d9f5..ed2eb52 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -145,6 +145,19 @@ of the upstream changelog at:
 
 this is linked from the site top-level of the site (not downloads).
 
+Debian changelog UNRELEASED entries:
+
+Openbve upstream releases tend to come in bunches of activity.  Quite
+often a second, or third upstream release may become available whilst
+the Debian packaging of the previous version is still under test and
+has not yet been uploaded.
+
+This accounts for a number of the UNRELEASED entries in
+'debian/changelog'.  It's very useful to keep these as it makes
+bisecting and testing/jumping between revisions much easier, even if
+those never actually made it to the Debian/Ubuntu archives because
+they were superseded by the newer version that became available.
+
 
 [1] "watch file syntax, version separate to .zip" (2009-02-17)
 http://www.mail-archive.com/pkg-devscripts@teams.debian.net/msg02553.html

-- 
openbve