From 423f10502eea43782566d737b0d314e10fa8514c Mon Sep 17 00:00:00 2001
From: Ivo De Decker <ivodd@debian.org>
Date: Wed, 1 Apr 2020 18:08:53 +0000
Subject: [PATCH] document allow-smooth-update hint

---
 doc/hints.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/hints.rst b/doc/hints.rst
index 66acd75..ce5e941 100644
--- a/doc/hints.rst
+++ b/doc/hints.rst
@@ -330,6 +330,19 @@ does the installability test. For arch: all package, this means that all
 relevant (`nobreakall`) architectures need to be specified, not `all`.
 
 
+allow-smooth-update `<action list>`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This hint allows the binaries from the sources listed in `<action list>` to
+stay in testing as a `smooth update`, even when the britney configuration
+wouldn't allow this otherwise.
+
+The `<action list>` is a list of versioned source packages.
+
+*Please note:* this hint expects the source version of the packages in
+testing, not in unstable.
+
+
 remove `<action list>`
 ^^^^^^^^^^^^^^^^^^^^^^