[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

doc of x-family-fonts

From: Drew Adams
Subject: doc of x-family-fonts
Date: 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:


     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 (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'

Important settings:
  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
  locale-coding-system: cp1252
  default-enable-multibyte-characters: t

Major mode: Dired by name

Minor modes in effect:
  encoded-kbd-mode: t
  tooltip-mode: t
  auto-compression-mode: t
  tool-bar-mode: t
  mouse-wheel-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  unify-8859-on-encoding-mode: t
  utf-translate-cjk-mode: t
  line-number-mode: t

Recent input:
<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

Recent messages:
(C:\Emacs-22-2006-03-20\bin\emacs.exe -q --no-site-file --debug-init
Loading encoded-kb...done
For information about the GNU Project and its goals, type C-h C-p.
Loading dired...
Loading regexp-opt...done
Loading dired...done
Loading emacsbug...done

reply via email to

[Prev in Thread] Current Thread [Next in Thread]