summaryrefslogtreecommitdiff
path: root/docs/pango-querymodules.xml
blob: 09c3209f2116a366e8f2f365c715ff4a8fef1df2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
<refentry id="pango-querymodules">

<refentryinfo>
<title>pango-querymodules</title>
<productname>Pango</productname>
<authorgroup>
<author>
<contrib>Developer</contrib>
<firstname>Owen</firstname>
<surname>Taylor</surname>
</author>
<author>
<contrib>Developer</contrib>
<firstname>Behdad</firstname>
<surname>Esfahbod</surname>
</author>
</authorgroup>
</refentryinfo>

<refmeta>
<refentrytitle>pango-querymodules</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">User Commands</refmiscinfo>
</refmeta>

<refnamediv>
<refname>pango-querymodules</refname>
<refpurpose>Module registration utility</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>pango-querymodules</command>
<arg choice="opt" rep="repeat">OPTION</arg>
<arg choice="opt" rep="repeat">MODULE</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1 id="Description"><title>Description</title>
<para>
<command>pango-querymodules</command> collects information about loadable
modules for Pango and writes it to <filename>stdout</filename>.
</para>
<para>
If called without MODULE arguments, it looks for modules in the Pango
module path, which is specified by the key <literal>Pango/ModulesPath</literal>
in the Pango configuration database.
</para>
<para>
If called with MODULE arguments, it looks for the specified modules. The
arguments may be absolute or relative paths.
</para>
<para>
At runtime, Pango looks for the loadable module information (i.e. the output
of pango-querymodules) in <filename><replaceable>libdir</replaceable>/pango/1.8.0/modules.cache</filename>.
</para>
</refsect1>

<refsect1><title>Options</title>
<variablelist>

<varlistentry>
<term><option>-?</option>, <option>--help</option></term>
<listitem><para>Prints a short help text and exits.</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--version</option></term>
<listitem><para>Prints version information.</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--system</option></term>
<listitem><para>Do not load user-specific configuration.</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--update-cache</option></term>
<listitem><para>Update the Pango module cache file directly,
instead of writing the information to <filename>stdout</filename>.</para></listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1 id="Environment"><title>Environment</title>
<variablelist>

<varlistentry>
<term><envar>PANGO_RC_FILE</envar></term>
<listitem><para>Specifies an additional rc file for the Pango configuration
database, in addition to the system-wide and per-user files.</para></listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1><title>Files</title>

<variablelist>

<varlistentry>
<term><filename><replaceable>sysconfdir</replaceable>/pango/pangorc</filename></term>
<listitem><para>System-wide Pango configuration file.</para></listitem>
</varlistentry>

<varlistentry>
<term><filename><envar>$XDG_CONFIG_HOME</envar>/pango/pangorc</filename></term>
<listitem><para>User-specific Pango configuration file.</para></listitem>
</varlistentry>

<varlistentry>
<term><filename><replaceable>libdir</replaceable>/pango/1.8.0/modules.cache</filename></term>
<listitem><para>Location of the module cache file read by Pango.</para></listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1 id="Bugs"><title>Bugs</title>
<para>
None known yet.
</para>
</refsect1>

</refentry>