From 12496b9b720a0b218827307c46c196e648a3dc76 Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Sat, 30 Sep 2017 19:36:49 +0000
Subject:  doc: mention when to recompile service databases

---
 doc/upgrade.html | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/upgrade.html b/doc/upgrade.html
index b49c13f..4cefb17 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -16,6 +16,18 @@
 <a href="//skarnet.org/">skarnet.org</a>
 </p>
 
+
+<h1> Upgrade notes for s6-rc </h1>
+
+<p>
+ As a general rule, if you change <em>major versions</em>,
+for instance if you upgrade from 0.1.0.0 to 0.2.1.2, you need
+to <em>recompile your service databases</em>, because the
+binary format is not guaranteed stable across major version
+changes. You can keep your compiled service databases across
+minor and bugfix version changes.
+</p>
+
 <h1> What has changed in s6-rc </h1>
 
 <h2> in 0.2.1.2 </h2>
-- 
cgit v1.2.3