[kde-doc-english] [okular] doc: Document the new trim mode

[Yuri Chornoivan]

Git commit 0438c5a3f6394d89f99a7cca7e4c93399012cb87 by Yuri Chornoivan.
Committed on 29/08/2015 at 13:17.
Pushed by yurchor into branch 'master'.

Document the new trim mode

M  +16   -4    doc/index.docbook

http://commits.kde.org/okular/0438c5a3f6394d89f99a7cca7e4c93399012cb87

diff --git a/doc/index.docbook b/doc/index.docbook
index 1896af3..9cfa303 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -37,8 +37,8 @@ Context menu actions like Rename Bookmarks etc.)
 			<!-- TRANS:ROLES_OF_TRANSLATORS -->
 		</authorgroup>
 		<legalnotice>&FDLNotice;</legalnotice>
-		<date>2014-02-25</date>
-		<releaseinfo>0.19 (&kde; 4.13)</releaseinfo>
+		<date>2015-08-29</date>
+		<releaseinfo>0.24 (Applications 15.12)</releaseinfo>
 		<!-- Abstract about this handbook -->
 		<abstract>
 			<para>&okular; is a &kde; universal document viewer based on &kpdf; code.</para>
@@ -1421,12 +1421,24 @@ Context menu actions like Rename Bookmarks etc.)
 					<term>
 						<menuchoice>
 							<guimenu>View</guimenu>
-							<guimenuitem>Trim Margins</guimenuitem>
+							<guisubmenu>Trim View</guisubmenu>
 						</menuchoice>
 					</term>
 					<listitem>
 						<para>
-							Remove the white border of pages when viewing pages.
+						  This submenu allows you to remove the white border of pages when viewing pages (<guimenuitem>Trim Margins</guimenuitem> item) or trim viewport to selection (<guimenuitem>Trim To Selection</guimenuitem> item).
+						</para>
+						<para>
+						  The <quote>trim to selection</quote> mode allows you to draw a selection over the rendered page in order to define a visible bounding box to be applied to <emphasis>all pages</emphasis> in the document. Selecting a small trim bounding box enforces minimum dimensions size (20% as a percentage of total page size).
+						</para>
+						<para>
+						  The <quote>trim margins</quote> mode is persistent across &okular; restarts. The <quote>trim to selection</quote> mode is forgotten across &okular; restarts.
+						</para>
+						<para>
+						  When you switch &okular; from <quote>trim margins</quote> mode to <quote>trim to selection</quote> mode, the view jumps out of <quote>trim margins</quote> mode for the bounding box selection interaction.
+						</para>
+						<para>
+						  The trim mode can be deactivated by selecting the same menu item that activates it once again.
 						</para>
 					</listitem>
 				</varlistentry>