summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--debian/changelog2
-rw-r--r--doc/SUPPORT-POLICY20
2 files changed, 22 insertions, 0 deletions
diff --git a/debian/changelog b/debian/changelog
index 477443be..518031ce 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -29,6 +29,8 @@ debhelper (10.5) UNRELEASED; urgency=medium
* dh_installchangelogs: Ditto.
* dh_compress: Ditto
* dh_shlibdeps: Avoid calling file(1) on debug symbols.
+ * SUPPORT-POLICY: Include new document that describes the current
+ support policy of debhelper compat levels.
[ Iain Lane ]
* Dh_Lib: Re-add warning + exit 0 for the -i/-a shortcut that was
diff --git a/doc/SUPPORT-POLICY b/doc/SUPPORT-POLICY
new file mode 100644
index 00000000..9463e49f
--- /dev/null
+++ b/doc/SUPPORT-POLICY
@@ -0,0 +1,20 @@
+SUPPORT POLICY FOR DEBHELPER COMPAT LEVELS
+==========================================
+
+The current policy for supporting compat levels is:
+
+ * A compat level may be deprecated once the latest oldoldstable release
+ supports a /newer/ compat level. (E.g. compat 9 can be deprecated once
+ jessie becomes oldoldstable).
+
+ * Alternatively, a compat level may be deprecated if a debhelper version
+ supporting a newer compat level is backported to oldoldstable-backports/
+ oldoldstable-backports-sloppy and the oldest supported Ubuntu LTS release.
+
+ * These rules are independent of whether Debian oldoldstable is still
+ supported.
+
+ * Deprecated compat levels may be removed in unstable once it as been released
+ in Debian stable as deprecated (provided that the deprecation has been
+ announced at least one year prior to the freeze of said stable release).
+