[gnome-user-docs] Update fonts*.page

[Petr Kovář <pmkovar src gnome org>]

commit e49d509d9933b1f8b305fc7618a7564dd8da1c88
Author: Petr Kovar <pkovar redhat com>
Date:   Wed Jan 29 19:09:37 2014 +0000

    Update fonts*.page

 system-admin-guide/C/fonts-user.page       |   56 ++++++++++++++++++++++++++++
 system-admin-guide/C/fonts.page            |   37 ++++++++++++++----
 system-admin-guide/C/login-background.page |    3 +-
 system-admin-guide/C/login-banner.page     |   20 ++++-----
 system-admin-guide/Makefile.am             |    1 +
 5 files changed, 95 insertions(+), 22 deletions(-)
---
diff --git a/system-admin-guide/C/fonts-user.page b/system-admin-guide/C/fonts-user.page
new file mode 100644
index 0000000..0c8723a
--- /dev/null
+++ b/system-admin-guide/C/fonts-user.page
@@ -0,0 +1,56 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="fonts-user">
+
+  <info>
+    <link type="guide" xref="index#appearance" />
+    <link type="seealso" xref="fonts"/>
+    <revision pkgversion="3.11" date="2014-01-29" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Matthias Clasen</name>
+      <email>matthias clasen gmail com</email>
+      <years>2012</years>
+    </credit>
+    <credit type="editor">
+      <name>Jana Svarova</name>
+      <email>jana svarova gmail com</email>
+      <years>2013</years>
+    </credit>
+    <credit type="author copyright">
+      <name>Ekaterina Gerasimova</name>
+      <email its:translate="no">kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
+    <credit type="editor">
+      <name>Petr Kovar</name>
+      <email its:translate="no">pknbe volny cz</email>
+      <years>2014</years>
+    </credit>
+
+    <desc>Add extra fonts for individual users.</desc>
+  </info>
+
+  <title>Add an extra font for individual users</title>
+
+  <p>You can install an extra font which will be available to a specific user
+  on your system in applications that use <sys>fontconfig</sys> for
+  font handling.</p>
+
+  <steps>
+    <title>Install an extra font</title>
+    <item>
+      <p>Copy the font to the <file>~/.local/share/fonts/</file>
+      directory to install it.</p>
+    </item>
+    <item>
+      <p>You may need to run the following command to update the font cache:</p>
+      <screen><output>$ </output><input>fc-cache ~/.local/share/fonts</input></screen>
+    </item>
+  </steps>
+
+  <p>You may need to restart running applications to see the changes. User
+  sessions do not need to be restarted.</p>
+
+</page>
diff --git a/system-admin-guide/C/fonts.page b/system-admin-guide/C/fonts.page
index cae39ea..721b5f1 100644
--- a/system-admin-guide/C/fonts.page
+++ b/system-admin-guide/C/fonts.page
@@ -5,7 +5,8 @@
 
   <info>
     <link type="guide" xref="index#appearance" />
-    <revision pkgversion="3.8" date="2013-08-11" status="review"/>
+    <link type="seealso" xref="fonts-user"/>
+    <revision pkgversion="3.11" date="2014-01-29" status="draft"/>
 
     <credit type="author copyright">
       <name>Matthias Clasen</name>
@@ -22,11 +23,16 @@
       <email its:translate="no">kittykat3756 gmail com</email>
       <years>2013</years>
     </credit>
+    <credit type="editor">
+      <name>Petr Kovar</name>
+      <email its:translate="no">pknbe volny cz</email>
+      <years>2014</years>
+    </credit>
 
-    <desc>Add extra fonts for all users</desc>
+    <desc>Add extra fonts for all users.</desc>
   </info>
 
-  <title>Add an extra font</title>
+  <title>Add an extra font for all users</title>
 
   <comment>
     <cite date="2013-08-11">Kat</cite>
@@ -34,21 +40,34 @@
     /usr/local/share/fonts is the correct place for fonts to go into.</p>
   </comment>
 
-  <p>You can install a new font which will be available to users through
+  <p>You can install an extra font which will be available to users in
   applications that use <sys>fontconfig</sys> for font handling.</p>
 
   <steps>
-    <title>Install a font</title>
+    <title>Install an extra font</title>
     <item>
-      <p>Copy the font to <file>/usr/local/share/fonts/</file> to install
-      it.</p>
+      <p>Copy the font to the <file>/usr/local/share/fonts/</file>
+      directory to install it.</p>
     </item>
     <item>
-      <p>You may need to run <cmd>fc-cache</cmd> to update the font cache.</p>
+      <p>You may need to run the following command to update the font cache:</p>
+      <screen><output>$ </output><input>fc-cache /usr/local/share/fonts/</input></screen>
     </item>
   </steps>
 
-  <p>Running applications must be restarted to see the changes, while user
+  <p>You may need to restart running applications to see the changes. User
   sessions do not need to be restarted.</p>
+  
+  <p>Alternatively, you can also install fonts in another system directory than
+    <file>/usr/local/share/fonts/</file> if that directory is listed in the
+    <file>/etc/fonts/fonts.conf</file> file. If it is not, then you need
+    to create your own machine-wide configuration file in
+    <file>/etc/fonts/local.conf</file> containing the directory you
+    want to use. See the <cmd>fonts-conf</cmd>(5) man page for more
+    information.</p>
+  <p>If you are using an alternative directory, remember to specify
+    the directory name when updating the font cache with the <cmd>fc-cache</cmd>
+    command:</p>
+  <screen><output>$ </output><input>fc-cache <var>directory_name</var></input></screen>
 
 </page>
diff --git a/system-admin-guide/C/login-background.page b/system-admin-guide/C/login-background.page
index 16d8728..cb07174 100644
--- a/system-admin-guide/C/login-background.page
+++ b/system-admin-guide/C/login-background.page
@@ -57,8 +57,7 @@ picture-uri='file://<var>/opt/corp/background.jpg</var>'</code>
   the image file you want to use as the login screen background.</p>
   </item>
   <item><p>Update the system databases:</p>
-  <screen>
-<output># </output><input>dconf update</input></screen>
+  <screen><output># </output><input>dconf update</input></screen>
   </item>
 </steps>
 
diff --git a/system-admin-guide/C/login-banner.page b/system-admin-guide/C/login-banner.page
index c121edb..c1961be 100644
--- a/system-admin-guide/C/login-banner.page
+++ b/system-admin-guide/C/login-banner.page
@@ -30,7 +30,9 @@
       <years>2013</years>
     </credit>
 
-    <desc>Edit a <sys its:translate="no">GDM</sys> <sys its:translate="no">dconf</sys> profile to display a 
text banner on the login screen.</desc>
+    <desc>Edit a <sys its:translate="no">GDM</sys>
+    <sys its:translate="no">dconf</sys> profile to display a text banner on the
+    login screen.</desc>
   </info>
 
   <title>Display a text banner on the login screen</title>
@@ -65,13 +67,14 @@ banner-message-enable=true
 banner-message-text='<input its:translate="yes">Type the banner message here.</input>'
 </screen>
   </item>
-  <item><p>Run the <cmd its:translate="no">dconf update</cmd> command.</p></item>
+  <item><p>Update the system databases:</p>
+  <screen><output># </output><input>dconf update</input></screen>
+  </item>
 </steps>
 
 <note>
-  <p><sys its:translate="no">dconf</sys>
-  <!--<link xref="dconf-keyfiles">-->keyfiles<!--</link>--> are slightly
-  different from <sys its:translate="no">GSettings</sys> override files.</p>
+  <p>You should keep the banner message reasonably short as longer texts do not
+  fit in the screen.</p>
 </note>
 
 <section id="troubleshooting-banner">
@@ -80,12 +83,7 @@ banner-message-text='<input its:translate="yes">Type the banner message here.</i
   <cmd>dconf update</cmd> command.</p>
   <p>In case the banner message does not update, try restarting
   <sys>GDM</sys>. For more information see
-  <link xref="gdm-restart">Restart GDM</link>.</p>
-
+  <link xref="gdm-restart"/>.</p>
 
-<note>
-  <p>You should keep the banner message reasonably short as longer texts do not
-  fit in the screen.</p>
-</note>
 </section>
 </page>
diff --git a/system-admin-guide/Makefile.am b/system-admin-guide/Makefile.am
index 36167cd..8410758 100644
--- a/system-admin-guide/Makefile.am
+++ b/system-admin-guide/Makefile.am
@@ -20,6 +20,7 @@ HELP_FILES = \
        extensions-lockdown.page        \
        extensions-mandatory.page       \
        extensions.page                 \
+       fonts-user.page         \
        fonts.page                      \
        index.page                      \
        keyboard-layout.page            \