Add new image sizes, finish help

help/C/index.page

@@ -7,9 +7,9 @@
   <title type="text">Mugshot</title>
   <desc>The <app>Mugshot</app> help.</desc>
   <credit type="author">
-    <name>Your Name</name>
+    <name>Sean Davis</name>
-    <email>Your E-mail</email>
+    <email>smd.seandavis@gmail.com</email>
-    <years>2010</years>
+    <years>2013</years>
   </credit>
   <license href="http://creativecommons.org/licenses/by-sa/3.0/">
   <p>Creative Commons Attribution-Share Alike 3.0 Unported License</p>
@@ -23,7 +23,9 @@
 <app>Mugshot</app> Help
 </title>
 
-<p>This is an example guide page. It's main function is to link together the help topics.</p>
+<p>Welcome to the <app>Mugshot</app> help guide.  For a quick introduction into <app>Mugshot's</app> most basic features, visit the <link xref="mugshot-quickstart">Getting Started with Mugshot</link> page.</p>
+
+<p>Other help topics are grouped together into sections below.  Enjoy using <app>Mugshot</app>!</p>
 
 <!-- This is the visible index -->
 <section id="contents" style="2column">

help/C/mugshot-quickstart.page

@@ -0,0 +1,29 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic"
+      id="mugshot-quickstart">
+
+<info>
+  <link type="guide" xref="index#contents"/>
+  <link type="seealso" xref="mugshot-take-a-picture"/>
+  <credit type="author">
+    <name>Sean Davis</name>
+    <email>smd.seandavis@gmail.com</email>
+    <years>2013</years>
+  </credit>
+  <desc>Get started with Mugshot</desc>
+</info>
+
+<title>Getting Started</title>
+<p><app>Mugshot</app> is a lightweight user configuration utility. It allows you to quickly configure your profile image in Linux and Pidgin, as well as your user details for your Linux user and LibreOffice.</p>
+
+<media type="image" mime="image/png" src="figures/main.png"/>
+
+<p>Once <app>Mugshot</app> launches, enter your user details, <link xref="mugshot-take-a-picture">choose a profile image</link>, and click <gui>Apply</gui> to save your changes.</p>
+
+<p>If you've installed and regularly use Pidgin and/or LibreOffice, you will then be prompted to update your settings, but this is entirely up to you.</p>
+
+<media type="image" mime="image/png" src="figures/pidgin.png"/>
+
+<media type="image" mime="image/png" src="figures/libreoffice.png"/>
+
+</page>

help/C/mugshot-take-a-picture.page

@@ -0,0 +1,55 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic"
+      id="mugshot-take-a-picture">
+
+<info>
+  <link type="guide" xref="index#contents"/>
+  <link type="seealso" xref="mugshot-quickstart"/>
+  <credit type="author">
+    <name>Sean Davis</name>
+    <email>smd.seandavis@gmail.com</email>
+    <years>2013</years>
+  </credit>
+  <desc>Take a picture with Mugshot</desc>
+</info>
+
+<title>Taking a Picture</title>
+<p>One of the key features of <app>Mugshot</app> is the ability to easily choose a profile image, whether its from your camera (say "cheese!"), stock photos, or your picture library.</p>
+
+<media type="image" mime="image/png" src="figures/take_a_photo.png"/>
+
+<section id="stock-browser">
+<title>Using the Stock Browser</title>
+
+<p>If stock user images are installed (/usr/share/pixmaps/faces), the <gui>Select from stock...</gui> option will be available in the image menu. Click this menu item to continue.</p>
+
+<media type="image" mime="image/png" src="figures/stock_browser.png"/>
+
+<p>Each of the stock photos will be loaded into the browser.  Simply select the one you wish to use and click <gui>Apply</gui>. Note that the picture will not be saved until clicking the <gui>Apply</gui> button in the main application window.</p>
+
+</section>
+
+<section id="file-browser">
+<title>Using the File Browser</title>
+
+<p>The stock browser is your typical file chooser dialog, with the addition of a preview window and cropping options.  Since user images are square, <app>Mugshot</app> automatically crops images to the desired size.  You can crop left (aligning to the left side of the image), center (centering the image), or right (aligning to the right side of the image.</p>
+
+<media type="image" mime="image/png" src="figures/file_chooser.png"/>
+
+<p>Once you are happy with your selection and crop settings, click <gui>Apply</gui>. Note that the picture will not be saved until clicking the <gui>Apply</gui> button in the main application window.</p>
+
+</section>
+
+<section id="using-a-camera">
+<title>Using a Camera</title>
+
+<p>If your webcam is detected by Linux, and you have the necessary components installed (gstreamer1.0-plugins-good), the <gui>Capture from camera...</gui> option will be available in the image menu. Click this menu item to continue.</p>
+
+<media type="image" mime="image/png" src="figures/camera.png"/>
+
+<p>The camera will then initialize, and the <gui>Record</gui> button will become available once the camera is ready.  Simply click the record button to snap a photo.  Try to position yourself in the middle of the frame as the photo will be cropped to a square and center-aligned.</p>
+
+<p>If you'd like to try again, just click the <gui>Retry</gui> button.  Otherwise, click the <gui>Apply</gui> button to continue.  Note that the picture will not be saved until clicking the <gui>Apply</gui> button in the main application window.</p>
+</section>
+
+</page>

help/C/topic1.page

@@ -1,18 +0,0 @@
-<page xmlns="http://projectmallard.org/1.0/"
-      type="topic"
-      id="topic1">
-
-<info>
-  <link type="guide" xref="index#contents"/>
-  <credit type="author">
-    <name>Your Name</name>
-    <email>Your E-mail</email>
-    <years>2010</years>
-  </credit>
-  <desc>Optional short description of Topic 1 for contents page</desc>
-</info>
-
-<title>Topic 1</title>
-<p>This is an example topic page. It's main function is to describe one topic.</p>
-
-</page>

setup.py

@@ -53,7 +53,7 @@ def update_config(libdir, values = {}):
     
 def move_icon_file(root, target_data, prefix):
     old_icon_path = os.path.normpath(root + target_data + '/share/mugshot/media')
-    for icon_size in ['24x24', '48x48', '64x64', 'scalable']:
+    for icon_size in ['16x16', '22x22', '24x24', '48x48', '64x64', 'scalable']:
         if icon_size == 'scalable':
             old_icon_file = old_icon_path + '/mugshot.svg'
         else: