[gnome-user-docs] further drafting of dconf-profiles.page. still in draft status.

[Jim Campbell <jcampbell src gnome org>]

commit 9fa5b72556177d19ca7653f0dc945e400e3875e8
Author: Jim Campbell <jwcampbell gmail com>
Date:   Mon Aug 13 23:32:03 2012 -0500

    further drafting of dconf-profiles.page. still in draft status.

 system-admin-guide/C/dconf-profiles.page |   50 ++++++++++++++++++++++-------
 1 files changed, 38 insertions(+), 12 deletions(-)
---
diff --git a/system-admin-guide/C/dconf-profiles.page b/system-admin-guide/C/dconf-profiles.page
index b9b665c..d7fb6a8 100644
--- a/system-admin-guide/C/dconf-profiles.page
+++ b/system-admin-guide/C/dconf-profiles.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="dconf-profiles">
   <info>
-    <revision version="0.1" date="2012-05-21" status="stub"/>
+    <revision pkgversion="3.6" version="0.1" date="2012-05-21" status="stub"/>
     <link type="guide" xref="index" group="user" />
     <link type="seealso" xref="backgrounds-extra" />
 
@@ -12,16 +12,29 @@
       <years>2012</years>
     </credit>
 
+    <credit type="author copyright">
+      <name>Jeremy Bicha</name>
+      <email>jbicha ubuntu com</email>
+      <years>2012</years>
+    </credit>
+
+    <credit type="author copyright">
+      <name>Jim Campbell</name>
+      <email>jwcampbell gmail com</email>
+      <years>2012</years>
+    </credit>
+    
     <desc>Set system-wide default values using dconf's key file directories</desc>
   </info>
 
   <title>Custom default values for system settings</title>
 
   <p>System-wide default values can be set using dconf's <em>key file
-   directories</em>. </p>
-
-  <p>A key file in this directory will look something like this:</p>
+   directories</em>. Key files contain <em>groups</em> and <em>key-value pairs
+   </em>.</p>
 
+  <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
@@ -31,31 +44,44 @@ gnome-control-center integration would be great too.</p></comment>
 <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>Edit <file>/etc/dconf/profile/user</file></p>
+  <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>
 <code>
 user-db:user
 system-db:local
 </code></item>
 
-  <item><p>Create a directory named <file>/etc/dconf/db/local.d</file></p></item>
-  <item><p>Edit <file>/etc/dconf/db/local.d/00_default-wallpaper</file></p>
+  <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'
-# You can use any hex color; 000000 is white.
 primary-color='000000'
 secondary-color='000000'
 </code>
 </item>
 <item><p>Run <cmd>dconf update</cmd></p></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>
+    <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>
-</example>
+
+
+<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>
 
 </page>