diff options
| author | Chong Yidong <cyd@stupidchicken.com> | 2009-01-19 15:29:18 +0000 |
|---|---|---|
| committer | Chong Yidong <cyd@stupidchicken.com> | 2009-01-19 15:29:18 +0000 |
| commit | 803ee7b9b1e33ef920245b8daaf3d9601716cf65 (patch) | |
| tree | 08b155dfbdda7a71c09f1126a527ef569c964c1a | |
| parent | fb13a41632555a82f635224750f8b6bf359a510f (diff) | |
| download | emacs-803ee7b9b1e33ef920245b8daaf3d9601716cf65.tar.gz | |
(Font Lookup): Document WIDTH argument of x-list-fonts.
| -rw-r--r-- | doc/lispref/display.texi | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 76e65d3316a..b29515cdc8f 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -2725,7 +2725,7 @@ nominal heights and widths would suggest. @node Font Lookup @subsection Looking Up Fonts -@defun x-list-fonts name &optional reference-face frame maximum +@defun x-list-fonts name &optional reference-face frame maximum width This function returns a list of available font names that match @var{name}. @var{name} should be a string containing a font name in either the Fontconfig, GTK, or XLFD format (@pxref{Font X,, Font @@ -2744,6 +2744,11 @@ return. If it is non-@code{nil}, then the return value is truncated after the first @var{maximum} matching fonts. Specifying a small value for @var{maximum} can make this function much faster, in cases where many fonts match the pattern. + +The optional argument @var{width} specifies a desired font width. If +it is non-@code{nil}, the function only returns those fonts whose +characters are (on average) @var{width} times as wide as +@var{reference-face}. @end defun @defun x-family-fonts &optional family frame |