Git commit 3f8d9f760c9dbd5c4969e07805da25f0fde3f826 by Burkhard Lück.
Committed on 11/11/2016 at 14:26.
Pushed by lueck into branch 'master'.

Update/proofread Okular docbooks to kf5

remove entities kappname, package, PDF - unused or already defined in kdoctools
bum date + releaseinfo - is version 1.0 correct for 16.12?
add missing shortcuts
add 'Drawing Tool Configuration'
remove appendix installation
update man page - remove kde4 options + add qt5options+kf5options
REVIEW:129326

M  +16   -70   doc/index.docbook
M  +13   -60   doc/man-okular.1.docbook

http://commits.kde.org/okular/3f8d9f760c9dbd5c4969e07805da25f0fde3f826

diff --git a/doc/index.docbook b/doc/index.docbook
index 81eca45..9c8c4e1 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1,10 +1,7 @@
 <?xml version="1.0" ?>
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" 
"dtd/kdedbx45.dtd" [
-  <!ENTITY kappname "&okular;">
   <!ENTITY latex "L<superscript>A</superscript>T<subscript>E</subscript>X">
-  <!ENTITY package "kdegraphics">
   <!ENTITY kpdf "<application>KPDF</application>">
-  <!ENTITY PDF "<acronym>PDF</acronym>">
   <!ENTITY % English "INCLUDE">
   <!ENTITY % addindex "IGNORE">
 ]>
@@ -37,8 +34,8 @@ Context menu actions like Rename Bookmarks etc.)
                        <!-- TRANS:ROLES_OF_TRANSLATORS -->
                </authorgroup>
                <legalnotice>&FDLNotice;</legalnotice>
-               <date>2016-07-26</date>
-               <releaseinfo>0.26 (Applications 16.08)</releaseinfo>
+               <date>2016-11-04</date>
+               <releaseinfo>1.0 (Applications 16.12)</releaseinfo>
                <!-- Abstract about this handbook -->
                <abstract>
                        <para>&okular; is a &kde; universal document viewer 
based on &kpdf; code.</para>
@@ -889,42 +886,7 @@ Context menu actions like Rename Bookmarks etc.)
                        <variablelist>
                            <varlistentry>
                                <term><userinput><command>okular</command>
-                               <option>--help</option></userinput></term>
-                               <listitem><para>This lists the most basic 
options available at the command line.</para></listitem>
-                           </varlistentry>
-                           <varlistentry>
-                               <term><userinput><command>okular</command>
-                               <option>--help-qt</option></userinput></term>
-                               <listitem><para>This lists the options 
available for changing the way &okular; interacts with &Qt;.</para></listitem>
-                           </varlistentry>
-                           <varlistentry>
-                               <term><userinput><command>okular</command>
-                               <option>--help-kde</option></userinput></term>
-                               <listitem><para>This lists the options 
available for changing the way &okular; interacts with &kde;.</para></listitem>
-                           </varlistentry>
-                           <varlistentry>
-                               <term><userinput><command>okular</command>
-                               <option>--help-all</option></userinput></term>
-                               <listitem><para>This lists all of the command 
line options.</para></listitem>
-                           </varlistentry>
-                           <varlistentry>
-                               <term><userinput><command>okular</command>
-                               <option>--author</option></userinput></term>
-                               <listitem><para>Lists &okular;'s authors in the 
terminal window</para></listitem>
-                           </varlistentry>
-                           <varlistentry>
-                               <term><userinput><command>okular</command>
-                               <option>-v, 
--version</option></userinput></term>
-                               <listitem><para>Lists version information for 
&Qt;, &kde;, and &okular;. Also available through 
<userinput><command>okular</command> <option>-v</option></userinput> 
</para></listitem>
-                           </varlistentry>
-                           <varlistentry>
-                               <term><userinput><command>okular</command>
-                               <option>--license</option></userinput></term>
-                               <listitem><para>Shows license 
information.</para></listitem>
-                           </varlistentry>
-                           <varlistentry>
-                               <term><userinput><command>okular</command>
-                               <option>--page 
<replaceable>number</replaceable></option></userinput></term>
+                               <option>-p --page 
<replaceable>number</replaceable></option></userinput></term>
                                <listitem><para>Open a page with a given number 
in the document. Also available through <userinput><command>okular</command> 
<option>-p 
<replaceable>number</replaceable></option></userinput></para></listitem>
                            </varlistentry>
                            <varlistentry>
@@ -946,12 +908,7 @@ Context menu actions like Rename Bookmarks etc.)
                                <term><userinput><command>okular</command>
                                <option>--noraise</option></userinput></term>
                                <listitem><para>Allows to prevent &okular; 
window raising after the start.</para></listitem>
-                           </varlistentry>
-                           <varlistentry>
-                               <term><userinput><command>okular</command>
-                               <option>--</option></userinput></term>
-                               <listitem><para>End of 
options.</para></listitem>
-                           </varlistentry>
+                            </varlistentry>
                        </variablelist>
                    </sect2>
                </sect1>
@@ -1037,6 +994,9 @@ Context menu actions like Rename Bookmarks etc.)
                                <varlistentry>
                                        <term>
                                                <menuchoice>
+                                                       <shortcut>
+                                                       <keycombo 
action="simul">&Ctrl;<keycap>S</keycap></keycombo>
+                                                       </shortcut>
                                                        <guimenu>File</guimenu>
                                                        <guimenuitem>Save 
As...</guimenuitem>
                                                </menuchoice>
@@ -1054,6 +1014,9 @@ Context menu actions like Rename Bookmarks etc.)
                                <varlistentry>
                                        <term>
                                                <menuchoice>
+                                                       <shortcut>
+                                                       <keycombo 
action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo>
+                                                       </shortcut>
                                                        <guimenu>File</guimenu>
                                                        <guimenuitem>Save Copy 
As...</guimenuitem>
                                                </menuchoice>
@@ -2273,12 +2236,6 @@ Context menu actions like Rename Bookmarks etc.)
                                        </listitem>
                                </varlistentry>
                                <varlistentry>
-                                       <term><guilabel>Pencil 
color</guilabel></term>
-                                       <listitem>
-                                               <para>The color of the pencil 
used when drawing on the pages during the presentation mode.</para>
-                                       </listitem>
-                               </varlistentry>
-                               <varlistentry>
                                        <term><guilabel>Mouse 
cursor</guilabel></term>
                                        <listitem>
                                                <para>Whether the mouse should 
be always hidden, always shown or hidden after a small time of 
inactivity.</para>
@@ -2319,6 +2276,12 @@ Context menu actions like Rename Bookmarks etc.)
                                                <para><guilabel>Screen 
0</guilabel>, <guilabel>Screen 1</guilabel> &etc; are the available 
screens.</para>
                                        </listitem>
                                </varlistentry>
+                               <varlistentry>
+                                       <term><guilabel>Drawing Tool 
Configuration</guilabel></term>
+                                       <listitem>
+                                               <para>Manage the colors of the 
pencil used when drawing on the pages during the presentation mode.</para>
+                                       </listitem>
+                               </varlistentry>
                        </variablelist>
                </sect1>
                <sect1 id="configannotations">
@@ -2440,23 +2403,6 @@ Context menu actions like Rename Bookmarks etc.)
                &underGPL;
        </chapter>
 
-       <appendix id="installation">
-               <title>Installation</title>
-               <sect1 id="getting-kapp">
-                       <title>How to obtain &okular;</title>
-                       &install.intro.documentation;
-               </sect1>
-               <sect1 id="compilation">
-                       <title>Compilation and Installation</title>
-                       <note>
-                               <para>
-                                       If you are reading this help in the 
&khelpcenter;, &okular; has already been
-                                       installed on this system and you do not 
need install it anymore.
-                               </para>
-                       </note>
-                       &install.compile.documentation;
-               </sect1>
-       </appendix>
        &documentation.index;
 </book>
 
diff --git a/doc/man-okular.1.docbook b/doc/man-okular.1.docbook
index ecfda1e..4a374e6 100644
--- a/doc/man-okular.1.docbook
+++ b/doc/man-okular.1.docbook
@@ -6,12 +6,13 @@
 <!--  Please keep this man page content in sync with Command Line Options 
sections of Okular handbook -->
 <refentry lang="&language;">
 <refentryinfo>
-<title>KDE User's Manual</title>
+<title>Okular User's Manual</title>
 <author><firstname>Yuri</firstname><surname>Chornoivan</surname>
 <contrib>Okular man page.</contrib>
 <email>[email protected]</email></author>
-<date>2013-03-09</date>
-<productname>K Desktop Environment</productname>
+<date>2016-11-04</date>
+<releaseinfo>Okular 1.0</releaseinfo>
+<productname>KDE Applications</productname>
 </refentryinfo>
 
 <refmeta>
@@ -26,8 +27,7 @@
 <!-- body begins here -->
 <refsynopsisdiv id='synopsis'>
 <cmdsynopsis>
-  <command>okular</command>    <arg 
choice="opt"><replaceable>Qt-options</replaceable></arg>
-    <arg choice="opt"><replaceable>KDE-options</replaceable></arg>
+  <command>okular</command>
     <arg choice="opt"><replaceable>Okular options</replaceable></arg>
     <arg choice="opt"><replaceable>URL</replaceable></arg>
 </cmdsynopsis>
@@ -40,59 +40,6 @@ is aimed to show documents in different formats.</para>
 
 </refsect1>
 
-<refsect1 id="generic_options"><title>Generic Options</title>
-<variablelist>
-  <varlistentry>
-  <term><option>--help</option></term>
-  <listitem>
-<para>Show help about options.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--help-qt</option></term>
-  <listitem>
-<para>Show Qt specific options.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--help-kde</option></term>
-  <listitem>
-<para>Show KDE specific options.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--help-all</option></term>
-  <listitem>
-<para>Show all options.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--author</option></term>
-  <listitem>
-<para>Show author information.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>-v, --version</option></term>
-  <listitem>
-<para>Show version information.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--license</option></term>
-  <listitem>
-<para>Show license information.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--</option></term>
-  <listitem>
-<para>End of options.</para>
-  </listitem>
-  </varlistentry>
-</variablelist>
-</refsect1>
-
 <refsect1 id="options"><title>Okular options</title>
 <variablelist>
   <varlistentry>
@@ -145,11 +92,17 @@ is aimed to show documents in different formats.</para>
 
 <refsect1>
 <title>See Also</title>
-<para>More detailed user documentation is available from <ulink
+<simplelist>
+<member>More detailed user documentation is available from <ulink
 url="help:/okular">help:/okular</ulink>
 (either enter this <acronym>URL</acronym> into &konqueror;, or run
 <userinput><command>khelpcenter</command>
-<parameter>help:/okular</parameter></userinput>).</para>
+<parameter>help:/okular</parameter></userinput>).</member>
+<member>kf5options(7)</member>
+<member>qt5options(7)</member>
+<member>There is also further information available at
+<ulink url="http://okular.kde.org/";>http://okular.kde.org/</ulink></member>
+</simplelist>
 </refsect1>
 
 <refsect1 id="copyright"><title>Copyright</title>

Reply via email to