← Back to branch summary

~ubuntu-branches/ubuntu/saucy/glib2.0/saucy-proposed

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-Deprecated-Thread-APIs.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2013-08-21 10:08:49 UTC
  • mfrom: (1.63.24)
  • Revision ID: package-import@ubuntu.com-20130821100849-enhti9o2tk0iug5r
Tags: 2.37.6-1ubuntu1
* Resynchronise with Debian, remaining change:
  - Build-Depend on python:any for cross-building.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-Deprecated-Thread-APIs.html
2
2
<html>
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>Deprecated thread API</title>
 
5
<title>GLib Reference Manual: Deprecated thread API</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="GLib Reference Manual">
8
8
<link rel="up" href="deprecated.html" title="Deprecated APIs">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
 
<tr valign="middle">
17
 
<td><a accesskey="p" href="deprecated.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
 
<td><a accesskey="u" href="deprecated.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
 
<th width="100%" align="center">GLib Reference Manual</th>
21
 
<td><a accesskey="n" href="glib-Caches.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
 
</tr>
23
 
<tr><td colspan="5" class="shortcuts">
24
 
<a href="#glib-Deprecated-Thread-APIs.synopsis" class="shortcut">Top</a>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
 
16
<td width="100%" align="left">
 
17
<a href="#" class="shortcut">Top</a>
25
18
                   | 
26
19
                  <a href="#glib-Deprecated-Thread-APIs.description" class="shortcut">Description</a>
27
 
</td></tr>
28
 
</table>
 
20
</td>
 
21
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
 
22
<td><a accesskey="u" href="deprecated.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
 
23
<td><a accesskey="p" href="deprecated.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
 
24
<td><a accesskey="n" href="glib-Caches.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
 
25
</tr></table>
29
26
<div class="refentry">
30
27
<a name="glib-Deprecated-Thread-APIs"></a><div class="titlepage"></div>
31
28
<div class="refnamediv"><table width="100%"><tr>
125
122
<a name="G-THREADS-IMPL-POSIX:CAPS"></a><h3>G_THREADS_IMPL_POSIX</h3>
126
123
<pre class="programlisting">#define G_THREADS_IMPL_POSIX
127
124
</pre>
128
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
125
<div class="warning">
129
126
<h3 class="title">Warning</h3>
130
127
<p><code class="literal">G_THREADS_IMPL_POSIX</code> has been deprecated since version 2.32 and should not be used in newly-written code. POSIX threads are in use on all non-Windows systems.
131
128
                Use G_OS_WIN32 to detect Windows.</p>
139
136
<a name="G-THREADS-IMPL-WIN32:CAPS"></a><h3>G_THREADS_IMPL_WIN32</h3>
140
137
<pre class="programlisting">#define G_THREADS_IMPL_NONE
141
138
</pre>
142
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
139
<div class="warning">
143
140
<h3 class="title">Warning</h3>
144
141
<p><code class="literal">G_THREADS_IMPL_WIN32</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use G_OS_WIN32 to detect Windows.</p>
145
142
</div>
151
148
<div class="refsect2">
152
149
<a name="g-thread-init"></a><h3>g_thread_init ()</h3>
153
150
<pre class="programlisting"><span class="returnvalue">void</span>                g_thread_init                       (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> vtable</code></em>);</pre>
154
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
151
<div class="warning">
155
152
<h3 class="title">Warning</h3>
156
153
<p><code class="literal">g_thread_init</code> has been deprecated since version 2.32 and should not be used in newly-written code. This function is no longer necessary. The GLib
157
154
    threading system is automatically initialized at the start
171
168
</p>
172
169
<p>
173
170
</p>
174
 
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 
171
<div class="note">
175
172
<h3 class="title">Note</h3>
176
173
<p><a class="link" href="glib-Deprecated-Thread-APIs.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> must not be called directly or indirectly
177
174
in a callback from GLib. Also no mutexes may be currently locked while
181
178
</p>
182
179
<p>
183
180
</p>
184
 
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 
181
<div class="note">
185
182
<h3 class="title">Note</h3>
186
183
<p>To use <a class="link" href="glib-Deprecated-Thread-APIs.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> in your program, you have to link
187
184
with the libraries that the command <span class="command"><strong>pkg-config --libs
256
253
                                                         <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
257
254
                                                         <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> joinable</code></em>,
258
255
                                                         <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>
