svn merge ^/branches/released .

3 files changed, 442 insertions, 441 deletions

diff --git a/fontconfig/fc-query/Makefile.am b/fontconfig/fc-query/Makefile.am
index 114fd7f80..a7300a3bc 100644
--- a/fontconfig/fc-query/Makefile.am
+++ b/fontconfig/fc-query/Makefile.am
@@ -1,59 +1,59 @@
-#
-#  fontconfig/fc-query/Makefile.am
-#
-#  Copyright © 2003 Keith Packard
-#
-#  Permission to use, copy, modify, distribute, and sell this software and its
-#  documentation for any purpose is hereby granted without fee, provided that
-#  the above copyright notice appear in all copies and that both that
-#  copyright notice and this permission notice appear in supporting
-#  documentation, and that the name of Keith Packard not be used in
-#  advertising or publicity pertaining to distribution of the software without
-#  specific, written prior permission.  Keith Packard makes no
-#  representations about the suitability of this software for any purpose.  It
-#  is provided "as is" without express or implied warranty.
-#
-#  THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
-#  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
-#  EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
-#  CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
-#  DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
-#  TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-#  PERFORMANCE OF THIS SOFTWARE.
-
-bin_PROGRAMS=fc-query
-
-DOC2MAN = docbook2man
-
-FC_QUERY_SRC=${top_srcdir}/fc-query
-
-SGML = ${FC_QUERY_SRC}/fc-query.sgml
-
-INCLUDES=-I${top_srcdir} $(FREETYPE_CFLAGS) $(WARN_CFLAGS)
-
-BUILT_MANS=fc-query.1
-
-if ENABLE_DOCS
-man_MANS=${BUILT_MANS}
-endif
-
-EXTRA_DIST=fc-query.sgml $(BUILT_MANS)
-
-fc_query_LDADD = ${top_builddir}/src/libfontconfig.la
-
-if USEDOCBOOK
-
-${man_MANS}: ${SGML}
-	$(RM) $@
-	$(DOC2MAN) ${SGML}
-	$(RM) manpage.*
-
-all-local: $(man_MANS)
-
-clean-local:
-	$(RM) $(man_MANS)
-
-else
-all-local:
-clean-local:
-endif
+#

+#  fontconfig/fc-query/Makefile.am

+#

+#  Copyright © 2003 Keith Packard

+#

+#  Permission to use, copy, modify, distribute, and sell this software and its

+#  documentation for any purpose is hereby granted without fee, provided that

+#  the above copyright notice appear in all copies and that both that

+#  copyright notice and this permission notice appear in supporting

+#  documentation, and that the name of the author(s) not be used in

+#  advertising or publicity pertaining to distribution of the software without

+#  specific, written prior permission.  The authors make no

+#  representations about the suitability of this software for any purpose.  It

+#  is provided "as is" without express or implied warranty.

+#

+#  THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,

+#  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO

+#  EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR

+#  CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,

+#  DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER

+#  TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+#  PERFORMANCE OF THIS SOFTWARE.

+

+bin_PROGRAMS=fc-query

+

+DOC2MAN = docbook2man

+

+FC_QUERY_SRC=${top_srcdir}/fc-query

+

+SGML = ${FC_QUERY_SRC}/fc-query.sgml

+

+INCLUDES=-I${top_srcdir} $(FREETYPE_CFLAGS) $(WARN_CFLAGS)

+

+BUILT_MANS=fc-query.1

+

+if ENABLE_DOCS

+man_MANS=${BUILT_MANS}

+endif

+

+EXTRA_DIST=fc-query.sgml $(BUILT_MANS)

+

+fc_query_LDADD = ${top_builddir}/src/libfontconfig.la

+

+if USEDOCBOOK

+

+${man_MANS}: ${SGML}

+	$(RM) $@

+	$(DOC2MAN) ${SGML}

+	$(RM) manpage.*

+

+all-local: $(man_MANS)

+

+clean-local:

+	$(RM) $(man_MANS)

+

+else

+all-local:

+clean-local:

+endif

diff --git a/fontconfig/fc-query/fc-query.c b/fontconfig/fc-query/fc-query.c
index f2693de59..efb1aa0e4 100644
--- a/fontconfig/fc-query/fc-query.c
+++ b/fontconfig/fc-query/fc-query.c
@@ -1,191 +1,191 @@
-/*
- * fontconfig/fc-query/fc-query.c
- *
- * Copyright © 2003 Keith Packard
- * Copyright © 2008 Red Hat, Inc.
- * Red Hat Author(s): Behdad Esfahbod
- *
- * Permission to use, copy, modify, distribute, and sell this software and its
- * documentation for any purpose is hereby granted without fee, provided that
- * the above copyright notice appear in all copies and that both that
- * copyright notice and this permission notice appear in supporting
- * documentation, and that the name of Keith Packard not be used in
- * advertising or publicity pertaining to distribution of the software without
- * specific, written prior permission.  Keith Packard makes no
- * representations about the suitability of this software for any purpose.  It
- * is provided "as is" without express or implied warranty.
- *
- * THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
- * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
- * EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
- * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
- * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
- * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- * PERFORMANCE OF THIS SOFTWARE.
- */
-
-#ifdef HAVE_CONFIG_H
-#include <config.h>
-#else
-#ifdef linux
-#define HAVE_GETOPT_LONG 1
-#endif
-#define HAVE_GETOPT 1
-#endif
-
-#include <fontconfig/fontconfig.h>
-#include <fontconfig/fcfreetype.h>
-#include <stdio.h>
-#include <unistd.h>
-#include <stdlib.h>
-#include <string.h>
-
-#ifndef HAVE_GETOPT
-#define HAVE_GETOPT 0
-#endif
-#ifndef HAVE_GETOPT_LONG
-#define HAVE_GETOPT_LONG 0
-#endif
-
-#if HAVE_GETOPT_LONG
-#undef  _GNU_SOURCE
-#define _GNU_SOURCE
-#include <getopt.h>
-static const struct option longopts[] = {
-    {"index", 1, 0, 'i'},
-    {"format", 1, 0, 'f'},
-    {"version", 0, 0, 'V'},
-    {"help", 0, 0, 'h'},
-    {NULL,0,0,0},
-};
-#else
-#if HAVE_GETOPT
-extern char *optarg;
-extern int optind, opterr, optopt;
-#endif
-#endif
-
-static void
-usage (char *program, int error)
-{
-    FILE *file = error ? stderr : stdout;
-#if HAVE_GETOPT_LONG
-    fprintf (file, "usage: %s [-Vh] [-i index] [-f FORMAT] [--index index] [--format FORMAT] [--version] [--help] font-file...\n",
-	     program);
-#else
-    fprintf (file, "usage: %s [-Vh] [-i index] [-f FORMAT] font-file...\n",
-	     program);
-#endif
-    fprintf (file, "Query font files and print resulting pattern(s)\n");
-    fprintf (file, "\n");
-#if HAVE_GETOPT_LONG
-    fprintf (file, "  -i, --index INDEX    display the INDEX face of each font file only\n");
-    fprintf (file, "  -f, --format=FORMAT  use the given output format\n");
-    fprintf (file, "  -V, --version        display font config version and exit\n");
-    fprintf (file, "  -h, --help           display this help and exit\n");
-#else
-    fprintf (file, "  -i INDEX   (index)   display the INDEX face of each font file only\n");
-    fprintf (file, "  -f FORMAT  (format)  use the given output format\n");
-    fprintf (file, "  -V         (version) display font config version and exit\n");
-    fprintf (file, "  -h         (help)    display this help and exit\n");
-#endif
-    exit (error);
-}
-
-int
-main (int argc, char **argv)
-{
-    int		index_set = 0;
-    int		set_index = 0;
-    FcChar8     *format = NULL;
-    int		err = 0;
-    int		i;
-    FcBlanks    *blanks;
-#if HAVE_GETOPT_LONG || HAVE_GETOPT
-    int		c;
-
-#if HAVE_GETOPT_LONG
-    while ((c = getopt_long (argc, argv, "i:f:Vh", longopts, NULL)) != -1)
-#else
-    while ((c = getopt (argc, argv, "i:f:Vh")) != -1)
-#endif
-    {
-	switch (c) {
-	case 'i':
-	    index_set = 1;
-	    set_index = atoi (optarg);
-	    break;
-	case 'f':
-	    format = (FcChar8 *) strdup (optarg);
-	    break;
-	case 'V':
-	    fprintf (stderr, "fontconfig version %d.%d.%d\n",
-		     FC_MAJOR, FC_MINOR, FC_REVISION);
-	    exit (0);
-	case 'h':
-	    usage (argv[0], 0);
-	default:
-	    usage (argv[0], 1);
-	}
-    }
-    i = optind;
-#else
-    i = 1;
-#endif
-
-    if (i == argc)
-	usage (argv[0], 1);
-
-    if (!FcInit ())
-    {
-	fprintf (stderr, "Can't init font config library\n");
-	return 1;
-    }
-
-    blanks = FcConfigGetBlanks (NULL);
-
-    for (; i < argc; i++)
-    {
-	int index;
-	int count = 0;
-
-	index = set_index;
-
-	do {
-	    FcPattern *pat;
-
-	    pat = FcFreeTypeQuery ((FcChar8 *) argv[i], index, blanks, &count);
-	    if (pat)
-	    {
-		if (format)
-		{
-		    FcChar8 *s;
-
-		    s = FcPatternFormat (pat, format);
-		    if (s)
-		    {
-			printf ("%s", s);
-			free (s);
-		    }
-		}
-		else
-		{
-		    FcPatternPrint (pat);
-		}
-
-		FcPatternDestroy (pat);
-	    }
-	    else
-	    {
-		fprintf (stderr, "Can't query face %d of font file %s\n",
-			 index, argv[i]);
-		err = 1;
-	    }
-
-	    index++;
-	} while (!index_set && index < count);
-    }
-
-    FcFini ();
-    return err;
-}
+/*

+ * fontconfig/fc-query/fc-query.c

+ *

+ * Copyright © 2003 Keith Packard

+ * Copyright © 2008 Red Hat, Inc.

+ * Red Hat Author(s): Behdad Esfahbod

+ *

+ * Permission to use, copy, modify, distribute, and sell this software and its

+ * documentation for any purpose is hereby granted without fee, provided that

+ * the above copyright notice appear in all copies and that both that

+ * copyright notice and this permission notice appear in supporting

+ * documentation, and that the name of the author(s) not be used in

+ * advertising or publicity pertaining to distribution of the software without

+ * specific, written prior permission.  The authors make no

+ * representations about the suitability of this software for any purpose.  It

+ * is provided "as is" without express or implied warranty.

+ *

+ * THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,

+ * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO

+ * EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR

+ * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,

+ * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER

+ * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+ * PERFORMANCE OF THIS SOFTWARE.

+ */

+

+#ifdef HAVE_CONFIG_H

+#include <config.h>

+#else

+#ifdef linux

+#define HAVE_GETOPT_LONG 1

+#endif

+#define HAVE_GETOPT 1

+#endif

+

+#include <fontconfig/fontconfig.h>

+#include <fontconfig/fcfreetype.h>

+#include <stdio.h>

+#include <unistd.h>

+#include <stdlib.h>

+#include <string.h>

+

+#ifndef HAVE_GETOPT

+#define HAVE_GETOPT 0

+#endif

+#ifndef HAVE_GETOPT_LONG

+#define HAVE_GETOPT_LONG 0

+#endif

+

+#if HAVE_GETOPT_LONG

+#undef  _GNU_SOURCE

+#define _GNU_SOURCE

+#include <getopt.h>

+static const struct option longopts[] = {

+    {"index", 1, 0, 'i'},

+    {"format", 1, 0, 'f'},

+    {"version", 0, 0, 'V'},

+    {"help", 0, 0, 'h'},

+    {NULL,0,0,0},

+};

+#else

+#if HAVE_GETOPT

+extern char *optarg;

+extern int optind, opterr, optopt;

+#endif

+#endif

+

+static void

+usage (char *program, int error)

+{

+    FILE *file = error ? stderr : stdout;

+#if HAVE_GETOPT_LONG

+    fprintf (file, "usage: %s [-Vh] [-i index] [-f FORMAT] [--index index] [--format FORMAT] [--version] [--help] font-file...\n",

+	     program);

+#else

+    fprintf (file, "usage: %s [-Vh] [-i index] [-f FORMAT] font-file...\n",

+	     program);

+#endif

+    fprintf (file, "Query font files and print resulting pattern(s)\n");

+    fprintf (file, "\n");

+#if HAVE_GETOPT_LONG

+    fprintf (file, "  -i, --index INDEX    display the INDEX face of each font file only\n");

+    fprintf (file, "  -f, --format=FORMAT  use the given output format\n");

+    fprintf (file, "  -V, --version        display font config version and exit\n");

+    fprintf (file, "  -h, --help           display this help and exit\n");

+#else

+    fprintf (file, "  -i INDEX   (index)   display the INDEX face of each font file only\n");

+    fprintf (file, "  -f FORMAT  (format)  use the given output format\n");

+    fprintf (file, "  -V         (version) display font config version and exit\n");

+    fprintf (file, "  -h         (help)    display this help and exit\n");

+#endif

+    exit (error);

+}

