<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="pango-Version-Checking">
<refmeta>
<refentrytitle role="top_of_page" id="pango-Version-Checking.top_of_page">Version Checking</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>PANGO Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Version Checking</refname>
<refpurpose>Tools for checking Pango version at compile- and run-time.</refpurpose>
</refnamediv>

<refsect1 id="pango-Version-Checking.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-ENCODE:CAPS">PANGO_VERSION_ENCODE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-CHECK:CAPS">PANGO_VERSION_CHECK</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="pango-version">pango_version</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-version-string">pango_version_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="pango-version-check">pango_version_check</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="pango-Version-Checking.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION:CAPS">PANGO_VERSION</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-MAJOR:CAPS">PANGO_VERSION_MAJOR</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-MINOR:CAPS">PANGO_VERSION_MINOR</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-MICRO:CAPS">PANGO_VERSION_MICRO</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-STRING:CAPS">PANGO_VERSION_STRING</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-2:CAPS">PANGO_VERSION_1_2</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-4:CAPS">PANGO_VERSION_1_4</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-6:CAPS">PANGO_VERSION_1_6</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-8:CAPS">PANGO_VERSION_1_8</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-10:CAPS">PANGO_VERSION_1_10</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-12:CAPS">PANGO_VERSION_1_12</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-14:CAPS">PANGO_VERSION_1_14</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-16:CAPS">PANGO_VERSION_1_16</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-18:CAPS">PANGO_VERSION_1_18</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-20:CAPS">PANGO_VERSION_1_20</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-22:CAPS">PANGO_VERSION_1_22</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-24:CAPS">PANGO_VERSION_1_24</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-26:CAPS">PANGO_VERSION_1_26</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-28:CAPS">PANGO_VERSION_1_28</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-30:CAPS">PANGO_VERSION_1_30</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-32:CAPS">PANGO_VERSION_1_32</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-34:CAPS">PANGO_VERSION_1_34</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-36:CAPS">PANGO_VERSION_1_36</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-38:CAPS">PANGO_VERSION_1_38</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-40:CAPS">PANGO_VERSION_1_40</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-42:CAPS">PANGO_VERSION_1_42</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-1-44:CAPS">PANGO_VERSION_1_44</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-MIN-REQUIRED:CAPS">PANGO_VERSION_MIN_REQUIRED</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="PANGO-VERSION-MAX-ALLOWED:CAPS">PANGO_VERSION_MAX_ALLOWED</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>


<refsect1 id="pango-Version-Checking.description" role="desc">
<title role="desc.title">Description</title>
<para>The capital-letter macros defined here can be used to check the version of Pango
at compile-time, and to <firstterm>encode</firstterm> Pango versions into integers.</para>
<para>The functions can be used to check the version of the linked Pango library at run-time.</para>

