procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Clarify the meaning of the argument of ':align-to' space spec

Browse source 
* doc/lispref/display.texi (Specified Space): Clarify the meaning
and measurement of HPOS in ':align-to' space specs.  (Bug#65015)
This commit is contained in:
Eli Zaretskii 2023-08-03 08:31:17 +03:00
parent 5c6a51668b
commit 6eddbfe33f
1 changed files with 12 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/lispref/display.texi
View file

@ -5287,10 +5287,18 @@ the ``pixel width'' of a character is usually 1, but it could be more
for TABs and double-width CJK characters.) for TABs and double-width CJK characters.)
@item :align-to @var{hpos} @item :align-to @var{hpos}
Specifies that the space should be wide enough to reach @var{hpos}. Specifies that the space should be wide enough to reach the column
If @var{hpos} is a number, it is measured in units of the normal @var{hpos}. If @var{hpos} is a number, it is a column number, and is
character width. @var{hpos} can also be a @dfn{pixel width} measured in units of the canonical character width (@pxref{Frame
specification (@pxref{Pixel Specification}). Font}). @var{hpos} can also be a @dfn{pixel width} specification
(@pxref{Pixel Specification}). When the current line is wider than
the window, and is either displayed by one or more continuation lines,
or is truncated and possibly scrolled horizontally (@pxref{Horizontal
Scrolling}), @var{hpos} is measured from the beginning of the logical
line, not from the visual beginning of the screen line. This way,
alignment produced by @code{:align-to} is consistent with functions
that count columns, such as @code{current-column} and
@code{move-to-column} (@pxref{Columns}).
@end table @end table
You should use one and only one of the above properties. You can You should use one and only one of the above properties. You can