RubyGems - gstreamer - Versions diffs - 3.1.6-x64-mingw32 → 3.1.7-x64-mingw32 - Mend

gstreamer 3.1.6-x64-mingw32 → 3.1.7-x64-mingw32

Files changed (1658) hide show

data/vendor/local/share/gtk-doc/html/libsoup-2.4/libsoup-2.4-Top-Level-Domain-utils.html CHANGED Viewed

@@ -7,8 +7,8 @@
 <link rel="home" href="index.html" title="libsoup Reference Manual">
 <link rel="up" href="ch02.html" title="Core API">
 <link rel="prev" href="libsoup-2.4-soup-status.html" title="soup-status">
-<link rel="next" href="libsoup-2.4-SoupURI.html" title="SoupURI">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<link rel="next" href="SoupURI.html" title="SoupURI">
+<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -20,34 +20,224 @@
 <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="ch02.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
 <td><a accesskey="p" href="libsoup-2.4-soup-status.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
-<td><a accesskey="n" href="libsoup-2.4-SoupURI.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+<td><a accesskey="n" href="SoupURI.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
 </tr></table>
 <div class="refentry">
 <a name="libsoup-2.4-Top-Level-Domain-utils"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
 <h2><span class="refentrytitle"><a name="libsoup-2.4-Top-Level-Domain-utils.top_of_page"></a>Top Level Domain utils</span></h2>
-<p>Top Level Domain utils</p>
+<p>Top Level Domain utils — Top-Level Domain Utilities</p>
 </td>
 <td class="gallery_image" valign="top" align="right"></td>
 </tr></table></div>
 <div class="refsect1">
+<a name="libsoup-2.4-Top-Level-Domain-utils.functions"></a><h2>Functions</h2>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="functions_return">
+<col class="functions_name">
+</colgroup>
+<tbody>
+<tr>
+<td class="function_type">const <span class="returnvalue">char</span> *
+</td>
+<td class="function_name">
+<a class="link" href="libsoup-2.4-Top-Level-Domain-utils.html#soup-tld-get-base-domain" title="soup_tld_get_base_domain ()">soup_tld_get_base_domain</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="libsoup-2.4-Top-Level-Domain-utils.html#soup-tld-domain-is-public-suffix" title="soup_tld_domain_is_public_suffix ()">soup_tld_domain_is_public_suffix</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="libsoup-2.4-Top-Level-Domain-utils.other"></a><h2>Types and Values</h2>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="name">
+<col class="description">
+</colgroup>
+<tbody>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name"><a class="link" href="libsoup-2.4-Top-Level-Domain-utils.html#SOUP-TLD-ERROR:CAPS" title="SOUP_TLD_ERROR">SOUP_TLD_ERROR</a></td>
+</tr>
+<tr>
+<td class="datatype_keyword">enum</td>
+<td class="function_name"><a class="link" href="libsoup-2.4-Top-Level-Domain-utils.html#SoupTLDError" title="enum SoupTLDError">SoupTLDError</a></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect1">
 <a name="libsoup-2.4-Top-Level-Domain-utils.includes"></a><h2>Includes</h2>
 <pre class="synopsis">#include &lt;libsoup/soup.h&gt;
 </pre>
 </div>
 <div class="refsect1">
 <a name="libsoup-2.4-Top-Level-Domain-utils.description"></a><h2>Description</h2>
+<p>These functions can be used to parse hostnames to attempt to determine
+what part of the name belongs to the domain owner, and what part is
+simply a "public suffix" such as ".com".</p>
 </div>
 <div class="refsect1">
 <a name="libsoup-2.4-Top-Level-Domain-utils.functions_details"></a><h2>Functions</h2>
