diff --git a/doc/pages/changelog.asciidoc b/doc/pages/changelog.asciidoc
index 6723850d..c76c20f8 100644
--- a/doc/pages/changelog.asciidoc
+++ b/doc/pages/changelog.asciidoc
@@ -19,6 +19,11 @@ released versions.
   The new `<a-m>` and `<a-M>` are now symmetrical with `m` and `M`.
   Those commands select (or extend) to the matching char backwards.
 
+* `define-command` switches `-shell-completion` and `-shell-candidates`
+  have been renamed to `-shell-script-completion` and
+  `-shell-script-candidates` to make way for a new `-shell-completion`
+  which completes like the shell (shell command name then filename).
+
 == Kakoune 2018.09.04
 
 This version contains a significant overhaul of various Kakoune
diff --git a/src/main.cc b/src/main.cc
index 405ffb21..6fda5da6 100644
--- a/src/main.cc
+++ b/src/main.cc
@@ -43,6 +43,12 @@ struct {
     unsigned int version;
     const char* notes;
 } constexpr version_notes[] = { {
+        0,
+        "» define-commands -shell-completion and -shell-candidates has been renamed\n"
+        "» exclusive face attributes is replaced with final (fg/bg/attr)\n"
+        "» <a-M> (merge consecutive) moved to <a-_> to make <a-M> backward <a-m>\n"
+        "» remove-hooks now takes a regex parameter\n"
+    }, {
         20180904,
         "» Big breaking refactoring of various Kakoune features,\n"
         "  configuration might need to be updated see `:doc changelog` for details\n"