259
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
256
<div class="warning">
260
257
<h3 class="title">Warning</h3>
261
258
<p><code class="literal">g_thread_create</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-thread-new" title="g_thread_new ()"><code class="function">g_thread_new()</code></a> instead</p>
262
259
</div>
317
314
                                                         <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> bound</code></em>,
318
315
                                                         <em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GThreadPriority" title="enum GThreadPriority"><span class="type">GThreadPriority</span></a> priority</code></em>,
319
316
                                                         <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>
320
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
317
<div class="warning">
321
318
<h3 class="title">Warning</h3>
322
319
<p><code class="literal">g_thread_create_full</code> has been deprecated since version 2.32 and should not be used in newly-written code. The <em class="parameter"><code>bound</code></em> and <em class="parameter"><code>priority</code></em> arguments are now ignored.
323
320
Use <a class="link" href="glib-Threads.html#g-thread-new" title="g_thread_new ()"><code class="function">g_thread_new()</code></a>.</p>
376
373
  G_THREAD_PRIORITY_URGENT
377
374
} GThreadPriority;
378
375
</pre>
379
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
376
<div class="warning">
380
377
<h3 class="title">Warning</h3>
381
378
<p><code class="literal">GThreadPriority</code> has been deprecated since version 2.32 and should not be used in newly-written code. Thread priorities no longer have any effect.</p>
382
379
</div>
414
411
<a name="g-thread-set-priority"></a><h3>g_thread_set_priority ()</h3>
415
412
<pre class="programlisting"><span class="returnvalue">void</span>                g_thread_set_priority               (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> *thread</code></em>,
416
413
                                                         <em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GThreadPriority" title="enum GThreadPriority"><span class="type">GThreadPriority</span></a> priority</code></em>);</pre>
417
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
414
<div class="warning">
418
415
<h3 class="title">Warning</h3>
419
416
<p><code class="literal">g_thread_set_priority</code> has been deprecated since version 2.32 and should not be used in newly-written code. Thread priorities no longer have any effect.</p>
420
417
</div>
443
440
<a name="g-thread-foreach"></a><h3>g_thread_foreach ()</h3>
444
441
<pre class="programlisting"><span class="returnvalue">void</span>                g_thread_foreach                    (<em class="parameter"><code><a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()"><span class="type">GFunc</span></a> thread_func</code></em>,
445
442
                                                         <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
446
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
443
<div class="warning">
447
444
<h3 class="title">Warning</h3>
448
445
<p><code class="literal">g_thread_foreach</code> has been deprecated since version 2.32 and should not be used in newly-written code. There aren't many things you can do with a <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a>,
449
446
    except comparing it with one that was returned from <a class="link" href="glib-Deprecated-Thread-APIs.html#g-thread-create" title="g_thread_create ()"><code class="function">g_thread_create()</code></a>.
487
484
<div class="refsect2">
488
485
<a name="g-mutex-new"></a><h3>g_mutex_new ()</h3>
489
486
<pre class="programlisting"><a class="link" href="glib-Threads.html#GMutex" title="union GMutex"><span class="returnvalue">GMutex</span></a> *            g_mutex_new                         ();</pre>
490
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
487
<div class="warning">
491
488
<h3 class="title">Warning</h3>
492
489
<p><code class="literal">g_mutex_new</code> has been deprecated since version 2.32 and should not be used in newly-written code. GMutex can now be statically allocated, or embedded
493
490
in structures and initialised with <a class="link" href="glib-Threads.html#g-mutex-init" title="g_mutex_init ()"><code class="function">g_mutex_init()</code></a>.</p>
510
507
<div class="refsect2">
511
508
<a name="g-mutex-free"></a><h3>g_mutex_free ()</h3>
512
509
<pre class="programlisting"><span class="returnvalue">void</span>                g_mutex_free                        (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="union GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);</pre>
513
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
510
<div class="warning">
514
511
<h3 class="title">Warning</h3>
515
512
<p><code class="literal">g_mutex_free</code> has been deprecated since version 2.32 and should not be used in newly-written code. GMutex can now be statically allocated, or embedded
516
513
in structures and initialised with <a class="link" href="glib-Threads.html#g-mutex-init" title="g_mutex_init ()"><code class="function">g_mutex_init()</code></a>.</p>
538
535
<div class="refsect2">
539
536
<a name="g-cond-new"></a><h3>g_cond_new ()</h3>
540
537
<pre class="programlisting"><a class="link" href="glib-Threads.html#GCond" title="struct GCond"><span class="returnvalue">GCond</span></a>*              g_cond_new                          ();</pre>
541
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
538
<div class="warning">
542
539
<h3 class="title">Warning</h3>
543
540
<p><code class="literal">g_cond_new</code> has been deprecated since version 2.32 and should not be used in newly-written code. GCond can now be statically allocated, or embedded
544
541
in structures and initialised with <a class="link" href="glib-Threads.html#g-cond-init" title="g_cond_init ()"><code class="function">g_cond_init()</code></a>.</p>
562
559
<div class="refsect2">
563
560
<a name="g-cond-free"></a><h3>g_cond_free ()</h3>
564
561
<pre class="programlisting"><span class="returnvalue">void</span>                g_cond_free                         (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="struct GCond"><span class="type">GCond</span></a> *cond</code></em>);</pre>
565
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
562
<div class="warning">
566
563
<h3 class="title">Warning</h3>
567
564
<p><code class="literal">g_cond_free</code> has been deprecated since version 2.32 and should not be used in newly-written code. GCond can now be statically allocated, or embedded
568
565
in structures and initialised with <a class="link" href="glib-Threads.html#g-cond-init" title="g_cond_init ()"><code class="function">g_cond_init()</code></a>.</p>
590
587
<div class="refsect2">
591
588
<a name="g-private-new"></a><h3>g_private_new ()</h3>
592
589
<pre class="programlisting"><a class="link" href="glib-Threads.html#GPrivate" title="struct GPrivate"><span class="returnvalue">GPrivate</span></a> *          g_private_new                       (<em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre>
593
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
590
<div class="warning">
594
591
<h3 class="title">Warning</h3>
595
592
<p><code class="literal">g_private_new</code> has been deprecated since version 2.32 and should not be used in newly-written code. dynamic allocation of <a class="link" href="glib-Threads.html#GPrivate" title="struct GPrivate"><span class="type">GPrivate</span></a> is a bad idea.  Use
596
593
                 static storage and <a class="link" href="glib-Threads.html#G-PRIVATE-INIT:CAPS" title="G_PRIVATE_INIT()"><code class="function">G_PRIVATE_INIT()</code></a> instead.</p>
702
699
</p>
703
700
<p>
704
701
</p>
705
 
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 
702
<div class="note">
706
703
<h3 class="title">Note</h3>
707
704
<p>All of the <code class="function">g_static_mutex_*</code>
708
705
functions are actually macros. Apart from taking their addresses, you
742
739
<div class="refsect2">
743
740
<a name="g-static-mutex-init"></a><h3>g_static_mutex_init ()</h3>
744
741
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_mutex_init                 (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
745
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
742
<div class="warning">
746
743
<h3 class="title">Warning</h3>
747
744
<p><code class="literal">g_static_mutex_init</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-mutex-init" title="g_mutex_init ()"><code class="function">g_mutex_init()</code></a></p>
748
745
</div>
765
762
<div class="refsect2">
766
763
<a name="g-static-mutex-lock"></a><h3>g_static_mutex_lock ()</h3>
767
764
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_mutex_lock                 (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
768
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
765
<div class="warning">
769
766
<h3 class="title">Warning</h3>
770
767
<p><code class="literal">g_static_mutex_lock</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-mutex-lock" title="g_mutex_lock ()"><code class="function">g_mutex_lock()</code></a></p>
771
768
</div>
787
784
<div class="refsect2">
788
785
<a name="g-static-mutex-trylock"></a><h3>g_static_mutex_trylock ()</h3>
789
786
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_static_mutex_trylock              (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
790
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
787
<div class="warning">
791
788
<h3 class="title">Warning</h3>
792
789
<p><code class="literal">g_static_mutex_trylock</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-mutex-trylock" title="g_mutex_trylock ()"><code class="function">g_mutex_trylock()</code></a></p>
793
790
</div>
816
813
<div class="refsect2">
817
814
<a name="g-static-mutex-unlock"></a><h3>g_static_mutex_unlock ()</h3>
818
815
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_mutex_unlock               (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
819
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
816
<div class="warning">
820
817
<h3 class="title">Warning</h3>
821
818
<p><code class="literal">g_static_mutex_unlock</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-mutex-unlock" title="g_mutex_unlock ()"><code class="function">g_mutex_unlock()</code></a></p>
822
819
</div>
838
835
<div class="refsect2">
839
836
<a name="g-static-mutex-get-mutex"></a><h3>g_static_mutex_get_mutex ()</h3>
840
837
<pre class="programlisting"><a class="link" href="glib-Threads.html#GMutex" title="union GMutex"><span class="returnvalue">GMutex</span></a> *            g_static_mutex_get_mutex            (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
841
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
838
<div class="warning">
842
839
<h3 class="title">Warning</h3>
843
840
<p><code class="literal">g_static_mutex_get_mutex</code> has been deprecated since version 2.32 and should not be used in newly-written code. Just use a <a class="link" href="glib-Threads.html#GMutex" title="union GMutex"><span class="type">GMutex</span></a></p>
844
841
</div>
868
865
<div class="refsect2">
869
866
<a name="g-static-mutex-free"></a><h3>g_static_mutex_free ()</h3>
870
867
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_mutex_free                 (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
871
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
868
<div class="warning">
872
869
<h3 class="title">Warning</h3>
873
870
<p><code class="literal">g_static_mutex_free</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-mutex-clear" title="g_mutex_clear ()"><code class="function">g_mutex_clear()</code></a></p>
874
871
</div>
883
880
</p>
884
881
<p>
885
882
</p>
886
 
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 
883
<div class="note">
887
884
<h3 class="title">Note</h3>
888
885
<p>Calling <a class="link" href="glib-Deprecated-Thread-APIs.html#g-static-mutex-free" title="g_static_mutex_free ()"><code class="function">g_static_mutex_free()</code></a> on a locked mutex may
889
886
result in undefined behaviour.</p>
960
957
<div class="refsect2">
961
958
<a name="g-static-rec-mutex-init"></a><h3>g_static_rec_mutex_init ()</h3>
962
959
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_rec_mutex_init             (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRecMutex" title="struct GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
963
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
960
<div class="warning">
964
961
<h3 class="title">Warning</h3>
965
962
<p><code class="literal">g_static_rec_mutex_init</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rec-mutex-init" title="g_rec_mutex_init ()"><code class="function">g_rec_mutex_init()</code></a></p>
966
963
</div>
984
981
<div class="refsect2">
985
982
<a name="g-static-rec-mutex-lock"></a><h3>g_static_rec_mutex_lock ()</h3>
986
983
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_rec_mutex_lock             (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRecMutex" title="struct GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
987
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
984
<div class="warning">
988
985
<h3 class="title">Warning</h3>
989
986
<p><code class="literal">g_static_rec_mutex_lock</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rec-mutex-lock" title="g_rec_mutex_lock ()"><code class="function">g_rec_mutex_lock()</code></a></p>
990
987
</div>
1009
1006
<div class="refsect2">
1010
1007
<a name="g-static-rec-mutex-trylock"></a><h3>g_static_rec_mutex_trylock ()</h3>
1011
1008
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_static_rec_mutex_trylock          (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRecMutex" title="struct GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1012
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1009
<div class="warning">
1013
1010
<h3 class="title">Warning</h3>
1014
1011
<p><code class="literal">g_static_rec_mutex_trylock</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rec-mutex-trylock" title="g_rec_mutex_trylock ()"><code class="function">g_rec_mutex_trylock()</code></a></p>
1015
1012
</div>
1042
1039
<div class="refsect2">
1043
1040
<a name="g-static-rec-mutex-unlock"></a><h3>g_static_rec_mutex_unlock ()</h3>
1044
1041
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_rec_mutex_unlock           (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRecMutex" title="struct GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1045
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1042
<div class="warning">
1046
1043
<h3 class="title">Warning</h3>
1047
1044
<p><code class="literal">g_static_rec_mutex_unlock</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rec-mutex-unlock" title="g_rec_mutex_unlock ()"><code class="function">g_rec_mutex_unlock()</code></a></p>
1048
1045
</div>
1069
1066
<a name="g-static-rec-mutex-lock-full"></a><h3>g_static_rec_mutex_lock_full ()</h3>
1070
1067
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_rec_mutex_lock_full        (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRecMutex" title="struct GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>,
1071
1068
                                                         <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> depth</code></em>);</pre>
1072
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1069
<div class="warning">
1073
1070
<h3 class="title">Warning</h3>
1074
1071
<p><code class="literal">g_static_rec_mutex_lock_full</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rec-mutex-lock" title="g_rec_mutex_lock ()"><code class="function">g_rec_mutex_lock()</code></a></p>
1075
1072
</div>
1098
1095
<div class="refsect2">
1099
1096
<a name="g-static-rec-mutex-unlock-full"></a><h3>g_static_rec_mutex_unlock_full ()</h3>
1100
1097
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>               g_static_rec_mutex_unlock_full      (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRecMutex" title="struct GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1101
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1098
<div class="warning">
1102
1099
<h3 class="title">Warning</h3>
1103
1100
<p><code class="literal">g_static_rec_mutex_unlock_full</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rec-mutex-unlock" title="g_rec_mutex_unlock ()"><code class="function">g_rec_mutex_unlock()</code></a></p>
1104
1101
</div>
1133
1130
<div class="refsect2">
1134
1131
<a name="g-static-rec-mutex-free"></a><h3>g_static_rec_mutex_free ()</h3>
1135
1132
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_rec_mutex_free             (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRecMutex" title="struct GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1136
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1133
<div class="warning">
1137
1134
<h3 class="title">Warning</h3>
1138
1135
<p><code class="literal">g_static_rec_mutex_free</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rec-mutex-clear" title="g_rec_mutex_clear ()"><code class="function">g_rec_mutex_clear()</code></a></p>
1139
1136
</div>
1163
1160
<pre class="programlisting">struct GStaticRWLock {
1164
1161
};
1165
1162
</pre>
1166
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1163
<div class="warning">
1167
1164
<h3 class="title">Warning</h3>
1168
1165
<p><code class="literal">GStaticRWLock</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use a <a class="link" href="glib-Threads.html#GRWLock" title="struct GRWLock"><span class="type">GRWLock</span></a> instead</p>
1169
1166
</div>
1286
1283
</p>
1287
1284
<p>
1288
1285
</p>
1289
 
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1286
<div class="note">
1290
1287
<h3 class="title">Note</h3>
1291
1288
<p>A read-write lock has a higher overhead than a mutex. For
1292
1289
example, both <a class="link" href="glib-Deprecated-Thread-APIs.html#g-static-rw-lock-reader-lock" title="g_static_rw_lock_reader_lock ()"><code class="function">g_static_rw_lock_reader_lock()</code></a> and
1332
1329
<div class="refsect2">
1333
1330
<a name="g-static-rw-lock-init"></a><h3>g_static_rw_lock_init ()</h3>
1334
1331
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_rw_lock_init               (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRWLock" title="struct GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
1335
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1332
<div class="warning">
1336
1333
<h3 class="title">Warning</h3>
1337
1334
<p><code class="literal">g_static_rw_lock_init</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rw-lock-init" title="g_rw_lock_init ()"><code class="function">g_rw_lock_init()</code></a> instead</p>
1338
1335
</div>
1356
1353
<div class="refsect2">
1357
1354
<a name="g-static-rw-lock-reader-lock"></a><h3>g_static_rw_lock_reader_lock ()</h3>
1358
1355
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_rw_lock_reader_lock        (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRWLock" title="struct GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
1359
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1356
<div class="warning">
1360
1357
<h3 class="title">Warning</h3>
1361
1358
<p><code class="literal">g_static_rw_lock_reader_lock</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use <a class="link" href="glib-Threads.html#g-rw-lock-reader-lock" title="g_rw_lock_reader_lock ()"><code class="function">g_rw_lock_reader_lock()</code></a> instead</p>
1362
1359
</div>
1524
1521
<div class="refsect2">
1525
1522
<a name="g-static-rw-lock-free"></a><h3>g_static_rw_lock_free ()</h3>
1526
1523
<pre class="programlisting"><span class="returnvalue">void</span>                g_static_rw_lock_free               (<em class="parameter"><code><a class="link" href="glib-Deprecated-Thread-APIs.html#GStaticRWLock" title="struct GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
1527
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1524
<div class="warning">
1528
1525
<h3 class="title">Warning</h3>
1529
1526
<p><code class="literal">g_static_rw_lock_free</code> has been deprecated since version 2.32 and should not be used in newly-written code. Use a <a class="link" href="glib-Threads.html#GRWLock" title="struct GRWLock"><span class="type">GRWLock</span></a> instead</p>
1530
1527
</div>
1705
1702
</p>
1706
1703
<p>
1707
1704
</p>
1708
 
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1705
<div class="note">
1709
1706
<h3 class="title">Note</h3>
1710
1707
<p><em class="parameter"><code>notify</code></em> is used quite differently from <em class="parameter"><code>destructor</code></em> in
1711
1708
<a class="link" href="glib-Deprecated-Thread-APIs.html#g-private-new" title="g_private_new ()"><code class="function">g_private_new()</code></a>.</p>