fc-match/fc-match.1

   1 .\" auto-generated by docbook2man-spec from docbook-utils package
   2 .TH "FC-MATCH" "1" "Aug 13, 2008" "" ""
   3 .SH NAME
   4 fc-match \- match available fonts
   5 .SH SYNOPSIS
   6 .sp
   7 \fBfc-match\fR [ \fB-asvVh\fR ]  [ \fB--all\fR ]  [ \fB--sort\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-match\fR matches
  13 \fIpattern\fR (empty
  14 pattern by default) using the normal fontconfig matching rules to find
  15 the best font available. If \fB--sort\fR is given, the sorted list of best
  16 matching fonts is displayed.
  17 The \fB--all\fR option works like
  18 \fB--sort\fR except that no pruning is done on the list of fonts.
  19 .PP
  20 If any elements are specified, only those are printed.
  21 Otherwise short file name, family, and style are printed, unless verbose
  22 output is requested.
  23 .SH "OPTIONS"
  24 .PP
  25 This program follows the usual GNU command line syntax,
  26 with long options starting with two dashes (`-'). A summary of
  27 options is included below.
  28 .TP
  29 \fB-a\fR
  30 Displays sorted list of best matching fonts, but do not do any
  31 pruning on the list.
  32 .TP
  33 \fB-s\fR
  34 Displays sorted list of best matching fonts.
  35 .TP
  36 \fB-v\fR
  37 Print verbose output of the whole font pattern for each match,
  38 or \fIelement\fRs if any is
  39 provided.
  40 .TP
  41 \fB-f\fR
  42 Format output according to the format specifier
  43 \fIformat\fR\&.
  44 .TP
  45 \fB-V\fR
  46 Show version of the program and exit.
  47 .TP
  48 \fB-h\fR
  49 Show summary of options.
  50 .TP
  51 \fB\fIpattern\fB\fR
  52 Displays fonts matching
  53 \fIpattern\fR (uses empty pattern by default).
  54 .TP
  55 \fB\fIelement\fB\fR
  56 If set, the \fIelement\fR property
  57 is displayed for matching fonts.
  58 .SH "SEE ALSO"
  59 .PP
  60 \fBfc-list\fR(1)
  61 \fBFcFontMatch\fR(3)
  62 \fBFcFontSort\fR(3)
  63 \fBFcPatternFormat\fR(3)
  64 \fBfc-cat\fR(1)
  65 \fBfc-cache\fR(1)
  66 \fBfc-pattern\fR(1)
  67 \fBfc-query\fR(1)
  68 \fBfc-scan\fR(1)
  69 .PP
  70 The fontconfig user's guide, in HTML format:
  71 \fI/usr/share/doc/fontconfig/fontconfig-user.html\fR\&.
  72 .SH "AUTHOR"
  73 .PP
  74 This manual page was updated by Patrick Lam <plam@csail.mit.edu>\&.