<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2001/384 Gtk+ 2.0 / glib 2.0-->
<!--ARC : LSARC 2001/781 location of GTK/Glib-->
<!--ARC : PSARC 2001/804 GTK/Glib becomes Contracted External-->
<!ENTITY cmd "pango-querymodules">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2003,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">
]>
<refentry id="pango-querymodules-1">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta>
<refentrytitle>pango-querymodules</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">09 Nov 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm>
<primary>pango-querymodules</primary></indexterm>
<indexterm><primary>list the language modules available to the pango layout engine</primary></indexterm>
<refnamediv id="pango-querymodules-1-name">
<refname>pango-querymodules</refname>
<refpurpose>
list the language modules available to the pango layout engine
</refpurpose></refnamediv>
<refsynopsisdiv id="pango-querymodules-1-synp"><title>&synp-tt;</title>
<cmdsynopsis><command>&cmd;</command>
<arg choice="opt"><option>-help</option></arg>
<arg choice="opt"><option>-version</option></arg>
<arg choice="opt" rep="repeat"><option role="nodash"><replaceable>module</replaceable></option></arg>
</cmdsynopsis></refsynopsisdiv>

<refsect1 id="pango-querymodules-1-desc"><title>&desc-tt;</title>
<para>
&cmd; collects information about loadable modules for Pango and writes it to
<literal>stdout</literal>.
</para>

<para>
If called without arguments, it looks for language modules in the Pango module
path.  If called with arguments, it looks for the specified modules.  The
arguments may be absolute or relative paths.
</para>

<para>
The Pango module path is specified by the key Pango/ModulesPath in the Pango
config database, which is read from <filename>/etc/pango/pangorc</filename>,
<filename>~/.pangorc</filename>, and the file specified in the environment
variable PANGO_RC_FILE.
</para>

<para>
If the output is redirected to <filename>/etc/pango/pango.modules</filename>, 
this will cause the specified modules to be loaded as default modules.
</para>

</refsect1>
<refsect1 id="pango-querymodules-1-opts"><title>&opts-tt;</title>
<para>The following options are supported:</para>
<variablelist termlength="narrow">

<varlistentry>
<term><option>-help</option></term><listitem><para>Displays
help and usage information.</para>
</listitem></varlistentry>
<varlistentry>
<term><option>-version</option></term><listitem><para>Displays
version information for pango-querymodules.</para>
</listitem></varlistentry>
</variablelist>
</refsect1>

<refsect1 id="pango-querymodules-1-oper"><title>&oper-tt;</title>
<para>The following operands are supported:</para>
<variablelist termlength="narrow">
<varlistentry>
<term><option role="nodash"><replaceable>module</replaceable></option></term>
<listitem><para>
List the language modules stored in the specified custom location.
</para>
</listitem></varlistentry>
</variablelist>
</refsect1>

<refsect1 id="pango-querymodules-1-exam"><title>&exam-tt;</title>
<example role="example">
<title>Getting the default list of modules</title>
<para><screen>example% <userinput>&cmd;</userinput></screen></para>
</example>
</refsect1>

<refsect1 id="pango-querymodules-1-envr"><title>&envr-tt;</title>
<para>See
<citerefentry><refentrytitle>environ</refentrytitle>
<manvolnum>5</manvolnum></citerefentry>
for descriptions of the following environment variables that affect the
execution of <command>&cmd;</command>: NLSPATH.
</para>

<variablelist>
<varlistentry>
<term><envar>PANGO_RC_FILE</envar></term>
<listitem><para>
Used to specify configuration database file.
</para></listitem></varlistentry>
</variablelist></refsect1>

<refsect1 id="pango-querymodules-1-exit"><title>&exit-tt;</title>
<para>
The following exit values are returned:
</para>

<variablelist termlength="xtranarrow">
<varlistentry>
<term><returnvalue>0</returnvalue></term>
<listitem><para>
Application exited successfully
</para></listitem></varlistentry>
<varlistentry>
<term><returnvalue>&gt;0</returnvalue></term>
<listitem><para>
Application exited with failure
</para></listitem></varlistentry>
</variablelist>
</refsect1>

<refsect1 id="pango-querymodules-1-file"><title>&file-tt;</title>
<para>
The following files are used by this application:
</para>

<variablelist termlength="wide">
<varlistentry><term><filename>/usr/bin/&cmd;</filename> </term><listitem>
<para>
The command-line executable for the application.
</para>

</listitem></varlistentry>
<varlistentry>
<term><filename>/etc/pango/pangorc</filename></term><listitem>
<para>
Pango system configuration database
</para></listitem></varlistentry>
<varlistentry>
<term><filename>~/.pangorc</filename></term><listitem>
<para>
Pango user configuration database
</para></listitem></varlistentry>
<varlistentry>
<term><filename>/etc/pango/pango.modules</filename></term><listitem>
<para>
Pango modules file
</para></listitem></varlistentry>
<varlistentry>
<term><filename>/usr/share/gtk-doc/html/pango</filename></term><listitem>
<para>
Location of developer documentation
</para></listitem>
</varlistentry>
</variablelist></refsect1>

<refsect1 id="pango-querymodules-1-attr"><title>&attr-tt;</title>
<para>See
<olink targetdocent="REFMAN5" localinfo="attributes-5">
<citerefentry><refentrytitle>attributes</refentrytitle>
<manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:
</para>

<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row>
<entry align="center" valign="middle">ATTRIBUTE TYPE</entry>
<entry align="center" valign="middle">ATTRIBUTE VALUE</entry>
</row>
</thead>
<tbody>
<row>
<entry><para>Availability</para></entry>
<entry><para>library/desktop/pango</para></entry>
</row>
<row>
<entry colname="COLSPEC0"><para>Interface stability</para></entry>
<entry colname="COLSPEC1"><para>Committed</para></entry>
</row>
</tbody></tgroup></informaltable>
</refsect1>

<refsect1 id="pango-querymodules-1-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>Latest version of the <citetitle>GNOME Desktop User Guide</citetitle>
for your platform.</para>
<para>
<citerefentry><refentrytitle>libpango-1.0</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>environ</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnome-interfaces</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>

<refsect1 id="pango-querymodules-1-note"><title>&note-tt;</title>
<para>
Written by Erwann Chenede, Sun Microsystems Inc., 2003, 2006, 2007.
</para>
</refsect1>
</refentry>
