RubyGems - pango - Versions diffs - 2.1.0-x86-mingw32 → 2.2.0-x86-mingw32 - Mend

pango 2.1.0-x86-mingw32 → 2.2.0-x86-mingw32

Files changed (120) hide show

data/vendor/local/share/gtk-doc/html/pango/pango-Miscellaneous-Utilities.html CHANGED Viewed

@@ -2,30 +2,27 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Miscellaneous Utilities</title>
+<title>Pango Reference Manual: Miscellaneous Utilities</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="Pango Reference Manual">
 <link rel="up" href="lowlevel.html" title="Low Level Functionality">
 <link rel="prev" href="pango-Modules.html" title="Modules">
 <link rel="next" href="pango-Version-Checking.html" title="Version Checking">
-<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="pango-Modules.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">Pango Reference Manual</th>
-<td><a accesskey="n" href="pango-Version-Checking.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#pango-Miscellaneous-Utilities.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#pango-Miscellaneous-Utilities.description" class="shortcut">Description</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="pango-Modules.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="pango-Version-Checking.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="pango-Miscellaneous-Utilities"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -84,8 +81,7 @@ const <span class="returnvalue">char</span> *        <a class="link" href="pango
 <a name="pango-Miscellaneous-Utilities.description"></a><h2>Description</h2>
 <p>
 The functions and utilities in this section are mostly used from Pango
-backends and modules, but may be useful for other purposes too.
-</p>
+backends and modules, but may be useful for other purposes too.</p>
 </div>
 <div class="refsect1">
 <a name="pango-Miscellaneous-Utilities.details"></a><h2>Details</h2>
@@ -94,8 +90,7 @@ backends and modules, but may be useful for other purposes too.
 <pre class="programlisting"><span class="returnvalue">char</span> **             pango_split_file_list               (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);</pre>
 <p>
 Splits a <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#G-SEARCHPATH-SEPARATOR:CAPS"><code class="literal">G_SEARCHPATH_SEPARATOR</code></a>-separated list of files, stripping
-white space and substituting ~/ with $HOME/.
-</p>
+white space and substituting ~/ with $HOME/.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -120,8 +115,7 @@ strings to be freed with <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/ve
 <a name="pango-trim-string"></a><h3>pango_trim_string ()</h3>
 <pre class="programlisting"><span class="returnvalue">char</span> *              pango_trim_string                   (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);</pre>
 <p>
-Trims leading and trailing whitespace from a string.
-</p>
+Trims leading and trailing whitespace from a string.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -152,8 +146,7 @@ is not written into the buffer. Text after a '#' character is treated as
 a comment and skipped. '\' can be used to escape a # character.
 '\' proceeding a line delimiter combines adjacent lines. A '\' proceeding
 any other character is ignored and written into the output buffer
-unmodified.
-</p>
+unmodified.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -184,8 +177,7 @@ a line number counter which doesn't combine lines with '\')</td>
 <a name="pango-skip-space"></a><h3>pango_skip_space ()</h3>
 <pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_skip_space                    (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>);</pre>
 <p>
-Skips 0 or more characters of white space.
-</p>
+Skips 0 or more characters of white space.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -214,8 +206,7 @@ the position at a '\0' character.</td>
 <p>
 Scans a word into a <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> buffer. A word consists
 of [A-Za-z_] followed by zero or more [A-Za-z_0-9]
-Leading white space is skipped.
-</p>
+Leading white space is skipped.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -249,8 +240,7 @@ Leading white space is skipped.
 Scans a string into a <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> buffer. The string may either
 be a sequence of non-white-space characters, or a quoted
 string with '"'. Instead a quoted string, '\"' represents
-a literal quote. Leading white space outside of quotes is skipped.
-</p>
+a literal quote. Leading white space outside of quotes is skipped.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -282,8 +272,7 @@ a literal quote. Leading white space outside of quotes is skipped.
                                                          <em class="parameter"><code><span class="type">int</span> *out</code></em>);</pre>
 <p>
 Scans an integer.
-Leading white space is skipped.
-</p>
+Leading white space is skipped.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -315,8 +304,7 @@ Leading white space is skipped.
 <p>
 Looks up a key in the Pango config database
 (pseudo-win.ini style, read from $sysconfdir/pango/pangorc,
- $XDG_CONFIG_HOME/pango/pangorc, and getenv (PANGO_RC_FILE).)
-</p>
+ $XDG_CONFIG_HOME/pango/pangorc, and getenv (PANGO_RC_FILE).)</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -341,8 +329,7 @@ newly-allocated string and must be freed with <a href="/home/kou/work/ruby/ruby-
 <pre class="programlisting"><span class="returnvalue">char</span> *              pango_config_key_get_system         (<em class="parameter"><code>const <span class="type">char</span> *key</code></em>);</pre>
 <p>
 Looks up a key, consulting only the Pango system config database
-in $sysconfdir/pango/pangorc.
-</p>
+in $sysconfdir/pango/pangorc.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -367,15 +354,14 @@ newly-allocated string and must be freed with <a href="/home/kou/work/ruby/ruby-
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_lookup_aliases                (<em class="parameter"><code>const <span class="type">char</span> *fontname</code></em>,
                                                          <em class="parameter"><code><span class="type">char</span> ***families</code></em>,
                                                          <em class="parameter"><code><span class="type">int</span> *n_families</code></em>);</pre>
-<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="warning">
 <h3 class="title">Warning</h3>
 <p><code class="literal">pango_lookup_aliases</code> has been deprecated since version 1.32 and should not be used in newly-written code. This function is not thread-safe.</p>
 </div>
 <p>
 Look up all user defined aliases for the alias <em class="parameter"><code>fontname</code></em>.
 The resulting font family names will be stored in <em class="parameter"><code>families</code></em>,
-and the number of families in <em class="parameter"><code>n_families</code></em>.
-</p>
+and the number of families in <em class="parameter"><code>n_families</code></em>.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -409,8 +395,7 @@ this array is owned by pango and should not be freed. <span class="annotation">[
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> warn</code></em>,
                                                          <em class="parameter"><code><span class="type">char</span> **possible_values</code></em>);</pre>
 <p>
