<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="overview-settings" xml:lang="it">

  <info>

    <link type="guide" xref="index" group="settings"/>

    <revision version="0.1" date="2013-08-06" status="review"/>

    <credit type="author copyright">

      <name>David King</name>

      <email its:translate="no">davidk@gnome.org</email>

      <years>2013</years>

    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc>Flexible user configuration system.</desc>

  </info>

<title>Settings management</title>

<list>

  <item>

    
High-level access for application settings

  </item>

  <item>

    
Easily bind settings to UI elements

  </item>

  <item>

    
Flexible overrides for packagers and system

    administrators

  </item>

</list>

Store user settings and make your application respond to them automatically

with GSettings. Easily override settings defaults as a system administrator.

Store a wide variety of data, such as integers and arrays of strings, with

ease.

<section id="what">

  <title>What can you do?</title>

  
Use the GSettings API of

  GIO to read and write application settings. GSettings

  transparently uses the platform configuration

  database so that platform-specific configuration tools can be

  used. Make UI controls update according to settings

  with a single function.

</section>

<section id="samples">

 <title>Code samples</title>

 <list>

  <item>
A sample we should write
</item>

  <item>
<link xref="samples">More…</link>
</item>

 </list>

</section>

-->

<section id="realworld">

  <title>Real-world examples</title>

  
Nearly all GNOME applications use GSettings.

  <list>

    <item>

      
Dconf editor is the GUI tool for managing

      preferences stored in the dconf database with GSettings.

      
( <link href="https://developer.gnome.org/dconf/unstable/dconf-editor.html">Website</link> | <link href="https://git.gnome.org/browse/dconf/tree/editor">Source code</link> )

    </item>

  </list>

</section>

</page>