Mercurial > emacs
changeset 101289:fb88ce222846
(Font Lookup): Document WIDTH argument of x-list-fonts.
| author | Chong Yidong <cyd@stupidchicken.com> |
|---|---|
| date | Mon, 19 Jan 2009 15:29:18 +0000 |
| parents | 022735387864 |
| children | 017ab5339c4c |
| files | doc/lispref/display.texi |
| diffstat | 1 files changed, 6 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/lispref/display.texi Mon Jan 19 15:29:05 2009 +0000 +++ b/doc/lispref/display.texi Mon Jan 19 15:29:18 2009 +0000 @@ -2725,7 +2725,7 @@ @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 @@ 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