summaryrefslogtreecommitdiff
path: root/examples
diff options
context:
space:
mode:
authorHavoc Pennington <hp@redhat.com>2001-12-04 22:17:09 +0000
committerHavoc Pennington <hp@src.gnome.org>2001-12-04 22:17:09 +0000
commit0bfea60355648ed04251df842a9d9ee0f8756e82 (patch)
treea48f915629e11efde3015b18ade21323c7be5f2e /examples
parenteb60990202cc3b25413008a52e257b73d7055744 (diff)
downloadgconf-0bfea60355648ed04251df842a9d9ee0f8756e82.tar.gz
improve error
2001-12-04 Havoc Pennington <hp@redhat.com> * gconf/gconf-internals.c (open_empty_locked_file): improve error * gconf/gconftool.c (main): complain about using --config-source but not --direct * backends/xml-backend.c (resolve_address): don't try to lock readonly sources; fixes the case where users install to a prefix that they can write to, was causing problems for people using build scripts. * gconf/gconfd.c (gconf_set_exception): add missing value to case statement so we don't crash * examples/basic-gconf-app.c: update comment to say that the example isn't really right anymore * gconf/gconftool.c (process_schema_list): make sure we have an element instead of a text node before we try to process it; kills a bunch of irritating warnings. * Makefile.am (SUBDIRS): remove standard-schemas subdir, should have long ago
Diffstat (limited to 'examples')
-rw-r--r--examples/basic-gconf-app.c16
1 files changed, 16 insertions, 0 deletions
diff --git a/examples/basic-gconf-app.c b/examples/basic-gconf-app.c
index b9e63fcf..7286c997 100644
--- a/examples/basic-gconf-app.c
+++ b/examples/basic-gconf-app.c
@@ -41,6 +41,22 @@
was opened; it also resets the prefs dialog contents to those settings.
*/
+/* NOTE NOTE NOTE NOTE NOTE
+ *
+ * This example is obsolete; current GNOME wisdom is that dialogs should be
+ * "instant apply." That means you can drop all the stuff about using
+ * GConfChangeSet. You need three basic steps in your app:
+ *
+ * - call gconf_client_add_dir() to add the dirs you're interested in
+ * - call gconf_client_notify_add() to subscribe your views to notification
+ * - call gconf_client_set_*() to modify the model
+ *
+ * For bonus points, support "mandatory" sysadmin settings by
+ * turning off or desensitizing GUI according to gconf_client_key_is_writable().
+ *
+ * You really shouldn't need to use much API beyond that.
+ */
+
#include <gconf/gconf-client.h>
#include <gtk/gtk.h>