4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GConf Core Interfaces</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
7
<link rel="home" href="index.html" title="GConf Reference Manual">
8
8
<link rel="up" href="ch01.html" title="Using the GConf library">
9
9
<link rel="prev" href="gconf-gconf-value.html" title="GConfValue, GConfEntry, GConfMetaInfo">
10
10
<link rel="next" href="gconf-gconf-locale.html" title="gconf-locale">
11
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
226
226
<col align="left" valign="top">
229
<td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
234
<td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
239
229
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
240
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
230
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
244
233
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
246
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> otherwise.
235
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> otherwise.</td>
263
<div class="variablelist"><table border="0">
264
<col align="left" valign="top">
267
<td><p><span class="term"><em class="parameter"><code>app</code></em> :</span></p></td>
272
<td><p><span class="term"><em class="parameter"><code>mod_info</code></em> :</span></p></td>
280
253
<div class="refsect2">
290
<div class="variablelist"><table border="0">
291
<col align="left" valign="top">
294
<td><p><span class="term"><em class="parameter"><code>app</code></em> :</span></p></td>
299
<td><p><span class="term"><em class="parameter"><code>mod_info</code></em> :</span></p></td>
307
265
<div class="refsect2">
348
305
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
349
<td>the <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> passed to <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>.
306
<td>the <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> passed to <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>.</td>
353
309
<td><p><span class="term"><em class="parameter"><code>cnxn_id</code></em> :</span></p></td>
354
<td>the ID returned from <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>.
358
<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td>
310
<td>the ID returned from <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>.</td>
363
313
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
364
<td>the user data passed to <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>.
314
<td>the user data passed to <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>.</td>
394
343
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
395
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to monitor for changes.
344
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to monitor for changes.</td>
399
347
<td><p><span class="term"><em class="parameter"><code>namespace_section</code></em> :</span></p></td>
400
<td>the directory or key to watch; you will be notified of changes at or below this point.
348
<td>the directory or key to watch; you will be notified of changes at or below this point.</td>
404
351
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
405
<td>the callback to invoke when a notification is received from the server.
352
<td>the callback to invoke when a notification is received from the server.</td>
409
355
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
410
<td>the data to pass to the callback.
356
<td>the data to pass to the callback.</td>
414
359
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
415
360
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
416
Return value: an ID for the notification request, or 0 on error.
361
Return value: an ID for the notification request, or 0 on error.</td>
420
364
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
421
<td>value: an ID for the notification request, or 0 on error.
365
<td>value: an ID for the notification request, or 0 on error.</td>
439
382
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
440
<td>the <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> you were monitoring for changes.
383
<td>the <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> you were monitoring for changes.</td>
444
386
<td><p><span class="term"><em class="parameter"><code>cnxn</code></em> :</span></p></td>
445
<td>The ID returned by <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>.
387
<td>The ID returned by <a class="link" href="gconf-gconf.html#gconf-engine-notify-add" title="gconf_engine_notify_add ()"><code class="function">gconf_engine_notify_add()</code></a>.</td>
469
410
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
470
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to get the value from.
411
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to get the value from.</td>
474
414
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
415
<td>the key to get.</td>
479
418
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
480
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
419
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
484
422
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
485
<td>newly-allocated <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>, or <span class="symbol">NULL</span> if unset and no default exists.
423
<td>newly-allocated <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>, or <span class="symbol">NULL</span> if unset and no default exists.</td>
506
443
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
507
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to get the value from.
444
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to get the value from.</td>
511
447
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
448
<td>the key to get.</td>
516
451
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
517
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
452
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
521
455
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
522
<td>newly-allocated <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>, or <span class="symbol">NULL</span> if unset.
456
<td>newly-allocated <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>, or <span class="symbol">NULL</span> if unset.</td>
543
476
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
544
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
477
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
548
480
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
481
<td>the key to get.</td>
553
484
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
554
<td>preferred locale (as in the locale-related environment variables).
485
<td>preferred locale (as in the locale-related environment variables).</td>
558
488
<td><p><span class="term"><em class="parameter"><code>use_schema_default</code></em> :</span></p></td>
559
489
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value indicating whether the default value associated with schema
564
493
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
565
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
494
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
569
497
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
570
<td>a <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>.
498
<td>a <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>.</td>
596
523
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
597
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to get the value from.
524
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to get the value from.</td>
601
527
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
528
<td>the key to get.</td>
606
531
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
607
<td>preferred locale (as in the locale-related environment variables).
532
<td>preferred locale (as in the locale-related environment variables).</td>
611
535
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
612
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
536
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
616
539
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
617
<td>newly-allocated <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>, or <span class="symbol">NULL</span> if unset.
540
<td>newly-allocated <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>, or <span class="symbol">NULL</span> if unset.</td>
643
565
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
644
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to get the value from.
566
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to get the value from.</td>
648
569
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
649
<td>the key to get the default value for.
570
<td>the key to get the default value for.</td>
653
573
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
654
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
574
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
658
577
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
659
<td>newly-allocated <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>, or <span class="symbol">NULL</span> if unset.
578
<td>newly-allocated <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>, or <span class="symbol">NULL</span> if unset.</td>
688
606
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
689
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to set the value in.
607
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to set the value in.</td>
693
610
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
611
<td>the key to set.</td>
698
614
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
699
<td>the new value of <em class="parameter"><code>key</code></em>.
615
<td>the new value of <em class="parameter"><code>key</code></em>.</td>
703
618
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
704
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
619
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
708
622
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
710
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
624
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
731
644
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
732
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to affect.
645
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to affect.</td>
736
648
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
737
<td>the key to unset.
649
<td>the key to unset.</td>
741
652
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
742
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
653
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
746
656
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
748
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
658
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
773
682
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
774
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to affect.
683
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to affect.</td>
778
686
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
779
<td>the key to associate the schema with.
687
<td>the key to associate the schema with.</td>
783
690
<td><p><span class="term"><em class="parameter"><code>schema_key</code></em> :</span></p></td>
784
<td>the key where the schema will be stored.
691
<td>the key where the schema will be stored.</td>
788
694
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
789
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
695
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
793
698
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
795
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
700
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
819
723
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
820
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
724
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
824
727
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
825
<td>Directory to list.
728
<td>Directory to list.</td>
829
731
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
830
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
732
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
834
735
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
835
<td>value: (element-type GConfEntry) (transfer full): List of <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>.
736
<td>value: (element-type GConfEntry) (transfer full): List of <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>.</td>
857
757
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
858
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
758
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
862
761
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
863
<td>Directory to get subdirectories from.
762
<td>Directory to get subdirectories from.</td>
867
765
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
868
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
766
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
872
769
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
873
<td>value: (element-type utf8) (transfer full): List of allocated subdirectory names.
770
<td>value: (element-type utf8) (transfer full): List of allocated subdirectory names.</td>
897
793
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
898
<td>the <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to suggest syncing to.
794
<td>the <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to suggest syncing to.</td>
902
797
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
903
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
798
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
923
817
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
924
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
818
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
928
821
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
929
<td>Directory to check for.
822
<td>Directory to check for.</td>
933
825
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
934
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
826
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
938
829
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
940
<span class="symbol">TRUE</span> or <span class="symbol">FALSE</span>.
831
<span class="symbol">TRUE</span> or <span class="symbol">FALSE</span>.</td>
962
852
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
963
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
853
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
967
856
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
968
<td>the name of the directory to be removed.
857
<td>the name of the directory to be removed.</td>
972
860
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
973
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
861
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
992
879
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
993
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
880
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
997
883
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
998
<td>the value to be changed.
884
<td>the value to be changed.</td>
1002
887
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1003
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
888
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1007
891
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1009
<span class="symbol">TRUE</span> if the key is writable, <span class="symbol">FALSE</span> if the key is read only.
893
<span class="symbol">TRUE</span> if the key is writable, <span class="symbol">FALSE</span> if the key is read only.</td>
1035
918
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
919
<td>key to check.</td>
1040
922
<td><p><span class="term"><em class="parameter"><code>why_invalid</code></em> :</span></p></td>
1041
<td>return location for an explanation of the problem, if any. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> the returned string.
923
<td>return location for an explanation of the problem, if any. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> the returned string.</td>
1045
926
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1047
<span class="symbol">TRUE</span> if the key is valid, or <span class="symbol">FALSE</span> if not.
928
<span class="symbol">TRUE</span> if the key is valid, or <span class="symbol">FALSE</span> if not.</td>
1069
949
<td><p><span class="term"><em class="parameter"><code>above</code></em> :</span></p></td>
1070
<td>the key on the "left hand side" of the predicate.
950
<td>the key on the "left hand side" of the predicate.</td>
1074
953
<td><p><span class="term"><em class="parameter"><code>below</code></em> :</span></p></td>
1075
<td>the key on the "right hand side."
954
<td>the key on the "right hand side."</td>
1079
957
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1081
<span class="symbol">TRUE</span> or <span class="symbol">FALSE</span>.
959
<span class="symbol">TRUE</span> or <span class="symbol">FALSE</span>.</td>
1100
977
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
978
<td>the directory.</td>
1105
981
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1110
985
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1111
<td>the newly concatenated string.
986
<td>the newly concatenated string.</td>
1126
1000
<col align="left" valign="top">
1128
1002
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1129
<td>a newly created key, a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> value.
1003
<td>a newly created key, a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> value.</td>
1150
1023
<td><p><span class="term"><em class="parameter"><code>arbitrary_text</code></em> :</span></p></td>
1151
<td>some text in any encoding or format
1024
<td>some text in any encoding or format</td>
1155
1027
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
1156
<td>length of <em class="parameter"><code>arbitrary_text</code></em> in bytes, or -1 if <em class="parameter"><code>arbitrary_text</code></em> is nul-terminated
1028
<td>length of <em class="parameter"><code>arbitrary_text</code></em> in bytes, or -1 if <em class="parameter"><code>arbitrary_text</code></em> is nul-terminated</td>
1160
1031
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1161
<td> a nul-terminated valid GConf key
1032
<td>a nul-terminated valid GConf key</td>
1185
1055
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
1186
<td>length of <em class="parameter"><code>escaped_key</code></em> in bytes, or -1 if <em class="parameter"><code>escaped_key</code></em> is nul-terminated
1056
<td>length of <em class="parameter"><code>escaped_key</code></em> in bytes, or -1 if <em class="parameter"><code>escaped_key</code></em> is nul-terminated</td>
1190
1059
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1191
<td> the original string that was escaped to create <em class="parameter"><code>escaped_key</code></em>
1060
<td>the original string that was escaped to create <em class="parameter"><code>escaped_key</code></em>
1213
1082
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1214
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1083
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1218
1086
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1219
<td>key you want the value of.
1087
<td>key you want the value of.</td>
1223
1090
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1224
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1091
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1228
1094
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1229
<td>the value of <em class="parameter"><code>key</code></em>, or 0.0 if no value is obtained.
1095
<td>the value of <em class="parameter"><code>key</code></em>, or 0.0 if no value is obtained.</td>
1251
1116
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1252
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1117
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1256
1120
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1257
<td>key you want the value of.
1121
<td>key you want the value of.</td>
1261
1124
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1262
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1125
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1266
1128
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1267
<td>the value of <em class="parameter"><code>key</code></em>, or 0 if no value is obtained.
1129
<td>the value of <em class="parameter"><code>key</code></em>, or 0 if no value is obtained.</td>
1289
1150
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1290
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1151
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1294
1154
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1295
<td>key you want the value of.
1155
<td>key you want the value of.</td>
1299
1158
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1300
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1159
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1304
1162
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1305
<td>allocated string (value of <em class="parameter"><code>key</code></em>), or <span class="symbol">NULL</span> if no value is obtained.
1163
<td>allocated string (value of <em class="parameter"><code>key</code></em>), or <span class="symbol">NULL</span> if no value is obtained.</td>
1327
1184
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1328
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1185
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1332
1188
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1333
<td>key you want the value of.
1189
<td>key you want the value of.</td>
1337
1192
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1338
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1193
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1342
1196
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1343
<td>the value of <em class="parameter"><code>key</code></em>, or <span class="symbol">FALSE</span> if no value is obtained.
1197
<td>the value of <em class="parameter"><code>key</code></em>, or <span class="symbol">FALSE</span> if no value is obtained.</td>
1365
1218
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1366
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1219
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1370
1222
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1371
<td>key you want the value of.
1223
<td>key you want the value of.</td>
1375
1226
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1376
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1227
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1380
1230
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1381
<td>the value of <em class="parameter"><code>key</code></em> as an allocated <a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema"><span class="type">GConfSchema</span></a>, or <span class="symbol">NULL</span> if no value was obtained.
1231
<td>the value of <em class="parameter"><code>key</code></em> as an allocated <a class="link" href="gconf-gconf-schema.html#GConfSchema" title="GConfSchema"><span class="type">GConfSchema</span></a>, or <span class="symbol">NULL</span> if no value was obtained.</td>
1461
1310
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1462
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1311
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1466
1314
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1467
<td>key you want the value of.
1315
<td>key you want the value of.</td>
1471
1318
<td><p><span class="term"><em class="parameter"><code>list_type</code></em> :</span></p></td>
1472
<td>type of each list element.
1319
<td>type of each list element.</td>
1476
1322
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1477
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1323
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1481
1326
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1482
<td> an allocated list, with elements as described above.
1327
<td>an allocated list, with elements as described above.</td>
1590
1434
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1591
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1435
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1595
1438
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1596
<td>key you want the value of.
1439
<td>key you want the value of.</td>
1600
1442
<td><p><span class="term"><em class="parameter"><code>car_type</code></em> :</span></p></td>
1601
<td>desired type of the pair's first field (car).
1443
<td>desired type of the pair's first field (car).</td>
1605
1446
<td><p><span class="term"><em class="parameter"><code>cdr_type</code></em> :</span></p></td>
1606
<td>desired type of the pair's second field (cdr).
1447
<td>desired type of the pair's second field (cdr).</td>
1610
1450
<td><p><span class="term"><em class="parameter"><code>car_retloc</code></em> :</span></p></td>
1611
<td>address of a return location for the car.
1451
<td>address of a return location for the car.</td>
1615
1454
<td><p><span class="term"><em class="parameter"><code>cdr_retloc</code></em> :</span></p></td>
1616
<td>address of a return location for the cdr.
1455
<td>address of a return location for the cdr.</td>
1620
1458
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1621
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1459
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1625
1462
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1627
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1464
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1647
1483
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1648
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1484
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1652
1487
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1653
<td>key you want to set the value of.
1488
<td>key you want to set the value of.</td>
1657
1491
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1658
<td>new value of <em class="parameter"><code>key</code></em>.
1492
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1662
1495
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1663
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1496
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1667
1499
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1669
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1501
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1689
1520
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1690
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1521
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1694
1524
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1695
<td>key you want to set the value of.
1525
<td>key you want to set the value of.</td>
1699
1528
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1700
<td>new value of <em class="parameter"><code>key</code></em>.
1529
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1704
1532
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1705
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1533
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1709
1536
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1711
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1538
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1731
1557
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1732
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1558
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1736
1561
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1737
<td>key you want to set the value of.
1562
<td>key you want to set the value of.</td>
1741
1565
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1742
<td>new value of <em class="parameter"><code>key</code></em>.
1566
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1746
1569
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1747
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1570
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1751
1573
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1753
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1575
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1773
1594
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1774
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1595
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1778
1598
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1779
<td>key you want to set the value of.
1599
<td>key you want to set the value of.</td>
1783
1602
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1784
<td>new value of <em class="parameter"><code>key</code></em>.
1603
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1788
1606
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1789
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1607
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1793
1610
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1795
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1612
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1815
1631
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1816
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1632
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1820
1635
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1821
<td>key you want to set the value of.
1636
<td>key you want to set the value of.</td>
1825
1639
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1826
<td>new value of <em class="parameter"><code>key</code></em>.
1640
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1830
1643
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1831
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1644
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1835
1647
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1837
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1649
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1860
1671
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1861
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1672
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1865
1675
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1866
<td>key you want to set the value of.
1676
<td>key you want to set the value of.</td>
1870
1679
<td><p><span class="term"><em class="parameter"><code>list_type</code></em> :</span></p></td>
1871
<td>type of each list element.
1680
<td>type of each list element.</td>
1875
1683
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1876
<td>new value of <em class="parameter"><code>key</code></em>.
1684
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1880
1687
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1881
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1688
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1885
1691
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1887
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1693
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1912
1717
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
1913
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1718
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
1917
1721
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1918
<td>key you want to set the value of.
1722
<td>key you want to set the value of.</td>
1922
1725
<td><p><span class="term"><em class="parameter"><code>car_type</code></em> :</span></p></td>
1923
<td>type of the pair's first field (car).
1726
<td>type of the pair's first field (car).</td>
1927
1729
<td><p><span class="term"><em class="parameter"><code>cdr_type</code></em> :</span></p></td>
1928
<td>type of the pair's second field (cdr).
1730
<td>type of the pair's second field (cdr).</td>
1932
1733
<td><p><span class="term"><em class="parameter"><code>address_of_car</code></em> :</span></p></td>
1933
<td>address of the car.
1734
<td>address of the car.</td>
1937
1737
<td><p><span class="term"><em class="parameter"><code>address_of_cdr</code></em> :</span></p></td>
1938
<td>address of the cdr.
1738
<td>address of the cdr.</td>
1942
1741
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1943
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1742
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
1947
1745
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1949
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1747
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
2001
1798
<td><p><span class="term"><em class="parameter"><code>lookup_table</code></em> :</span></p></td>
2002
<td>a lookup table mapping enum values to strings.
1799
<td>a lookup table mapping enum values to strings.</td>
2006
1802
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2007
<td>the string to convert to an enum value.
1803
<td>the string to convert to an enum value.</td>
2011
1806
<td><p><span class="term"><em class="parameter"><code>enum_value_retloc</code></em> :</span></p></td>
2012
<td>the address of an enum variable.
1807
<td>the address of an enum variable.</td>
2016
1810
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2018
<span class="symbol">TRUE</span> if a match was found.
1812
<span class="symbol">TRUE</span> if a match was found.</td>
2036
1829
<td><p><span class="term"><em class="parameter"><code>lookup_table</code></em> :</span></p></td>
2037
<td>a lookup table mapping enum values to strings.
1830
<td>a lookup table mapping enum values to strings.</td>
2041
1833
<td><p><span class="term"><em class="parameter"><code>enum_value</code></em> :</span></p></td>
2042
<td>the enumeration value to convert to a string.
1834
<td>the enumeration value to convert to a string.</td>
2046
1837
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2047
<td>a pointer to the proper string in the lookup table, or <span class="symbol">NULL</span> if no match was found.
1838
<td>a pointer to the proper string in the lookup table, or <span class="symbol">NULL</span> if no match was found.</td>
2067
1857
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
2068
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1858
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
2072
1861
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
2073
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1862
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
2093
1881
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
2094
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1882
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
2098
1885
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
2099
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1886
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
2122
1908
<td><p><span class="term"><em class="parameter"><code>conf</code></em> :</span></p></td>
2123
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.
1909
<td>a <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>.</td>
2127
1912
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2128
<td>the key whose value is to be obtained.
1913
<td>the key whose value is to be obtained.</td>
2132
1916
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
2133
1917
<td>the preferred locale (as in the locale related environment variables) or<span class="symbol">NULL</span> if no locale is to be
2138
1921
<td><p><span class="term"><em class="parameter"><code>use_schema_default</code></em> :</span></p></td>
2139
1922
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value, indicating whether schema information is to be used as the default
2144
1926
<td><p><span class="term"><em class="parameter"><code>is_default_p</code></em> :</span></p></td>
2145
1927
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> if the is_default field of the <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a> is required, <span class="symbol">NULL</span>
2150
1931
<td><p><span class="term"><em class="parameter"><code>is_writable_p</code></em> :</span></p></td>
2151
1932
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> if the is_writable field of the <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a> is required, <span class="symbol">NULL</span>
2156
1936
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
2157
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.
1937
<td>the return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <span class="symbol">NULL</span> to ignore errors.</td>
2161
1940
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2162
<td>the <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>.
1941
<td>the <a class="link" href="gconf-gconf-value.html#GConfValue" title="struct GConfValue"><span class="type">GConfValue</span></a>.</td>