docs/reference/gio/html/ch29s05.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Change sets</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GIO Reference Manual">
   8 <link rel="up" href="ch29.html" title="Migrating from GConf to GSettings">
   9 <link rel="prev" href="ch29s04.html" title="Change notification">
  10 <link rel="next" href="ch29s06.html" title="Schema conversion">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
  16 <td><a accesskey="p" href="ch29s04.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  17 <td><a accesskey="u" href="ch29.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  18 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  19 <th width="100%" align="center">GIO Reference Manual</th>
  20 <td><a accesskey="n" href="ch29s06.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  21 </tr></table>
  22 <div class="section">
  23 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  24 <a name="id767395"></a>Change sets</h2></div></div></div>
  25 <p>
  26         GConf has a a concept of a set of changes which can be applied or reverted
  27         at once: <a href="/usr/share/gtk-doc/html/gconf/gconf-gconf-changeset.html#GConfChangeSet"><span class="type">GConfChangeSet</span></a> (GConf doesn't actually apply changes atomically,
  28         which is one of its shortcomings).
  29       </p>
  30 <p>
  31         Instead of a separate object to represent a change set, GSettings has a
  32         'delayed-apply' mode, which can be turned on for a GSettings object by
  33         calling <a class="link" href="GSettings.html#g-settings-delay" title="g_settings_delay ()"><code class="function">g_settings_delay()</code></a>. In this mode, changes done to the GSettings
  34         object are not applied - they are still visible when calling <a class="link" href="GSettings.html#g-settings-get" title="g_settings_get ()"><code class="function">g_settings_get()</code></a>
  35         <span class="emphasis"><em>on the same object</em></span>, but not to other GSettings instances
  36         or even other processes.
  37       </p>
  38 <p>
  39         To apply the pending changes all at once (GSettings <span class="emphasis"><em>does</em></span>
  40         atomicity here), call <a class="link" href="GSettings.html#g-settings-apply" title="g_settings_apply ()"><code class="function">g_settings_apply()</code></a>. To revert the pending changes,
  41         call <a class="link" href="GSettings.html#g-settings-revert" title="g_settings_revert ()"><code class="function">g_settings_revert()</code></a> or just drop the reference to the <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object.
  42       </p>
  43 </div>
  44 <div class="footer">
  45 <hr>
  46           Generated by GTK-Doc V1.18</div>
  47 </body>
  48 </html>