11
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
<refsynopsisdiv role="synopsis">
14
<refsynopsisdiv id="pango-Version-Checking.synopsis" role="synopsis">
15
15
<title role="synopsis.title">Synopsis</title>
21
18
#define <link linkend="PANGO-VERSION-ENCODE:CAPS">PANGO_VERSION_ENCODE</link> (major, minor, micro)
22
19
#define <link linkend="PANGO-VERSION:CAPS">PANGO_VERSION</link>
23
20
#define <link linkend="PANGO-VERSION-MAJOR:CAPS">PANGO_VERSION_MAJOR</link>
56
<refsect1 role="details">
53
<refsect1 id="pango-Version-Checking.details" role="details">
57
54
<title role="details.title">Details</title>
59
<title><anchor id="PANGO-VERSION-ENCODE:CAPS" role="macro"/>PANGO_VERSION_ENCODE()</title>
60
<indexterm><primary>PANGO_VERSION_ENCODE</primary></indexterm><programlisting>#define PANGO_VERSION_ENCODE(major, minor, micro)</programlisting>
55
<refsect2 id="PANGO-VERSION-ENCODE:CAPS" role="macro">
56
<title>PANGO_VERSION_ENCODE()</title>
57
<indexterm zone="PANGO-VERSION-ENCODE:CAPS"><primary>PANGO_VERSION_ENCODE</primary></indexterm><programlisting>#define PANGO_VERSION_ENCODE(major, minor, micro)</programlisting>
62
59
This macro encodes the given Pango version into an integer. The numbers
63
60
returned by <link linkend="PANGO-VERSION:CAPS"><literal>PANGO_VERSION</literal></link> and <link linkend="pango-version"><function>pango_version()</function></link> are encoded using this macro.
76
73
</simpara></listitem></varlistentry>
77
74
</variablelist></refsect2>
79
<title><anchor id="PANGO-VERSION:CAPS" role="macro"/>PANGO_VERSION</title>
80
<indexterm><primary>PANGO_VERSION</primary></indexterm><programlisting>#define PANGO_VERSION</programlisting>
75
<refsect2 id="PANGO-VERSION:CAPS" role="macro">
76
<title>PANGO_VERSION</title>
77
<indexterm zone="PANGO-VERSION:CAPS"><primary>PANGO_VERSION</primary></indexterm><programlisting>#define PANGO_VERSION</programlisting>
82
79
The version of Pango available at compile-time, encoded using
83
80
<link linkend="PANGO-VERSION-ENCODE:CAPS"><function>PANGO_VERSION_ENCODE()</function></link>.
86
<title><anchor id="PANGO-VERSION-MAJOR:CAPS" role="macro"/>PANGO_VERSION_MAJOR</title>
87
<indexterm><primary>PANGO_VERSION_MAJOR</primary></indexterm><programlisting>#define PANGO_VERSION_MAJOR 1
82
<refsect2 id="PANGO-VERSION-MAJOR:CAPS" role="macro">
83
<title>PANGO_VERSION_MAJOR</title>
84
<indexterm zone="PANGO-VERSION-MAJOR:CAPS"><primary>PANGO_VERSION_MAJOR</primary></indexterm><programlisting>#define PANGO_VERSION_MAJOR 1
90
87
The major component of the version of Pango available at compile-time.
93
<title><anchor id="PANGO-VERSION-MINOR:CAPS" role="macro"/>PANGO_VERSION_MINOR</title>
94
<indexterm><primary>PANGO_VERSION_MINOR</primary></indexterm><programlisting>#define PANGO_VERSION_MINOR 21
89
<refsect2 id="PANGO-VERSION-MINOR:CAPS" role="macro">
90
<title>PANGO_VERSION_MINOR</title>
91
<indexterm zone="PANGO-VERSION-MINOR:CAPS"><primary>PANGO_VERSION_MINOR</primary></indexterm><programlisting>#define PANGO_VERSION_MINOR 21
97
94
The minor component of the version of Pango available at compile-time.
100
<title><anchor id="PANGO-VERSION-MICRO:CAPS" role="macro"/>PANGO_VERSION_MICRO</title>
101
<indexterm><primary>PANGO_VERSION_MICRO</primary></indexterm><programlisting>#define PANGO_VERSION_MICRO 3
96
<refsect2 id="PANGO-VERSION-MICRO:CAPS" role="macro">
97
<title>PANGO_VERSION_MICRO</title>
98
<indexterm zone="PANGO-VERSION-MICRO:CAPS"><primary>PANGO_VERSION_MICRO</primary></indexterm><programlisting>#define PANGO_VERSION_MICRO 6
104
101
The micro component of the version of Pango available at compile-time.
105
102
</para></refsect2>
107
<title><anchor id="PANGO-VERSION-STRING:CAPS" role="macro"/>PANGO_VERSION_STRING</title>
108
<indexterm><primary>PANGO_VERSION_STRING</primary></indexterm><programlisting>#define PANGO_VERSION_STRING "1.21.3"
103
<refsect2 id="PANGO-VERSION-STRING:CAPS" role="macro">
104
<title>PANGO_VERSION_STRING</title>
105
<indexterm zone="PANGO-VERSION-STRING:CAPS"><primary>PANGO_VERSION_STRING</primary></indexterm><programlisting>#define PANGO_VERSION_STRING "1.21.6"
109
106
</programlisting>
111
108
A string literal containing the version of Pango available at compile-time.
112
109
</para></refsect2>
114
<title><anchor id="PANGO-VERSION-CHECK:CAPS" role="macro"/>PANGO_VERSION_CHECK()</title>
115
<indexterm><primary>PANGO_VERSION_CHECK</primary></indexterm><programlisting>#define PANGO_VERSION_CHECK(major,minor,micro)</programlisting>
110
<refsect2 id="PANGO-VERSION-CHECK:CAPS" role="macro">
111
<title>PANGO_VERSION_CHECK()</title>
112
<indexterm zone="PANGO-VERSION-CHECK:CAPS"><primary>PANGO_VERSION_CHECK</primary></indexterm><programlisting>#define PANGO_VERSION_CHECK(major,minor,micro)</programlisting>
117
114
Checks that the version of Pango available at compile-time is not older than
118
115
the provided version number.
130
127
</simpara></listitem></varlistentry>
131
128
</variablelist></refsect2>
133
<title><anchor id="pango-version" role="function" condition="since:1.16"/>pango_version ()</title>
134
<indexterm role="1.16"><primary>pango_version</primary></indexterm><programlisting><link linkend="int">int</link> pango_version (void);</programlisting>
129
<refsect2 id="pango-version" role="function" condition="since:1.16">
130
<title>pango_version ()</title>
131
<indexterm zone="pango-version" role="1.16"><primary>pango_version</primary></indexterm><programlisting><link linkend="int">int</link> pango_version (void);</programlisting>
136
133
This is similar to the macro <link linkend="PANGO-VERSION:CAPS"><literal>PANGO_VERSION</literal></link> except that
137
134
it returns the encoded version of Pango available at run-time,
149
146
</simpara></listitem></varlistentry>
150
147
</variablelist><para role="since">Since 1.16
151
148
</para></refsect2>
153
<title><anchor id="pango-version-string" role="function" condition="since:1.16"/>pango_version_string ()</title>
154
<indexterm role="1.16"><primary>pango_version_string</primary></indexterm><programlisting>const <link linkend="char">char</link>* pango_version_string (void);</programlisting>
149
<refsect2 id="pango-version-string" role="function" condition="since:1.16">
150
<title>pango_version_string ()</title>
151
<indexterm zone="pango-version-string" role="1.16"><primary>pango_version_string</primary></indexterm><programlisting>const <link linkend="char">char</link>* pango_version_string (void);</programlisting>
156
153
This is similar to the macro <link linkend="PANGO-VERSION-STRING:CAPS"><literal>PANGO_VERSION_STRING</literal></link> except that
157
154
it returns the version of Pango available at run-time, as opposed to
167
164
</simpara></listitem></varlistentry>
168
165
</variablelist><para role="since">Since 1.16
169
166
</para></refsect2>
171
<title><anchor id="pango-version-check" role="function" condition="since:1.16"/>pango_version_check ()</title>
172
<indexterm role="1.16"><primary>pango_version_check</primary></indexterm><programlisting>const <link linkend="char">char</link>* pango_version_check (<link linkend="int">int</link> required_major,
167
<refsect2 id="pango-version-check" role="function" condition="since:1.16">
168
<title>pango_version_check ()</title>
169
<indexterm zone="pango-version-check" role="1.16"><primary>pango_version_check</primary></indexterm><programlisting>const <link linkend="char">char</link>* pango_version_check (<link linkend="int">int</link> required_major,
173
170
<link linkend="int">int</link> required_minor,
174
171
<link linkend="int">int</link> required_micro);</programlisting>