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

Improve the documentation of glyphless-character display

Browse source 
* lisp/international/characters.el (glyphless-char-display-control):
* src/xdisp.c (syms_of_xdisp) <glyphless-char-display>: Mention
the 'glyphless-char' face in the doc string.

* doc/lispref/display.texi (Glyphless Chars): Index
'glyphless-char' face.
This commit is contained in:
Eli Zaretskii 2022-08-28 08:40:25 +03:00
parent 72ae02377e
commit 195fcc932e
3 changed files with 12 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
doc/lispref/display.texi
View file

@ -7994,6 +7994,7 @@ Display with @var{graphical} on graphical displays, and with
must be one of the display methods described above. must be one of the display methods described above.
@end table @end table
@vindex glyphless-char@r{ face}
@noindent @noindent
The @code{thin-space}, @code{empty-box}, @code{hex-code}, and The @code{thin-space}, @code{empty-box}, @code{hex-code}, and
@acronym{ASCII} string display methods are drawn with the @acronym{ASCII} string display methods are drawn with the
@ -8048,7 +8049,8 @@ emojis).
@item no-font @item no-font
Characters for which there is no suitable font, or which cannot be Characters for which there is no suitable font, or which cannot be
encoded by the terminal's coding system. encoded by the terminal's coding system, or those for which the
text-mode terminal has no glyphs.
@end table @end table
@c FIXME: this can also be 'acronym', but that's not currently @c FIXME: this can also be 'acronym', but that's not currently

8
lisp/international/characters.el
View file

@ -1599,7 +1599,8 @@ GROUP must be one of these symbols:
presentation). presentation).
`no-font': characters for which no suitable font is found. `no-font': characters for which no suitable font is found.
For character terminals, characters that cannot For character terminals, characters that cannot
be encoded by `terminal-coding-system'. be encoded by `terminal-coding-system' or those
for which the terminal has no glyphs.
METHOD must be one of these symbols: METHOD must be one of these symbols:
`zero-width': don't display. `zero-width': don't display.
@ -1613,7 +1614,10 @@ METHOD must be one of these symbols:
Do not set its value directly from Lisp; the value takes effect Do not set its value directly from Lisp; the value takes effect
only via a custom `:set' only via a custom `:set'
function (`update-glyphless-char-display'), which updates function (`update-glyphless-char-display'), which updates
`glyphless-char-display'." `glyphless-char-display'.
See also the `glyphless-char' face, which is used to display the
visual representation of these characters."
:version "28.1" :version "28.1"
:type '(alist :key-type (symbol :tag "Character Group") :type '(alist :key-type (symbol :tag "Character Group")
:value-type (symbol :tag "Display Method")) :value-type (symbol :tag "Display Method"))

3
src/xdisp.c
View file

@ -35831,6 +35831,9 @@ which no font is found on graphical terminals, and characters that cannot
be displayed by text-mode terminals. Its value should be an ASCII acronym be displayed by text-mode terminals. Its value should be an ASCII acronym
string, `hex-code', `empty-box', or `thin-space'. The default is `hex-code'. string, `hex-code', `empty-box', or `thin-space'. The default is `hex-code'.
With the obvious exception of `zero-width', all the other representations
are displayed using the face `glyphless-char'.
If a character has a non-nil entry in an active display table, the If a character has a non-nil entry in an active display table, the
display table takes effect; in this case, Emacs does not consult display table takes effect; in this case, Emacs does not consult
`glyphless-char-display' at all. */); `glyphless-char-display' at all. */);