[gnome-user-docs] Improve favorite-applications, dconf-profiles, add markup & navigation



commit f06328c698b86a8bfe32389e6aa1e5e8a48b91b5
Author: Petr Kovar <pkovar redhat com>
Date:   Sun Feb 24 18:01:32 2019 +0100

    Improve favorite-applications, dconf-profiles, add markup & navigation

 system-admin-guide/C/appearance.page               |   2 +-
 system-admin-guide/C/backgrounds-extra.page        |   4 +-
 system-admin-guide/C/dconf-profiles.page           |  22 +++-
 system-admin-guide/C/desktop-background.page       |   1 +
 .../C/desktop-favorite-applications.page           | 127 +++++++++++----------
 system-admin-guide/C/desktop-lockscreen.page       |   6 +-
 system-admin-guide/C/index.page                    |   1 +
 system-admin-guide/C/keyboard-layout.page          |  18 +--
 system-admin-guide/C/lockdown-single-app-mode.page |   5 +-
 system-admin-guide/C/login-logo.page               |   1 +
 system-admin-guide/C/login.page                    |   2 +-
 .../C/mime-types-application-user.page             |   5 +-
 system-admin-guide/C/mime-types-application.page   |   4 +-
 system-admin-guide/C/mime-types-custom-user.page   |   5 +-
 system-admin-guide/C/mime-types-custom.page        |   5 +-
 system-admin-guide/C/mime-types.page               |   3 +-
 system-admin-guide/C/network-printer-config.page   |  26 ++---
 system-admin-guide/C/network.page                  |   5 +-
 system-admin-guide/C/processes.page                |   1 +
 system-admin-guide/C/setup.page                    |   4 +
 system-admin-guide/C/software.page                 |   7 +-
 system-admin-guide/C/sundry.page                   |   4 +
 system-admin-guide/C/user-settings.page            |   2 +-
 23 files changed, 156 insertions(+), 104 deletions(-)
---
diff --git a/system-admin-guide/C/appearance.page b/system-admin-guide/C/appearance.page
index 163300f2..fe0c9d4d 100644
--- a/system-admin-guide/C/appearance.page
+++ b/system-admin-guide/C/appearance.page
@@ -11,7 +11,7 @@
       <link xref="desktop-shield">Change the lock screen shield</link>,
       <link xref="desktop-favorite-applications">default favorite
       applications</link>,
-      <link xref="desktop-lockscreen">lock the screen when user is idle</link>…
+      <link xref="desktop-lockscreen">lock the screen when idle</link>…
     </desc>
 
   </info>
diff --git a/system-admin-guide/C/backgrounds-extra.page b/system-admin-guide/C/backgrounds-extra.page
index a01918b2..537777ac 100644
--- a/system-admin-guide/C/backgrounds-extra.page
+++ b/system-admin-guide/C/backgrounds-extra.page
@@ -78,7 +78,7 @@
   </p>
   <p>Below is a sample <file><var>filename</var>.xml</file> file:</p>
 
