[Emacs-diffs] /srv/bzr/emacs/emacs-24 r108497: * buffer.c (word_wrap): Doc fix.

[Chong Yidong]

------------------------------------------------------------
revno: 108497
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Wed 2012-06-06 14:39:24 +0800
message:
  * buffer.c (word_wrap): Doc fix.
modified:
  src/ChangeLog
  src/buffer.c

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2012-06-04 06:03:19 +0000
+++ b/src/ChangeLog     2012-06-06 06:39:24 +0000
@@ -1,3 +1,7 @@
+2012-06-06  Chong Yidong  <address@hidden>
+
+       * buffer.c (word_wrap): Doc fix.
+
 2012-06-04  Paul Eggert  <address@hidden>
 
        * xdisp.c (note_mode_line_or_margin_highlight): Pacify gcc -Wall.

=== modified file 'src/buffer.c'
--- a/src/buffer.c      2012-06-03 09:03:23 +0000
+++ b/src/buffer.c      2012-06-06 06:39:24 +0000
@@ -5522,7 +5522,13 @@
 `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),