From 01ce40b955f9ec9554fa488a8b4e0c307e5e1a31 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Burkhard=20L=C3=BCck?= <lueck@hube-lueck.de>
Date: Tue, 7 Nov 2017 11:01:42 +0100
Subject: [PATCH] Update okular docbook

add info about alternative method to delete an annotation
add info about resize feature for annotations (text modified from commit log)
replace outdated rating.png with new bookmarks.png
add info about available bookmark actions in the table of Contents

Differential Revision: https://phabricator.kde.org/D8677
---
 doc/bookmarks.png | Bin 0 -> 226 bytes
 doc/index.docbook |  17 ++++++++++++++---
 doc/rating.png    | Bin 744 -> 0 bytes
 3 files changed, 14 insertions(+), 3 deletions(-)
 create mode 100644 doc/bookmarks.png
 delete mode 100644 doc/rating.png

diff --git a/doc/bookmarks.png b/doc/bookmarks.png
new file mode 100644
index 0000000000000000000000000000000000000000..4919e970384c2cfbb852d28003b40b79e18f09b4
GIT binary patch
literal 226
zcmeAS@N?(olHy`uVBq!ia0vp^Vj#@H1|*Mc$*~4foCO|{#S9F5M?jcysy3fAP;iQ;
zi(`mI@7q2_p+g1&uK&|#bUre8Dkm+@JS)ujPFs~vOc75T^8wQXSKcIP8Srjlo2*{`
zf8Sq+)Rtgw!Hw}Omd`zpClzXLp7k}CEi~q6=pX)%zoHLR?+?6cd-AY_)#N=(rp#Nq
zJ1JT4<=Homn*y(fg+?<(8}IJ+*uTQ?q;$jT;&&3sHMMJY2^`9lXp?PNrm~)a;okik
WT`j>!FP(tyWAJqKb6Mw<&;$T+;#AQ9

literal 0
HcmV?d00001

diff --git a/doc/index.docbook b/doc/index.docbook
index 0d01a9f4f..3053c5821 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -34,7 +34,7 @@ Context menu actions like Rename Bookmarks etc.)
 			<!-- TRANS:ROLES_OF_TRANSLATORS -->
 		</authorgroup>
 		<legalnotice>&FDLNotice;</legalnotice>
-		<date>2017-10-02</date>
+		<date>2017-11-06</date>
 		<releaseinfo>1.3 (Applications 17.12)</releaseinfo>
 		<!-- Abstract about this handbook -->
 		<abstract>
@@ -775,7 +775,7 @@ Context menu actions like Rename Bookmarks etc.)
 				<title>Removing annotations</title>
 				<para>
 					To remove an annotation, just click on it with the &RMB;, and select
-					<guimenuitem>Delete</guimenuitem>.
+					<guimenuitem>Delete</guimenuitem> or select an annotation using the &LMB; and press the &Del; key.
 				</para>
 				<para>
 					When removing the annotation, its window will be closed if open.
@@ -810,6 +810,14 @@ Context menu actions like Rename Bookmarks etc.)
 					To move an annotation, hold down the &Ctrl; key, move the mouse pointer on it and
 					then start dragging with the &LMB;.
 				</para>
+				<para>If you click with the &LMB; on an annotation, it gets selected. Resize handles appear on the
+					selection rectangle. When the cursor is moved over one of the 8 resize handles on
+					the corners or edges, the cursor shape changes to indicate the resize mode. Click anywhere
+					else on the annotation to move it.
+					Pressing &Esc; or clicking an area outside the annotation cancels a selection.
+				</para>
+				<para>Resizing is only applicable for annotation types Inline Note, Stamp and Ellipse.</para>
+
 				<note>
 					<para>
 						Depending on the document permissions (typically with &PDF; documents), some options
@@ -850,7 +858,7 @@ Context menu actions like Rename Bookmarks etc.)
 				  The list pane permits to view the bookmark list in a tree-like fashion: each document in the list can be <quote>expanded</quote> or <quote>collapsed</quote> by clicking on the <guiicon>&lt;</guiicon> or <guiicon>v</guiicon> icon next to it.
 				</para>
 				<para>
-				  Click on <inlinemediaobject><imageobject><imagedata fileref="rating.png" format="PNG"/></imageobject></inlinemediaobject> icon below the list to show only the bookmarks from the current document.
+				  Click on <inlinemediaobject><imageobject><imagedata fileref="bookmarks.png" format="PNG"/></imageobject></inlinemediaobject> icon below the list to show only the bookmarks from the current document.
 				</para>
 				<para>
 				  Right-click menu of document item can be used to open document, rename its item or remove it from the list. Remember that the removal of a document item leads to the removal of all bookmarks in the corresponding document.
@@ -858,6 +866,9 @@ Context menu actions like Rename Bookmarks etc.)
 				<para>
 				  Right-click menus of individual bookmark items allow you to go to the bookmark, rename or remove it.
 				</para>
+				<para>
+				  The Right-click menu of items in the table of contents can be used to create bookmarks or go to the next or previous bookmark.
+				</para>
 		      </sect2>
 		</sect1>
 		<!-- Please keep this section content in sync with man page (man-okular.1.docbook) -->
diff --git a/doc/rating.png b/doc/rating.png
deleted file mode 100644
index 3630d8ff194e8fc8953bcb0d9dc75b85a33113bb..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 744
zcmV<E0vG*>P)<h;3K|Lk000e1NJLTq000mG000mO0{{R3C@l|D0004!P)t-s|NsB$
zvk&UD5agx>@X1W@%1z^^1>U9w;i?(osTkg-1=E}c*qR8~nhDdK2F{cO(U1hxmJ!&W
zA=;uP)t3^{j|9<?1I391)07q0n<K@E1ipX-#exRMg$lla1h;ns!F~wDgblZM1GsJi
z!-5UMf&#a30<&rYvu^^dV*#yc0j*{Mux<gYX8@{Z0Gn9=lT-kmUI4CY0h&wzsbvG2
zO#qER0F6KZnot0!WC5L00r&5R_wR=D&}sMPf$hOr_uYN>-hKDqeelR&^UG)V)Oq*Q
zcK6nH_}O;&+IINccK6tJ_ttsz%WLnvRQAbk_Rntj({A_IZur@5_}Xsx*lzdLZuik{
z@yKQIzf<?jX86%&_||6m*=G6MX8GD?_}FIn)M@g^RQJkR_|aVW*IfDBT>0Bm`PWGI
z%P{u05b&}R_qr1J#0vS%0Q%AZ`OpCP$N=@d0P(K^_qzc3%mDh@0Q=$q``-Zi(*X9!
z0QIZ@_q_o5(E#+^0P^4f{Okbu#{l%F0N9oQ)uRCS#sD%W^8^3@06TP2PE!EJ%8~v3
zmKgc^8xQ8@6h+VG`1tA8RVVlOE&}K21Qhr77eV^^MBd}*?CtOF^6c&O@3QW(92u<a
zxx$}qmjD0&%1J~)RCwBTjAvJY0T@7^7M1K|q|8K;8AbLcBO^p*7b;YQh7teU>Adeb
z<s98__kOtW9}A1KzO=l8`RmwK!`a&Uuj4k1CX*3QK#WKtQ_L2t&1R==(zXET42RR@
z_IQ0hum3#2WWhE&7z$rRqOn-~GLhWb1>kT~SLw|4&22W9=kb3g0%4(8D&O5#s(T`2
zyI*^Fe5yB^&tgE3yu7yBZ=G)M01eXjkI%3EpglZ9gKYGDBv&ZM6BQcNnqw`1?&MSt
abC?3Rt0d}&F$kmp0000<MNUMnLSTY`b%wqG