[gnome-user-docs] Overrides content added to sysadmin pages

[Michael Hill <mdhill src gnome org>]

commit bb1cd1ac6d2ca7970bd373152c02663e6ce1b327
Author: Michael Hill <mdhillca gmail com>
Date:   Fri Jul 6 17:52:55 2012 -0400

    Overrides content added to sysadmin pages

 system-admin-guide/C/background.page           |   29 ++++++++----------
 system-admin-guide/C/lockscreenbackground.page |   24 +++++++++++++++
 system-admin-guide/C/overrides.page            |   38 ++++++++++++++++++++++++
 system-admin-guide/C/vendor.page               |   33 --------------------
 4 files changed, 75 insertions(+), 49 deletions(-)
---
diff --git a/system-admin-guide/C/background.page b/system-admin-guide/C/background.page
index 115db4b..ed4bd30 100644
--- a/system-admin-guide/C/background.page
+++ b/system-admin-guide/C/background.page
@@ -6,28 +6,25 @@
     <link type="guide" xref="index" group="appearance" />
 
     <credit type="author copyright">
-      <name>Michael Hill</name>
-      <email>mdhillca gmail com</email>
+      <name>Matthias Clasen</name>
+      <email>matthias clasen gmail com</email>
       <years>2012</years>
     </credit>
 
-    <desc>Set defaults using GSettings keys</desc>
+    <desc>Set the default desktop background using a GSettings override</desc>
    </info>
 
-  <title>Setting the default background</title>
+  <title>Setting the default desktop background</title>
 
-  <comment>
-    <cite date="2012-05-21" href="mailto:mdhillca gmail com">Michael Hill</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+  <p>Install an <link xref="overrides">override</link> for the
+   <file>org.gnome.desktop.background.picture-uri</file> gsettings key.  As an
+   example, here is the file
+   <file>/usr/share/glib-2.0/schemas/org.gnome.desktop.background.fedora.gschema.override</file>
+   that is used in Fedora 17:</p>
 
-  <p>Short introductory text...</p>
-
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<code>
+[org.gnome.desktop.background]
+picture-uri='file:///usr/share/backgrounds/beefy-miracle/default/beefy-miracle.xml'
+</code>
 
 </page>
diff --git a/system-admin-guide/C/lockscreenbackground.page b/system-admin-guide/C/lockscreenbackground.page
new file mode 100644
index 0000000..5e7b8eb
--- /dev/null
+++ b/system-admin-guide/C/lockscreenbackground.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="lockscreenbackground">
+  <info>
+    <revision version="0.1" date="2012-05-21" status="stub"/>
+    <link type="guide" xref="index" group="appearance" />
+
+    <credit type="author copyright">
+      <name>Matthias Clasen</name>
+      <email>matthias clasen gmail com</email>
+      <years>2012</years>
+    </credit>
+
+    <desc>Set the default lock screen background using a GSettings override</desc>
+   </info>
+
+  <title>Setting the default lock screen background</title>
+
+  <p><app>gnome-screensaver</app> is running in the user's session and uses the
+   default value of the <file>org.gnome.desktop.background.picture-uri</file>
+   gsettings key. To change the default, install an
+   <link xref="overrides">override</link>.</p>
+
+</page>
diff --git a/system-admin-guide/C/overrides.page b/system-admin-guide/C/overrides.page
new file mode 100644
index 0000000..5341590
--- /dev/null
+++ b/system-admin-guide/C/overrides.page
@@ -0,0 +1,38 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="overrides">
+  <info>
+    <revision version="0.1" date="2012-05-21" status="stub"/>
+
+    <credit type="author copyright">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+      <years>2012</years>
+    </credit>
+
+    <desc>Override defaults using GSettings keys</desc>
+   </info>
+
+  <title>GSettings overrides</title>
+
+  <comment>
+    <cite date="2012-07-05" href="mailto:mdhillca gmail com">Michael Hill</cite>
+    <p>Adapted from d-g-o GSettings page. Add a see-also?</p>
+  </comment>
+
+  <p>Default values are defined in the schemas that get installed by an
+   application. Sometimes, it is necessary for a vendor or distributor to adjust
+   these defaults. Since patching the XML source for the schema is inconvenient
+   and error-prone, glib-compile-schemas reads so-called
+   <em>"vendor override"</em>  files. These are keyfiles in the same directory
+   as the XML schema sources which can override default values. The schema id
+   serves as the group name in the key file, and the values are expected in
+   serialized GVariant form, as in the following example:</p>
+
+<code>
+[org.gtk.Example]
+key1='string'
+key2=1.5
+</code>
+
+</page>