glib2 3.1.8-x86-mingw32 → 3.1.9-x86-mingw32

data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html

@@ -1238,7 +1238,10 @@ or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code
 <div class="refsect2">
 <a name="g-slist-next"></a><h3>g_slist_next()</h3>
 <pre class="programlisting">#define             g_slist_next(slist)</pre>
-<p>A convenience macro to get the next element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="struct GSList"><span class="type">GSList</span></a>.</p>
+<p>A convenience macro to get the next element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="struct GSList"><span class="type">GSList</span></a>.
+Note that it is considered perfectly acceptable to access
+<em class="parameter"><code>slist-&gt;next</code></em>
+ directly.</p>
 <div class="refsect3">
 <a name="g-slist-next.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">

data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html

@@ -148,6 +148,95 @@ as well as convenience variants that take a complete shell-like
 commandline (<a class="link" href="glib-Spawning-Processes.html#g-spawn-command-line-sync" title="g_spawn_command_line_sync ()"><code class="function">g_spawn_command_line_sync()</code></a>, <a class="link" href="glib-Spawning-Processes.html#g-spawn-command-line-async" title="g_spawn_command_line_async ()"><code class="function">g_spawn_command_line_async()</code></a>).</p>
 <p>See <a href="../gio/GSubprocess.html#GSubprocess-struct"><span class="type">GSubprocess</span></a> in GIO for a higher-level API that provides
 stream interfaces for communication with child processes.</p>
+<p>An example of using <a class="link" href="glib-Spawning-Processes.html#g-spawn-async-with-pipes" title="g_spawn_async_with_pipes ()"><code class="function">g_spawn_async_with_pipes()</code></a>:</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">const</span> gchar <span class="gtkdoc opt">*</span> <span class="gtkdoc kwb">const</span> argv<span class="gtkdoc opt">[] = {</span> <span class="string">&quot;my-favourite-program&quot;</span><span class="gtkdoc opt">,</span> <span class="string">&quot;--args&quot;</span><span class="gtkdoc opt">,</span> NULL <span class="gtkdoc opt">};</span>
+gint child_stdout<span class="gtkdoc opt">,</span> child_stderr<span class="gtkdoc opt">;</span>
+GPid child_pid<span class="gtkdoc opt">;</span>
+<span class="function"><a href="glib-Miscellaneous-Macros.html#g-autoptr">g_autoptr</a></span><span class="gtkdoc opt">(</span>GError<span class="gtkdoc opt">)</span> error <span class="gtkdoc opt">=</span> NULL<span class="gtkdoc opt">;</span>
+
+<span class="gtkdoc slc">// Spawn child process.</span>
+<span class="function"><a href="glib-Spawning-Processes.html#g-spawn-async-with-pipes">g_spawn_async_with_pipes</a></span> <span class="gtkdoc opt">(</span>NULL<span class="gtkdoc opt">,</span> argv<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span> G_SPAWN_DO_NOT_REAP_CHILD<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">,</span>
+                          NULL<span class="gtkdoc opt">, &amp;</span>child_pid<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">, &amp;</span>child_stdout<span class="gtkdoc opt">,</span>
+                          <span class="gtkdoc opt">&amp;</span>child_stderr<span class="gtkdoc opt">, &amp;</span>error<span class="gtkdoc opt">);</span>
+<span class="keyword">if</span> <span class="gtkdoc opt">(</span>error <span class="gtkdoc opt">!=</span> NULL<span class="gtkdoc opt">)</span>
+  <span class="gtkdoc opt">{</span>
+    <span class="function"><a href="glib-Message-Logging.html#g-error">g_error</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;Spawning child failed: %s&quot;</span><span class="gtkdoc opt">,</span> error<span class="gtkdoc opt">-&gt;</span>message<span class="gtkdoc opt">);</span>
+    <span class="keyword">return</span><span class="gtkdoc opt">;</span>
+  <span class="gtkdoc opt">}</span>
+
+<span class="gtkdoc slc">// Add a child watch function which will be called when the child process</span>
+<span class="gtkdoc slc">// exits.</span>
+<span class="function"><a href="glib-The-Main-Event-Loop.html#g-child-watch-add">g_child_watch_add</a></span> <span class="gtkdoc opt">(</span>child_pid<span class="gtkdoc opt">,</span> child_watch_cb<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
+
+<span class="gtkdoc slc">// You could watch for output on &#64;child_stdout and &#64;child_stderr using</span>
+<span class="gtkdoc slc">// #GUnixInputStream or #GIOChannel here.</span>
+
+<span class="gtkdoc kwb">static void</span>
+<span class="function">child_watch_cb</span> <span class="gtkdoc opt">(</span>GPid     pid<span class="gtkdoc opt">,</span>
+                gint     status<span class="gtkdoc opt">,</span>
+                gpointer user_data<span class="gtkdoc opt">)</span>
+<span class="gtkdoc opt">{</span>
+  <span class="function"><a href="glib-Message-Logging.html#g-message">g_message</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;Child %&quot;</span> G_PID_FORMAT <span class="string">&quot; exited %s&quot;</span><span class="gtkdoc opt">,</span> pid<span class="gtkdoc opt">,</span>
+             <span class="function"><a href="glib-Spawning-Processes.html#g-spawn-check-exit-status">g_spawn_check_exit_status</a></span> <span class="gtkdoc opt">(</span>status<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">) ?</span> <span class="string">&quot;normally&quot;</span> <span class="gtkdoc opt">:</span> <span class="string">&quot;abnormally&quot;</span><span class="gtkdoc opt">);</span>
+
+  <span class="gtkdoc slc">// Free any resources associated with the child here, such as I/O channels</span>
+  <span class="gtkdoc slc">// on its stdout and stderr FDs. If you have no code to put in the</span>
+  <span class="gtkdoc slc">// child_watch_cb() callback, you can remove it and the g_child_watch_add()</span>
+  <span class="gtkdoc slc">// call, but you must also remove the G_SPAWN_DO_NOT_REAP_CHILD flag,</span>
+  <span class="gtkdoc slc">// otherwise the child process will stay around as a zombie until this</span>
+  <span class="gtkdoc slc">// process exits.</span>
+
+  <span class="function"><a href="glib-Spawning-Processes.html#g-spawn-close-pid">g_spawn_close_pid</a></span> <span class="gtkdoc opt">(</span>pid<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+
+<p></p>
 </div>
 <div class="refsect1">
 <a name="glib-Spawning-Processes.functions_details"></a><h2>Functions</h2>
@@ -275,11 +364,12 @@ If <em class="parameter"><code>envp</code></em>
 <p><em class="parameter"><code>flags</code></em>
  should be the bitwise OR of any flags you want to affect the
 function's behaviour. The <a class="link" href="glib-Spawning-Processes.html#G-SPAWN-DO-NOT-REAP-CHILD:CAPS"><code class="literal">G_SPAWN_DO_NOT_REAP_CHILD</code></a> means that the
-child will not automatically be reaped; you must use a child watch to
-be notified about the death of the child process. Eventually you must
-call <a class="link" href="glib-Spawning-Processes.html#g-spawn-close-pid" title="g_spawn_close_pid ()"><code class="function">g_spawn_close_pid()</code></a> on the <em class="parameter"><code>child_pid</code></em>
-, in order to free
-resources which may be associated with the child process. (On Unix,
+child will not automatically be reaped; you must use a child watch
+(<a class="link" href="glib-The-Main-Event-Loop.html#g-child-watch-add" title="g_child_watch_add ()"><code class="function">g_child_watch_add()</code></a>) to be notified about the death of the child process,
+otherwise it will stay around as a zombie process until this process exits.
+Eventually you must call <a class="link" href="glib-Spawning-Processes.html#g-spawn-close-pid" title="g_spawn_close_pid ()"><code class="function">g_spawn_close_pid()</code></a> on the <em class="parameter"><code>child_pid</code></em>
+, in order to
+free resources which may be associated with the child process. (On Unix,
 using a child watch is equivalent to calling <code class="function">waitpid()</code> or handling
 the <code class="literal">SIGCHLD</code> signal manually. On Windows, calling <a class="link" href="glib-Spawning-Processes.html#g-spawn-close-pid" title="g_spawn_close_pid ()"><code class="function">g_spawn_close_pid()</code></a>
 is equivalent to calling <code class="function">CloseHandle()</code> on the process handle returned
@@ -380,10 +470,10 @@ and <em class="parameter"><code>standard_error</code></em>
 <p>If <em class="parameter"><code>child_pid</code></em>
  is not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> and an error does not occur then the returned
 process reference must be closed using <a class="link" href="glib-Spawning-Processes.html#g-spawn-close-pid" title="g_spawn_close_pid ()"><code class="function">g_spawn_close_pid()</code></a>.</p>
-<p>If you are writing a GTK+ application, and the program you 
-are spawning is a graphical application, too, then you may
-want to use <code class="function">gdk_spawn_on_screen_with_pipes()</code> instead to ensure that
-the spawned program opens its windows on the right screen.</p>
+<p>If you are writing a GTK+ application, and the program you are spawning is a
+graphical application too, then to ensure that the spawned program opens its
+windows on the right screen, you may want to use <a href="../gdk4/gdk4-Application-launching.html#GdkAppLaunchContext-struct"><span class="type">GdkAppLaunchContext</span></a>,
+<span class="type">GAppLaunchcontext</span>, or set the <code class="literal">DISPLAY</code> environment variable.</p>
 <div class="refsect3">
 <a name="g-spawn-async-with-pipes.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -473,10 +563,10 @@ g_spawn_async (<em class="parameter"><code>const <a class="link" href="glib-Basi
 simply calls the <a class="link" href="glib-Spawning-Processes.html#g-spawn-async-with-pipes" title="g_spawn_async_with_pipes ()"><code class="function">g_spawn_async_with_pipes()</code></a> without any pipes.</p>
 <p>You should call <a class="link" href="glib-Spawning-Processes.html#g-spawn-close-pid" title="g_spawn_close_pid ()"><code class="function">g_spawn_close_pid()</code></a> on the returned child process
 reference when you don't need it any more.</p>
-<p>If you are writing a GTK+ application, and the program you are
-spawning is a graphical application, too, then you may want to
-use <code class="function">gdk_spawn_on_screen()</code> instead to ensure that the spawned program
-opens its windows on the right screen.</p>
+<p>If you are writing a GTK+ application, and the program you are spawning is a
+graphical application too, then to ensure that the spawned program opens its
+windows on the right screen, you may want to use <a href="../gdk4/gdk4-Application-launching.html#GdkAppLaunchContext-struct"><span class="type">GdkAppLaunchContext</span></a>,
+<span class="type">GAppLaunchcontext</span>, or set the <code class="literal">DISPLAY</code> environment variable.</p>
 <p>Note that the returned <em class="parameter"><code>child_pid</code></em>
  on Windows is a handle to the child
 process and not its identifier. Process handles and process identifiers

data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html

@@ -529,6 +529,22 @@
 </tr>
 <tr>
 <td class="function_type">
+<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="glib-String-Utility-Functions.html#g-ascii-string-to-signed" title="g_ascii_string_to_signed ()">g_ascii_string_to_signed</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="glib-String-Utility-Functions.html#g-ascii-string-to-unsigned" title="g_ascii_string_to_unsigned ()">g_ascii_string_to_unsigned</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *
 </td>
 <td class="function_name">
@@ -675,6 +691,14 @@
 <td class="function_name"><a class="link" href="glib-String-Utility-Functions.html#G-ASCII-DTOSTR-BUF-SIZE:CAPS" title="G_ASCII_DTOSTR_BUF_SIZE">G_ASCII_DTOSTR_BUF_SIZE</a></td>
 </tr>
 <tr>
+<td class="datatype_keyword">enum</td>
+<td class="function_name"><a class="link" href="glib-String-Utility-Functions.html#GNumberParserError" title="enum GNumberParserError">GNumberParserError</a></td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name"><a class="link" href="glib-String-Utility-Functions.html#G-NUMBER-PARSER-ERROR:CAPS" title="G_NUMBER_PARSER_ERROR">G_NUMBER_PARSER_ERROR</a></td>
+</tr>
+<tr>
 <td class="define_keyword">#define</td>
 <td class="function_name"><a class="link" href="glib-String-Utility-Functions.html#G-STR-DELIMITERS:CAPS" title="G_STR_DELIMITERS">G_STR_DELIMITERS</a></td>
 </tr>
@@ -3304,6 +3328,170 @@ character after the last character used in the conversion. </p></td>
 </div>
 <hr>
 <div class="refsect2">
+<a name="g-ascii-string-to-signed"></a><h3>g_ascii_string_to_signed ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
+g_ascii_string_to_signed (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
+                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> base</code></em>,
+                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> min</code></em>,
+                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> max</code></em>,
+                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> *out_num</code></em>,
+                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+<p>A convenience function for converting a string to a signed number.</p>
+<p>This function assumes that <em class="parameter"><code>str</code></em>
+ contains only a number of the given
+<em class="parameter"><code>base</code></em>
+ that is within inclusive bounds limited by <em class="parameter"><code>min</code></em>
+ and <em class="parameter"><code>max</code></em>
+. If
+this is true, then the converted number is stored in <em class="parameter"><code>out_num</code></em>
+. An
+empty string is not a valid input. A string with leading or
+trailing whitespace is also an invalid input.</p>
+<p><em class="parameter"><code>base</code></em>
+ can be between 2 and 36 inclusive. Hexadecimal numbers must
+not be prefixed with "0x" or "0X". Such a problem does not exist
+for octal numbers, since they were usually prefixed with a zero
+which does not change the value of the parsed number.</p>
+<p>Parsing failures result in an error with the <a class="link" href="glib-String-Utility-Functions.html#G-NUMBER-PARSER-ERROR:CAPS" title="G_NUMBER_PARSER_ERROR"><code class="literal">G_NUMBER_PARSER_ERROR</code></a>
+domain. If the input is invalid, the error code will be
+<a class="link" href="glib-String-Utility-Functions.html#G-NUMBER-PARSER-ERROR-INVALID:CAPS"><code class="literal">G_NUMBER_PARSER_ERROR_INVALID</code></a>. If the parsed number is out of
+bounds - <a class="link" href="glib-String-Utility-Functions.html#G-NUMBER-PARSER-ERROR-OUT-OF-BOUNDS:CAPS"><code class="literal">G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS</code></a>.</p>
+<p>See <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtoll" title="g_ascii_strtoll ()"><code class="function">g_ascii_strtoll()</code></a> if you have more complex needs such as
+parsing a string which starts with a number, but then has other
+characters.</p>
+<div class="refsect3">
+<a name="g-ascii-string-to-signed.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>str</p></td>
+<td class="parameter_description"><p>a string</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>base</p></td>
+<td class="parameter_description"><p>base of a parsed number</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>min</p></td>
+<td class="parameter_description"><p>a lower bound (inclusive)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>max</p></td>
+<td class="parameter_description"><p>an upper bound (inclusive)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>out_num</p></td>
+<td class="parameter_description"><p> a return location for a number. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>a return location for <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="g-ascii-string-to-signed.returns"></a><h4>Returns</h4>
+<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em>
+was a number, otherwise <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>.</p>
+</div>
+<p class="since">Since: <a class="link" href="api-index-2-54.html#api-index-2.54">2.54</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-ascii-string-to-unsigned"></a><h3>g_ascii_string_to_unsigned ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
+g_ascii_string_to_unsigned (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
+                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> base</code></em>,
+                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> min</code></em>,
+                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> max</code></em>,
+                            <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> *out_num</code></em>,
+                            <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+<p>A convenience function for converting a string to an unsigned number.</p>
+<p>This function assumes that <em class="parameter"><code>str</code></em>
+ contains only a number of the given
+<em class="parameter"><code>base</code></em>
+ that is within inclusive bounds limited by <em class="parameter"><code>min</code></em>
+ and <em class="parameter"><code>max</code></em>
+. If
+this is true, then the converted number is stored in <em class="parameter"><code>out_num</code></em>
+. An
+empty string is not a valid input. A string with leading or
+trailing whitespace is also an invalid input.</p>
+<p><em class="parameter"><code>base</code></em>
+ can be between 2 and 36 inclusive. Hexadecimal numbers must
+not be prefixed with "0x" or "0X". Such a problem does not exist
+for octal numbers, since they were usually prefixed with a zero
+which does not change the value of the parsed number.</p>
+<p>Parsing failures result in an error with the <a class="link" href="glib-String-Utility-Functions.html#G-NUMBER-PARSER-ERROR:CAPS" title="G_NUMBER_PARSER_ERROR"><code class="literal">G_NUMBER_PARSER_ERROR</code></a>
+domain. If the input is invalid, the error code will be
+<a class="link" href="glib-String-Utility-Functions.html#G-NUMBER-PARSER-ERROR-INVALID:CAPS"><code class="literal">G_NUMBER_PARSER_ERROR_INVALID</code></a>. If the parsed number is out of
+bounds - <a class="link" href="glib-String-Utility-Functions.html#G-NUMBER-PARSER-ERROR-OUT-OF-BOUNDS:CAPS"><code class="literal">G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS</code></a>.</p>
+<p>See <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtoull" title="g_ascii_strtoull ()"><code class="function">g_ascii_strtoull()</code></a> if you have more complex needs such as
+parsing a string which starts with a number, but then has other
+characters.</p>
+<div class="refsect3">
+<a name="g-ascii-string-to-unsigned.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>str</p></td>
+<td class="parameter_description"><p>a string</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>base</p></td>
+<td class="parameter_description"><p>base of a parsed number</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>min</p></td>
+<td class="parameter_description"><p>a lower bound (inclusive)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>max</p></td>
+<td class="parameter_description"><p>an upper bound (inclusive)</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>out_num</p></td>
+<td class="parameter_description"><p> a return location for a number. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>a return location for <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="g-ascii-string-to-unsigned.returns"></a><h4>Returns</h4>
+<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em>
+was a number, otherwise <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>.</p>
+</div>
+<p class="since">Since: <a class="link" href="api-index-2-54.html#api-index-2.54">2.54</a></p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="g-strchug"></a><h3>g_strchug ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *
 g_strchug (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
@@ -3956,7 +4144,31 @@ such process". Unlike <code class="function">strerror()</code>, this always retu
 UTF-8 encoding, and the pointer is guaranteed to remain valid for
 the lifetime of the process.</p>
 <p>Note that the string may be translated according to the current locale.</p>
-<p>The value of <code class="literal">errno</code> will not be changed by this function.</p>
+<p>The value of <code class="literal">errno</code> will not be changed by this function. However, it may
+be changed by intermediate function calls, so you should save its value
+as soon as the call returns:</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">int</span> saved_errno<span class="gtkdoc opt">;</span>
+
+ret <span class="gtkdoc opt">=</span> <span class="function">read</span> <span class="gtkdoc opt">(</span>blah<span class="gtkdoc opt">);</span>
+saved_errno <span class="gtkdoc opt">=</span> errno<span class="gtkdoc opt">;</span>
+
+<span class="function"><a href="glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span> <span class="gtkdoc opt">(</span>saved_errno<span class="gtkdoc opt">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+
+<p></p>
 <div class="refsect3">
 <a name="g-strerror.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -4039,6 +4251,47 @@ on systems with 64bit IEEE-compatible doubles.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="GNumberParserError"></a><h3>enum GNumberParserError</h3>
+<p>Error codes returned by functions converting a string to a number.</p>
+<div class="refsect3">
+<a name="GNumberParserError.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="G-NUMBER-PARSER-ERROR-INVALID:CAPS"></a>G_NUMBER_PARSER_ERROR_INVALID</p></td>
+<td class="enum_member_description">
+<p>String was not a valid number.</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+<tr>
+<td class="enum_member_name"><p><a name="G-NUMBER-PARSER-ERROR-OUT-OF-BOUNDS:CAPS"></a>G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS</p></td>
+<td class="enum_member_description">
+<p>String was a number, but out of bounds.</p>
+</td>
+<td class="enum_member_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="api-index-2-54.html#api-index-2.54">2.54</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-NUMBER-PARSER-ERROR:CAPS"></a><h3>G_NUMBER_PARSER_ERROR</h3>
+<pre class="programlisting">#define G_NUMBER_PARSER_ERROR (g_number_parser_error_quark ())
+</pre>
+<p>Domain for errors returned by functions converting a string to a
+number.</p>
+<p class="since">Since: <a class="link" href="api-index-2-54.html#api-index-2.54">2.54</a></p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="G-STR-DELIMITERS:CAPS"></a><h3>G_STR_DELIMITERS</h3>
 <pre class="programlisting">#define	 G_STR_DELIMITERS "_-|&gt; &lt;."
 </pre>

data/vendor/local/share/gtk-doc/html/glib/glib-UNIX-specific-utilities-and-integration.html

@@ -345,7 +345,7 @@ g_unix_signal_source_new (<em class="parameter"><code><a class="link" href="glib
 signal <em class="parameter"><code>signum</code></em>
 .  In GLib versions before 2.36, only <code class="literal">SIGHUP</code>, <code class="literal">SIGINT</code>,
 <code class="literal">SIGTERM</code> can be monitored.  In GLib 2.36, <code class="literal">SIGUSR1</code> and <code class="literal">SIGUSR2</code>
-were added.</p>
+were added. In GLib 2.54, <code class="literal">SIGWINCH</code> was added.</p>
 <p>Note that unlike the UNIX default, all sources which have created a
 watch will be dispatched, regardless of which underlying thread
 invoked <a class="link" href="glib-UNIX-specific-utilities-and-integration.html#g-unix-signal-source-new" title="g_unix_signal_source_new ()"><code class="function">g_unix_signal_source_new()</code></a>.</p>