</refsect1>
<refsect1 id="pango-Version-Checking.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="PANGO-VERSION-ENCODE:CAPS" role="macro">
<title>PANGO_VERSION_ENCODE()</title>
<indexterm zone="PANGO-VERSION-ENCODE:CAPS"><primary>PANGO_VERSION_ENCODE</primary></indexterm>
<programlisting language="C">#define             PANGO_VERSION_ENCODE(major, minor, micro)</programlisting>
<para>This macro encodes the given Pango version into an integer.  The numbers
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.
Two encoded version numbers can be compared as integers.</para>
<refsect3 id="PANGO-VERSION-ENCODE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>major</para></entry>
<entry role="parameter_description"><para>the major component of the version number</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minor</para></entry>
<entry role="parameter_description"><para>the minor component of the version number</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>micro</para></entry>
<entry role="parameter_description"><para>the micro component of the version number</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="PANGO-VERSION-CHECK:CAPS" role="macro">
<title>PANGO_VERSION_CHECK()</title>
<indexterm zone="PANGO-VERSION-CHECK:CAPS"><primary>PANGO_VERSION_CHECK</primary></indexterm>
<programlisting language="C">#define             PANGO_VERSION_CHECK(major,minor,micro)</programlisting>
<para>Checks that the version of Pango available at compile-time is not older than
the provided version number.</para>
<refsect3 id="PANGO-VERSION-CHECK.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>major</para></entry>
<entry role="parameter_description"><para>the major component of the version number</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minor</para></entry>
<entry role="parameter_description"><para>the minor component of the version number</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>micro</para></entry>
<entry role="parameter_description"><para>the micro component of the version number</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="pango-version" role="function" condition="since:1.16">
<title>pango_version&#160;()</title>
<indexterm zone="pango-version" role="1.16"><primary>pango_version</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
pango_version (<parameter><type>void</type></parameter>);</programlisting>
<para>This is similar to the macro <link linkend="PANGO-VERSION:CAPS"><literal>PANGO_VERSION</literal></link> except that
it returns the encoded version of Pango available at run-time,
as opposed to the version available at compile-time.</para>
<para>A version number can be encoded into an integer using
<link linkend="PANGO-VERSION-ENCODE:CAPS"><function>PANGO_VERSION_ENCODE()</function></link>.</para>
<refsect3 id="pango-version.returns" role="returns">
<title>Returns</title>
<para> The encoded version of Pango library
available at run time.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.16">1.16</link></para></refsect2>
<refsect2 id="pango-version-string" role="function" condition="since:1.16">
<title>pango_version_string&#160;()</title>
<indexterm zone="pango-version-string" role="1.16"><primary>pango_version_string</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
pango_version_string (<parameter><type>void</type></parameter>);</programlisting>
<para>This is similar to the macro <link linkend="PANGO-VERSION-STRING:CAPS"><literal>PANGO_VERSION_STRING</literal></link> except that
it returns the version of Pango available at run-time, as opposed to
the version available at compile-time.</para>
<refsect3 id="pango-version-string.returns" role="returns">
<title>Returns</title>
<para> A string containing the version of Pango library
available at run time.
The returned string is owned by Pango and should not be modified
or freed.</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.16">1.16</link></para></refsect2>
<refsect2 id="pango-version-check" role="function" condition="since:1.16">
<title>pango_version_check&#160;()</title>
<indexterm zone="pango-version-check" role="1.16"><primary>pango_version_check</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
pango_version_check (<parameter><link linkend="int"><type>int</type></link> required_major</parameter>,
                     <parameter><link linkend="int"><type>int</type></link> required_minor</parameter>,
                     <parameter><link linkend="int"><type>int</type></link> required_micro</parameter>);</programlisting>
<para>Checks that the Pango library in use is compatible with the
given version. Generally you would pass in the constants
<link linkend="PANGO-VERSION-MAJOR:CAPS"><literal>PANGO_VERSION_MAJOR</literal></link>, <link linkend="PANGO-VERSION-MINOR:CAPS"><literal>PANGO_VERSION_MINOR</literal></link>, <link linkend="PANGO-VERSION-MICRO:CAPS"><literal>PANGO_VERSION_MICRO</literal></link>
as the three arguments to this function; that produces
a check that the library in use at run-time is compatible with
the version of Pango the application or module was compiled against.</para>
<para>Compatibility is defined by two things: first the version
of the running library is newer than the version
<parameter>required_major.required_minor</parameter>
.<parameter>required_micro</parameter>
. Second
the running library must be binary compatible with the
version <parameter>required_major.required_minor</parameter>
.<parameter>required_micro</parameter>

(same major version.)</para>
<para>For compile-time version checking use <link linkend="PANGO-VERSION-CHECK:CAPS"><function>PANGO_VERSION_CHECK()</function></link>.</para>
<refsect3 id="pango-version-check.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>required_major</para></entry>
<entry role="parameter_description"><para>the required major version.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>required_minor</para></entry>
<entry role="parameter_description"><para>the required minor version.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>required_micro</para></entry>
<entry role="parameter_description"><para>the required major version.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="pango-version-check.returns" role="returns">
<title>Returns</title>
<para><link linkend="NULL:CAPS"><literal>NULL</literal></link> if the Pango library is compatible
with the given version, or a string describing the version
mismatch.  The returned string is owned by Pango and should not
be modified or freed. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-1.16">1.16</link></para></refsect2>