+

+int

+main (int argc, char **argv)

+{

+    int		index_set = 0;

+    int		set_index = 0;

+    FcChar8     *format = NULL;

+    int		err = 0;

+    int		i;

+    FcBlanks    *blanks;

+#if HAVE_GETOPT_LONG || HAVE_GETOPT

+    int		c;

+

+#if HAVE_GETOPT_LONG

+    while ((c = getopt_long (argc, argv, "i:f:Vh", longopts, NULL)) != -1)

+#else

+    while ((c = getopt (argc, argv, "i:f:Vh")) != -1)

+#endif

+    {

+	switch (c) {

+	case 'i':

+	    index_set = 1;

+	    set_index = atoi (optarg);

+	    break;

+	case 'f':

+	    format = (FcChar8 *) strdup (optarg);

+	    break;

+	case 'V':

+	    fprintf (stderr, "fontconfig version %d.%d.%d\n",

+		     FC_MAJOR, FC_MINOR, FC_REVISION);

+	    exit (0);

+	case 'h':

+	    usage (argv[0], 0);

+	default:

+	    usage (argv[0], 1);

+	}

+    }

+    i = optind;

+#else

+    i = 1;

+#endif

+

+    if (i == argc)

+	usage (argv[0], 1);

+

+    if (!FcInit ())

+    {

+	fprintf (stderr, "Can't init font config library\n");

+	return 1;

+    }

+

+    blanks = FcConfigGetBlanks (NULL);

+

+    for (; i < argc; i++)

+    {

+	int index;

+	int count = 0;

+

+	index = set_index;

+

+	do {

+	    FcPattern *pat;

+

+	    pat = FcFreeTypeQuery ((FcChar8 *) argv[i], index, blanks, &count);

+	    if (pat)

+	    {

+		if (format)

+		{

+		    FcChar8 *s;

+

+		    s = FcPatternFormat (pat, format);

+		    if (s)

+		    {

+			printf ("%s", s);

+			free (s);

+		    }

+		}

+		else

+		{

+		    FcPatternPrint (pat);

+		}

+

+		FcPatternDestroy (pat);

+	    }

+	    else

+	    {

+		fprintf (stderr, "Can't query face %d of font file %s\n",

+			 index, argv[i]);

+		err = 1;

+	    }

+

+	    index++;

+	} while (!index_set && index < count);

+    }

+

+    FcFini ();

+    return err;

+}

