runtime(doc): clarify the use of change marks when writing a buffer
related: #17008
Signed-off-by: Christian Brabandt <cb@256bit.org>
diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt
index a70515d..a88aad1 100644
--- a/runtime/doc/editing.txt
+++ b/runtime/doc/editing.txt
@@ -1,4 +1,4 @@
-*editing.txt* For Vim version 9.1. Last change: 2024 Oct 14
+*editing.txt* For Vim version 9.1. Last change: 2025 Apr 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -974,8 +974,9 @@
executed like with ":!{cmd}", any '!' is replaced with
the previous command |:!|.
-The default [range] for the ":w" command is the whole buffer (1,$). If you
-write the whole buffer, it is no longer considered changed. When you
+The default [range] for the ":w" command is the whole buffer (1,$). The |'[|
+and |']| marks will be set to the [range] being used for the write command.
+If you write the whole buffer, it is no longer considered changed. When you
write it to a different file with ":w somefile" it depends on the "+" flag in
'cpoptions'. When included, the write command will reset the 'modified' flag,
even though the buffer itself may still be different from its file.