-Parses an enum type and stores the result in <em class="parameter"><code>value</code></em>.
-</p>
+Parses an enum type and stores the result in <em class="parameter"><code>value</code></em>.</p>
 <p>
 If <em class="parameter"><code>str</code></em> does not match the nick name of any of the possible values for the
 enum and is not an integer, <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, a warning is issued
@@ -418,8 +403,7 @@ if <em class="parameter"><code>warn</code></em> is <a href="/home/kou/work/ruby/
 string representing the list of possible values is stored in
 <em class="parameter"><code>possible_values</code></em>.  The list is slash-separated, eg.
 "none/start/middle/end".  If failed and <em class="parameter"><code>possible_values</code></em> is not <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
-returned string should be freed using <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
-</p>
+returned string should be freed using <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -467,8 +451,7 @@ returned string should be freed using <a href="/home/kou/work/ruby/ruby-gnome2.w
 <p>
 Parses a font style. The allowed values are "normal",
 "italic" and "oblique", case variations being
-ignored.
-</p>
+ignored.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -506,8 +489,7 @@ in. <span class="annotation">[<acronym title="Out parameter, where caller must a
 <p>
 Parses a font variant. The allowed values are "normal"
 and "smallcaps" or "small_caps", case variations being
-ignored.
-</p>
+ignored.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -545,8 +527,7 @@ result in. <span class="annotation">[<acronym title="Out parameter, where caller
 <p>
 Parses a font weight. The allowed values are "heavy",
 "ultrabold", "bold", "normal", "light", "ultraleight"
-and integers. Case variations are ignored.
-</p>
+and integers. Case variations are ignored.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -586,8 +567,7 @@ Parses a font stretch. The allowed values are
 "ultra_condensed", "extra_condensed", "condensed",
 "semi_condensed", "normal", "semi_expanded", "expanded",
 "extra_expanded" and "ultra_expanded". Case variations are
-ignored and the '_' characters may be omitted.
-</p>
+ignored and the '_' characters may be omitted.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -624,8 +604,7 @@ result in. <span class="annotation">[<acronym title="Out parameter, where caller
 On Unix, returns the name of the "pango" subdirectory of SYSCONFDIR
 (which is set at compile time). On Windows, returns the etc\pango
 subdirectory of the Pango installation directory (which is deduced
-at run time from the DLL's location).
-</p>
+at run time from the DLL's location).</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -646,8 +625,7 @@ not be freed.</td>
 On Unix, returns the name of the "pango" subdirectory of LIBDIR
 (which is set at compile time). On Windows, returns the lib\pango
 subdirectory of the Pango installation directory (which is deduced
-at run time from the DLL's location).
-</p>
+at run time from the DLL's location).</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -668,15 +646,12 @@ not be freed.</td>
                                                          <em class="parameter"><code><a class="link" href="pango-Bidirectional-Text.html#PangoDirection"><span class="type">PangoDirection</span></a> *pbase_dir</code></em>);</pre>
 <p>
 This will return the bidirectional embedding levels of the input paragraph
-as defined by the Unicode Bidirectional Algorithm available at:
-</p>
+as defined by the Unicode Bidirectional Algorithm available at:</p>
 <p>
-  http://www.unicode.org/reports/tr9/
-</p>
+  http://www.unicode.org/reports/tr9/</p>
 <p>
 If the input base direction is a weak direction, the direction of the
-characters in the text will determine the final resolved direction.
-</p>
+characters in the text will determine the final resolved direction.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -714,8 +689,7 @@ Checks <em class="parameter"><code>ch</code></em> to see if it is a character th
 normally rendered on the screen.  This includes all Unicode characters
 with "ZERO WIDTH" in their name, as well as <em class="firstterm">bidi</em> formatting characters, and
 a few other ones.  This is totally different from <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#g-unichar-iszerowidth"><code class="function">g_unichar_iszerowidth()</code></a>
-and is at best misnamed.
-</p>
+and is at best misnamed.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -744,13 +718,11 @@ and is at best misnamed.
 Quantizes the thickness and position of a line, typically an
 underline or strikethrough, to whole device pixels, that is integer
 multiples of <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a>. The purpose of this function is to avoid
-such lines looking blurry.
-</p>
+such lines looking blurry.</p>
 <p>
 Care is taken to make sure <em class="parameter"><code>thickness</code></em> is at least one pixel when this
 function returns, but returned <em class="parameter"><code>position</code></em> may become zero as a result
-of rounding.
-</p>
+of rounding.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -775,6 +747,6 @@ of rounding.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.19</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/pango/pango-Modules.html CHANGED Viewed

@@ -2,30 +2,27 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Modules</title>
+<title>Pango Reference Manual: Modules</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="Pango Reference Manual">
 <link rel="up" href="lowlevel.html" title="Low Level Functionality">
 <link rel="prev" href="PangoEngineShape.html" title="PangoEngineShape">
 <link rel="next" href="pango-Miscellaneous-Utilities.html" title="Miscellaneous Utilities">
-<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="PangoEngineShape.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">Pango Reference Manual</th>
-<td><a accesskey="n" href="pango-Miscellaneous-Utilities.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#pango-Modules.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#pango-Modules.description" class="shortcut">Description</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="PangoEngineShape.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="pango-Miscellaneous-Utilities.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="pango-Modules"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -56,8 +53,7 @@
 <a name="pango-Modules.description"></a><h2>Description</h2>
 <p>
 Functions and macros in this section are used to support loading dynamic
-modules that add engines to Pango at run time.
-</p>
+modules that add engines to Pango at run time.</p>
 </div>
 <div class="refsect1">
 <a name="pango-Modules.details"></a><h2>Details</h2>
@@ -74,8 +70,7 @@ modules that add engines to Pango at run time.
 <p>
 The <a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> structure for a statically linked module
 contains the functions that would otherwise be loaded from a dynamically
-loaded module.
-</p>
+loaded module.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -107,8 +102,7 @@ loaded module.
 <pre class="programlisting">typedef struct _PangoMap PangoMap;</pre>
 <p>
 A <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> structure can be used to determine the engine to
-use for each character.
-</p>
+use for each character.</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -117,8 +111,7 @@ use for each character.
 <p>
 A <a class="link" href="pango-Modules.html#PangoMapEntry" title="PangoMapEntry"><span class="type">PangoMapEntry</span></a> contains information about the engine that should be used
 for the codepoint to which this entry belongs and also whether the engine
-matches the language tag for this entry's map exactly or just approximately.
-</p>
+matches the language tag for this entry's map exactly or just approximately.</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -129,8 +122,7 @@ matches the language tag for this entry's map exactly or just approximately.
 <p>
 Locate a <a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> for a particular engine type and render
 type. The resulting map can be used to determine the engine
-for each character.
-</p>
+for each character.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -162,8 +154,7 @@ for each character.
 <pre class="programlisting"><a class="link" href="pango-Engines.html#PangoEngine"><span class="returnvalue">PangoEngine</span></a> *       pango_map_get_engine                (<em class="parameter"><code><a class="link" href="pango-Modules.html#PangoMap" title="PangoMap"><span class="type">PangoMap</span></a> *map</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> script</code></em>);</pre>
 <p>
-Returns the best engine listed in the map for a given script
-</p>
+Returns the best engine listed in the map for a given script</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -202,8 +193,7 @@ returned is arbitrary.</td>
 Finds engines in the map that handle the given script. The returned
 lists should be freed with g_slist_free, but the engines in the
 lists are owned by GLib and will be kept around permanently, so
-they should not be unref'ed.
-</p>
+they should not be unref'ed.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -242,8 +232,7 @@ handle this script.</td>
 Registers a statically linked module with Pango. The
 <a class="link" href="pango-Modules.html#PangoIncludedModule" title="struct PangoIncludedModule"><span class="type">PangoIncludedModule</span></a> structure that is passed in contains the
 functions that would otherwise be loaded from a dynamically loaded
-module.
-</p>
+module.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -260,6 +249,6 @@ module.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.19</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/pango/pango-OpenType-Font-Handling.html CHANGED Viewed

@@ -2,32 +2,29 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>OpenType Font Handling</title>
+<title>Pango Reference Manual: OpenType Font Handling</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="Pango Reference Manual">
 <link rel="up" href="lowlevel.html" title="Low Level Functionality">
 <link rel="prev" href="PangoFcDecoder.html" title="PangoFcDecoder">
 <link rel="next" href="pango-Coverage-Maps.html" title="Coverage Maps">
-<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="PangoFcDecoder.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">Pango Reference Manual</th>
-<td><a accesskey="n" href="pango-Coverage-Maps.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#pango-OpenType-Font-Handling.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#pango-OpenType-Font-Handling.description" class="shortcut">Description</a>
                    |
                   <a href="#pango-OpenType-Font-Handling.object-hierarchy" class="shortcut">Object Hierarchy</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="PangoFcDecoder.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="pango-Coverage-Maps.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="pango-OpenType-Font-Handling"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -164,8 +161,7 @@ const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><s
 <p>
 Functions and macros in this section are used to implement the OpenType Layout
 features and algorithms.  These are mostly useful when writing Fontconfig-based
-shaping engines
-</p>
+shaping engines</p>
 </div>
 <div class="refsect1">
 <a name="pango-OpenType-Font-Handling.details"></a><h2>Details</h2>
@@ -176,8 +172,7 @@ shaping engines
 <p>
 The <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> typedef is used to represent TrueType and OpenType
 four letter tags inside Pango. Use <a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-TAG-MAKE:CAPS" title="PANGO_OT_TAG_MAKE()"><code class="function">PANGO_OT_TAG_MAKE()</code></a>
-or <a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-TAG-MAKE-FROM-STRING:CAPS" title="PANGO_OT_TAG_MAKE_FROM_STRING()"><code class="function">PANGO_OT_TAG_MAKE_FROM_STRING()</code></a> macros to create <span class="type">PangoOTTag</span>s manually.
-</p>
+or <a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-TAG-MAKE-FROM-STRING:CAPS" title="PANGO_OT_TAG_MAKE_FROM_STRING()"><code class="function">PANGO_OT_TAG_MAKE_FROM_STRING()</code></a> macros to create <span class="type">PangoOTTag</span>s manually.</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -188,8 +183,7 @@ The <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span c
 tables associated with an OpenType font. It contains only private fields and
 should only be accessed via the <code class="function">pango_ot_info_*</code> functions
 which are documented below. To obtain a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="type">PangoOTInfo</span></a>,
-use <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-get" title="pango_ot_info_get ()"><code class="function">pango_ot_info_get()</code></a>.
-</p>
+use <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-get" title="pango_ot_info_get ()"><code class="function">pango_ot_info_get()</code></a>.</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -200,8 +194,7 @@ The <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title
 with a <a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a>, suitable for OpenType layout processing.  It contains
 only private fields and should only be accessed via the
 <code class="function">pango_ot_buffer_*</code> functions which are documented below.
-To obtain a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a>, use <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-buffer-new" title="pango_ot_buffer_new ()"><code class="function">pango_ot_buffer_new()</code></a>.
-</p>
+To obtain a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a>, use <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-buffer-new" title="pango_ot_buffer_new ()"><code class="function">pango_ot_buffer_new()</code></a>.</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -219,8 +212,7 @@ To obtain a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffe
 <p>
 The <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTGlyph" title="struct PangoOTGlyph"><span class="type">PangoOTGlyph</span></a> structure represents a single glyph together with
 information used for OpenType layout processing of the glyph.
-It contains the following fields.
-</p>
+It contains the following fields.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -267,8 +259,7 @@ that should be applied to a text feature such as a certain
 type of accent.) A <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a>
 is created with <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-new" title="pango_ot_ruleset_new ()"><code class="function">pango_ot_ruleset_new()</code></a>, features are added
 to it with <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-add-feature" title="pango_ot_ruleset_add_feature ()"><code class="function">pango_ot_ruleset_add_feature()</code></a>, then it is
-applied to a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> with <code class="function">pango_ot_ruleset_shape()</code>.
-</p>
+applied to a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> with <code class="function">pango_ot_ruleset_shape()</code>.</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -290,8 +281,7 @@ to build a complete <a class="link" href="pango-OpenType-Font-Handling.html#Pang
 The main use of this struct is to act as the key for a per-font
 hash of rulesets.  The user populates a ruleset description and
 gets the ruleset using <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-get-for-description" title="pango_ot_ruleset_get_for_description ()"><code class="function">pango_ot_ruleset_get_for_description()</code></a>
-or create a new one using <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-new-from-description" title="pango_ot_ruleset_new_from_description ()"><code class="function">pango_ot_ruleset_new_from_description()</code></a>.
-</p>
+or create a new one using <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-new-from-description" title="pango_ot_ruleset_new_from_description ()"><code class="function">pango_ot_ruleset_new_from_description()</code></a>.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -347,8 +337,7 @@ the life of function calls taking this struct.</td>
 <p>
 The <span class="type">PangoOTTableType</span> enumeration values are used to
 identify the various OpenType tables in the
-<code class="function">pango_ot_info_*</code> functions.
-</p>
+<code class="function">pango_ot_info_*</code> functions.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -379,8 +368,7 @@ identify the various OpenType tables in the
 <p>
 The <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTFeatureMap" title="struct PangoOTFeatureMap"><span class="type">PangoOTFeatureMap</span></a> typedef is used to represent an OpenType
 feature with the property bit associated with it.  The feature tag is
-represented as a char array instead of a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> for convenience.
-</p>
+represented as a char array instead of a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> for convenience.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -407,8 +395,7 @@ represented as a char array instead of a <a class="link" href="pango-OpenType-Fo
 </pre>
 <p>
 Creates a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> from four characters.  This is similar and
-compatible with the <code class="function"><code class="function">FT_MAKE_TAG()</code></code> macro from FreeType.
-</p>
+compatible with the <code class="function"><code class="function">FT_MAKE_TAG()</code></code> macro from FreeType.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -443,8 +430,7 @@ Creates a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" ti
 four characters long (pad with space characters if needed), and need
 not be nul-terminated.  This is a convenience wrapper around
 <a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-TAG-MAKE:CAPS" title="PANGO_OT_TAG_MAKE()"><code class="function">PANGO_OT_TAG_MAKE()</code></a>, but cannot be used in certain situations, for
-example, as a switch expression, as it dereferences pointers.
-</p>
+example, as a switch expression, as it dereferences pointers.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -463,8 +449,7 @@ example, as a switch expression, as it dereferences pointers.
 </pre>
 <p>
 This is used as the property bit in <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-add-feature" title="pango_ot_ruleset_add_feature ()"><code class="function">pango_ot_ruleset_add_feature()</code></a> when a
-feature should be applied to all glyphs.
-</p>
+feature should be applied to all glyphs.</p>
 <p class="since">Since 1.16</p>
 </div>
 <hr>
@@ -476,8 +461,7 @@ feature should be applied to all glyphs.
 This is used as a feature index that represent no feature, that is, should be
 skipped.  It may be returned as feature index by <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-feature" title="pango_ot_info_find_feature ()"><code class="function">pango_ot_info_find_feature()</code></a>
 if the feature is not found, and <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-add-feature" title="pango_ot_ruleset_add_feature ()"><code class="function">pango_ot_ruleset_add_feature()</code></a> function
-automatically skips this value, so no special handling is required by the user.
-</p>
+automatically skips this value, so no special handling is required by the user.</p>
 <p class="since">Since 1.18</p>
 </div>
 <hr>
@@ -491,8 +475,7 @@ requested script was not found, and a default ('DFLT') script was not found
 either.  It may be returned as script index by <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-script" title="pango_ot_info_find_script ()"><code class="function">pango_ot_info_find_script()</code></a>
 if the script or a default script are not found, all other functions
 taking a script index essentially return if the input script index is
-this value, so no special handling is required by the user.
-</p>
+this value, so no special handling is required by the user.</p>
 <p class="since">Since 1.18</p>
 </div>
 <hr>
@@ -502,16 +485,14 @@ this value, so no special handling is required by the user.
 </pre>
 <p>
 This is used as the language index in <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-feature" title="pango_ot_info_find_feature ()"><code class="function">pango_ot_info_find_feature()</code></a> when
-the default language system of the script is desired.
-</p>
+the default language system of the script is desired.</p>
 <p>
 It is also returned by <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-language" title="pango_ot_info_find_language ()"><code class="function">pango_ot_info_find_language()</code></a> if the requested language
 is not found, or the requested language tag was PANGO_OT_TAG_DEFAULT_LANGUAGE.
 The end result is that one can always call <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-tag-from-language" title="pango_ot_tag_from_language ()"><code class="function">pango_ot_tag_from_language()</code></a>
 followed by <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-language" title="pango_ot_info_find_language ()"><code class="function">pango_ot_info_find_language()</code></a> and pass the result to
 <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-feature" title="pango_ot_info_find_feature ()"><code class="function">pango_ot_info_find_feature()</code></a> without having to worry about falling back to
-default language system explicitly.
-</p>
+default language system explicitly.</p>
 <p class="since">Since 1.16</p>
 </div>
 <hr>
@@ -524,8 +505,7 @@ This is a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" ti
 returned as language tag by <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-tag-from-language" title="pango_ot_tag_from_language ()"><code class="function">pango_ot_tag_from_language()</code></a> if the requested
 language is not found.  It is safe to pass this value to
 <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-language" title="pango_ot_info_find_language ()"><code class="function">pango_ot_info_find_language()</code></a> as that function falls back to returning default
-language-system if the requested language tag is not found.
-</p>
+language-system if the requested language tag is not found.</p>
 <p class="since">Since 1.18</p>
 </div>
 <hr>
@@ -536,17 +516,19 @@ language-system if the requested language tag is not found.
 <p>
 This is a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> representing the special script tag 'DFLT'.  It is
 returned as script tag by <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-tag-from-script" title="pango_ot_tag_from_script ()"><code class="function">pango_ot_tag_from_script()</code></a> if the requested script
-is not found.
-</p>
+is not found.</p>
 <p class="since">Since 1.18</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="pango-ot-info-get"></a><h3>pango_ot_info_get ()</h3>
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="returnvalue">PangoOTInfo</span></a> *       pango_ot_info_get                   (<em class="parameter"><code><span class="type">FT_Face</span> face</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_info_get</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Returns the <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="type">PangoOTInfo</span></a> structure for the given FreeType font face.
-</p>
+Returns the <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="type">PangoOTInfo</span></a> structure for the given FreeType font face.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -573,18 +555,20 @@ the same lifetime as <em class="parameter"><code>face</code></em>.</td>
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTableType" title="enum PangoOTTableType"><span class="type">PangoOTTableType</span></a> table_type</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> script_tag</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *script_index</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_info_find_script</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Finds the index of a script.  If not found, tries to find the 'DFLT'
 and then 'dflt' scripts and return the index of that in <em class="parameter"><code>script_index</code></em>.
 If none of those is found either, <a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-NO-SCRIPT:CAPS" title="PANGO_OT_NO_SCRIPT"><code class="literal">PANGO_OT_NO_SCRIPT</code></a> is placed in
-<em class="parameter"><code>script_index</code></em>.
-</p>
+<em class="parameter"><code>script_index</code></em>.</p>
 <p>
 All other functions taking an input script_index parameter know
 how to handle <a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-NO-SCRIPT:CAPS" title="PANGO_OT_NO_SCRIPT"><code class="literal">PANGO_OT_NO_SCRIPT</code></a>, so one can ignore the return
 value of this function completely and proceed, to enjoy the automatic
-fallback to the 'DFLT'/'dflt' script.
-</p>
+fallback to the 'DFLT'/'dflt' script.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -624,6 +608,10 @@ fallback to the 'DFLT'/'dflt' script.
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> language_tag</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *language_index</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *required_feature_index</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_info_find_language</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Finds the index of a language and its required feature index.
 If the language is not found, sets <em class="parameter"><code>language_index</code></em> to
@@ -632,8 +620,7 @@ system is returned in required_feature_index.  For best compatibility with
 some fonts, also searches the language system tag 'dflt' before falling
 back to the default language system, but that is transparent to the user.
 The user can simply ignore the return value of this function to
-automatically fall back to the default language system.
-</p>
+automatically fall back to the default language system.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -682,18 +669,20 @@ the language, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/loc
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> script_index</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> language_index</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *feature_index</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_info_find_feature</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Finds the index of a feature.  If the feature is not found, sets
 <em class="parameter"><code>feature_index</code></em> to PANGO_OT_NO_FEATURE, which is safe to pass to
-<a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-add-feature" title="pango_ot_ruleset_add_feature ()"><code class="function">pango_ot_ruleset_add_feature()</code></a> and similar functions.
-</p>
+<a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-add-feature" title="pango_ot_ruleset_add_feature ()"><code class="function">pango_ot_ruleset_add_feature()</code></a> and similar functions.</p>
 <p>
 In the future, this may set <em class="parameter"><code>feature_index</code></em> to an special value that if used
 in <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-add-feature" title="pango_ot_ruleset_add_feature ()"><code class="function">pango_ot_ruleset_add_feature()</code></a> will ask Pango to synthesize the
 requested feature based on Unicode properties and data.  However, this
 function will still return <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> in those cases.  So, users may want to
-ignore the return value of this function in certain cases.
-</p>
+ignore the return value of this function in certain cases.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -738,9 +727,12 @@ or <a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-DEFAULT-LANG
 <a name="pango-ot-info-list-scripts"></a><h3>pango_ot_info_list_scripts ()</h3>
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="returnvalue">PangoOTTag</span></a> *        pango_ot_info_list_scripts          (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="type">PangoOTInfo</span></a> *info</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTableType" title="enum PangoOTTableType"><span class="type">PangoOTTableType</span></a> table_type</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_info_list_scripts</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Obtains the list of available scripts.
-</p>
+Obtains the list of available scripts.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -770,9 +762,12 @@ available scripts.  Should be freed using <a href="/home/kou/work/ruby/ruby-gnom
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTableType" title="enum PangoOTTableType"><span class="type">PangoOTTableType</span></a> table_type</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> script_index</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> language_tag</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_info_list_languages</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Obtains the list of available languages for a given script.
-</p>
+Obtains the list of available languages for a given script.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -811,9 +806,12 @@ available languages.  Should be freed using <a href="/home/kou/work/ruby/ruby-gn
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> tag</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> script_index</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> language_index</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_info_list_features</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Obtains the list of features for the given language of the given script.
-</p>
+Obtains the list of features for the given language of the given script.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -854,9 +852,12 @@ available features.  Should be freed using <a href="/home/kou/work/ruby/ruby-gno
 <div class="refsect2">
 <a name="pango-ot-buffer-new"></a><h3>pango_ot_buffer_new ()</h3>
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="returnvalue">PangoOTBuffer</span></a> *     pango_ot_buffer_new                 (<em class="parameter"><code><a class="link" href="PangoFcFont.html" title="PangoFcFont"><span class="type">PangoFcFont</span></a> *font</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_buffer_new</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Creates a new <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> for the given OpenType font.
-</p>
+Creates a new <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> for the given OpenType font.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -881,9 +882,12 @@ be freed with <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-b
 <div class="refsect2">
 <a name="pango-ot-buffer-destroy"></a><h3>pango_ot_buffer_destroy ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_buffer_destroy             (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> *buffer</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_buffer_destroy</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Destroys a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> and free all associated memory.
-</p>
+Destroys a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> and free all associated memory.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -901,9 +905,12 @@ Destroys a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer
 <div class="refsect2">
 <a name="pango-ot-buffer-clear"></a><h3>pango_ot_buffer_clear ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_buffer_clear               (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> *buffer</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_buffer_clear</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Empties a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a>, make it ready to add glyphs to.
-</p>
+Empties a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a>, make it ready to add glyphs to.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -924,10 +931,13 @@ Empties a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer"
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> glyph</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> properties</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cluster</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_buffer_add_glyph</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Appends a glyph to a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a>, with <em class="parameter"><code>properties</code></em> identifying which
-features should be applied on this glyph.  See <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-add-feature" title="pango_ot_ruleset_add_feature ()"><code class="function">pango_ot_ruleset_add_feature()</code></a>.
-</p>
+features should be applied on this glyph.  See <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-add-feature" title="pango_ot_ruleset_add_feature ()"><code class="function">pango_ot_ruleset_add_feature()</code></a>.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -961,10 +971,13 @@ features should be applied on this glyph.  See <a class="link" href="pango-OpenT
 <a name="pango-ot-buffer-set-rtl"></a><h3>pango_ot_buffer_set_rtl ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_buffer_set_rtl             (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> *buffer</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> rtl</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_buffer_set_rtl</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Sets whether glyphs will be rendered right-to-left.  This setting
-is needed for proper horizontal positioning of right-to-left scripts.
-</p>
+is needed for proper horizontal positioning of right-to-left scripts.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -991,12 +1004,15 @@ is needed for proper horizontal positioning of right-to-left scripts.
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_buffer_set_zero_width_marks
                                                         (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> *buffer</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> zero_width_marks</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_buffer_set_zero_width_marks</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Sets whether characters with a mark class should be forced to zero width.
 This setting is needed for proper positioning of Arabic accents,
 but will produce incorrect results with standard OpenType Indic
-fonts.
-</p>
+fonts.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1024,11 +1040,14 @@ be forced to zero width.</td>
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_buffer_get_glyphs          (<em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> *buffer</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTGlyph" title="struct PangoOTGlyph"><span class="type">PangoOTGlyph</span></a> **glyphs</code></em>,
                                                          <em class="parameter"><code><span class="type">int</span> *n_glyphs</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_buffer_get_glyphs</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Gets the glyph array contained in a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a>.  The glyphs are
 owned by the buffer and should not be freed, and are only valid as long
-as buffer is not modified.
-</p>
+as buffer is not modified.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1059,11 +1078,14 @@ as buffer is not modified.
 <a name="pango-ot-buffer-output"></a><h3>pango_ot_buffer_output ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_buffer_output              (<em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> *buffer</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_buffer_output</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Exports the glyphs in a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> into a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a>.  This is
 typically used after the OpenType layout processing is over, to convert the
-resulting glyphs into a generic Pango glyph string.
-</p>
+resulting glyphs into a generic Pango glyph string.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1090,16 +1112,18 @@ resulting glyphs into a generic Pango glyph string.
 <pre class="programlisting">const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="returnvalue">PangoOTRuleset</span></a> * pango_ot_ruleset_get_for_description
                                                         (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="type">PangoOTInfo</span></a> *info</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="type">PangoOTRulesetDescription</span></a> *desc</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_get_for_description</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Returns a ruleset for the given OpenType info and ruleset
 description.  Rulesets are created on demand using
 <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-new-from-description" title="pango_ot_ruleset_new_from_description ()"><code class="function">pango_ot_ruleset_new_from_description()</code></a>.
-The returned ruleset should not be modified or destroyed.
-</p>
+The returned ruleset should not be modified or destroyed.</p>
 <p>
 The static feature map members of <em class="parameter"><code>desc</code></em> should be alive as
-long as <em class="parameter"><code>info</code></em> is.
-</p>
+long as <em class="parameter"><code>info</code></em> is.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1127,9 +1151,12 @@ the same lifetime as <em class="parameter"><code>info</code></em>.</td>
 <div class="refsect2">
 <a name="pango-ot-ruleset-new"></a><h3>pango_ot_ruleset_new ()</h3>
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="returnvalue">PangoOTRuleset</span></a> *    pango_ot_ruleset_new                (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="type">PangoOTInfo</span></a> *info</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_new</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Creates a new <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a> for the given OpenType info.
-</p>
+Creates a new <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a> for the given OpenType info.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1154,18 +1181,20 @@ should be freed with <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="returnvalue">PangoOTRuleset</span></a> *    pango_ot_ruleset_new_for            (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="type">PangoOTInfo</span></a> *info</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> script</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_new_for</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Creates a new <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a> for the given OpenType info, script, and
-language.
-</p>
+language.</p>
 <p>
 This function is part of a convenience scheme that highly simplifies
 using a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a> to represent features for a specific pair of script
 and language.  So one can use this function passing in the script and
 language of interest, and later try to add features to the ruleset by just
 specifying the feature name or tag, without having to deal with finding
-script, language, or feature indices manually.
-</p>
+script, language, or feature indices manually.</p>
 <p>
 In excess to what <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-new" title="pango_ot_ruleset_new ()"><code class="function">pango_ot_ruleset_new()</code></a> does, this function will:
 </p>
@@ -1193,12 +1222,9 @@ In excess to what <a class="link" href="pango-OpenType-Font-Handling.html#pango-
   </li>
 </ul></div>
 <p>
-</p>
-<p>
 Because of the way return values of <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-script" title="pango_ot_info_find_script ()"><code class="function">pango_ot_info_find_script()</code></a> and
 <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-language" title="pango_ot_info_find_language ()"><code class="function">pango_ot_info_find_language()</code></a> are ignored, this function automatically
-finds and uses the 'DFLT' script and the default language-system.
-</p>
+finds and uses the 'DFLT' script and the default language-system.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1232,19 +1258,20 @@ should be freed with <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="returnvalue">PangoOTRuleset</span></a> *    pango_ot_ruleset_new_from_description
                                                         (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTInfo"><span class="type">PangoOTInfo</span></a> *info</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="type">PangoOTRulesetDescription</span></a> *desc</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_new_from_description</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Creates a new <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a> for the given OpenType infor and
-matching the given ruleset description.
-</p>
+matching the given ruleset description.</p>
 <p>
 This is a convenience function that calls <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-new-for" title="pango_ot_ruleset_new_for ()"><code class="function">pango_ot_ruleset_new_for()</code></a> and
 adds the static GSUB/GPOS features to the resulting ruleset, followed by
-adding other features to both GSUB and GPOS.
-</p>
+adding other features to both GSUB and GPOS.</p>
 <p>
 The static feature map members of <em class="parameter"><code>desc</code></em> should be alive as
-long as <em class="parameter"><code>info</code></em> is.
-</p>
+long as <em class="parameter"><code>info</code></em> is.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1275,9 +1302,12 @@ should be freed with <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTableType" title="enum PangoOTTableType"><span class="type">PangoOTTableType</span></a> table_type</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> feature_index</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> property_bit</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_add_feature</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Adds a feature to the ruleset.
-</p>
+Adds a feature to the ruleset.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1312,16 +1342,18 @@ the glyphs that this feature should be applied to, or
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTableType" title="enum PangoOTTableType"><span class="type">PangoOTTableType</span></a> table_type</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> feature_tag</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> property_bit</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_maybe_add_feature</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 This is a convenience function that first tries to find the feature
 using <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-info-find-feature" title="pango_ot_info_find_feature ()"><code class="function">pango_ot_info_find_feature()</code></a> and the ruleset script and language
 passed to <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-new-for" title="pango_ot_ruleset_new_for ()"><code class="function">pango_ot_ruleset_new_for()</code></a>,
-and if the feature is found, adds it to the ruleset.
-</p>
+and if the feature is found, adds it to the ruleset.</p>
 <p>
 If <em class="parameter"><code>ruleset</code></em> was not created using <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-new-for" title="pango_ot_ruleset_new_for ()"><code class="function">pango_ot_ruleset_new_for()</code></a>, this function
-does nothing.
-</p>
+does nothing.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1363,12 +1395,15 @@ the glyphs that this feature should be applied to, or
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTableType" title="enum PangoOTTableType"><span class="type">PangoOTTableType</span></a> table_type</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTFeatureMap" title="struct PangoOTFeatureMap"><span class="type">PangoOTFeatureMap</span></a> *features</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_features</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_maybe_add_features</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 This is a convenience function that
 for each feature in the feature map array <em class="parameter"><code>features</code></em>
 converts the feature name to a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> feature tag using <a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-TAG-MAKE:CAPS" title="PANGO_OT_TAG_MAKE()"><code class="function">PANGO_OT_TAG_MAKE()</code></a>
-and calls <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-maybe-add-feature" title="pango_ot_ruleset_maybe_add_feature ()"><code class="function">pango_ot_ruleset_maybe_add_feature()</code></a> on it.
-</p>
+and calls <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-maybe-add-feature" title="pango_ot_ruleset_maybe_add_feature ()"><code class="function">pango_ot_ruleset_maybe_add_feature()</code></a> on it.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1406,9 +1441,12 @@ and added to <em class="parameter"><code>ruleset</code></em>.</td>
 <pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               pango_ot_ruleset_get_feature_count  (<em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a> *ruleset</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_gsub_features</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_gpos_features</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_get_feature_count</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Gets the number of GSUB and GPOS features in the ruleset.
-</p>
+Gets the number of GSUB and GPOS features in the ruleset.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1440,10 +1478,13 @@ Gets the number of GSUB and GPOS features in the ruleset.
 <a name="pango-ot-ruleset-substitute"></a><h3>pango_ot_ruleset_substitute ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_ruleset_substitute         (<em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a> *ruleset</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> *buffer</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_substitute</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Performs the OpenType GSUB substitution on <em class="parameter"><code>buffer</code></em> using the features
-in <em class="parameter"><code>ruleset</code></em>
-</p>
+in <em class="parameter"><code>ruleset</code></em></p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1467,10 +1508,13 @@ in <em class="parameter"><code>ruleset</code></em>
 <a name="pango-ot-ruleset-position"></a><h3>pango_ot_ruleset_position ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_ruleset_position           (<em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRuleset"><span class="type">PangoOTRuleset</span></a> *ruleset</code></em>,
                                                          <em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTBuffer" title="PangoOTBuffer"><span class="type">PangoOTBuffer</span></a> *buffer</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_position</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Performs the OpenType GPOS positioning on <em class="parameter"><code>buffer</code></em> using the features
-in <em class="parameter"><code>ruleset</code></em>
-</p>
+in <em class="parameter"><code>ruleset</code></em></p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1494,12 +1538,15 @@ in <em class="parameter"><code>ruleset</code></em>
 <a name="pango-ot-ruleset-description-copy"></a><h3>pango_ot_ruleset_description_copy ()</h3>
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="returnvalue">PangoOTRulesetDescription</span></a> * pango_ot_ruleset_description_copy
                                                         (<em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="type">PangoOTRulesetDescription</span></a> *desc</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_description_copy</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Creates a copy of <em class="parameter"><code>desc</code></em>, which should be freed with
 <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-description-free" title="pango_ot_ruleset_description_free ()"><code class="function">pango_ot_ruleset_description_free()</code></a>. Primarily used internally
 by <a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-get-for-description" title="pango_ot_ruleset_get_for_description ()"><code class="function">pango_ot_ruleset_get_for_description()</code></a> to cache rulesets for
-ruleset descriptions.
-</p>
+ruleset descriptions.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1524,6 +1571,10 @@ should be freed with <a class="link" href="pango-OpenType-Font-Handling.html#pan
 <a name="pango-ot-ruleset-description-equal"></a><h3>pango_ot_ruleset_description_equal ()</h3>
 <pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_ot_ruleset_description_equal  (<em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="type">PangoOTRulesetDescription</span></a> *desc1</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="type">PangoOTRulesetDescription</span></a> *desc2</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_description_equal</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Compares two ruleset descriptions for equality.
 Two ruleset descriptions are considered equal if the rulesets
@@ -1532,8 +1583,7 @@ script, language, and all feature sets should be equal.  For static feature
 sets, the array addresses are compared directly, while for other
 features, the list of features is compared one by one.
 (Two ruleset descriptions may result in identical rulesets
-being created, but still compare <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.)
-</p>
+being created, but still compare <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.)</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1562,10 +1612,13 @@ being created, but still compare <a href="/home/kou/work/ruby/ruby-gnome2.win32/
 <div class="refsect2">
 <a name="pango-ot-ruleset-description-free"></a><h3>pango_ot_ruleset_description_free ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                pango_ot_ruleset_description_free   (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="type">PangoOTRulesetDescription</span></a> *desc</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_description_free</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Frees a ruleset description allocated by
-<a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-description-copy" title="pango_ot_ruleset_description_copy ()"><code class="function">pango_ot_ruleset_description_copy()</code></a>.
-</p>
+<a class="link" href="pango-OpenType-Font-Handling.html#pango-ot-ruleset-description-copy" title="pango_ot_ruleset_description_copy ()"><code class="function">pango_ot_ruleset_description_copy()</code></a>.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1583,10 +1636,13 @@ Frees a ruleset description allocated by
 <div class="refsect2">
 <a name="pango-ot-ruleset-description-hash"></a><h3>pango_ot_ruleset_description_hash ()</h3>
 <pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               pango_ot_ruleset_description_hash   (<em class="parameter"><code>const <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="type">PangoOTRulesetDescription</span></a> *desc</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_ruleset_description_hash</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
 Computes a hash of a <a class="link" href="pango-OpenType-Font-Handling.html#PangoOTRulesetDescription" title="struct PangoOTRulesetDescription"><span class="type">PangoOTRulesetDescription</span></a> structure suitable
-to be used, for example, as an argument to <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a>.
-</p>
+to be used, for example, as an argument to <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a>.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1609,9 +1665,12 @@ to be used, for example, as an argument to <a href="/home/kou/work/ruby/ruby-gno
 <div class="refsect2">
 <a name="pango-ot-tag-from-language"></a><h3>pango_ot_tag_from_language ()</h3>
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="returnvalue">PangoOTTag</span></a>          pango_ot_tag_from_language          (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_tag_from_language</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Finds the OpenType language-system tag best describing <em class="parameter"><code>language</code></em>.
-</p>
+Finds the OpenType language-system tag best describing <em class="parameter"><code>language</code></em>.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1638,20 +1697,21 @@ is <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-d
 <div class="refsect2">
 <a name="pango-ot-tag-from-script"></a><h3>pango_ot_tag_from_script ()</h3>
 <pre class="programlisting"><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="returnvalue">PangoOTTag</span></a>          pango_ot_tag_from_script            (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> script</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_tag_from_script</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Finds the OpenType script tag corresponding to <em class="parameter"><code>script</code></em>.
-</p>
+Finds the OpenType script tag corresponding to <em class="parameter"><code>script</code></em>.</p>
 <p>
 The <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-COMMON:CAPS"><code class="literal">PANGO_SCRIPT_COMMON</code></a>, <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-INHERITED:CAPS"><code class="literal">PANGO_SCRIPT_INHERITED</code></a>, and
 <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-UNKNOWN:CAPS"><code class="literal">PANGO_SCRIPT_UNKNOWN</code></a> scripts are mapped to the OpenType
 'DFLT' script tag that is also defined as
-<a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-TAG-DEFAULT-SCRIPT:CAPS" title="PANGO_OT_TAG_DEFAULT_SCRIPT"><code class="literal">PANGO_OT_TAG_DEFAULT_SCRIPT</code></a>.
-</p>
+<a class="link" href="pango-OpenType-Font-Handling.html#PANGO-OT-TAG-DEFAULT-SCRIPT:CAPS" title="PANGO_OT_TAG_DEFAULT_SCRIPT"><code class="literal">PANGO_OT_TAG_DEFAULT_SCRIPT</code></a>.</p>
 <p>
 Note that multiple <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> values may map to the same
 OpenType script tag.  In particular, <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-HIRAGANA:CAPS"><code class="literal">PANGO_SCRIPT_HIRAGANA</code></a>
-and <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-KATAKANA:CAPS"><code class="literal">PANGO_SCRIPT_KATAKANA</code></a> both map to the OT tag 'kana'.
-</p>
+and <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-KATAKANA:CAPS"><code class="literal">PANGO_SCRIPT_KATAKANA</code></a> both map to the OT tag 'kana'.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1677,9 +1737,12 @@ and <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-KATAKANA
 <div class="refsect2">
 <a name="pango-ot-tag-to-language"></a><h3>pango_ot_tag_to_language ()</h3>
 <pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="returnvalue">PangoLanguage</span></a> *     pango_ot_tag_to_language            (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> language_tag</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_tag_to_language</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Finds a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> corresponding to <em class="parameter"><code>language_tag</code></em>.
-</p>
+Finds a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> corresponding to <em class="parameter"><code>language_tag</code></em>.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1704,12 +1767,14 @@ Finds a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><s
 <div class="refsect2">
 <a name="pango-ot-tag-to-script"></a><h3>pango_ot_tag_to_script ()</h3>
 <pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="returnvalue">PangoScript</span></a>         pango_ot_tag_to_script              (<em class="parameter"><code><a class="link" href="pango-OpenType-Font-Handling.html#PangoOTTag" title="PangoOTTag"><span class="type">PangoOTTag</span></a> script_tag</code></em>);</pre>
+<div class="warning">
+<h3 class="title">Warning</h3>
+<p><code class="literal">pango_ot_tag_to_script</code> is deprecated and should not be used in newly-written code.</p>
+</div>
 <p>
-Finds the <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> corresponding to <em class="parameter"><code>script_tag</code></em>.
-</p>
+Finds the <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> corresponding to <em class="parameter"><code>script_tag</code></em>.</p>
 <p>
-The 'DFLT' script tag is mapped to <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-COMMON:CAPS"><code class="literal">PANGO_SCRIPT_COMMON</code></a>.
-</p>
+The 'DFLT' script tag is mapped to <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-COMMON:CAPS"><code class="literal">PANGO_SCRIPT_COMMON</code></a>.</p>
 <p>
 Note that an OpenType script tag may correspond to multiple
 <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> values.  In such cases, the <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> value
@@ -1717,8 +1782,7 @@ with the smallest value is returned.
 In particular, <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-HIRAGANA:CAPS"><code class="literal">PANGO_SCRIPT_HIRAGANA</code></a>
 and <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-KATAKANA:CAPS"><code class="literal">PANGO_SCRIPT_KATAKANA</code></a> both map to the OT tag 'kana'.
 This function will return <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-HIRAGANA:CAPS"><code class="literal">PANGO_SCRIPT_HIRAGANA</code></a> for
-'kana'.
-</p>
+'kana'.</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -1743,6 +1807,6 @@ This function will return <a class="link" href="pango-Scripts-and-Languages.html
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.19</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>