gconf docs/example updated

[Havoc Pennington <hp redhat com>]

Hi,

GConf 2 should be easier to figure out now:

 a) the docs makefile works so API docs actually build, 
    and it has the standard gtk-doc related options

 b) the reference docs aren't complete, but they no longer 
    contain obsolete information, and do contain the basics

 c) examples/basic-gconf-app.c is simplified a good bit 
    to reflect our current instant-apply recommendation 
    instead of the ancient ok/try/revert/cancel thing, 
    and deprecated API has been removed from it

If you only have time to read one thing, I suggest
examples/basic-gconf-app.c and the comments in there. I've noticed
people just replacing gnome_config_ calls with GConf calls; that's not
really going to work right...

Also, even if you only read that one thing, also read about the key
naming conventions and how to install schema files, discussed in the
reference manual. The example doesn't really cover schemas.

Havoc