[gnome-user-docs/wip/system-admin-guide: 37/38] Icons.page has been updated

[Jana Svarova <jsvarova src gnome org>]

commit 6cc3432dc7792b065c908b20d21010a53a7eb05e
Author: Jana Svarova <jsvarova redhat com>
Date:   Tue Jul 16 10:12:29 2013 +0200

    Icons.page has been updated

 system-admin-guide/C/icons.page |   52 +++++++++++++++++++++++++++++---------
 1 files changed, 39 insertions(+), 13 deletions(-)
---
diff --git a/system-admin-guide/C/icons.page b/system-admin-guide/C/icons.page
index f148a0b..3275650 100644
--- a/system-admin-guide/C/icons.page
+++ b/system-admin-guide/C/icons.page
@@ -11,7 +11,7 @@
 
     <revision pkgversion="3.8" date="2013-06-11" status="draft"/>
 
-    <credit type="author copyright">
+    <credit type="author">
       <name>Jana Svarova</name>
       <email>jana svarova gmail com</email>
       <years>2013</years>
@@ -22,19 +22,45 @@
 
 <title>Icons</title>
 
-  <p>Every application has an icon stored in </p>
-   /usr/share/pixmaps
-   /usr/share/icons/hicolor/scalable/apps/
-   /usr/share/icons/hicolor/48x48/apps/
-  The icons are typically stored as .png or 
-  
-  Best to read the freedesktop specification which tells you where application icons and icons themes should 
reside.
-  So when you install an app, where is the official location where the icons are stored for the app? 
-  
+  <p>An application icon is a small picture or symbol serving as a quick
+  representation of an application accessible on the system.</p>
+
+  <p>Concerning icons format, the supported image file types are PNG, XPM,
+  or SVG.</p>
+
+  <p>There are two ways an application icon is stored in the OS. You
+  either install an application with its own icons, or you are an application
+  author and want to install application icons which work in the KDE and
+  Gnome menus.</p>
+
 <note>
-  <p>Do not confuse application icons with icons for system-wide
-  themes (or <em>icon themes</em>), which are stored in the
-  <file>/usr/share/icons</file> file.</p>
+  <p>Do not confuse <em>application icons</em> with icons for system-wide themes
+  (<em>icon themes</em>), which are stored in the
+  <file>/usr/share/icons</file> directory.</p>
 </note>
 
+<section id="install-application">
+  <title>Install an application</title>
+
+  <p>When you install an application, icons are located to base directories.
+  Applications are stored in the <file>HOME/.icons</file>,
+  <file>XDG_DATA_DIRS/icons</file>, and <file>/usr/share/pixmaps</file>
+  directories (in that order) by default. Applications may further add their own
+  icon directories to this list. Users may extend or change the list
+  (in application/desktop specific ways).</p>
+
+</section>
+
+<section id="application-author">
+  <title>Being an application author</title>
+
+  <p>If you are an application author and want to install application icons,
+  you should install an icon with the size of 48x48 in the hicolor theme. 
+  Simply create a PNG file and store it in the
+  <file>prefix/share/icons/hicolor/48x48/apps</file> directory.
+  Alternatively, you can install icons in different sizes. For example, when you
+  install an SVG icon in the <file>prefix/share/icons/hicolor/scalable/apps</file>
+  directory, most desktops will be able to adjust the icon to work for all sizes.</p>
+</section>
+
 </page>