diff --git a/fontconfig/fc-query/fc-query.sgml b/fontconfig/fc-query/fc-query.sgml
index 59fd63548..e81e7bf14 100644
--- a/fontconfig/fc-query/fc-query.sgml
+++ b/fontconfig/fc-query/fc-query.sgml
@@ -1,191 +1,192 @@
-<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
-
-<!-- Process this file with docbook-to-man to generate an nroff manual
-     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
-     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
-     less'.  A typical entry in a Makefile or Makefile.am is:
-
-manpage.1: manpage.sgml
-	docbook-to-man $< > $@
-
-
-	The docbook-to-man binary is found in the docbook-to-man package.
-	Please remember that if you create the nroff version in one of the
-	debian/rules file targets (such as build), you will need to include
-	docbook-to-man in your Build-Depends control field.
-
-  -->
-
-  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
-  <!ENTITY dhfirstname "<firstname>Behdad</firstname>">
-  <!ENTITY dhsurname   "<surname>Esfahbod</surname>">
-  <!-- Please adjust the date whenever revising the manpage. -->
-  <!ENTITY dhdate      "<date>Aug 13, 2008</date>">
-  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
-       allowed: see man(7), man(1). -->
-  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
-  <!ENTITY dhemail     "<email>behdad@behdad.org</email>">
-  <!ENTITY dhusername  "Behdad Esfahbod">
-  <!ENTITY dhucpackage "<refentrytitle>fc-query</refentrytitle>">
-  <!ENTITY dhpackage   "fc-query">
-
-  <!ENTITY gnu         "<acronym>GNU</acronym>">
-  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
-]>
-
-<refentry>
-  <refentryinfo>
-    <address>
-      &dhemail;
-    </address>
-    <author>
-      &dhfirstname;
-      &dhsurname;
-    </author>
-    <copyright>
-      <year>2008</year>
-      <holder>&dhusername;</holder>
-    </copyright>
-    &dhdate;
-  </refentryinfo>
-  <refmeta>
-    &dhucpackage;
-
-    &dhsection;
-  </refmeta>
-  <refnamediv>
-    <refname>&dhpackage;</refname>
-
-    <refpurpose>query font files</refpurpose>
-  </refnamediv>
-  <refsynopsisdiv>
-    <cmdsynopsis>
-      <command>&dhpackage;</command>
-
-      <arg><option>-Vh</option></arg>
-      <sbr>
-      <group>
-        <arg><option>-i</option> <option><replaceable>index</replaceable></option></arg>
-        <arg><option>--index</option> <option><replaceable>index</replaceable></option></arg>
-      </group>
-      <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>
-      <arg choice="req" rep="repeat"><option><replaceable>font-file</replaceable></option></arg>
-
-     </cmdsynopsis>
-  </refsynopsisdiv>
-  <refsect1>
-    <title>DESCRIPTION</title>
-
-    <para><command>&dhpackage;</command> queries
-    <replaceable>font-file</replaceable>(s) using the normal fontconfig
-    rules and prints out font pattern for each face found.
-    If <option>--index</option> is given, only one face of each file is
-    queried, otherwise all faces are queried.</para>
-
-  </refsect1>
-  <refsect1>
-    <title>OPTIONS</title>
-
-    <para>This program follows the usual &gnu; command line syntax,
-      with long options starting with two dashes (`-').  A summary of
-      options is included below.</para>
-
-    <variablelist>
-      <varlistentry>
-        <term><option>-i</option>
-          <option>--index</option>
-	  <option><replaceable>index</replaceable></option>
-        </term>
-        <listitem>
-          <para>Only query face indexed <replaceable>index</replaceable> of
-	  each file.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-f</option>
-          <option>--format</option>
-	  <option><replaceable>format</replaceable></option>
-        </term>
-        <listitem>
-          <para>Format output according to the format specifier
-	  <replaceable>format</replaceable>.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-V</option>
-          <option>--version</option>
-        </term>
-        <listitem>
-          <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>font-file</replaceable></option>
-        </term>
-        <listitem>
-          <para>Query <replaceable>font-file</replaceable> for font faces.</para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-  </refsect1>
-
-  <refsect1>
-    <title>RETURN CODES</title>
-    <para><command>fc-query</command> returns error code 0 for successful parsing,
-    or 1 if any errors occured or if at least one font face could not be opened.</para>
-  </refsect1>
-
-  <refsect1>
-    <title>SEE ALSO</title>
-
-    <para>
-      <command>fc-scan</command>(1)
-      <function>FcFreeTypeQuery</function>(3)
-      <function>FcPatternFormat</function>(3)
-      <command>fc-cat</command>(1)
-      <command>fc-cache</command>(1)
-      <command>fc-list</command>(1)
-      <command>fc-match</command>(1)
-    </para>
-
-    <para>The fontconfig user's guide, in HTML format:
-      <filename>/usr/share/doc/fontconfig/fontconfig-user.html</filename>.</para>
-
- </refsect1>
-  <refsect1>
-    <title>AUTHOR</title>
-
-    <para>This manual page was updated by &dhusername; &dhemail;.</para>
-
-  </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:2
-sgml-indent-data:t
-sgml-parent-document:nil
-sgml-default-dtd-file:nil
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

+

+<!-- Process this file with docbook-to-man to generate an nroff manual

+     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view

+     the manual page with: `docbook-to-man manpage.sgml | nroff -man |

+     less'.  A typical entry in a Makefile or Makefile.am is:

+

+manpage.1: manpage.sgml

+	docbook-to-man $< > $@

+

+

+	The docbook-to-man binary is found in the docbook-to-man package.

+	Please remember that if you create the nroff version in one of the

+	debian/rules file targets (such as build), you will need to include

+	docbook-to-man in your Build-Depends control field.

+

+  -->

+

+  <!-- Fill in your name for FIRSTNAME and SURNAME. -->

+  <!ENTITY dhfirstname "<firstname>Behdad</firstname>">

+  <!ENTITY dhsurname   "<surname>Esfahbod</surname>">

+  <!-- Please adjust the date whenever revising the manpage. -->

+  <!ENTITY dhdate      "<date>Aug 13, 2008</date>">

+  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are

+       allowed: see man(7), man(1). -->

+  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">

+  <!ENTITY dhemail     "<email>behdad@behdad.org</email>">

+  <!ENTITY dhusername  "Behdad Esfahbod">

+  <!ENTITY dhucpackage "<refentrytitle>fc-query</refentrytitle>">

+  <!ENTITY dhpackage   "fc-query">

+

+  <!ENTITY gnu         "<acronym>GNU</acronym>">

+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">

+]>

