[gnome-photos/help] help: New help for Photos

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 0f25b5a0881e8baf4ec2cd187246fd41441d675d
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Thu Mar 13 12:39:36 2014 +0530

    help: New help for Photos
    
    Add index.page - Index
    Add the legal.xml file - CC-by-SA 3.0 Unported license
    Add the guide page to view photos
    ->Sub pages
        - view photos from an album
        - view favourites.
    
    Also add changes after Kat's review, so link the view-favorites page to
    the favorites page.

 help/C/favorites-set.page  |   51 ++++++++++++++++++++++++++++++++++++++++++++
 help/C/favorites.page      |   29 +++++++++++++++++++++++++
 help/C/index.page          |   24 ++++++++++++++++++++
 help/C/legal.xml           |    8 +++++++
 help/C/view-album.page     |   40 ++++++++++++++++++++++++++++++++++
 help/C/view-favorites.page |   40 ++++++++++++++++++++++++++++++++++
 help/C/view.page           |   31 ++++++++++++++++++++++++++
 help/Makefile.am           |    9 +++++++-
 8 files changed, 231 insertions(+), 1 deletions(-)
---
diff --git a/help/C/favorites-set.page b/help/C/favorites-set.page
new file mode 100644
index 0000000..f2411ee
--- /dev/null
+++ b/help/C/favorites-set.page
@@ -0,0 +1,51 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="favorites-set">
+
+  <info>
+    <link type="guide" xref="favorites"/>
+
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Pick favorites from <app>Photos</app>.</desc>
+  </info>
+
+  <title>Tag your favorites</title>
+
+  <p>Photos or albums can be marked as favorites from the
+  <gui style="tab">Recent</gui> tab or <gui style="tab">Albums</gui> tab.</p>
+
+  <steps>
+  <title>To label favorite items:</title>
+    <item>
+      <p>Select the <gui>Albums</gui> tab or <gui>Recent</gui> tab depending on
+      whether you want to mark an album or a photo as a favorite.</p>
+    </item>
+    <item>
+      <p><link xref="selection-mode-toggle#on">Switch on</link> the selection
+      mode.</p>
+    </item>
+    <item>
+      <p><link xref="selection-mode-how">Select</link> all the items you want
+      to favorite.</p>
+    </item>
+    <item>
+      <p>To finish, select the button with the picture of a heart from the
+      toolbar at the bottom.</p>
+    </item>
+  </steps>
+
+  <p>Your favorite items can now be found in the <gui>Favorites</gui> tab.</p>
+
+</page>
diff --git a/help/C/favorites.page b/help/C/favorites.page
new file mode 100644
index 0000000..9f2b4cd
--- /dev/null
+++ b/help/C/favorites.page
@@ -0,0 +1,29 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="guide" style="task"
+       id="favorites">
+
+  <info>
+    <link type="guide" xref="index"/>
+
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Tag a special image or album as a favorite.</desc>
+
+  </info>
+
+  <title>Favorite photos</title>
+    <p>You can label photos or images that you particularly like as favorites to
+    store them for easy access in the <gui>Favorites</gui> tab.</p>
+
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..daaacc5
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="guide" style="2column"
+       id="index">
+
+  <info>
+    <revision pkgversion="3.8" date="2014-03-25" status="review"/>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <title type="text">Photos</title>
+
+    <desc><app>Photos</app> is a personalised photo manager tool from
+    GNOME.</desc>
+  </info>
+
+   <title>Photos</title>
+
+   <p><app>Photos</app> can be used to organise and manage your images in an
+   engaging and personalized manner. In addition to creating albums out of
+   images on your computer, you can integrate your Facebook and Flickr albums
+   with <app>Photos</app>. You can also set photos you like as your desktop
+   wallpaper, or easily bookmark them as favorites.</p>
+
+</page>
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000..aa36246
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,8 @@
+<license xmlns="http://projectmallard.org/1.0/";
+         href="http://creativecommons.org/licenses/by-sa/3.0/";>
+
+  <p>This work is licensed under a
+  <link href="http://creativecommons.org/licenses/by-sa/3.0/";>Creative Commons
+  Attribution-ShareAlike 3.0 Unported License</link>.</p>
+
+</license>
diff --git a/help/C/view-album.page b/help/C/view-album.page
new file mode 100644
index 0000000..8510956
--- /dev/null
+++ b/help/C/view-album.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="view-album">
+
+  <info>
+    <link type="guide" xref="view"/>
+
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Open a photo from your albums.</desc>
+  </info>
+
+  <title>View photos from an album</title>
+  <p>To open a photo located in a specific album:</p>
+
+  <steps>
+    <item>
+      <p>Select the <gui style="tab">Albums</gui> tab.</p>
+    </item>
+    <item>
+      <p>Select the album which contains the photo.</p>
+    </item>
+    <item>
+      <p>You will see a grid of photos from the album you selected. Select a
+      photo from the grid to open it. </p>
+    </item>
+  </steps>
+
+</page>
diff --git a/help/C/view-favorites.page b/help/C/view-favorites.page
new file mode 100644
index 0000000..351db8e
--- /dev/null
+++ b/help/C/view-favorites.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="view-favorites">
+
+  <info>
+    <link type="guide" xref="view"/>
+    <link type="seealso" xref="favorites"/>
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Open your favorite photos.</desc>
+  </info>
+
+  <title>View photos marked as favorites.</title>
+
+  <p>Your <link xref="favorites">favorite</link> photos are located in the
+  <gui>Favorites</gui> tab.</p>
+
+  <steps>
+  <title>To open a photo tagged as a favorite:</title>
+    <item>
+      <p>Select the <gui style="tab">Favorites</gui> tab.</p>
+    </item>
+    <item>
+      <p>Select photo you want to open, or use the arrow keys to navigate to
+      the photo and press <key>Enter</key>.</p>
+    </item>
+  </steps>
+
+</page>
diff --git a/help/C/view.page b/help/C/view.page
new file mode 100644
index 0000000..f8f37f0
--- /dev/null
+++ b/help/C/view.page
@@ -0,0 +1,31 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="guide" style="task"
+       id="view">
+
+  <info>
+    <link type="guide" xref="index"/>
+
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Open a photo for viewing.</desc>
+  </info>
+
+  <title>View images</title>
+
+  <p>When <app>Photos</app> is opened, you will see the <gui>Recent</gui> tab
+  open. The <gui>Recent</gui> tab contains images from your computer, the
+  <gui>Albums</gui> tab contains your photo albums, and any image you mark as a
+  favourite can be found in the <gui>Favorites</gui> tab.</p>
+
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index 859332d..c11a4e6 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -2,7 +2,14 @@
 
 HELP_ID = gnome-photos
 
-HELP_FILES = 
+HELP_FILES = \
+        favorites.page \
+        favorites-set.page \
+        index.page \
+        legal.xml \
+        view-album.page \
+        view-favorites.page \
+        view.page
 
 HELP_MEDIA =