document XftFontOpenXlfd and XftXlfdParse

Signed-off-by: Thomas E. Dickey <dickey@invisible-island.net>

1 files changed, 69 insertions, 2 deletions

diff --git a/man/Xft.man b/man/Xft.man
index afb1fb0..6a2504a 100644
--- a/man/Xft.man
+++ b/man/Xft.man
@@ -674,7 +674,10 @@ function).
 behaves as
 .B XftFontOpen
 does, except that it takes a string containing an X Logical Font
-Description (XLFD).
+Description (XLFD),
+and uses the
+.BR XftXlfdParse ()
+function.
 .PP
 .PS
 \fBFcPattern\fP *\fBXftFontMatch\fP (
@@ -696,6 +699,70 @@ The
 and
 .B FcResult
 data types are defined by the Fontconfig library.
+.PS
+\fBFcPattern\fP *\fBXftXlfdParse\fP (
+	\fB_Xconst char\fP	*\fIxlfd_orig\fP,
+	\fBBool\fP	\fIignore_scalable\fP,
+	\fBBool\fP	\fIcomplete\fP);
+.PE
+.B XftXlfdParse
+parses the
+.I xlfd_orig
+parameter according to the
+.I X Logical Font Description Conventions
+document, but ignores
+some of the fields:
+.IR setwidth_name ,
+.IR add_style_name  ,
+.IR spacing  ,
+and
+.IR average_width .
+.IP
+.B XftXlfdParse
+creates a Fontconfig pattern,
+setting
+.I XFT_XLFD
+to the
+.I xlfd_orig
+value,
+and
+maps the collected information to Fontconfig properties.
+Empty or \*(``*\*('' fields are ignored:
+.RS 10
+.TP 5
+FC_FOUNDRY
+from
+.IR foundry .
+.TP 5
+FC_FAMILY
+from
+.IR family .
+.TP 5
+FC_WEIGHT
+.IR weight_name ,
+defaulting to
+FC_WEIGHT_MEDIUM.
+.TP 5
+FC_SLANT
+from
+.IR slant ,
+defaulting to
+FC_SLANT_ROMAN.
+.TP 5
+FC_SIZE
+from
+.IR point_size .
+.TP 5
+FC_PIXEL_SIZE
+from 
+.IR pixel_size .
+If
+.I point_size
+was set, as well as
+.IR resolution_x and
+.IR resolution_y ,
+then the value is scaled convert the font's height to points.
+.RE
 .\" *************************************************************************
 .SS "Determining Text Extents"
 .B Xft
@@ -705,7 +772,7 @@ After accounting for the
 .IR offset ,
 in cases where the string will be shifted up, down, left or right,
 these numbers are referred to as
-.IR Itext extents .
+.IR "text extents" .
 .PS
 \fBvoid\fP \fBXftTextExtents8\fP (
 	\fBDisplay\fP	*\fIdpy\fP,