[Emacs-diffs] Changes to emacs/doc/emacs/display.texi,v

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      08/07/31 19:30:16

Index: display.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/display.texi,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- display.texi        5 Jun 2008 02:42:55 -0000       1.10
+++ display.texi        31 Jul 2008 19:30:16 -0000      1.11
@@ -31,6 +31,7 @@
 * Cursor Display::         Features for displaying the cursor.
 * Line Truncation::        Truncating lines to fit the screen width instead
                              of continuing them to multiple screen lines.
+* Visual Line Mode::       Word wrap and screen line-based editing.
 * Temporary Face Changes:: Commands to temporarily modify the default text face
 * Display Custom::         Information on variables for customizing display.
 @end menu
@@ -1172,6 +1173,50 @@
 newline overflows into the right fringe, and the cursor appears in the
 fringe when positioned on that newline.
 
address@hidden Visual Line Mode
address@hidden Visual Line Mode
+
address@hidden word wrap
+  Another alternative to ordinary line continuation is to use
address@hidden wrap}.  Here, each long logical line is divided into two or
+more screen lines, like in ordinary line continuation.  However, Emacs
+attempts to wrap the line at word boundaries near the right window
+edge.  This makes the text easier to read, as wrapping does not occur
+in the middle of words.
+
address@hidden Visual Line mode
address@hidden visual-line-mode
address@hidden global-visual-line-mode
+  Word wrap is enabled by Visual Line mode, an optional minor mode.
+To turn on Visual Line mode in the current buffer, type @kbd{M-x
+visual-line-mode}; repeating this command turns it off.  You can also
+turn on Visual Line mode using the menu bar: in the Options menu,
+select the @samp{Line Wrapping in this Buffer} submenu, followed by
+the @samp{Word Wrap (Visual Line Mode)} menu item.  While Visual Line
+mode is enabled, the mode-line shows the string @samp{wrap} in the
+mode display.  The command @kbd{M-x global-visual-line-mode} toggles
+Visual Line mode in all buffers.
+
address@hidden beginning-of-visual-line
address@hidden end-of-visual-line
address@hidden next-logical-line
address@hidden previous-logical-line
+  In Visual Line mode, some editing commands work on screen lines
+instead of logical lines: @kbd{C-a} (@code{beginning-of-visual-line})
+moves to the beginning of the screen line, @kbd{C-e}
+(@code{end-of-visual-line}) moves to the end of the screen line, and
address@hidden (@code{kill-visual-line}) kills text to the end of the
+screen line.  Furthermore, the commands @kbd{M-]}
+(@code{next-logical-line}) and @kbd{M-[}
+(@code{previous-logical-line}) move point to the next logical line and
+previous logical line respectively.
+
+  By default, word-wrapped lines do not display fringe indicators.
+Visual Line mode is often used to edit files that contain many long
+logical lines, so having a fringe indicator for each wrapped line
+would be visually distracting.  You can change this by customizing the
+variable @code{visual-line-fringe-indicators}.
+
 @node Temporary Face Changes
 @section Temporary Face Changes