From 15aa4fe1379c4cddb2e548bad0c1cd99f7fbf90e Mon Sep 17 00:00:00 2001
From: Maxime Coste <mawww@kakoune.org>
Date: Tue, 20 Jul 2021 22:45:33 +1000
Subject: [PATCH] Document the new write behaviour

---
 doc/pages/changelog.asciidoc | 3 +++
 src/main.cc                  | 1 +
 2 files changed, 4 insertions(+)

diff --git a/doc/pages/changelog.asciidoc b/doc/pages/changelog.asciidoc
index d9f6af2c8..f57036467 100644
--- a/doc/pages/changelog.asciidoc
+++ b/doc/pages/changelog.asciidoc
@@ -19,6 +19,9 @@ released versions.
 * `write -atomic` was replaced with `write -method [replace|overwrite]` to
   make both write methods available explicitly
 
+* `write <filename>` will fail if the given filename already exists and is
+  a regular file. Use the `-force` switch to override that behaviour.
+
 == Kakoune 2020.09.01
 
 * The `repl` and `send-text` aliases have been renamed respectively into
diff --git a/src/main.cc b/src/main.cc
index d04a85a64..2a50b72d1 100644
--- a/src/main.cc
+++ b/src/main.cc
@@ -45,6 +45,7 @@ struct {
     StringView notes;
 } constexpr version_notes[] = { {
         0,
+        "» {+u}write <filename>{} will refuse to overwrite without {+u}-force{}\n"
         "» {+u}$kak_command_fifo{} support\n"
         "» {+u}set-option -remove{} support\n"
         "» prompts auto select {+i}menu{} completions on space\n"