-<code><![CDATA[
+<code mime="application/xml"><![CDATA[
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd">
 <wallpapers>
@@ -112,7 +112,7 @@
   <p>See the following example with two <code>&lt;wallpaper&gt;</code> elements,
   adding two different backgrounds:</p>
 
-<code><![CDATA[
+<code mime="application/xml"><![CDATA[
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd">
 <wallpapers>
diff --git a/system-admin-guide/C/dconf-profiles.page b/system-admin-guide/C/dconf-profiles.page
index e42c2a5d..b7dc2338 100644
--- a/system-admin-guide/C/dconf-profiles.page
+++ b/system-admin-guide/C/dconf-profiles.page
@@ -7,7 +7,7 @@
     <link type="guide" xref="setup" />
     <link type="seealso" xref="dconf-custom-defaults" />
     <link type="seealso" xref="dconf" />
-    <revision pkgversion="3.30" date="2019-02-08" status="incomplete"/>
+    <revision pkgversion="3.30" date="2019-02-22" status="incomplete"/>
 
     <credit type="author copyright">
       <name>Ryan Lortie</name>
@@ -59,8 +59,8 @@
       <title>Sample profile</title>
 <code its:translate="no">
 user-db:user
-system-db:<input>local</input>
-system-db:<input>site</input>
+system-db:<var>local</var>
+system-db:<var>site</var>
 </code>
     </listing>
   </example>
@@ -68,12 +68,25 @@ system-db:<input>site</input>
   <!-- TODO: explain the profile syntax (maybe new page) -->
   <!--TODO: explain local and site -->
 
+  <p>Configuring a single user and multiple system databases allows for layering
+  of preferences. Settings from the <code>user</code> database file take
+  precedence over the settings in the <code>local</code> database file, and the
+  <code>local</code> database file in turn takes precedence over the
+  <code>site</code> database file.</p>
+
+  <p>However, the order of precedence for <link xref="dconf-lockdown">locks</link>
+  is reversed. Locks introduced in the <code>site</code> or <code>local</code>
+  database files take priority over those present in <code>user</code>.</p>
+
   <note style="important">
   <p>The <sys>dconf</sys> profile for a session is determined at login, so users
   will have to log out and log in to apply a new <sys>dconf</sys> user profile
   to their session.</p>
   </note>
 
+  <p>For more information, see the <link its:translate="no" href="man:dconf(7)">
+  <cmd>dconf</cmd>(7)</link> man page.</p>
+
   <section id="dconf-profiles">
 
   <title>Select a profile</title>
@@ -88,6 +101,9 @@ system-db:<input>site</input>
   <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>For more information, see the <link its:translate="no" href="man:dconf(7)">
+  <cmd>dconf</cmd>(7)</link> man page.</p>
+
   </section>
 
 </page>
diff --git a/system-admin-guide/C/desktop-background.page b/system-admin-guide/C/desktop-background.page
index dc40a29c..3ea7ae86 100644
--- a/system-admin-guide/C/desktop-background.page
+++ b/system-admin-guide/C/desktop-background.page
@@ -5,6 +5,7 @@
 
   <info>
     <link type="guide" xref="appearance" />
+    <link type="seealso" xref="backgrounds-extra" />
     <revision pkgversion="3.11" date="2014-01-29" status="draft"/>
     <revision pkgversion="3.14" date="2014-06-17" status="incomplete">
       <desc>All prose and instructions are up to par. Extra info needs
diff --git a/system-admin-guide/C/desktop-favorite-applications.page 
b/system-admin-guide/C/desktop-favorite-applications.page
index 7a56b352..52c565ac 100644
--- a/system-admin-guide/C/desktop-favorite-applications.page
+++ b/system-admin-guide/C/desktop-favorite-applications.page
@@ -5,24 +5,29 @@
 
   <info>
     <link type="guide" xref="appearance"/>
-    <revision pkgversion="3.8" date="2013-04-28" status="draft"/>
+    <revision pkgversion="3.30" date="2019-02-22" status="review"/>
 
     <credit type="author">
       <name>Aruna Sankaranarayanan</name>
       <email>aruna evam gmail com</email>
     </credit>
+    <credit type="editor">
+      <name>Petr Kovar</name>
+      <email>pknbe volny cz</email>
+      <years>2019</years>
+    </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Customize the default favourites in the Activities overview.</desc>
+    <desc>Customize the default favorites in the Activities overview.</desc>
 
   </info>
 
-  <title>Default favorite applications</title>
+  <title>Set default favorite applications</title>
 
-  <p>Favorite applications are those visible on the
-  <link href="help:gnome-help/shell-terminology">dash</link>. You can use
-  <sys its:translate="no">dconf</sys> to set favorite applications
+  <p>Favorite applications are those visible on the GNOME Shell
+  <link href="help:gnome-help/shell-introduction#activities">dash</link>.
+  You can use <sys its:translate="no">dconf</sys> to set favorite applications
   for one user, or to set the same favorite applications
   for all users. For both cases, you must first edit the
   <sys its:translate="no">dconf</sys> profile found in
@@ -35,28 +40,25 @@
   their user database file found in
   <file its:translate="no">~/.config/dconf/user</file>. The following example
   snippet uses <sys its:translate="no">dconf</sys> to set <app>gedit</app>,
-  <app>Terminal</app> and <app>Nautilus</app> as default favorites for a user.
-  The example code allows users to modify the list later, if they wish to do
-  so.</p>
-
-  <!--The code itself need not be translated but the comments withing the
-  code have to be translated.-Aruna-->
+  <app>Terminal</app> and <app>Files</app> (<sys>nautilus</sys>) as default
+  favorites for a user. The example code allows users to modify the list later,
+  if they wish to do so.</p>
 
   <listing>
     <title>Contents of <file its:translate="no">/etc/dconf/profile</file>:</title>
-      <code>
-      #This line allows the user to change the default favorites later.
-      user-db:user
-      </code>
+<code its:translate="no">
+# <span its:translate="yes">This line allows the user to change the default favorites later</span>
+user-db:user
+</code>
   </listing>
 
   <listing>
     <title>Contents of <file its:translate="no">~/.config/dconf/user</file>:</title>
-      <code>
-      #Set gedit, terminal and nautilus as default favorites
-      [org/gnome/shell]
-      favorite-apps = [<input>'gedit.desktop'</input>, <input>'gnome-terminal.desktop'</input>, 
<input>'nautilus.desktop'</input>]
-      </code>
+<code its:translate="no">
+# <span its:translate="yes">Set gedit, terminal and nautilus as default favorites</span>
+[org/gnome/shell]
+favorite-apps = [<var>'gedit.desktop'</var>, <var>'gnome-terminal.desktop'</var>, 
<var>'nautilus.desktop'</var>]
+</code>
   </listing>
 
   <note style="tip">
@@ -71,45 +73,52 @@
 
   <p>In order to have the same favorites for all users, you must modify system
   database files using <link xref="dconf-keyfiles">dconf keyfiles</link>. The
-  following code snippets edit the <sys its:translate="no">dconf</sys> profile
+  following steps edit the <sys its:translate="no">dconf</sys> profile
   and then create a keyfile to set default favorite applications for all
-  employees in the first floor of an organization.</p>
-
-  <!--The code itself need not be translated but the comments within the
-  code have to be translated.-Aruna-->
-
-  <listing>
-    <title>Contents of <file its:translate="no">/etc/dconf/profile</file>:</title>
-      <code>
-      user-db:user
-
-      #This line defines a system database file called first_floor
-      system-db:first_floor
-      </code>
-  </listing>
-
-  <note style="info">
-    <p>Settings from the <code>user</code> database file
-    will take precedence over the settings in the
-    <code>first_floor</code> database file, but
-    <link xref="dconf-lockdown">locks</link> introduced in the
-    <code>first_floor</code> database file will take priority over
-    those present in <code>user</code>.</p>
-  </note>
-
-  <listing>
-    <title>Contents of <file 
its:translate="no">/etc/dconf/db/first_floor.d/00_floor1_settings</file>:</title>
-      <code>
-      # Snippet sets gedit, terminal and nautilus as default favorites
-      # for all users in the first floor
-
-      [org/gnome/shell]
-      favorite-apps = [<input>'gedit.desktop'</input>, <input>'gnome-terminal.desktop'</input>, 
<input>'nautilus.desktop'</input>]
-      </code>
-  </listing>
-
-    <p>Incorporate your changes into the system databases by running
-    <cmd>dconf update</cmd>.</p>
+  users in the <code>local</code> configuration database.</p>
+
+  <steps>
+    <title>Set the favorite applications</title>
+    <include href="dconf-snippets.xml"
+             xpointer="xpointer(/*/*[@xml:id='dconf-profile-user'])"
+             xmlns="http://www.w3.org/2001/XInclude"/>
+    <include href="dconf-snippets.xml"
+             xpointer="xpointer(/*/*[@xml:id='dconf-profile-user-dir'])"
+             xmlns="http://www.w3.org/2001/XInclude"/>
+    <item>
+      <p>Create the key file
+      <file>/etc/dconf/db/local.d/00-favorite-apps</file> to provide
+      information for the <sys>local</sys> database.</p>
+      <listing>
+      <title>Contents of
+      <file its:translate="no">/etc/dconf/db/local.d/00-favorite-apps</file>:
+      </title>
+<code>
+# Snippet sets gedit, terminal and nautilus as default favorites for all users
+[org/gnome/shell]
+favorite-apps = [<var>'gedit.desktop'</var>, <var>'gnome-terminal.desktop'</var>, 
<var>'nautilus.desktop'</var>]
+</code>
+      </listing>
+    </item>
+    <item>
+      <p>To prevent the user from overriding these settings, create the file
+      <file>/etc/dconf/db/local.d/locks/favorite-apps</file> with the following
+      content:</p>
+      <listing>
+      <title><file>/etc/dconf/db/local.db/locks/favorite-apps</file></title>
+<code>
+# Lock default favorite applications
+/org/gnome/shell/favorite-apps
+</code>
+      </listing>
+    </item>
+    <include href="dconf-snippets.xml"
+             xpointer="xpointer(/*/*[@xml:id='dconf-update'])"
+             xmlns="http://www.w3.org/2001/XInclude"/>
+    <include href="dconf-snippets.xml"
+             xpointer="xpointer(/*/*[@xml:id='dconf-logoutin'])"
+             xmlns="http://www.w3.org/2001/XInclude"/>
+  </steps>
 
 </section>
 
diff --git a/system-admin-guide/C/desktop-lockscreen.page b/system-admin-guide/C/desktop-lockscreen.page
index 7a7ed825..27767f70 100644
--- a/system-admin-guide/C/desktop-lockscreen.page
+++ b/system-admin-guide/C/desktop-lockscreen.page
@@ -29,10 +29,10 @@
     enter a password after being idle.</desc>
   </info>
 
-  <title>Lock the screen when user is idle</title>
+  <title>Lock the screen when the user is idle</title>
 
-  <p>You can make the screen lock automatically whenever a user
-  is idle for some amount of time. This is useful if your users
+  <p>You can make the screen lock automatically whenever the user
+  is idle for some amount of time. This is useful if users
   may leave their computers unattended in public or unsecure
   locations.</p>
 
diff --git a/system-admin-guide/C/index.page b/system-admin-guide/C/index.page
index 5e167fa5..592d9617 100644
--- a/system-admin-guide/C/index.page
+++ b/system-admin-guide/C/index.page
@@ -10,6 +10,7 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
     <desc>A guide for GNOME 3 system administrators</desc>
+
   </info>
 
   <title>GNOME System Administration Guide</title>
diff --git a/system-admin-guide/C/keyboard-layout.page b/system-admin-guide/C/keyboard-layout.page
index 3932653f..78b8dafe 100644
--- a/system-admin-guide/C/keyboard-layout.page
+++ b/system-admin-guide/C/keyboard-layout.page
@@ -86,15 +86,15 @@
       <p>Add the layout codes to
       <file>/usr/share/X11/xorg.conf.d/10-evdev.conf</file> in the following
       way:</p>
-      <screen>
-        Section "InputClass"
-          Identifier "evdev keyboard catchall"
-          MatchIsKeyboard "on"
-          MatchDevicePath "/dev/input/event*"
-          Driver "evdev"
-          <input>Option "XkbLayout" "en,fr"</input>
-        EndSection
-      </screen>
+<screen>
+Section "InputClass"
+  Identifier "evdev keyboard catchall"
+  MatchIsKeyboard "on"
+  MatchDevicePath "/dev/input/event*"
+  Driver "evdev"
+  <input>Option "XkbLayout" "en,fr"</input>
+EndSection
+</screen>
       <p>Multiple layouts can be added as a comma separated list, as shown in
       the example for English (<sys>en</sys>) and French (<sys>fr</sys>)
       layouts.</p>
diff --git a/system-admin-guide/C/lockdown-single-app-mode.page 
b/system-admin-guide/C/lockdown-single-app-mode.page
index ae370b0a..d967920e 100644
--- a/system-admin-guide/C/lockdown-single-app-mode.page
+++ b/system-admin-guide/C/lockdown-single-app-mode.page
@@ -5,11 +5,14 @@
      
   <info>
     <link type="guide" xref="user-settings#lockdown"/>
+    <link type="guide" xref="sundry#session"/>
     <link type="seealso" xref="lockdown-printing" />
     <link type="seealso" xref="lockdown-file-saving" />
     <link type="seealso" xref="lockdown-repartitioning" />
     <link type="seealso" xref="lockdown-command-line" />
     <link type="seealso" xref="login-automatic" />
+    <link type="seealso" xref="session-custom" />
+    <link type="seealso" xref="session-user" />
 
     <revision pkgversion="3.30" date="2019-02-08" status="review"/>
 
@@ -33,7 +36,7 @@
        
     <desc>Set up a kiosk-like, single-application system.</desc>
   </info>
-  
+
   <title>Configure single-application mode</title>
 
   <p>Single-application mode is a modified GNOME Shell which configures the
diff --git a/system-admin-guide/C/login-logo.page b/system-admin-guide/C/login-logo.page
index e979311d..2ebe80fc 100644
--- a/system-admin-guide/C/login-logo.page
+++ b/system-admin-guide/C/login-logo.page
@@ -5,6 +5,7 @@
 
   <info>
     <link type="guide" xref="login#appearance"/>
+    <link type="seealso" xref="login-banner"/>
     <!--<link type="seealso" xref="gdm-restart"/>-->
     <revision pkgversion="3.11" date="2014-01-29" status="draft"/>
 
diff --git a/system-admin-guide/C/login.page b/system-admin-guide/C/login.page
index cf0f0380..19f7e124 100644
--- a/system-admin-guide/C/login.page
+++ b/system-admin-guide/C/login.page
@@ -9,7 +9,7 @@
     <desc>
       <link xref="login-userlist-disable">Disable the user list</link>,
       <link xref="session-user">configure a user default session</link>,
-      <link xref="login-automatic">configure automatic login</link>…
+      <link xref="login-automatic">automatic login</link>…
     </desc>
 
   </info>
diff --git a/system-admin-guide/C/mime-types-application-user.page 
b/system-admin-guide/C/mime-types-application-user.page
index a17fc983..52d10452 100644
--- a/system-admin-guide/C/mime-types-application-user.page
+++ b/system-admin-guide/C/mime-types-application-user.page
@@ -8,13 +8,16 @@
     <link type="seealso" xref="mime-types-custom" />
     <revision pkgversion="3.30" date="2019-02-08" status="review"/>
 
-    <credit type="author">
+    <credit type="author copyright">
       <name>Petr Kovar</name>
       <email>pknbe volny cz</email>
+      <years>2014</years>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
+    <desc>Customize per user which application opens a specific MIME type.
+    </desc>
   </info>
 
     <title>Override the default registered application for individual users</title>
diff --git a/system-admin-guide/C/mime-types-application.page 
b/system-admin-guide/C/mime-types-application.page
index ce10b28f..c3375c08 100644
--- a/system-admin-guide/C/mime-types-application.page
+++ b/system-admin-guide/C/mime-types-application.page
@@ -9,13 +9,15 @@
     <link type="seealso" xref="mime-types-custom" />
     <revision pkgversion="3.30" date="2019-02-08" status="review"/>
 
-    <credit type="author">
+    <credit type="author copyright">
       <name>Petr Kovar</name>
       <email>pknbe volny cz</email>
+      <years>2014</years>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
+    <desc>Customize which application opens a specific MIME type.</desc>
   </info>
 
     <title>Override the default registered application for all users</title>
diff --git a/system-admin-guide/C/mime-types-custom-user.page 
b/system-admin-guide/C/mime-types-custom-user.page
index 4739ab16..b6e90771 100644
--- a/system-admin-guide/C/mime-types-custom-user.page
+++ b/system-admin-guide/C/mime-types-custom-user.page
@@ -7,13 +7,16 @@
     <link type="seealso" xref="mime-types" />
     <revision pkgversion="3.12" date="2014-06-17" status="review"/>
 
-    <credit type="author">
+    <credit type="author copyright">
       <name>Petr Kovar</name>
       <email>pknbe volny cz</email>
+      <years>2014</years>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
+    <desc>Create a user's MIME type specification and register a default
+    application.</desc>
   </info>
 
     <title>Add a custom MIME type for individual users</title>
diff --git a/system-admin-guide/C/mime-types-custom.page b/system-admin-guide/C/mime-types-custom.page
index 3c508d8f..592e7ff9 100644
--- a/system-admin-guide/C/mime-types-custom.page
+++ b/system-admin-guide/C/mime-types-custom.page
@@ -8,13 +8,16 @@
     <link type="seealso" xref="mime-types-custom-user" />
     <revision pkgversion="3.12" date="2014-06-17" status="review"/>
 
-    <credit type="author">
+    <credit type="author copyright">
       <name>Petr Kovar</name>
       <email>pknbe volny cz</email>
+      <years>2014</years>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
+    <desc>Create a MIME type specification and register a default
+    application.</desc>
   </info>
 
     <title>Add a custom MIME type for all users</title>
diff --git a/system-admin-guide/C/mime-types.page b/system-admin-guide/C/mime-types.page
index 87caf7ee..713fc2f7 100644
--- a/system-admin-guide/C/mime-types.page
+++ b/system-admin-guide/C/mime-types.page
@@ -9,9 +9,10 @@
     <link type="seealso" xref="mime-types-custom-user" />
     <revision pkgversion="3.12" date="2014-06-17" status="review"/>
 
-    <credit type="author">
+    <credit type="author copyright">
       <name>Petr Kovar</name>
       <email>pknbe volny cz</email>
+      <years>2014</years>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
diff --git a/system-admin-guide/C/network-printer-config.page 
b/system-admin-guide/C/network-printer-config.page
index ef1e04ee..60d3faa2 100644
--- a/system-admin-guide/C/network-printer-config.page
+++ b/system-admin-guide/C/network-printer-config.page
@@ -4,33 +4,33 @@
       id="network-printer-config">
 
   <info>
-   <link type="guide" xref="network" />
-   <revision pkgversion="3.8" date="2013-03-19" status="draft"/>
+    <link type="guide" xref="network" />
+    <revision pkgversion="3.30" date="2019-02-22" status="review"/>
 
     <credit type="author copyright">
       <name>Jana Svarova</name>
       <email>jana svarova gmail com</email>
       <years>2013</years>
     </credit>
+    <credit type="editor">
+      <name>Petr Kovar</name>
+      <email>pknbe volny cz</email>
+      <years>2019</years>
+    </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>How do I preconfigure my Samba printer</desc>
+    <desc>How do I configure a Samba printer?</desc>
   </info>
 
-  <title>Configure a printer</title>
-
-  <comment>
-    <cite date="2013-03-19" href="mailto:jsvarova gmail com">Jana Svarova</cite>
-    <p>Adapted from GNOME Bugzilla – Bug 694569</p>
-  </comment>
+  <title>Configure a network printer</title>
 
-  <p>This topic explains how to make printers, Windows printers in particular,
-  available in GNOME.</p>      
+  <p>This topic explains how to make network printers, Windows printers in
+  particular, available in GNOME.</p>
 
   <p>There is no preconfiguration needed for being able to install Samba 
-  printers using gnome-control-center. To add a new Samba printer to your CUPS 
-  (Common UNIX Printing System) server, simply follow the steps below.</p>
+  printers using <app>GNOME Settings</app>. To add a new Samba printer to your
+  CUPS (Common UNIX Printing System) server, simply follow the steps below.</p>
 
   <steps>
     <title>Configure your printer</title>
diff --git a/system-admin-guide/C/network.page b/system-admin-guide/C/network.page
index be9380bb..c347746e 100644
--- a/system-admin-guide/C/network.page
+++ b/system-admin-guide/C/network.page
@@ -9,11 +9,12 @@
 
     <desc>
       <link xref="network-server-list">Configure a default server list</link>,
-      <link xref="network-printer-config">configure a printer</link>,
+      <link xref="network-printer-config">a network printer</link>,
       <link xref="network-vpn">default VPN settings</link>…
     </desc>
 
   </info>
 
-  <title>Network &amp; Hardware</title>
+  <title>Network &amp; hardware</title>
+
 </page>
diff --git a/system-admin-guide/C/processes.page b/system-admin-guide/C/processes.page
index d29d1bdc..4afa5379 100644
--- a/system-admin-guide/C/processes.page
+++ b/system-admin-guide/C/processes.page
@@ -6,6 +6,7 @@
 
   <info>
     <link type="guide" xref="software#management" />
+    <link type="guide" xref="sundry#session"/>
     <revision pkgversion="3.12" date="2014-06-17" status="review"/>
 
     <credit type="author copyright">
diff --git a/system-admin-guide/C/setup.page b/system-admin-guide/C/setup.page
index e2fd86e7..1ba8c3bd 100644
--- a/system-admin-guide/C/setup.page
+++ b/system-admin-guide/C/setup.page
@@ -3,9 +3,13 @@
       id="setup">
 
   <info>
+
     <link type="guide" xref="index" group="#first"/>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>User and system settings management</desc>
+
   </info>
 
   <title>Setup</title>
diff --git a/system-admin-guide/C/software.page b/system-admin-guide/C/software.page
index e3f393da..7a6d0633 100644
--- a/system-admin-guide/C/software.page
+++ b/system-admin-guide/C/software.page
@@ -8,10 +8,9 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
     <desc>
-      <link xref="extensions">What are GNOME Shell extensions?</link>,
-      <link xref="mime-types">what are MIME types?</link>,
-      <link xref="mime-types-application">override the default registered
-      application for all users</link>…
+      <link xref="extensions">GNOME Shell extensions</link>,
+      <link xref="mime-types">MIME types</link>,
+      <link xref="mime-types-application">override default applications</link>…
     </desc>
 
   </info>
diff --git a/system-admin-guide/C/sundry.page b/system-admin-guide/C/sundry.page
index a18863e1..b6815602 100644
--- a/system-admin-guide/C/sundry.page
+++ b/system-admin-guide/C/sundry.page
@@ -3,9 +3,13 @@
       id="sundry">
 
   <info>
+
     <link type="guide" xref="index" group="#last"/>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Session management and troubleshooting</desc>
+
   </info>
 
   <title>Other</title>
diff --git a/system-admin-guide/C/user-settings.page b/system-admin-guide/C/user-settings.page
index 30bdcea6..52967f25 100644
--- a/system-admin-guide/C/user-settings.page
+++ b/system-admin-guide/C/user-settings.page
@@ -16,7 +16,7 @@
 
   </info>
 
-  <title>User Settings</title>
+  <title>User settings</title>
 
 <!--<section id="default">
   <title>Pre-seed user defaults</title>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]