Update Okular documentation to version 0.15.

doc/index.docbook

@@ -36,8 +36,8 @@ Context menu actions like Rename Bookmarks etc)
 			<!-- TRANS:ROLES_OF_TRANSLATORS -->
 		</authorgroup>
 		<legalnotice>&FDLNotice;</legalnotice>
-		<date>2010-10-05</date>
+		<date>2012-06-18</date>
-		<releaseinfo>0.11.80 (&kde; 4.6)</releaseinfo>
+		<releaseinfo>0.15 (&kde; 4.9)</releaseinfo>
 		<!-- Abstract about this handbook -->
 		<abstract>
 			<para>&okular; is a &kde; universal document viewer based on &kpdf; code.</para>
@@ -369,6 +369,20 @@ Add a 'Find Previous' entry
 			<para>
 				Since &kde; 4.2, &okular; has the "document archiving" feature. This is an &okular;-specific format for carrying the document plus various metadata related to it (currently only annotations). You can save a "document archive" from the open document by choosing <menuchoice><guimenu>File</guimenu><guisubmenu>Export As</guisubmenu><guimenuitem>Document Archive</guimenuitem></menuchoice>. To open an &okular; document archive, just open it with &okular; as it would be &eg; a &PDF; document.
 			</para>
+			<para>
+			  Since &okular; 0.15 you can <emphasis>also</emphasis> save annotations directly into PDF files. This feature is only available if &okular; has been built with version 0.20 or later of <ulink url="http://poppler.freedesktop.org/">Poppler rendering library</ulink>. You can use <menuchoice><guimenu>File</guimenu> <guimenuitem>Save As...</guimenuitem></menuchoice> to save the copy of &PDF; file with annotations.
+			</para>
+				<note>
+					<para>
+						It is not possible to save annotations into &PDF; file if original file was encrypted.
+					</para>
+				</note>
+				<note>
+				  <para>
+				    If you open a &PDF; with existing annotations, your annotation changes are not automatically saved in the internal local data folder, and you need to save the modified document (using <menuchoice><guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice>) before closing it. Should you forget to do this &okular; will show confirmation window that allows you to save the document.
+				  </para>
+				</note>
+
 				<note>
 					<para>
 						Due to DRM limitations (typically with &PDF; documents), adding, editing some properties
@@ -534,7 +548,7 @@ Add a 'Find Previous' entry
 						</menuchoice>
 					</term>
 					<listitem>
-					  <para><action>Save</action> the currently open file under a different name using the document backend. With the &PDF; backend (Poppler >= 0.8 required) it is possible to save the document with the changed values of the form fields. <!--Only useful for pdf? what happens with other formats/backends?--></para>
+					  <para><action>Save</action> the currently open file under a different name using the document backend. With the &PDF; backend (Poppler >= 0.8 required) it is possible to save the document with the changed values of the form fields.<!--Only useful for pdf? what happens with other formats/backends?--> It can be possible (provided that the data were not encrypted or secured using DRM) to save annotations with &PDF; files (Poppler >= 0.20 required).</para>
 					</listitem>
 				</varlistentry>
 
@@ -1332,6 +1346,14 @@ Add a 'Find Previous' entry
 							load, &etc;.</para>
 					</listitem>
 				</varlistentry>
+				<varlistentry>
+					<term><guilabel>Display document title in title bar</guilabel></term>
+					<listitem>
+						<para>Whether to show the current document title in the title bar of &okular; window. If no metadata for title
+						found in the document or this item is unchecked &okular; shows filename of the document.
+						</para>
+					</listitem>
+				</varlistentry>
 				<varlistentry>
 					<term><guilabel>Obey DRM limitations</guilabel></term>
 					<listitem>
@@ -1368,7 +1390,15 @@ Add a 'Find Previous' entry
 					<term><guilabel>Overview columns</guilabel></term>
 					<listitem>
 						<para>
-							This options represent the number of columns to use in the overview mode.
+							This option represents the number of columns to use in the overview mode.
+						</para>
+					</listitem>
+				</varlistentry>
+				<varlistentry>
+					<term><guilabel>Page Up/Down overlap</guilabel></term>
+					<listitem>
+						<para>
+						  Here you can define the percentage of the current viewing area that should be visible after pressing <keycap>Page Up</keycap>/<keycap>Page Down</keycap> keys.
 						</para>
 					</listitem>
 				</varlistentry>
@@ -1454,7 +1484,8 @@ Add a 'Find Previous' entry
 						<para>&okular; can achieve best performance by tuning the memory usage, based on your system and your tastes.
 							The more memory you let it to use, the faster the program will behave. The Default profile is good
 							for every system, but you can prevent &okular; from using more memory than necessary by selecting the Low
-							profile, or let it get the most out of your system using Aggressive.</para>
+							profile, or let it get the most out of your system using Aggressive. Use Greedy profile to preload all
+							pages without risk of system memory overfull (only 50% of total memory or free memory will be used).</para>
 					</listitem>
 				</varlistentry>
 			</variablelist>
@@ -1505,6 +1536,12 @@ Add a 'Find Previous' entry
 						<para>Whether to show a summary page at the beginning of the presentation with the title, author and number of pages of the document.</para>
 					</listitem>
 				</varlistentry>
+				<varlistentry>
+					<term><guilabel>Enable transitions</guilabel></term>
+					<listitem>
+						<para>Use this checkbox to enable or disable transition effects between pages.</para>
+					</listitem>
+				</varlistentry>
 				<varlistentry>
 					<term><guilabel>Default transition</guilabel></term>
 					<listitem>