masscollaborationlabs/emacs
2
0
Fork 0
mirror of https://github.com/masscollaborationlabs/emacs.git synced 2025-07-08 13:19:36 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Mention "visual line" in user manual

Browse source 
* doc/emacs/display.texi (Visual Line Mode):
* doc/emacs/basic.texi (Continuation Lines, Moving Point): Mention
"visual line".  (Bug#67382)
This commit is contained in:
Eli Zaretskii 2023-11-23 16:56:10 +02:00
parent 4bb65ed77a
commit 86016d8ecd
2 changed files with 18 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

25
doc/emacs/basic.texi
View file

@ -360,15 +360,15 @@ preserve the horizontal position, as usual.
@vindex line-move-visual @vindex line-move-visual
When a line of text in the buffer is longer than the width of the When a line of text in the buffer is longer than the width of the
window, Emacs usually displays it on two or more @dfn{screen lines}. window, Emacs usually displays it on two or more @dfn{screen lines},
For convenience, @kbd{C-n} and @kbd{C-p} move point by screen lines, a.k.a.@: @dfn{visual lines}. For convenience, @kbd{C-n} and @kbd{C-p}
as do the equivalent keys @kbd{@key{down}} and @kbd{@key{up}}. You move point by screen lines, as do the equivalent keys @kbd{@key{down}}
can force these commands to move according to @dfn{logical lines} and @kbd{@key{up}}. You can force these commands to move according to
(i.e., according to the text lines in the buffer) by setting the @dfn{logical lines} (i.e., according to the text lines in the buffer)
variable @code{line-move-visual} to @code{nil}; if a logical line by setting the variable @code{line-move-visual} to @code{nil}; if a
occupies multiple screen lines, the cursor then skips over the logical line occupies multiple screen lines, the cursor then skips
additional screen lines. For details, see @ref{Continuation Lines}. over the additional screen lines. For details, see @ref{Continuation
@xref{Variables}, for how to set variables such as Lines}. @xref{Variables}, for how to set variables such as
@code{line-move-visual}. @code{line-move-visual}.
Unlike @kbd{C-n} and @kbd{C-p}, most of the Emacs commands that work Unlike @kbd{C-n} and @kbd{C-p}, most of the Emacs commands that work
@ -596,10 +596,13 @@ lines, if any exists.
@cindex wrapping @cindex wrapping
@cindex line wrapping @cindex line wrapping
@cindex fringes, and continuation lines @cindex fringes, and continuation lines
@cindex logical line
@cindex screen line
@cindex visual line
Sometimes, a line of text in the buffer---a @dfn{logical line}---is Sometimes, a line of text in the buffer---a @dfn{logical line}---is
too long to fit in the window, and Emacs displays it as two or more too long to fit in the window, and Emacs displays it as two or more
@dfn{screen lines}. This is called @dfn{line wrapping} or @dfn{screen lines}, or @dfn{visual lines}. This is called @dfn{line
@dfn{continuation}, and the long logical line is called a wrapping} or @dfn{continuation}, and the long logical line is called a
@dfn{continued line}. On a graphical display, Emacs indicates line @dfn{continued line}. On a graphical display, Emacs indicates line
wrapping with small bent arrows in the left and right window fringes. wrapping with small bent arrows in the left and right window fringes.
On a text terminal, Emacs indicates line wrapping by displaying a On a text terminal, Emacs indicates line wrapping by displaying a

7
doc/emacs/display.texi
View file

@ -2010,9 +2010,10 @@ line truncation. @xref{Split Window}, for the variable
@section Visual Line Mode @section Visual Line Mode
@cindex word wrap @cindex word wrap
Another alternative to ordinary line continuation is to use Another alternative to ordinary line continuation
@dfn{word wrap}. Here, each long logical line is divided into two or (@pxref{Continuation Lines}) is to use @dfn{word wrap}. Here, each
more screen lines, like in ordinary line continuation. However, Emacs long logical line is divided into two or more screen lines, or
``visual lines'', like in ordinary line continuation. However, Emacs
attempts to wrap the line at word boundaries near the right window attempts to wrap the line at word boundaries near the right window
edge. (If the line's direction is right-to-left, it is wrapped at the edge. (If the line's direction is right-to-left, it is wrapped at the
left window edge instead.) This makes the text easier to read, as left window edge instead.) This makes the text easier to read, as