-<p></p>
+<div class="refsect2">
+<a name="soup-tld-get-base-domain"></a><h3>soup_tld_get_base_domain ()</h3>
+<pre class="programlisting">const <span class="returnvalue">char</span> *
+soup_tld_get_base_domain (<em class="parameter"><code>const <span class="type">char</span> *hostname</code></em>,
+                          <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+<p>Finds the base domain for a given <em class="parameter"><code>hostname</code></em>
+. The base domain is
+composed by the top level domain (such as .org, .com, .co.uk, etc)
+plus the second level domain, for example for myhost.mydomain.com
+it will return mydomain.com.</p>
+<p>Note that <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned for private URLs (those not ending
+with any well known TLD) because choosing a base domain for them
+would be totally arbitrary.</p>
+<p>Prior to libsoup 2.46, this function required that <em class="parameter"><code>hostname</code></em>
+ be in
+UTF-8 if it was an IDN. From 2.46 on, the name can be in either
+UTF-8 or ASCII format (and the return value will be in the same
+format).</p>
+<div class="refsect3">
+<a name="soup-tld-get-base-domain.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>hostname</p></td>
+<td class="parameter_description"><p>a hostname</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>return location for a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore
+errors. See <a class="link" href="libsoup-2.4-Top-Level-Domain-utils.html#SoupTLDError" title="enum SoupTLDError"><span class="type">SoupTLDError</span></a> for the available error codes</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="soup-tld-get-base-domain.returns"></a><h4>Returns</h4>
+<p> a pointer to the start of the base domain in <em class="parameter"><code>hostname</code></em>
+. If
+an error occurs, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned and <em class="parameter"><code>error</code></em>
+set.</p>
+</div>
+<p class="since">Since: 2.40</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="soup-tld-domain-is-public-suffix"></a><h3>soup_tld_domain_is_public_suffix ()</h3>
+<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+soup_tld_domain_is_public_suffix (<em class="parameter"><code>const <span class="type">char</span> *domain</code></em>);</pre>
+<p>Looks whether the <em class="parameter"><code>domain</code></em>
+ passed as argument is a public domain
+suffix (.org, .com, .co.uk, etc) or not.</p>
+<p>Prior to libsoup 2.46, this function required that <em class="parameter"><code>domain</code></em>
+ be in
+UTF-8 if it was an IDN. From 2.46 on, the name can be in either
+UTF-8 or ASCII format (and the return value will be in the same
+format).</p>
+<div class="refsect3">
+<a name="soup-tld-domain-is-public-suffix.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>domain</p></td>
+<td class="parameter_description"><p>a domain name</p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="soup-tld-domain-is-public-suffix.returns"></a><h4>Returns</h4>
+<p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if it is a public domain, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
+</div>
+<p class="since">Since: 2.40</p>
+</div>
 </div>
 <div class="refsect1">
 <a name="libsoup-2.4-Top-Level-Domain-utils.other_details"></a><h2>Types and Values</h2>
+<div class="refsect2">
+<a name="SOUP-TLD-ERROR:CAPS"></a><h3>SOUP_TLD_ERROR</h3>
+<pre class="programlisting">#define SOUP_TLD_ERROR soup_tld_error_quark()
+</pre>
+<p>The <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> domain for soup-tld-related errors.</p>
+<p class="since">Since: 2.40</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="SoupTLDError"></a><h3>enum SoupTLDError</h3>
+<p>Error codes for <a class="link" href="libsoup-2.4-Top-Level-Domain-utils.html#SOUP-TLD-ERROR:CAPS" title="SOUP_TLD_ERROR"><code class="literal">SOUP_TLD_ERROR</code></a>.</p>
+<div class="refsect3">
+<a name="SoupTLDError.members"></a><h4>Members</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="300px" class="enum_members_name">
+<col class="enum_members_description">
+<col width="200px" class="enum_members_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="enum_member_name"><p><a name="SOUP-TLD-ERROR-INVALID-HOSTNAME:CAPS"></a>SOUP_TLD_ERROR_INVALID_HOSTNAME</p></td>
+<td class="enum_member_description">
+<p>A hostname was syntactically
+  invalid.</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="SOUP-TLD-ERROR-IS-IP-ADDRESS:CAPS"></a>SOUP_TLD_ERROR_IS_IP_ADDRESS</p></td>
+<td class="enum_member_description">
+<p>The passed-in "hostname" was
+  actually an IP address (and thus has no base domain or
+  public suffix).</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="SOUP-TLD-ERROR-NOT-ENOUGH-DOMAINS:CAPS"></a>SOUP_TLD_ERROR_NOT_ENOUGH_DOMAINS</p></td>
+<td class="enum_member_description">
+<p>The passed-in hostname
+  did not have enough components. Eg, calling
+  <a class="link" href="libsoup-2.4-Top-Level-Domain-utils.html#soup-tld-get-base-domain" title="soup_tld_get_base_domain ()"><code class="function">soup_tld_get_base_domain()</code></a> on <code class="literal">"co.uk"</code>.</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="SOUP-TLD-ERROR-NO-BASE-DOMAIN:CAPS"></a>SOUP_TLD_ERROR_NO_BASE_DOMAIN</p></td>
+<td class="enum_member_description">
+<p>The passed-in hostname has
+  no recognized public suffix.</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: 2.40</p>
+</div>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.25</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/libsoup-2.4/libsoup-2.4-Version-Information.html CHANGED Viewed

@@ -6,9 +6,9 @@
 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
 <link rel="home" href="index.html" title="libsoup Reference Manual">
 <link rel="up" href="ch02.html" title="Core API">
-<link rel="prev" href="libsoup-2.4-SoupURI.html" title="SoupURI">
+<link rel="prev" href="SoupURI.html" title="SoupURI">
 <link rel="next" href="ch03.html" title="Additional Features">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -19,7 +19,7 @@
 </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="ch02.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
-<td><a accesskey="p" href="libsoup-2.4-SoupURI.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="p" href="SoupURI.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
 <td><a accesskey="n" href="ch03.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
 </tr></table>
 <div class="refentry">
@@ -27,7 +27,7 @@
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
 <h2><span class="refentrytitle"><a name="libsoup-2.4-Version-Information.top_of_page"></a>Version Information</span></h2>
-<p>Version Information</p>
+<p>Version Information — Variables and functions to check the libsoup version</p>
 </td>
 <td class="gallery_image" valign="top" align="right"></td>
 </tr></table></div>
@@ -185,18 +185,51 @@
 <a name="soup-get-major-version"></a><h3>soup_get_major_version ()</h3>
 <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
 soup_get_major_version (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>Returns the major version number of the libsoup library.
+(e.g. in libsoup version 2.42.0 this is 2.)</p>
+<p>This function is in the library, so it represents the libsoup library
+your code is running against. Contrast with the <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-MAJOR-VERSION:CAPS" title="SOUP_MAJOR_VERSION"><span class="type">SOUP_MAJOR_VERSION</span></a>
+macro, which represents the major version of the libsoup headers you
+have included when compiling your code.</p>
+<div class="refsect3">
+<a name="soup-get-major-version.returns"></a><h4>Returns</h4>
+<p> the major version number of the libsoup library</p>
+</div>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="soup-get-minor-version"></a><h3>soup_get_minor_version ()</h3>
 <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
 soup_get_minor_version (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>Returns the minor version number of the libsoup library.
+(e.g. in libsoup version 2.42.0 this is 42.)</p>
+<p>This function is in the library, so it represents the libsoup library
+your code is running against. Contrast with the <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-MINOR-VERSION:CAPS" title="SOUP_MINOR_VERSION"><span class="type">SOUP_MINOR_VERSION</span></a>
+macro, which represents the minor version of the libsoup headers you
+have included when compiling your code.</p>
+<div class="refsect3">
+<a name="soup-get-minor-version.returns"></a><h4>Returns</h4>
+<p> the minor version number of the libsoup library</p>
+</div>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="soup-get-micro-version"></a><h3>soup_get_micro_version ()</h3>
 <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
 soup_get_micro_version (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>Returns the micro version number of the libsoup library.
+(e.g. in libsoup version 2.42.0 this is 0.)</p>
+<p>This function is in the library, so it represents the libsoup library
+your code is running against. Contrast with the <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-MICRO-VERSION:CAPS" title="SOUP_MICRO_VERSION"><span class="type">SOUP_MICRO_VERSION</span></a>
+macro, which represents the micro version of the libsoup headers you
+have included when compiling your code.</p>
+<div class="refsect3">
+<a name="soup-get-micro-version.returns"></a><h4>Returns</h4>
+<p> the micro version number of the libsoup library</p>
+</div>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -205,11 +238,82 @@ soup_get_micro_version (<em class="parameter"><code><span class="type">void</spa
 soup_check_version (<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> major</code></em>,
                     <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> minor</code></em>,
                     <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> micro</code></em>);</pre>
+<p>Like SOUP_CHECK_VERSION, but the check for soup_check_version is
+at runtime instead of compile time. This is useful for compiling
+against older versions of libsoup, but using features from newer
+versions.</p>
+<div class="refsect3">
+<a name="soup-check-version.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>major</p></td>
+<td class="parameter_description"><p>the major version to check</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>minor</p></td>
+<td class="parameter_description"><p>the minor version to check</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>micro</p></td>
+<td class="parameter_description"><p>the micro version to check</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="soup-check-version.returns"></a><h4>Returns</h4>
+<p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the version of the libsoup currently loaded
+is the same as or newer than the passed-in version.</p>
+</div>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-CHECK-VERSION:CAPS"></a><h3>SOUP_CHECK_VERSION()</h3>
 <pre class="programlisting">#define             SOUP_CHECK_VERSION(major, minor, micro)</pre>
+<p>Macro to test the version of libsoup being compiled against.</p>
+<div class="refsect3">
+<a name="SOUP-CHECK-VERSION.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>major</p></td>
+<td class="parameter_description"><p>major version (e.g. 2 for version 2.42.0)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>minor</p></td>
+<td class="parameter_description"><p>minor version (e.g. 42 for version 2.42.0)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>micro</p></td>
+<td class="parameter_description"><p>micro version (e.g. 0 for version 2.42.0)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="SOUP-CHECK-VERSION.returns"></a><h4>Returns</h4>
+<p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the version of the libsoup header files
+is the same as or newer than the passed-in version.</p>
+</div>
+<p class="since">Since: 2.42</p>
 </div>
 </div>
 <div class="refsect1">
@@ -218,124 +322,218 @@ soup_check_version (<em class="parameter"><code><a href="/home/vagrant/ruby-gnom
 <a name="SOUP-MAJOR-VERSION:CAPS"></a><h3>SOUP_MAJOR_VERSION</h3>
 <pre class="programlisting">#define SOUP_MAJOR_VERSION (2)
 </pre>
+<p>Like <a class="link" href="libsoup-2.4-Version-Information.html#soup-get-major-version" title="soup_get_major_version ()"><code class="function">soup_get_major_version()</code></a>, but from the headers used at
+application compile time, rather than from the library linked
+against at application run time.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-MINOR-VERSION:CAPS"></a><h3>SOUP_MINOR_VERSION</h3>
-<pre class="programlisting">#define SOUP_MINOR_VERSION (57)
+<pre class="programlisting">#define SOUP_MINOR_VERSION (58)
 </pre>
+<p>Like <a class="link" href="libsoup-2.4-Version-Information.html#soup-get-minor-version" title="soup_get_minor_version ()"><code class="function">soup_get_minor_version()</code></a>, but from the headers used at
+application compile time, rather than from the library linked
+against at application run time.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-MICRO-VERSION:CAPS"></a><h3>SOUP_MICRO_VERSION</h3>
 <pre class="programlisting">#define SOUP_MICRO_VERSION (1)
 </pre>
+<p>Like <a class="link" href="libsoup-2.4-Version-Information.html#soup-get-micro-version" title="soup_get_micro_version ()"><code class="function">soup_get_micro_version()</code></a>, but from the headers used at
+application compile time, rather than from the library linked
+against at application run time.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-MIN-REQUIRED:CAPS"></a><h3>SOUP_VERSION_MIN_REQUIRED</h3>
 <pre class="programlisting"># define SOUP_VERSION_MIN_REQUIRED (SOUP_VERSION_CUR_STABLE)
 </pre>
+<p>A macro that should be defined by the user prior to including
+libsoup.h. The definition should be one of the predefined libsoup
+version macros: <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-2-24:CAPS" title="SOUP_VERSION_2_24"><code class="literal">SOUP_VERSION_2_24</code></a>, <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-2-26:CAPS" title="SOUP_VERSION_2_26"><code class="literal">SOUP_VERSION_2_26</code></a>, ...</p>
+<p>This macro defines the earliest version of libsoup that the package
+is required to be able to compile against.</p>
+<p>If the compiler is configured to warn about the use of deprecated
+functions, then using functions that were deprecated in version
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> or earlier will cause warnings (but
+using functions deprecated in later releases will not).</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-MAX-ALLOWED:CAPS"></a><h3>SOUP_VERSION_MAX_ALLOWED</h3>
 <pre class="programlisting"># define SOUP_VERSION_MAX_ALLOWED (SOUP_VERSION_CUR_STABLE)
 </pre>
+<p>A macro that should be defined by the user prior to including
+libsoup.h. The definition should be one of the predefined libsoup
+version macros: <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-2-24:CAPS" title="SOUP_VERSION_2_24"><code class="literal">SOUP_VERSION_2_24</code></a>, <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-2-26:CAPS" title="SOUP_VERSION_2_26"><code class="literal">SOUP_VERSION_2_26</code></a>, ...</p>
+<p>This macro defines the latest version of the libsoup API that the
+package is allowed to make use of.</p>
+<p>If the compiler is configured to warn about the use of deprecated
+functions, then using functions added after version
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a> will cause warnings.</p>
+<p>Unless you are using <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-CHECK-VERSION:CAPS" title="SOUP_CHECK_VERSION()"><code class="function">SOUP_CHECK_VERSION()</code></a> or the like to compile
+different code depending on the libsoup version, then this should be
+set to the same value as <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-24:CAPS"></a><h3>SOUP_VERSION_2_24</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_24 (G_ENCODE_VERSION (2, 24))
 </pre>
+<p>A macro that evaluates to the 2.24 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-26:CAPS"></a><h3>SOUP_VERSION_2_26</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_26 (G_ENCODE_VERSION (2, 26))
 </pre>
+<p>A macro that evaluates to the 2.26 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-28:CAPS"></a><h3>SOUP_VERSION_2_28</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_28 (G_ENCODE_VERSION (2, 28))
 </pre>
+<p>A macro that evaluates to the 2.28 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-30:CAPS"></a><h3>SOUP_VERSION_2_30</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_30 (G_ENCODE_VERSION (2, 30))
 </pre>
+<p>A macro that evaluates to the 2.30 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-32:CAPS"></a><h3>SOUP_VERSION_2_32</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_32 (G_ENCODE_VERSION (2, 32))
 </pre>
+<p>A macro that evaluates to the 2.32 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-34:CAPS"></a><h3>SOUP_VERSION_2_34</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_34 (G_ENCODE_VERSION (2, 34))
 </pre>
+<p>A macro that evaluates to the 2.34 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-36:CAPS"></a><h3>SOUP_VERSION_2_36</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_36 (G_ENCODE_VERSION (2, 36))
 </pre>
+<p>A macro that evaluates to the 2.36 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-38:CAPS"></a><h3>SOUP_VERSION_2_38</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_38 (G_ENCODE_VERSION (2, 38))
 </pre>
+<p>A macro that evaluates to the 2.38 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-40:CAPS"></a><h3>SOUP_VERSION_2_40</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_40 (G_ENCODE_VERSION (2, 40))
 </pre>
+<p>A macro that evaluates to the 2.40 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-42:CAPS"></a><h3>SOUP_VERSION_2_42</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_42 (G_ENCODE_VERSION (2, 42))
 </pre>
+<p>A macro that evaluates to the 2.42 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.42</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-44:CAPS"></a><h3>SOUP_VERSION_2_44</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_44 (G_ENCODE_VERSION (2, 44))
 </pre>
+<p>A macro that evaluates to the 2.44 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.44</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-46:CAPS"></a><h3>SOUP_VERSION_2_46</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_46 (G_ENCODE_VERSION (2, 46))
 </pre>
+<p>A macro that evaluates to the 2.46 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.46</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-48:CAPS"></a><h3>SOUP_VERSION_2_48</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_48 (G_ENCODE_VERSION (2, 48))
 </pre>
+<p>A macro that evaluates to the 2.48 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.48</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-50:CAPS"></a><h3>SOUP_VERSION_2_50</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_50 (G_ENCODE_VERSION (2, 50))
 </pre>
+<p>A macro that evaluates to the 2.50 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.50</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="SOUP-VERSION-2-52:CAPS"></a><h3>SOUP_VERSION_2_52</h3>
 <pre class="programlisting">#define SOUP_VERSION_2_52 (G_ENCODE_VERSION (2, 52))
 </pre>
+<p>A macro that evaluates to the 2.52 version of libsoup, in a format
+that can be used by <a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MIN-REQUIRED:CAPS" title="SOUP_VERSION_MIN_REQUIRED"><code class="literal">SOUP_VERSION_MIN_REQUIRED</code></a> and
+<a class="link" href="libsoup-2.4-Version-Information.html#SOUP-VERSION-MAX-ALLOWED:CAPS" title="SOUP_VERSION_MAX_ALLOWED"><code class="literal">SOUP_VERSION_MAX_ALLOWED</code></a>.</p>
+<p class="since">Since: 2.52</p>
 </div>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.25</div>
 </body>
 </html>