</refsect1>
<refsect1 id="pango-Version-Checking.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="PANGO-VERSION:CAPS" role="macro">
<title>PANGO_VERSION</title>
<indexterm zone="PANGO-VERSION:CAPS"><primary>PANGO_VERSION</primary></indexterm>
<programlisting language="C">#define             PANGO_VERSION</programlisting>
<para>The version of Pango available at compile-time, encoded using <link linkend="PANGO-VERSION-ENCODE:CAPS"><function>PANGO_VERSION_ENCODE()</function></link>.</para>
</refsect2>
<refsect2 id="PANGO-VERSION-MAJOR:CAPS" role="macro">
<title>PANGO_VERSION_MAJOR</title>
<indexterm zone="PANGO-VERSION-MAJOR:CAPS"><primary>PANGO_VERSION_MAJOR</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_MAJOR 1
</programlisting>
<para>The major component of the version of Pango available at compile-time.</para>
</refsect2>
<refsect2 id="PANGO-VERSION-MINOR:CAPS" role="macro">
<title>PANGO_VERSION_MINOR</title>
<indexterm zone="PANGO-VERSION-MINOR:CAPS"><primary>PANGO_VERSION_MINOR</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_MINOR 46
</programlisting>
<para>The minor component of the version of Pango available at compile-time.</para>
</refsect2>
<refsect2 id="PANGO-VERSION-MICRO:CAPS" role="macro">
<title>PANGO_VERSION_MICRO</title>
<indexterm zone="PANGO-VERSION-MICRO:CAPS"><primary>PANGO_VERSION_MICRO</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_MICRO 1
</programlisting>
<para>The micro component of the version of Pango available at compile-time.</para>
</refsect2>
<refsect2 id="PANGO-VERSION-STRING:CAPS" role="macro">
<title>PANGO_VERSION_STRING</title>
<indexterm zone="PANGO-VERSION-STRING:CAPS"><primary>PANGO_VERSION_STRING</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_STRING "1.46.1"
</programlisting>
<para>A string literal containing the version of Pango available at compile-time.</para>
</refsect2>
<refsect2 id="PANGO-VERSION-1-2:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_2</title>
<indexterm zone="PANGO-VERSION-1-2:CAPS" role="1.42"><primary>PANGO_VERSION_1_2</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_2        (G_ENCODE_VERSION (1, 2))
</programlisting>
<para>A macro that evaluates to the 1.2 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-4:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_4</title>
<indexterm zone="PANGO-VERSION-1-4:CAPS" role="1.42"><primary>PANGO_VERSION_1_4</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_4        (G_ENCODE_VERSION (1, 4))
</programlisting>
<para>A macro that evaluates to the 1.4 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-6:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_6</title>
<indexterm zone="PANGO-VERSION-1-6:CAPS" role="1.42"><primary>PANGO_VERSION_1_6</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_6        (G_ENCODE_VERSION (1, 6))
</programlisting>
<para>A macro that evaluates to the 1.6 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-8:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_8</title>
<indexterm zone="PANGO-VERSION-1-8:CAPS" role="1.42"><primary>PANGO_VERSION_1_8</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_8        (G_ENCODE_VERSION (1, 8))
</programlisting>
<para>A macro that evaluates to the 1.8 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-10:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_10</title>
<indexterm zone="PANGO-VERSION-1-10:CAPS" role="1.42"><primary>PANGO_VERSION_1_10</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_10       (G_ENCODE_VERSION (1, 10))
</programlisting>
<para>A macro that evaluates to the 1.10 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-12:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_12</title>
<indexterm zone="PANGO-VERSION-1-12:CAPS" role="1.42"><primary>PANGO_VERSION_1_12</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_12       (G_ENCODE_VERSION (1, 12))
</programlisting>
<para>A macro that evaluates to the 1.12 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-14:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_14</title>
<indexterm zone="PANGO-VERSION-1-14:CAPS" role="1.42"><primary>PANGO_VERSION_1_14</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_14       (G_ENCODE_VERSION (1, 14))
</programlisting>
<para>A macro that evaluates to the 1.14 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-16:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_16</title>
<indexterm zone="PANGO-VERSION-1-16:CAPS" role="1.42"><primary>PANGO_VERSION_1_16</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_16       (G_ENCODE_VERSION (1, 16))
</programlisting>
<para>A macro that evaluates to the 1.16 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-18:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_18</title>
<indexterm zone="PANGO-VERSION-1-18:CAPS" role="1.42"><primary>PANGO_VERSION_1_18</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_18       (G_ENCODE_VERSION (1, 18))
</programlisting>
<para>A macro that evaluates to the 1.18 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-20:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_20</title>
<indexterm zone="PANGO-VERSION-1-20:CAPS" role="1.42"><primary>PANGO_VERSION_1_20</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_20       (G_ENCODE_VERSION (1, 20))
</programlisting>
<para>A macro that evaluates to the 1.20 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-22:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_22</title>
<indexterm zone="PANGO-VERSION-1-22:CAPS" role="1.42"><primary>PANGO_VERSION_1_22</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_22       (G_ENCODE_VERSION (1, 22))
</programlisting>
<para>A macro that evaluates to the 1.22 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-24:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_24</title>
<indexterm zone="PANGO-VERSION-1-24:CAPS" role="1.42"><primary>PANGO_VERSION_1_24</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_24       (G_ENCODE_VERSION (1, 24))
</programlisting>
<para>A macro that evaluates to the 1.24 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-26:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_26</title>
<indexterm zone="PANGO-VERSION-1-26:CAPS" role="1.42"><primary>PANGO_VERSION_1_26</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_26       (G_ENCODE_VERSION (1, 26))
</programlisting>
<para>A macro that evaluates to the 1.26 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-28:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_28</title>
<indexterm zone="PANGO-VERSION-1-28:CAPS" role="1.42"><primary>PANGO_VERSION_1_28</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_28       (G_ENCODE_VERSION (1, 28))
</programlisting>
<para>A macro that evaluates to the 1.28 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-30:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_30</title>
<indexterm zone="PANGO-VERSION-1-30:CAPS" role="1.42"><primary>PANGO_VERSION_1_30</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_30       (G_ENCODE_VERSION (1, 30))
</programlisting>
<para>A macro that evaluates to the 1.30 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-32:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_32</title>
<indexterm zone="PANGO-VERSION-1-32:CAPS" role="1.42"><primary>PANGO_VERSION_1_32</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_32       (G_ENCODE_VERSION (1, 32))
</programlisting>
<para>A macro that evaluates to the 1.32 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-34:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_34</title>
<indexterm zone="PANGO-VERSION-1-34:CAPS" role="1.42"><primary>PANGO_VERSION_1_34</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_34       (G_ENCODE_VERSION (1, 34))
</programlisting>
<para>A macro that evaluates to the 1.34 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-36:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_36</title>
<indexterm zone="PANGO-VERSION-1-36:CAPS" role="1.42"><primary>PANGO_VERSION_1_36</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_36       (G_ENCODE_VERSION (1, 36))
</programlisting>
<para>A macro that evaluates to the 1.36 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-38:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_38</title>
<indexterm zone="PANGO-VERSION-1-38:CAPS" role="1.42"><primary>PANGO_VERSION_1_38</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_38       (G_ENCODE_VERSION (1, 38))
</programlisting>
<para>A macro that evaluates to the 1.38 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-40:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_40</title>
<indexterm zone="PANGO-VERSION-1-40:CAPS" role="1.42"><primary>PANGO_VERSION_1_40</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_40       (G_ENCODE_VERSION (1, 40))
</programlisting>
<para>A macro that evaluates to the 1.40 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-42:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_1_42</title>
<indexterm zone="PANGO-VERSION-1-42:CAPS" role="1.42"><primary>PANGO_VERSION_1_42</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_42       (G_ENCODE_VERSION (1, 42))
</programlisting>
<para>A macro that evaluates to the 1.42 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-1-44:CAPS" role="macro" condition="since:1.44">
<title>PANGO_VERSION_1_44</title>
<indexterm zone="PANGO-VERSION-1-44:CAPS" role="1.44"><primary>PANGO_VERSION_1_44</primary></indexterm>
<programlisting language="C">#define PANGO_VERSION_1_44       (G_ENCODE_VERSION (1, 44))
</programlisting>
<para>A macro that evaluates to the 1.44 version of Pango, in a format
that can be used by the C pre-processor.</para>
<para role="since">Since: <link linkend="api-index-1.44">1.44</link></para></refsect2>
<refsect2 id="PANGO-VERSION-MIN-REQUIRED:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_MIN_REQUIRED</title>
<indexterm zone="PANGO-VERSION-MIN-REQUIRED:CAPS" role="1.42"><primary>PANGO_VERSION_MIN_REQUIRED</primary></indexterm>
<programlisting language="C"># define PANGO_VERSION_MIN_REQUIRED      (PANGO_VERSION_CUR_STABLE)
</programlisting>
<para>A macro that should be defined by the user prior to including
the pango.h header.
The definition should be one of the predefined Pango version
macros: <link linkend="PANGO-VERSION-1-2:CAPS"><literal>PANGO_VERSION_1_2</literal></link>, <link linkend="PANGO-VERSION-1-4:CAPS"><literal>PANGO_VERSION_1_4</literal></link>,...</para>
<para>This macro defines the earliest version of Pango that the package is
required to be able to compile against.</para>
<para>If the compiler is configured to warn about the use of deprecated
functions, then using functions that were deprecated in version
<link linkend="PANGO-VERSION-MIN-REQUIRED:CAPS"><literal>PANGO_VERSION_MIN_REQUIRED</literal></link> or earlier will cause warnings (but
using functions deprecated in later releases will not).</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>
<refsect2 id="PANGO-VERSION-MAX-ALLOWED:CAPS" role="macro" condition="since:1.42">
<title>PANGO_VERSION_MAX_ALLOWED</title>
<indexterm zone="PANGO-VERSION-MAX-ALLOWED:CAPS" role="1.42"><primary>PANGO_VERSION_MAX_ALLOWED</primary></indexterm>
<programlisting language="C"># define PANGO_VERSION_MAX_ALLOWED      (PANGO_VERSION_CUR_STABLE)
</programlisting>
<para>A macro that should be defined by the user prior to including
the glib.h header.
The definition should be one of the predefined Pango version
macros: <link linkend="PANGO-VERSION-1-2:CAPS"><literal>PANGO_VERSION_1_2</literal></link>, <link linkend="PANGO-VERSION-1-4:CAPS"><literal>PANGO_VERSION_1_4</literal></link>,...</para>
<para>This macro defines the latest version of the Pango API that the
package is allowed to make use of.</para>
<para>If the compiler is configured to warn about the use of deprecated
functions, then using functions added after version
<link linkend="PANGO-VERSION-MAX-ALLOWED:CAPS"><literal>PANGO_VERSION_MAX_ALLOWED</literal></link> will cause warnings.</para>
<para>Unless you are using <link linkend="PANGO-CHECK-VERSION:CAPS"><function>PANGO_CHECK_VERSION()</function></link> or the like to compile
different code depending on the Pango version, then this should be
set to the same value as <link linkend="PANGO-VERSION-MIN-REQUIRED:CAPS"><literal>PANGO_VERSION_MIN_REQUIRED</literal></link>.</para>
<para role="since">Since: <link linkend="api-index-1.42">1.42</link></para></refsect2>

</refsect1>

</refentry>
