* buffer.c (word_wrap): Doc fix.

2 files changed, 11 insertions, 1 deletions

diff --git a/src/ChangeLog b/src/ChangeLog
index 7a9ab1757eb..7ea9ad8f3e3 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,7 @@
+2012-06-06  Chong Yidong  <cyd@gnu.org>
+
+        * buffer.c (word_wrap): Doc fix.
+
 2012-06-04  Paul Eggert  <eggert@cs.ucla.edu>
 
         * xdisp.c (note_mode_line_or_margin_highlight): Pacify gcc -Wall.
diff --git a/src/buffer.c b/src/buffer.c
index 386d9a78153..504d477494b 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5522,7 +5522,13 @@ This variable has no effect if long lines are truncated (see
 `truncate-lines' and `truncate-partial-width-windows').  If you use
 word-wrapping, you might want to reduce the value of
 `truncate-partial-width-windows', since wrapping can make text readable
-in narrower windows.  */);
+in narrower windows.
+
+Instead of setting this variable directly, most users should use
+Visual Line mode .  Visual Line mode, when enabled, sets `word-wrap'
+to t, and additionally redefines simple editing commands to act on
+visual lines rather than logical lines.  See the documentation of
+`visual-line-mode'.  */);
 
   DEFVAR_PER_BUFFER ("default-directory", &BVAR (current_buffer, directory),
                      make_number (Lisp_String),