+

+<refentry>

+  <refentryinfo>

+    <address>

+      &dhemail;

+    </address>

+    <author>

+      &dhfirstname;

+      &dhsurname;

+    </author>

+    <copyright>

+      <year>2008</year>

+      <holder>&dhusername;</holder>

+    </copyright>

+    &dhdate;

+  </refentryinfo>

+  <refmeta>

+    &dhucpackage;

+

+    &dhsection;

+  </refmeta>

+  <refnamediv>

+    <refname>&dhpackage;</refname>

+

+    <refpurpose>query font files</refpurpose>

+  </refnamediv>

+  <refsynopsisdiv>

+    <cmdsynopsis>

+      <command>&dhpackage;</command>

+

+      <arg><option>-Vh</option></arg>

+      <sbr>

+      <group>

+        <arg><option>-i</option> <option><replaceable>index</replaceable></option></arg>

+        <arg><option>--index</option> <option><replaceable>index</replaceable></option></arg>

+      </group>

+      <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>

+      <arg choice="req" rep="repeat"><option><replaceable>font-file</replaceable></option></arg>

+

+     </cmdsynopsis>

+  </refsynopsisdiv>

+  <refsect1>

+    <title>DESCRIPTION</title>

+

+    <para><command>&dhpackage;</command> queries

+    <replaceable>font-file</replaceable>(s) using the normal fontconfig

+    rules and prints out font pattern for each face found.

+    If <option>--index</option> is given, only one face of each file is

+    queried, otherwise all faces are queried.</para>

+

+  </refsect1>

+  <refsect1>

+    <title>OPTIONS</title>

+

+    <para>This program follows the usual &gnu; command line syntax,

+      with long options starting with two dashes (`-').  A summary of

+      options is included below.</para>

+

+    <variablelist>

+      <varlistentry>

+        <term><option>-i</option>

+          <option>--index</option>

+	  <option><replaceable>index</replaceable></option>

+        </term>

+        <listitem>

+          <para>Only query face indexed <replaceable>index</replaceable> of

+	  each file.</para>

+        </listitem>

+      </varlistentry>

+      <varlistentry>

+        <term><option>-f</option>

+          <option>--format</option>

+	  <option><replaceable>format</replaceable></option>

+        </term>

+        <listitem>

+          <para>Format output according to the format specifier

+	  <replaceable>format</replaceable>.</para>

+        </listitem>

+      </varlistentry>

+      <varlistentry>

+        <term><option>-V</option>

+          <option>--version</option>

+        </term>

+        <listitem>

+          <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>font-file</replaceable></option>

+        </term>

+        <listitem>

+          <para>Query <replaceable>font-file</replaceable> for font faces.</para>

+        </listitem>

+      </varlistentry>

+    </variablelist>

+  </refsect1>

+

+  <refsect1>

+    <title>RETURN CODES</title>

+    <para><command>fc-query</command> returns error code 0 for successful parsing,

+    or 1 if any errors occured or if at least one font face could not be opened.</para>

+  </refsect1>

+

+  <refsect1>

+    <title>SEE ALSO</title>

+

+    <para>

+      <command>fc-scan</command>(1)

+      <function>FcFreeTypeQuery</function>(3)

+      <function>FcPatternFormat</function>(3)

+      <command>fc-cat</command>(1)

+      <command>fc-cache</command>(1)

+      <command>fc-list</command>(1)

+      <command>fc-match</command>(1)

+      <command>fc-pattern</command>(1)

+    </para>

+

+    <para>The fontconfig user's guide, in HTML format:

+      <filename>/usr/share/doc/fontconfig/fontconfig-user.html</filename>.</para>

+

+ </refsect1>

+  <refsect1>

+    <title>AUTHOR</title>

+

+    <para>This manual page was updated by &dhusername; &dhemail;.</para>

+

+  </refsect1>

+</refentry>

+

+<!-- Keep this comment at the end of the file

+Local variables:

+mode: sgml

+sgml-omittag:t

+sgml-shorttag:t

+sgml-minimize-attributes:nil

+sgml-always-quote-attributes:t

+sgml-indent-step:2

+sgml-indent-data:t

+sgml-parent-document:nil

+sgml-default-dtd-file:nil

+sgml-exposed-tags:nil

+sgml-local-catalogs:nil

+sgml-local-ecat-files:nil

+End:

+-->