306ee239cc0189940f1185d144fd9ae3c66dcf97
[platform/upstream/fontconfig.git] / fc-list / fc-list.1
1 .\" auto-generated by docbook2man-spec from docbook-utils package
2 .TH "FC-LIST" "1" "Aug 13, 2008" "" ""
3 .SH NAME
4 fc-list \- list available fonts
5 .SH SYNOPSIS
6 .sp
7 \fBfc-list\fR [ \fB-vVh\fR ]  [ \fB--verbose\fR ]  [ \fB [ -f \fIformat\fB ]  [ --format \fIformat\fB ] \fR ]  [ \fB--version\fR ]  [ \fB--help\fR ] 
8
9  [ \fB\fIpattern\fB  [ \fIelement\fB\fI...\fB ]  \fR ] 
10 .SH "DESCRIPTION"
11 .PP
12 \fBfc-list\fR lists fonts and styles
13 available on the system for applications using fontconfig.
14 If any elements are specified, only those are printed.
15 Otherwise family and style are printed, unless verbose
16 output is requested.
17 .SH "OPTIONS"
18 .PP
19 This program follows the usual GNU command line syntax,
20 with long options starting with two dashes (`-'). A summary of
21 options is included below.
22 .TP
23 \fB-v\fR
24 Print verbose output of the whole font pattern for each match,
25 or \fIelement\fRs if any is
26 provided.
27 .TP
28 \fB-f\fR
29 Format output according to the format specifier
30 \fIformat\fR\&.
31 .TP
32 \fB-V\fR
33 Show version of the program and exit.
34 .TP
35 \fB-h\fR
36 Show summary of options.
37 .TP
38 \fB\fIpattern\fB\fR
39 If this argument is set, only fonts matching
40 \fIpattern\fR are displayed.
41 .TP
42 \fB\fIelement\fB\fR
43 If set, the \fIelement\fR property
44 is displayed for matching fonts.
45 .SH "EXAMPLES"
46 .TP
47 \fBfc-list\fR
48 Lists all font faces.
49 .TP
50 \fBfc-list :lang=hi\fR
51 Lists font faces that cover Hindi.
52 .TP
53 \fBfc-list : family style file spacing\fR
54 Lists the filename and spacing value for each font
55 face. ``:'' is an empty pattern that matches all
56 fonts.
57 .SH "SEE ALSO"
58 .PP
59 \fBfc-match\fR(1)
60 \fBFcFontList\fR(3)
61 \fBFcPatternFormat\fR(3)
62 \fBfc-cat\fR(1)
63 \fBfc-cache\fR(1)
64 \fBfc-pattern\fR(1)
65 \fBfc-query\fR(1)
66 \fBfc-scan\fR(1)
67 .PP
68 The fontconfig user's guide, in HTML format:
69 \fI/usr/share/doc/fontconfig/fontconfig-user.html\fR\&.
70 .SH "AUTHOR"
71 .PP
72 This manual page was written by Keith Packard
73 <keithp@keithp.com> and Josselin Mouette <joss@debian.org>\&.