Change script name following numbering policy
[platform/upstream/fontconfig.git] / fc-query / fc-query.1
1 .\" auto-generated by docbook2man-spec from docbook-utils package
2 .TH "FC-QUERY" "1" "Aug 13, 2008" "" ""
3 .SH NAME
4 fc-query \- query font files
5 .SH SYNOPSIS
6 .sp
7 \fBfc-query\fR [ \fB-Vh\fR ] 
8
9  [ \fB [ -b ]  [ --ignore-blanks ] \fR ]  [ \fB [ -i \fIindex\fB ]  [ --index \fIindex\fB ] \fR ]  [ \fB [ -f \fIformat\fB ]  [ --format \fIformat\fB ] \fR ]  [ \fB--version\fR ]  [ \fB--help\fR ]  \fB\fIfont-file\fB\fR\fI...\fR
10 .SH "DESCRIPTION"
11 .PP
12 \fBfc-query\fR queries
13 \fIfont-file\fR(s) using the normal fontconfig
14 rules and prints out font pattern for each face found.
15 If \fB--index\fR is given, only one face of each file is
16 queried, otherwise all faces are queried.
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-b\fR
24 Ignore blanks to compute languages
25 .TP
26 \fB-i\fR
27 Only query face indexed \fIindex\fR of
28 each file.
29 .TP
30 \fB-f\fR
31 Format output according to the format specifier
32 \fIformat\fR\&.
33 .TP
34 \fB-V\fR
35 Show version of the program and exit.
36 .TP
37 \fB-h\fR
38 Show summary of options.
39 .TP
40 \fB\fIfont-file\fB\fR
41 Query \fIfont-file\fR for font faces.
42 .SH "RETURN CODES"
43 .PP
44 \fBfc-query\fR returns error code 0 for successful parsing,
45 or 1 if any errors occured or if at least one font face could not be opened.
46 .SH "SEE ALSO"
47 .PP
48 \fBfc-scan\fR(1)
49 \fBFcFreeTypeQuery\fR(3)
50 \fBFcPatternFormat\fR(3)
51 \fBfc-cat\fR(1)
52 \fBfc-cache\fR(1)
53 \fBfc-list\fR(1)
54 \fBfc-match\fR(1)
55 \fBfc-pattern\fR(1)
56 .PP
57 The fontconfig user's guide, in HTML format:
58 \fI/usr/share/doc/fontconfig/fontconfig-user.html\fR\&.
59 .SH "AUTHOR"
60 .PP
61 This manual page was updated by Behdad Esfahbod <behdad@behdad.org>\&.