Add fc-pattern cmdline tool

[fontconfig.git] / fc-list / fc-list.sgml

diff --git a/fc-list/fc-list.sgml b/fc-list/fc-list.sgml
index 35bf899db7c7a1ed0724bf8098b0f86f7c5c3f1c..c4a82cd6f79e6397c7628685d5e092b89b502dbb 100644 (file)
--- a/fc-list/fc-list.sgml
+++ b/fc-list/fc-list.sgml
@@ -65,6 +65,10 @@ manpage.1: manpage.sgml
 
       <arg><option>-vVh</option></arg>
       <arg><option>--verbose</option></arg>
+      <group>
+        <arg><option>-f</option> <option><replaceable>format</replaceable></option></arg>
+        <arg><option>--format</option> <option><replaceable>format</replaceable></option></arg>
+      </group>
       <arg><option>--version</option></arg>
       <arg><option>--help</option></arg>
       <sbr>
@@ -77,9 +81,9 @@ manpage.1: manpage.sgml
 
     <para><command>&dhpackage;</command> lists fonts and styles
       available on the system for applications using fontconfig.
-      With <option>--verbose</option>, the whole font pattern
-      for each font is printed, otherwise only the elements requested
-      are printed (family and style if none provided).</para>
+      If any elements are specified, only those are printed.
+      Otherwise family and style are printed, unless verbose
+      output is requested.</para>
   </refsect1>
   <refsect1>
     <title>OPTIONS</title>
@@ -94,17 +98,19 @@ manpage.1: manpage.sgml
           <option>--verbose</option>
         </term>
         <listitem>
-          <para>Print whole font pattern for each match.  Provided
-               <replaceable>element</replaceable>s are ignored in this
-               case.</para>
+          <para>Print verbose output of the whole font pattern for each match,
+               or <replaceable>element</replaceable>s if any is
+               provided.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><option>-h</option>
-          <option>--help</option>
+        <term><option>-f</option>
+          <option>--format</option>
+         <option><replaceable>format</replaceable></option>
         </term>
         <listitem>
-          <para>Show summary of options.</para>
+          <para>Format output according to the format specifier
+         <replaceable>format</replaceable>.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -115,6 +121,14 @@ manpage.1: manpage.sgml
           <para>Show version of the program and exit.</para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term><option>-h</option>
+          <option>--help</option>
+        </term>
+        <listitem>
+          <para>Show summary of options.</para>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term><option><replaceable>pattern</replaceable></option>
         </term>
@@ -160,10 +174,14 @@ manpage.1: manpage.sgml
     <title>SEE ALSO</title>
 
     <para>
+      <command>fc-match</command>(1)
+      <function>FcFontList</function>(3)
+      <function>FcPatternFormat</function>(3)
       <command>fc-cat</command>(1)
       <command>fc-cache</command>(1)
-      <command>fc-match</command>(1)
+      <command>fc-pattern</command>(1)
       <command>fc-query</command>(1)
+      <command>fc-scan</command>(1)
     </para>
 
     <para>The fontconfig user's guide, in HTML format: