From 803ee7b9b1e33ef920245b8daaf3d9601716cf65 Mon Sep 17 00:00:00 2001 From: Chong Yidong Date: Mon, 19 Jan 2009 15:29:18 +0000 Subject: [PATCH] (Font Lookup): Document WIDTH argument of x-list-fonts. --- doc/lispref/display.texi | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) 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 -- 2.11.4.GIT