procyberian/emacs
1
0
Fork 0
Code Issues Pull requests 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
Show stats 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
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}.
For convenience, @kbd{C-n} and @kbd{C-p} move point by screen lines,
as do the equivalent keys @kbd{@key{down}} and @kbd{@key{up}}. You
can force these commands to move according to @dfn{logical lines}
(i.e., according to the text lines in the buffer) by setting the
variable @code{line-move-visual} to @code{nil}; if a logical line
occupies multiple screen lines, the cursor then skips over the
additional screen lines. For details, see @ref{Continuation Lines}.
@xref{Variables}, for how to set variables such as
window, Emacs usually displays it on two or more @dfn{screen lines},
a.k.a.@: @dfn{visual lines}. For convenience, @kbd{C-n} and @kbd{C-p}
move point by screen lines, as do the equivalent keys @kbd{@key{down}}
and @kbd{@key{up}}. You can force these commands to move according to
@dfn{logical lines} (i.e., according to the text lines in the buffer)
by setting the variable @code{line-move-visual} to @code{nil}; if a
logical line occupies multiple screen lines, the cursor then skips
over the additional screen lines. For details, see @ref{Continuation
Lines}. @xref{Variables}, for how to set variables such as
@code{line-move-visual}.
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 line wrapping
@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
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{continuation}, and the long logical line is called a
@dfn{screen lines}, or @dfn{visual lines}. This is called @dfn{line
wrapping} or @dfn{continuation}, and the long logical line is called a
@dfn{continued line}. On a graphical display, Emacs indicates line
wrapping with small bent arrows in the left and right window fringes.
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
@cindex word wrap
Another alternative to ordinary line continuation is to use
@dfn{word wrap}. Here, each long logical line is divided into two or
more screen lines, like in ordinary line continuation. However, Emacs
Another alternative to ordinary line continuation
(@pxref{Continuation Lines}) is to use @dfn{word wrap}. Here, each
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
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