[gnome-user-docs] Content changed for dconf-profiles.page
- From: Jana Svarova <jsvarova src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-user-docs] Content changed for dconf-profiles.page
- Date: Tue, 2 Apr 2013 16:50:56 +0000 (UTC)
commit 7cd58c38c3a3d687f15a47c0881056791d3d6c94
Author: Jana Svarova <jsvarova redhat com>
Date: Tue Apr 2 17:59:23 2013 +0200
Content changed for dconf-profiles.page
system-admin-guide/C/dconf-profiles.page | 110 +++++++++++-------------------
1 files changed, 39 insertions(+), 71 deletions(-)
---
diff --git a/system-admin-guide/C/dconf-profiles.page b/system-admin-guide/C/dconf-profiles.page
index 1703d9b..7da3756 100644
--- a/system-admin-guide/C/dconf-profiles.page
+++ b/system-admin-guide/C/dconf-profiles.page
@@ -1,90 +1,58 @@
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="dconf-profiles">
- <info>
- <revision pkgversion="3.6" version="0.1" date="2012-05-21" status="draft"/>
- <link type="guide" xref="index" group="user" />
- <link type="seealso" xref="backgrounds-extra" />
- <credit type="author copyright">
- <name>Ryan Lortie</name>
- <email>desrt desrt ca</email>
- <years>2012</years>
- </credit>
+<info>
+ <link type="seealso" xref="custom-default-values" />
+ <revision version="0.1" date="2013-03-25" status="draft"/>
+ <credit type="author">
+ <name>Jana Švárová</name>
+ <email>jana svarova gmail com</email>
+ </credit>
- <credit type="author copyright">
- <name>Jeremy Bicha</name>
- <email>jbicha ubuntu com</email>
- <years>2012</years>
- </credit>
+ <desc>This page defines the dconf tool, the dconf profile, gives detailed
+ information about profile selection.</desc>
- <credit type="author copyright">
- <name>Jim Campbell</name>
- <email>jwcampbell gmail com</email>
- <years>2012</years>
- </credit>
+</info>
+<title>dconf profiles</title>
- <desc>Set system-wide default values using dconf's key file directories</desc>
- </info>
+<section id="dconf">
+ <title>dconf</title>
- <title>Custom default values for system settings</title>
+ <p>The <sys>dconf</sys> tool collects a system's hardware and software
+ configuration. It allows to take your system configuration with you on the
+ road, compare identical systems to troubleshoot HW or SW problems.</p>
- <p>System-wide default values can be set using dconf's <em>key file
- directories</em>. Key files contain <em>groups</em> and <em>key-value pairs
- </em>.</p>
+ <p><sys>dconf</sys> is based on the concept of a 'profile'. A profile is a
+ list of configuration databases.</p>
+</section>
- <p>To demonstrate how dconf key files can be used to set default values,
- we'll look at how to use them to set a default wallpaper.</p>
-<comment><p>You don't have to use "local" as the profile name. You can even have
-different profiles for different users. This isn't mentioned because this
-functionality needs something like accountsservice integration to enforce this.
-gnome-control-center integration would be great too.</p></comment>
+<section id="select-a-profile">
+ <title>Select a profile</title>
+ <p><sys>dconf</sys> stores its profiles in text files. $DCONF_PROFILE can
+ specify a relative path to the file from the <file>/etc/dconf/profile/</file>
+ directory, or an absolute path (such as in a user's home directory).</p>
-<example>
-<list type="numbered">
- <title>Set the default wallpaper</title>
- <item><p>Create a directory named <file>/etc/dconf/profile/</file></p></item>
- <item><p>From within the <file>profile</file> directory, create and edit a
- file named <file>user</file>.</p>
+ <p>On startup, <sys>dconf</sys> consults the DCONF_PROFILE environment
+ variable. If set, <sys>dconf</sys> attempts to open the named profile and
+ aborts if that fails. If the environment variable is not set,
+ <sys>dconf</sys> attempts to open the profile named "user". If that
+ fails, it will fall back to an internal hard-wired configuration.</p>
+
+ <p>Each line in a profile specifies one <sys>dconf</sys> database. The first
+ line indicates the database used to write changes, and the remaining lines
+ indicate read-only databases. Here is an example:</p>
<code>
user-db:user
system-db:local
-</code></item>
-
- <item><p>Navigate to the <file>/etc/dconf/db/local.d/</file> directory. If
- this directory doesn't exist, you will need to create it.</p>
- </item>
- <item><p>In the <file>local.d</file> directory, create and edit a
- key file named <file>00_default-wallpaper</file>.</p>
-<code>
-#this portion of the key file identifies the dconf group
-[org/gnome/desktop/background]
-#these are the individual key-value pairs that are relevant to the key file group
-picture-uri='file:///usr/local/share/backgrounds/company-wallpaper.jpg'
-picture-options='scaled'
-primary-color='000000'
-secondary-color='000000'
+system-db:site
</code>
-</item>
-<item>
-<p>Update the system databases</p>
-<screen> <output style="prompt"># </output> <input>dconf update</input> </screen>
-</item>
-</list>
-</example>
- <note>
- <p>The first time you create a dconf user profile, you'll need to log out
- and log in to apply the new profile.</p>
- </note>
-
-
-<note>
- <p>
- You can include multiple sets of groups and key-value pairs in each key file,
- or you can use a separate key file for each group.
- </p>
+<note style="important">
+ <p>The first time you create a <sys>dconf</sys> user profile, you'll need to
+ log out and log in to apply the new profile.</p>
</note>
-
+</section>
+
</page>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]