[okular] doc: Update okular docbook

Burkhard Lück null at kde.org
Tue Nov 7 10:02:47 UTC 2017


Git commit 01ce40b955f9ec9554fa488a8b4e0c307e5e1a31 by Burkhard Lück.
Committed on 07/11/2017 at 10:01.
Pushed by lueck into branch 'master'.

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

A  +-    --    doc/bookmarks.png
M  +14   -3    doc/index.docbook
D  +-    --    doc/rating.png

https://commits.kde.org/okular/01ce40b955f9ec9554fa488a8b4e0c307e5e1a31

diff --git a/doc/bookmarks.png b/doc/bookmarks.png
new file mode 100644
index 00000000..4919e970
Binary files /dev/null and b/doc/bookmarks.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
index 0d01a9f4..3053c582 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 ∇ 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><</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 3630d8ff..00000000
Binary files a/doc/rating.png and /dev/null differ


More information about the kde-doc-english mailing list