[Xfce4-commits] <xfce4-docs:ristretto-master> Update getting-started & add preferences.page

[Stephan Arts]

Updating branch refs/heads/ristretto-master
         to a17bfec839b4facf51b4f409c2396b891c7dc2c4 (commit)
       from a1aa3372d6ca30a515ebbd9e2a06d5120c80a85e (commit)

commit a17bfec839b4facf51b4f409c2396b891c7dc2c4
Author: Stephan Arts <stephan at xfce.org>
Date:   Sun Oct 30 01:37:06 2011 +0200

    Update getting-started & add preferences.page

 manual/Makefile.am          |    3 ++-
 manual/getting-started.page |   37 +++++++++++++++++++++++++++++++++++++
 manual/index.page           |    2 --
 manual/preferences.page     |   23 +++++++++++++++++++++++
 4 files changed, 62 insertions(+), 3 deletions(-)

diff --git a/manual/Makefile.am b/manual/Makefile.am
index 2a2f895..082cd9b 100644
--- a/manual/Makefile.am
+++ b/manual/Makefile.am
@@ -4,7 +4,8 @@ SUBDIRS = \
 
 MALLARD_PAGES = \
 	index.page \
-    getting-started.page
+    getting-started.page \
+    preferences.page
 
 LINGUAS = $(shell cd $(srcdir)/po && echo `/bin/ls *.po | sed 's,[.]po,,g'`)
 ALL_LINGUAS = C $(LINGUAS)
diff --git a/manual/getting-started.page b/manual/getting-started.page
index 4c7b8b1..455df6e 100644
--- a/manual/getting-started.page
+++ b/manual/getting-started.page
@@ -103,4 +103,41 @@
         </note>
         </section>
     </section>
+    <section>
+    <title>Switching between images</title>
+    <p>
+    When an image is opened in <app>Ristretto</app>, it shows a list of
+    images in the <gui>Thumbnailbar</gui>, these are the other images
+    located inside the same folder as the currently opened image. The
+    arrow-buttons on the <gui>navigation toolbar</gui> allow for easy
+    switching between different images.
+    </p>
+    <p>
+    Also, using the scroll-wheel on the opened image, or on the
+    <gui>Thumbnailbar</gui> will switch to the next or previous image.
+    Allowing for fast and easy navigation between images.
+    </p>
+    <section>
+    <title>Slideshow</title>
+    <p>
+    To run a slideshow of all the opened images, all you need to do is
+    press the <gui>Play</gui> button. This can be found on the Toolbar
+    and the <gui>View</gui> menu.
+    </p>
+    <note style="tip">
+    <p>
+    The duration of the timeout before the next image is shown can be
+    configured inside the <gui>Preferences</gui> dialog, by default it
+    is set to 5 seconds.
+    </p>
+    </note>
+    <note style="tip">
+    <p>
+    When <gui>Wrap around images</gui> is disabled, the slideshow will stop at
+    the last image. To prevent this, enable the option 
+    <gui>Wrap around images</gui> in the <gui>Preferences Dialog</gui>.
+    </p>
+    </note>
+    </section>
+    </section>
 </page>
diff --git a/manual/index.page b/manual/index.page
index 6e5bbf0..8f1de00 100644
--- a/manual/index.page
+++ b/manual/index.page
@@ -28,9 +28,7 @@
         </p>
     </section>
 
-    <!--
     <section id="image-viewer" style="2column">
         <title>Image Viewer</title>
     </section>
-    -->
 </page>
diff --git a/manual/preferences.page b/manual/preferences.page
new file mode 100644
index 0000000..022653a
--- /dev/null
+++ b/manual/preferences.page
@@ -0,0 +1,23 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      xmlns:e="http://projectmallard.org/experimental/"
+      type="topic"
+      id="preferences">
+
+    <info>
+        <link type="guide" xref="index#image-viewer"/>
+        <desc><app>Image Viewer</app> Preferences</desc>
+        <credit type="author">
+        <name>Stephan Arts</name>
+        <email>stephan at xfce.org</email>
+        </credit>
+        <license>
+            <p>Creative Commons Share Alike 3.0</p>
+        </license>
+    </info>
+
+    <title>Preferences</title>
+    <section id="preferences">
+    <p>
+    </p>
+    </section>
+</page>