; * src/window.c (Fset_window_margins): Doc fix.

diff --git a/src/window.c b/src/window.c
index 894d9c4fc19ac705f0f9a7bedf27061652b5c15f..8d4bde8d6db6d894e016c1c2e81243f52087193d 100644 (file)
--- a/src/window.c
+++ b/src/window.c
@@ -7793,7 +7793,11 @@ means no margin.
 
 Leave margins unchanged if WINDOW is not large enough to accommodate
 margins of the desired width.  Return t if any margin was actually
-changed and nil otherwise.  */)
+changed and nil otherwise.
+
+The margins specified by calling this function may be later overridden
+by invoking `set-window-buffer' for the same WINDOW, with its
+KEEP-MARGINS argument nil or omitted.  */)
   (Lisp_Object window, Lisp_Object left_width, Lisp_Object right_width)
 {
   struct window *w = set_window_margins (decode_live_window (window),