[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
doc of x-family-fonts
doc of x-family-fonts
Sat, 3 Jun 2006 15:31:17 -0700
Elisp manual doc fof `x-family-fonts':
This function returns a list describing the available fonts for
family FAMILY on FRAME. If FAMILY is omitted or `nil', this list
applies to all families, and therefore, it contains all available
fonts. Otherwise, FAMILY must be a string; it may contain the
wildcards `?' and `*'.
The list describes the display that FRAME is on; if FRAME is
omitted or `nil', it applies to the selected frame's display
(*note Input Focus::).
The list contains a vector of the following form for each font:
[FAMILY WIDTH POINT-SIZE WEIGHT SLANT
FIXED-P FULL REGISTRY-AND-ENCODING]
The first five elements correspond to face attributes; if you
specify these attributes for a face, it will use this font.
The last three elements give additional information about the font.
FIXED-P is non-`nil' if the font is fixed-pitch. FULL is the full
name of the font, and REGISTRY-AND-ENCODING is a string giving the
registry and encoding of the font.
The result list is sorted according to the current face font sort
I tried emacs -Q, then M-: (x-family-fonts). Result: nil.
I expected to see all fonts (from all families) that were available
for the current frame. Is this a product bug or a doc bug? It's not
clear to me, in any case.
It's also not clear to me how to find all fonts available in Emacs,
regardless of the frame. Is (x-list-fonts "*") a way to do that? This
functionality seems like something that should be available, so users
can know how to deal with fonts (e.g. choose them) on their machines.
When I try (x-list-fonts "*") I get a list of fonts, but it is
completely different from the list I get via Shift mouse-1. Why is
that? Just what is each list used for in Emacs?
More generally, I think the Elisp-manual treatment of fonts is
poor. It doesn't seem to answer the basic questions a user would have
(what fonts do I have, how do I specify them, how can I specify a
priority list of fonts to use in a function I'm writing,...).
In GNU Emacs 188.8.131.52 (i386-mingw-nt5.1.2600)
of 2006-03-20 on W2ONE
X server distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --cflags -Id:/g/include'
value of $LC_ALL: nil
value of $LC_COLLATE: nil
value of $LC_CTYPE: nil
value of $LC_MESSAGES: nil
value of $LC_MONETARY: nil
value of $LC_NUMERIC: nil
value of $LC_TIME: nil
value of $LANG: ENU
Major mode: Dired by name
Minor modes in effect:
<down-mouse-1> <mouse-1> M-: ( x - f a m i l y - f
o n t s ) <return> <help-echo> <help-echo> <help-echo>
<help-echo> <menu-bar> <help-menu> <report-emacs-b
(C:\Emacs-22-2006-03-20\bin\emacs.exe -q --no-site-file --debug-init
For information about the GNU Project and its goals, type C-h C-p.
- doc of x-family-fonts,
Drew Adams <=