[gnome-user-docs] Content changed for dconf-profiles.page



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]