Git commit 91d4cc95b2d6dfa7a706ef226fc466a8a4301853 by Yuri Chornoivan.
Committed on 15/06/2013 at 17:43.
Pushed by yurchor into branch 'master'.

REVIEW: 111029

Additional bits of documentation proposed by Burkhard Lueck

M  +33   -7    doc/index.docbook

http://commits.kde.org/okular/91d4cc95b2d6dfa7a706ef226fc466a8a4301853

diff --git a/doc/index.docbook b/doc/index.docbook
index bf9011c..432aee2 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -37,7 +37,7 @@ Context menu actions like Rename Bookmarks etc.)
                        <!-- TRANS:ROLES_OF_TRANSLATORS -->
                </authorgroup>
                <legalnotice>&FDLNotice;</legalnotice>
-               <date>2013-05-22</date>
+               <date>2013-06-14</date>
                <releaseinfo>0.17 (&kde; 4.11)</releaseinfo>
                <!-- Abstract about this handbook -->
                <abstract>
@@ -111,22 +111,26 @@ Context menu actions like Rename Bookmarks etc.)
                <sect1 id="navigating">
                        <title>Navigating</title>
                        <para>This section describes how you can navigate 
through a document in &okular;.</para>
-<!--
-Presentation mode: add Up (previous page) and Down (next page) keys
-Add a 'Find Previous' entry
--->
                        <para>
                                There are multiple ways of scrolling the 
viewing area. One is to use the
-                               <keycap>Up Arrow</keycap> and <keycap>Down 
Arrow</keycap> keys. You may also use
+                               <keysym>Up Arrow</keysym> and <keysym>Down 
Arrow</keysym> keys. You may also use
                                the scrollbar, your mousewheel or the 
<keycap>Page Up</keycap> and <keycap>Page Down</keycap>
                                keys.
                        </para>
                        <para>
+                         You can also use <application>vim</application>-like 
navigation keys, namely <keycap>H</keycap> to move to the top of the previous 
page, <keycap>L</keycap> to move to the top of the next page, 
<keycap>J</keycap> to move one line down, and <keycap>K</keycap> to move one 
line up.
+                       </para>
+                       <para>
                                Another way is to hold the &LMB; down at any 
place on the document while dragging the mouse in the
                                opposite direction of where you want to move. 
This procedure only works if the Browse Tool is
                                enabled, which you can select by choosing 
<menuchoice><guimenu>Tools</guimenu>
                                <guimenuitem>Browse 
Tool</guimenuitem></menuchoice>.
                        </para>
+                       <note>
+                         <para>
+                           When viewing a document in the <link 
linkend="presentationMode">Presentation mode</link> use <keysym>Up 
Arrow</keysym> and <keysym>Down Arrow</keysym> keys to switch between pages or 
slides. The number and the position of the current slide will be shown in the 
overlay at the right upper corner of screen.
+                         </para>
+                       </note>
                        <para>If you want to read a document with several pages 
use the automatic scrolling feature of &okular;.
                        Start automatic scrolling with <keycombo 
action="simul">&Shift;<keysym>Down Arrow</keysym></keycombo> or
                        <keycombo action="simul">&Shift;<keysym>Up 
Arrow</keysym></keycombo>. Then use these keys to increase and
@@ -165,7 +169,7 @@ Add a 'Find Previous' entry
                                <listitem>
                                        <para>
                                                If the document has 
annotations, enable the <guilabel>Reviews</guilabel> view
-                                               and click the annotations or 
select them with the <keycap>Up Arrow</keycap> and <keycap>Down Arrow</keycap> 
keys and press <keycap>Return</keycap> to go to the associated page.
+                                               and click the annotations or 
select them with the <keysym>Up Arrow</keysym> and <keysym>Down Arrow</keysym> 
keys and press <keycap>Return</keycap> to go to the associated page.
                                        </para>
                                </listitem>
                        </itemizedlist>
@@ -176,6 +180,11 @@ Add a 'Find Previous' entry
                                For example, clicking on a link pointing to 
<quote>http://www.kde.org</quote>
                                will open the web page in the default &kde;'s 
web browser.
                        </para>
+                       <important>
+                         <para>
+                           The document internal links work only when <link 
linkend="menutools">Browse Tool</link> is used.
+                         </para>
+                       </important>
                        <para>
                                Additionally, you may use the following 
functionality to quickly move to specific places
                                in the document:
@@ -247,6 +256,23 @@ Add a 'Find Previous' entry
                                                </menuchoice> in the menubar.
                                        </para>
                                </listitem>
+                               <listitem>
+                                       <para>
+                                               You can go to the next match 
when searching using
+                                               <keycap>F3</keycap> key or
+                                               <menuchoice>
+                                                       <guimenu>Edit</guimenu>
+                                                       <guimenuitem>Find 
Next</guimenuitem>
+                                               </menuchoice>
+                                               menu item or move back to the 
previous match using
+                                               
<keycombo>&Shift;<keysym>F3</keysym></keycombo> keys or
+                                               <menuchoice>
+                                                       <guimenu>Edit</guimenu>
+                                                       <guimenuitem>Find 
Previous</guimenuitem>
+                                               </menuchoice>
+                                               menu item.
+                                       </para>
+                               </listitem>
                        </itemizedlist>
                </sect1>
                <sect1 id="presentationMode">

Reply via email to