# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1232378958 0
# Node ID fb88ce22284677d978296c04a8b90945c0cfbae5
# Parent  02273538786401545c5516c6eee5e57e87e7437b
(Font Lookup): Document WIDTH argument of x-list-fonts.

diff -r 022735387864 -r fb88ce222846 doc/lispref/display.texi
--- 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