4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GConfClient</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="ch01.html" title="Using the GConf library">
10
10
<link rel="next" href="gconf-gconf-backend.html" title="gconf-backend">
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">
225
225
<a class="link" href="gconf-gconf-client.html#gconf-client-get-default" title="gconf_client_get_default ()"><code class="function">gconf_client_get_default()</code></a>, there is no (legitimate) way to obtain a pointer to the
226
226
underlying <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>. If you create a <span class="type">GConfClient</span> from an existing engine,
227
227
you'll have to be disciplined enough to avoid using that engine directly.
228
<sup>[<a name="id2946786" href="#ftn.id2946786" class="footnote">1</a>]</sup>
228
<sup>[<a name="id3008065" href="#ftn.id3008065" class="footnote">1</a>]</sup>
394
394
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
395
<td>the <span class="type">GConfClient</span> notifying us.
395
<td>the <span class="type">GConfClient</span> notifying us.</td>
399
398
<td><p><span class="term"><em class="parameter"><code>cnxn_id</code></em> :</span></p></td>
400
<td>connection ID from <a class="link" href="gconf-gconf-client.html#gconf-client-notify-add" title="gconf_client_notify_add ()"><code class="function">gconf_client_notify_add()</code></a>.
399
<td>connection ID from <a class="link" href="gconf-gconf-client.html#gconf-client-notify-add" title="gconf_client_notify_add ()"><code class="function">gconf_client_notify_add()</code></a>.</td>
404
402
<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td>
405
<td>a <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>.
403
<td>a <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>.</td>
409
406
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
410
<td>user data from <a class="link" href="gconf-gconf-client.html#gconf-client-notify-add" title="gconf_client_notify_add ()"><code class="function">gconf_client_notify_add()</code></a>.
407
<td>user data from <a class="link" href="gconf-gconf-client.html#gconf-client-notify-add" title="gconf_client_notify_add ()"><code class="function">gconf_client_notify_add()</code></a>.</td>
429
425
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
430
<td>a <span class="type">GConfClient</span>.
426
<td>a <span class="type">GConfClient</span>.</td>
434
429
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
435
<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.
430
<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>
450
444
<col align="left" valign="top">
452
446
<td><p><span class="term"><em class="parameter"><code>obj</code></em> :</span></p></td>
453
<td>a <span class="type">GConfClient</span>.
447
<td>a <span class="type">GConfClient</span>.</td>
472
465
<col align="left" valign="top">
474
467
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
475
<td> a new <span class="type">GConfClient</span>. <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when you're done. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
468
<td>a new <span class="type">GConfClient</span>. <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when you're done. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
495
488
<td><p><span class="term"><em class="parameter"><code>engine</code></em> :</span></p></td>
496
<td>the <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to use.
489
<td>the <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a> to use.</td>
500
492
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
501
<td> a new <span class="type">GConfClient</span>. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
493
<td>a new <span class="type">GConfClient</span>. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
531
523
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
532
<td>a <span class="type">GConfClient</span>.
524
<td>a <span class="type">GConfClient</span>.</td>
536
527
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
537
<td>directory to add to the list.
528
<td>directory to add to the list.</td>
541
531
<td><p><span class="term"><em class="parameter"><code>preload</code></em> :</span></p></td>
542
<td>degree of preload.
532
<td>degree of preload.</td>
546
535
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
547
<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>
570
558
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
571
<td>a <span class="type">GConfClient</span>.
559
<td>a <span class="type">GConfClient</span>.</td>
575
562
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
576
<td>directory to remove.
563
<td>directory to remove.</td>
580
566
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
581
<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.
567
<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>
624
609
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
626
<em class="parameter"><code>namespace_section</code></em>
610
<td><em class="parameter"><code>namespace_section</code></em></td>
630
613
<td><p><span class="term"><em class="parameter"><code>namespace_section</code></em> :</span></p></td>
631
<td>where to listen for changes.
614
<td>where to listen for changes.</td>
635
617
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
636
<td>. <span class="annotation">[<a href="http://foldoc.org/scope%20notified"><span class="acronym">scope notified</span></a>][closure user_data][destroy destroy_notify]</span>
618
<td>. <span class="annotation">[<a href="http://foldoc.org/scope%20notified"><span class="acronym">scope notified</span></a>][<a href="http://foldoc.org/closure"><span class="acronym">closure</span></a> user_data][destroy destroy_notify]</span>
640
622
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
641
<td>a connection ID for removing the notification.
623
<td>a connection ID for removing the notification.</td>
661
642
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
662
<td>a <span class="type">GConfClient</span>.
643
<td>a <span class="type">GConfClient</span>.</td>
666
646
<td><p><span class="term"><em class="parameter"><code>cnxn</code></em> :</span></p></td>
647
<td>connection ID.</td>
686
665
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
687
<td>a <span class="type">GConfClient</span>.
666
<td>a <span class="type">GConfClient</span>.</td>
691
669
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
692
<td>the key that has changed.
670
<td>the key that has changed.</td>
712
689
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
713
<td>a <span class="type">GConfClient</span>.
690
<td>a <span class="type">GConfClient</span>.</td>
717
693
<td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
718
<td>error handling mode.
694
<td>error handling mode.</td>
734
709
<col align="left" valign="top">
736
711
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
737
<td>pointer to the function to be called for error handling.
712
<td>pointer to the function to be called for error handling.</td>
752
726
<col align="left" valign="top">
754
728
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
755
<td>a <span class="type">GConfClient</span>.
729
<td>a <span class="type">GConfClient</span>.</td>
776
749
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
777
<td>a <span class="type">GConfClient</span>.
750
<td>a <span class="type">GConfClient</span>.</td>
781
753
<td><p><span class="term"><em class="parameter"><code>dirname</code></em> :</span></p></td>
782
<td>directory to preload.
754
<td>directory to preload.</td>
786
757
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
787
<td>degree of preload.
758
<td>degree of preload.</td>
791
761
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
792
<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.
762
<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>
814
783
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
815
<td>a <span class="type">GConfClient</span>.
784
<td>a <span class="type">GConfClient</span>.</td>
819
787
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
824
791
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
829
795
<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.
796
<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>
850
815
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
851
<td>a <span class="type">GConfClient</span>.
816
<td>a <span class="type">GConfClient</span>.</td>
855
819
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
860
823
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
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.
824
<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>
865
827
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
866
<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.
828
<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>
885
846
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
886
<td>a <span class="type">GConfClient</span>.
847
<td>a <span class="type">GConfClient</span>.</td>
890
850
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
895
854
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
896
<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.
855
<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>
900
858
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
901
<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 (even if a default exists).
859
<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 (even if a default exists).</td>
922
879
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
923
<td>a <span class="type">GConfClient</span>.
880
<td>a <span class="type">GConfClient</span>.</td>
927
883
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
932
887
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
933
<td>preferred locale (as in the locale-related environment variables).
888
<td>preferred locale (as in the locale-related environment variables).</td>
937
891
<td><p><span class="term"><em class="parameter"><code>use_schema_default</code></em> :</span></p></td>
938
<td>indicates whether to look for a default value when the key is unset.
892
<td>indicates whether to look for a default value when the key is unset.</td>
942
895
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
943
<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.
896
<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>
947
899
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
948
<td>a <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>.
900
<td>a <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>.</td>
974
925
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
975
<td>a <span class="type">GConfClient</span>.
926
<td>a <span class="type">GConfClient</span>.</td>
979
929
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
984
933
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
985
<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.
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.</td>
989
937
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
990
<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 the key has no default value in its schema.
938
<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 the key has no default value in its schema.</td>
1012
959
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1013
<td>a <span class="type">GConfClient</span>.
960
<td>a <span class="type">GConfClient</span>.</td>
1017
963
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
964
<td>key to unset.</td>
1022
967
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1023
<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.
968
<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>
1027
971
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1029
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
973
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1051
994
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1052
<td>a <span class="type">GConfClient</span>.
995
<td>a <span class="type">GConfClient</span>.</td>
1056
998
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1057
<td>a key or directory name to be unset.
999
<td>a key or directory name to be unset.</td>
1061
1002
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
1062
<td>change how the unset is done.
1003
<td>change how the unset is done.</td>
1066
1006
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1067
<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.
1007
<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>
1071
1010
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1073
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1012
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1099
1037
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1100
<td>a <span class="type">GConfClient</span>.
1038
<td>a <span class="type">GConfClient</span>.</td>
1104
1041
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
1105
<td>directory to list.
1042
<td>directory to list.</td>
1109
1045
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1110
<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.
1046
<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>
1114
1049
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1115
<td> List of <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>. <span class="annotation">[<a href="http://foldoc.org/element-type"><span class="acronym">element-type</span></a> GConfEntry][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
1050
<td>List of <a class="link" href="gconf-gconf-value.html#GConfEntry" title="struct GConfEntry"><span class="type">GConfEntry</span></a>. <span class="annotation">[<a href="http://foldoc.org/element-type"><span class="acronym">element-type</span></a> GConfEntry][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
1138
1073
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1139
<td>a <span class="type">GConfClient</span>.
1074
<td>a <span class="type">GConfClient</span>.</td>
1143
1077
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
1144
<td>directory to get subdirectories from.
1078
<td>directory to get subdirectories from.</td>
1148
1081
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1149
<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.
1082
<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>
1153
1085
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1154
<td> List of allocated subdirectory names. <span class="annotation">[<a href="http://foldoc.org/element-type"><span class="acronym">element-type</span></a> utf8][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
1086
<td>List of allocated subdirectory names. <span class="annotation">[<a href="http://foldoc.org/element-type"><span class="acronym">element-type</span></a> utf8][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
1179
1111
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1180
<td>a <span class="type">GConfClient</span>.
1112
<td>a <span class="type">GConfClient</span>.</td>
1184
1115
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1185
<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.
1116
<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>
1206
1136
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1207
<td>a <span class="type">GConfClient</span>.
1137
<td>a <span class="type">GConfClient</span>.</td>
1211
1140
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
1212
<td>directory to check for
1141
<td>directory to check for</td>
1216
1144
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1217
<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.
1145
<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>
1221
1148
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1223
<span class="symbol">TRUE</span> or <span class="symbol">FALSE</span>.
1150
<span class="symbol">TRUE</span> or <span class="symbol">FALSE</span>.</td>
1242
1168
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1243
<td>a <span class="type">GConfClient</span>.
1169
<td>a <span class="type">GConfClient</span>.</td>
1247
1172
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1248
<td>the value to be changed.
1173
<td>the value to be changed.</td>
1252
1176
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1253
<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.
1177
<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>
1257
1180
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1259
<span class="symbol">TRUE</span> if the key is writable, <span class="symbol">FALSE</span> if the key is read only.
1182
<span class="symbol">TRUE</span> if the key is writable, <span class="symbol">FALSE</span> if the key is read only.</td>
1282
1204
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1283
<td>a <span class="type">GConfClient</span>.
1205
<td>a <span class="type">GConfClient</span>.</td>
1287
1208
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1288
<td>key you want the value of.
1209
<td>key you want the value of.</td>
1292
1212
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1293
<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.
1213
<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>
1297
1216
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1298
<td>the value of <em class="parameter"><code>key</code></em>, or 0.0 if no value is obtained.
1217
<td>the value of <em class="parameter"><code>key</code></em>, or 0.0 if no value is obtained.</td>
1321
1239
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1322
<td>a <span class="type">GConfClient</span>.
1240
<td>a <span class="type">GConfClient</span>.</td>
1326
1243
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1327
<td>key you want the value of.
1244
<td>key you want the value of.</td>
1331
1247
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1332
<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.
1248
<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>
1336
1251
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1337
<td>the value of <em class="parameter"><code>key</code></em>, or 0 if no value is obtained.
1252
<td>the value of <em class="parameter"><code>key</code></em>, or 0 if no value is obtained.</td>
1360
1274
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1361
<td>a <span class="type">GConfClient</span>.
1275
<td>a <span class="type">GConfClient</span>.</td>
1365
1278
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1366
<td>key you want the value of.
1279
<td>key you want the value of.</td>
1370
1282
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1371
<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.
1283
<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>
1375
1286
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1376
<td>allocated string (value of <em class="parameter"><code>key</code></em>), or <span class="symbol">NULL</span> if no value is obtained.
1287
<td>allocated string (value of <em class="parameter"><code>key</code></em>), or <span class="symbol">NULL</span> if no value is obtained.</td>
1399
1309
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1400
<td>a <span class="type">GConfClient</span>.
1310
<td>a <span class="type">GConfClient</span>.</td>
1404
1313
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1405
<td>key you want the value of.
1314
<td>key you want the value of.</td>
1409
1317
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1410
<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.
1318
<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>
1414
1321
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1415
<td>the value of <em class="parameter"><code>key</code></em>, or <span class="symbol">FALSE</span> if no value is obtained.
1322
<td>the value of <em class="parameter"><code>key</code></em>, or <span class="symbol">FALSE</span> if no value is obtained.</td>
1438
1344
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1439
<td>a <span class="type">GConfClient</span>.
1345
<td>a <span class="type">GConfClient</span>.</td>
1443
1348
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1444
<td>key you want the value of.
1349
<td>key you want the value of.</td>
1448
1352
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1449
<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.
1353
<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>
1453
1356
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1454
<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.
1357
<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>
1537
1439
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1538
<td>a <span class="type">GConfClient</span>.
1440
<td>a <span class="type">GConfClient</span>.</td>
1542
1443
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1543
<td>key you want the value of.
1444
<td>key you want the value of.</td>
1547
1447
<td><p><span class="term"><em class="parameter"><code>list_type</code></em> :</span></p></td>
1548
<td>type of each list element.
1448
<td>type of each list element.</td>
1552
1451
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1553
<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.
1452
<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>
1557
1455
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1558
<td> an allocated list, with elements as described above.
1456
<td>an allocated list, with elements as described above.</td>
1666
1563
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1667
<td>a <span class="type">GConfClient</span>.
1564
<td>a <span class="type">GConfClient</span>.</td>
1671
1567
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1672
<td>key you want the value of.
1568
<td>key you want the value of.</td>
1676
1571
<td><p><span class="term"><em class="parameter"><code>car_type</code></em> :</span></p></td>
1677
<td>desired type of the pair's first field (car).
1572
<td>desired type of the pair's first field (car).</td>
1681
1575
<td><p><span class="term"><em class="parameter"><code>cdr_type</code></em> :</span></p></td>
1682
<td>desired type of the pair's second field (cdr).
1576
<td>desired type of the pair's second field (cdr).</td>
1686
1579
<td><p><span class="term"><em class="parameter"><code>car_retloc</code></em> :</span></p></td>
1687
<td>address of a return location for the car.
1580
<td>address of a return location for the car.</td>
1691
1583
<td><p><span class="term"><em class="parameter"><code>cdr_retloc</code></em> :</span></p></td>
1692
<td>address of a return location for the cdr.
1584
<td>address of a return location for the cdr.</td>
1696
1587
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1697
<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.
1588
<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>
1701
1591
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1703
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1593
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1724
1613
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1725
<td>a <span class="type">GConfClient</span>.
1614
<td>a <span class="type">GConfClient</span>.</td>
1729
1617
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1730
<td>key you want to set the value of.
1618
<td>key you want to set the value of.</td>
1734
1621
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1735
<td>new value of <em class="parameter"><code>key</code></em>.
1622
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1739
1625
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1740
<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.
1626
<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>
1744
1629
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1746
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1631
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1767
1651
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1768
<td>a <span class="type">GConfClient</span>.
1652
<td>a <span class="type">GConfClient</span>.</td>
1772
1655
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1773
<td>key you want to set the value of.
1656
<td>key you want to set the value of.</td>
1777
1659
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1778
<td>new value of <em class="parameter"><code>key</code></em>.
1660
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1782
1663
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1783
<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.
1664
<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>
1787
1667
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1789
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1669
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1810
1689
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1811
<td>a <span class="type">GConfClient</span>.
1690
<td>a <span class="type">GConfClient</span>.</td>
1815
1693
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1816
<td>key you want to set the value of.
1694
<td>key you want to set the value of.</td>
1820
1697
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1821
<td>new value of <em class="parameter"><code>key</code></em>.
1698
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1825
1701
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1826
<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.
1702
<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>
1830
1705
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1832
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1707
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1853
1727
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1854
<td>a <span class="type">GConfClient</span>.
1728
<td>a <span class="type">GConfClient</span>.</td>
1858
1731
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1859
<td>key you want to set the value of.
1732
<td>key you want to set the value of.</td>
1863
1735
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1864
<td>new value of <em class="parameter"><code>key</code></em>.
1736
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1868
1739
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1869
<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.
1740
<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>
1873
1743
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1875
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1745
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1896
1765
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1897
<td>a <span class="type">GConfClient</span>.
1766
<td>a <span class="type">GConfClient</span>.</td>
1901
1769
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1902
<td>key you want to set the value of.
1770
<td>key you want to set the value of.</td>
1906
1773
<td><p><span class="term"><em class="parameter"><code>val</code></em> :</span></p></td>
1907
<td>new value of <em class="parameter"><code>key</code></em>.
1774
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1911
1777
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1912
<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.
1778
<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>
1916
1781
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1918
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1783
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1941
1805
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1942
<td>a <span class="type">GConfClient</span>.
1806
<td>a <span class="type">GConfClient</span>.</td>
1946
1809
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1947
<td>key you want to set the value of.
1810
<td>key you want to set the value of.</td>
1951
1813
<td><p><span class="term"><em class="parameter"><code>list_type</code></em> :</span></p></td>
1952
<td>type of each list element.
1814
<td>type of each list element.</td>
1956
1817
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1957
<td>new value of <em class="parameter"><code>key</code></em>.
1818
<td>new value of <em class="parameter"><code>key</code></em>.</td>
1961
1821
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1962
<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.
1822
<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>
1966
1825
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1968
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1827
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
1993
1851
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
1994
<td>a <span class="type">GConfClient</span>.
1852
<td>a <span class="type">GConfClient</span>.</td>
1998
1855
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1999
<td>key you want to set the value of.
1856
<td>key you want to set the value of.</td>
2003
1859
<td><p><span class="term"><em class="parameter"><code>car_type</code></em> :</span></p></td>
2004
<td>type of the pair's first field (car).
1860
<td>type of the pair's first field (car).</td>
2008
1863
<td><p><span class="term"><em class="parameter"><code>cdr_type</code></em> :</span></p></td>
2009
<td>type of the pair's second field (cdr).
1864
<td>type of the pair's second field (cdr).</td>
2013
1867
<td><p><span class="term"><em class="parameter"><code>address_of_car</code></em> :</span></p></td>
2014
<td>address of the car.
1868
<td>address of the car.</td>
2018
1871
<td><p><span class="term"><em class="parameter"><code>address_of_cdr</code></em> :</span></p></td>
2019
<td>address of the cdr.
1872
<td>address of the cdr.</td>
2023
1875
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
2024
<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.
1876
<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>
2028
1879
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2030
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.
1881
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> on error.</td>
2048
1898
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
2049
<td>a <span class="type">GConfClient</span>.
1899
<td>a <span class="type">GConfClient</span>.</td>
2053
1902
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2054
<td>error to pass to signal handlers.
1903
<td>error to pass to signal handlers.</td>
2072
1920
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
2073
<td>a <span class="type">GConfClient</span>.
1921
<td>a <span class="type">GConfClient</span>.</td>
2077
1924
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2078
<td>error to pass to signal handlers.
1925
<td>error to pass to signal handlers.</td>
2097
1943
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
2098
<td>a <span class="type">GConfClient</span>.
1944
<td>a <span class="type">GConfClient</span>.</td>
2102
1947
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2103
<td>key to pass to signal handlers.
1948
<td>key to pass to signal handlers.</td>
2107
1951
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2108
<td>value of <em class="parameter"><code>key</code></em> to pass to signal handlers.
1952
<td>value of <em class="parameter"><code>key</code></em> to pass to signal handlers.</td>
2140
1983
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
2141
<td>a <span class="type">GConfClient</span>.
1984
<td>a <span class="type">GConfClient</span>.</td>
2145
1987
<td><p><span class="term"><em class="parameter"><code>cs</code></em> :</span></p></td>
2146
<td>a <a class="link" href="gconf-gconf-changeset.html#GConfChangeSet" title="GConfChangeSet"><span class="type">GConfChangeSet</span></a>.
1988
<td>a <a class="link" href="gconf-gconf-changeset.html#GConfChangeSet" title="GConfChangeSet"><span class="type">GConfChangeSet</span></a>.</td>
2150
1991
<td><p><span class="term"><em class="parameter"><code>remove_committed</code></em> :</span></p></td>
2151
<td>whether to remove successfully-committed changes from the set.
1992
<td>whether to remove successfully-committed changes from the set.</td>
2155
1995
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
2156
<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.
1996
<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>
2160
1999
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2162
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> if an error occurs.
2001
<span class="symbol">TRUE</span> on success, <span class="symbol">FALSE</span> if an error occurs.</td>
2182
2020
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
2183
<td>a <span class="type">GConfClient</span>.
2021
<td>a <span class="type">GConfClient</span>.</td>
2187
2024
<td><p><span class="term"><em class="parameter"><code>cs</code></em> :</span></p></td>
2188
<td>change set to create the reverse of.
2025
<td>change set to create the reverse of.</td>
2192
2028
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
2193
<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.
2029
<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>
2197
2032
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2198
<td>a new change set that would restore the current state of each key in <em class="parameter"><code>cs</code></em>.
2033
<td>a new change set that would restore the current state of each key in <em class="parameter"><code>cs</code></em>.</td>
2221
2055
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
2222
<td>a <span class="type">GConfClient</span>.
2056
<td>a <span class="type">GConfClient</span>.</td>
2226
2059
<td><p><span class="term"><em class="parameter"><code>keys</code></em> :</span></p></td>
2228
<span class="symbol">NULL</span>-terminated array of key names.
2061
<span class="symbol">NULL</span>-terminated array of key names.</td>
2232
2064
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
2233
<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.
2065
<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>
2237
2068
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2238
<td>new change set that changes all the <em class="parameter"><code>keys</code></em> to their current state.
2069
<td>new change set that changes all the <em class="parameter"><code>keys</code></em> to their current state.</td>
2259
2089
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
2260
<td>a <span class="type">GConfClient</span>.
2090
<td>a <span class="type">GConfClient</span>.</td>
2264
2093
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
2265
<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.
2094
<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>
2269
2097
<td><p><span class="term"><em class="parameter"><code>first_key</code></em> :</span></p></td>
2270
<td>first key to save the current state of.
2098
<td>first key to save the current state of.</td>
2274
2101
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2276
<span class="symbol">NULL</span>-terminated list of additional keys.
2103
<span class="symbol">NULL</span>-terminated list of additional keys.</td>
2280
2106
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2281
<td>new change set that changes all the keys to their current state.
2107
<td>new change set that changes all the keys to their current state.</td>
2288
2113
<div class="footnotes">
2289
2114
<br><hr width="100" align="left">
2290
<div class="footnote"><p><sup>[<a name="ftn.id2946786" href="#id2946786" class="para">1</a>] </sup>
2115
<div class="footnote"><p><sup>[<a id="ftn.id3008065" href="#id3008065" class="para">1</a>] </sup>
2291
2116
This is all a white lie; <span class="emphasis"><em>some</em></span> direct <a class="link" href="gconf-gconf-engine.html#GConfEngine" title="GConfEngine"><span class="type">GConfEngine</span></a>
2292
2117
operations are safe. But it's complicated to know which, and if an operation
2293
2118
isn't safe the resulting bugs will mangle the cache and cause weird bugs at an