 <!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->

<html>
<head>
<title>"FC-MATCH"("1") manual page</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>

<h2><a name='sect0' href='#toc0'>Name</a></h2>
fc-match - match available fonts 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<p>
<b>fc-match</b> [ <b>-asvVh</b> ]  [ <b>--all</b> ]
 [ <b>--sort</b> ]  [ <b>--verbose</b> ]  [ <b> [ -f <i>format<b> ]  [ --format <i>format<b> ] </b></i></b></i></b> ]  [ <b>--version</b>
]  [ <b>--help</b> ]  
<p>  [ <b><i>pattern<b>  [ <i>element<b><i>...<b> ]  </b></i></b></i></b></i></b> ] <br>
 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<p>
<b>fc-match</b> matches <i>pattern</i> (empty pattern by default) using the
normal fontconfig matching rules to find the best font available. If <b>--sort</b>
is given, the sorted list of best matching fonts is displayed. The <b>--all</b> option
works like <b>--sort</b> except that no pruning is done on the list of fonts. <p>
If
any elements are specified, only those are printed. Otherwise short file
name, family, and style are printed, unless verbose output is requested.

<h2><a name='sect3' href='#toc3'>Options</a></h2>
<p>
This program follows the usual GNU command line syntax, with long
options starting with two dashes (&lsquo;-&rsquo;). A summary of options is included below.

<dl>

<dt><b>-a</b> </dt>
<dd>Displays sorted list of best matching fonts, but do not do any pruning
on the list. </dd>

<dt><b>-s</b> </dt>
<dd>Displays sorted list of best matching fonts. </dd>

<dt><b>-v</b> </dt>
<dd>Print verbose
output of the whole font pattern for each match, or <i>element</i>s if any is
provided. </dd>

<dt><b>-f</b> </dt>
<dd>Format output according to the format specifier <i>format</i>. </dd>

<dt><b>-V</b> </dt>
<dd>Show
version of the program and exit. </dd>

<dt><b>-h</b> </dt>
<dd>Show summary of options. </dd>

<dt><b><i>pattern<b></b></i></b> </dt>
<dd>Displays
fonts matching <i>pattern</i> (uses empty pattern by default). </dd>

<dt><b><i>element<b></b></i></b> </dt>
<dd>If set,
the <i>element</i> property is displayed for matching fonts. </dd>
</dl>

<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<p>
<a href='fc-list.1'><b>fc-list</b>(1)</a>

<a href='FcFontMatch.3'><b>FcFontMatch</b>(3)</a>
 <a href='FcFontSort.3'><b>FcFontSort</b>(3)</a>
 <a href='FcPatternFormat.3'><b>FcPatternFormat</b>(3)</a>
 <a href='fc-cat.1'><b>fc-cat</b>(1)</a>
 <a href='fc-cache.1'><b>fc-cache</b>(1)</a>
 <a href='fc-pattern.1'><b>fc-pattern</b>(1)</a>

<a href='fc-query.1'><b>fc-query</b>(1)</a>
 <a href='fc-scan.1'><b>fc-scan</b>(1)</a>
 <p>
The fontconfig user&rsquo;s guide, in HTML format: <i>/usr/share/doc/fontconfig/fontconfig-user.html</i>.

<h2><a name='sect5' href='#toc5'>Author</a></h2>
<p>
This manual page was updated by Patrick Lam &lt;plam@csail.mit.edu&gt;. <p>

<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Options</a></li>
<li><a name='toc4' href='#sect4'>See Also</a></li>
<li><a name='toc5' href='#sect5'>Author</a></li>
</ul>
</body>
</html>
