[kde-doc-english] [Bug 116093] New: kghostview: wrong menu description + guiitems in docs, patch
Burkhard Lück
lueck at hube-lueck.de
Thu Nov 10 21:37:42 CET 2005
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
http://bugs.kde.org/show_bug.cgi?id=116093
Summary: kghostview: wrong menu description + guiitems in docs,
patch
Product: docs
Version: unspecified
Platform: Compiled Sources
OS/Version: Linux
Status: NEW
Severity: normal
Priority: NOR
Component: general
AssignedTo: kde-doc-english kde org
ReportedBy: lueck hube-lueck de
Version: (using KDE Devel)
Installed from: Compiled sources
patch is checked with meinproc, check-empty-elements.py,
check-multiple-root-elements.py and check_preferred_forms.py
Index: svn/kdegraphics/doc/kghostview/index.docbook
===================================================================
--- svn/kdegraphics/doc/kghostview/index.docbook (Revision 460267)
+++ svn/kdegraphics/doc/kghostview/index.docbook (Arbeitskopie)
@ -92,13 +92,13 @
<para>
You can open multiple instances of &kghostview; to view multiple
-documents. The title bar at the top of a window shows you the name of
+documents. The titlebar at the top of a window shows you the name of
the document in that window.
</para>
<para>
The main area displays a page of the current document. If the page is
-too large to fit inside the window, scroll bars are automatically added
+too large to fit inside the window, scrollbars are automatically added
to the sides of the display, although these can be disabled with the
<guimenu>Settings</guimenu> menu.
</para>
@ -111,11 +111,10 @
<para>
You can scroll up and down in a page with the <keysym>Up
Arrow</keysym> and <keysym>Down Arrow</keysym> keys, or use the
-<menuchoice><guimenu>View</guimenu><guimenuitem>Read Up</guimenuitem></menuchoice> (<keycombo action="simul">&Shift;<keycap>Space
-</keycap></keycombo>) and <menuchoice><guimenu>View</guimenu>
-<guimenuitem>Read Down</guimenuitem></menuchoice>
-(<keycombo action="simul">&Ctrl;<keycap>Space</keycap></keycombo>)
-options to scroll through the entire document.
+<menuchoice><guimenu>View</guimenu><guimenuitem>Read Up</guimenuitem></menuchoice>
+(<keycap>PageUp</keycap>) and <menuchoice><guimenu>View</guimenu>
+<guimenuitem>Read Down</guimenuitem></menuchoice>
+(<keycap>PageDown</keycap>) options to scroll through the entire document.
</para>
<para>The
@ -136,11 +135,11 @
<para>
You can toggle the <quote>page marked</quote> flag for the currently
displayed page with <keycombo
-action="simul"><keycap>Ctrl</keycap><keycap>M</keycap></keycombo> or for
+action="simul"><keycap>&Ctrl;</keycap><keycap>M</keycap></keycombo> or for
any page by &MMB; clicking on it in the Page List. You can also clear or
-change your page marks using the drop-down menu that is activated by
+change your page marks using the context menu that is activated by
&RMB; clicking anywhere in the Page List area or by selecting the <link
-linkend="pagemarks">PageMarks</link> menu.
+linkend="menuedit">Edit</link> menu.
</para>
</chapter>
@ -170,7 +169,7 @
<guimenu>File</guimenu>
<guimenuitem>Open Recent</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Open</action> a file selected from a drop-down list of
+<listitem><para><action>Open</action> a file selected from a combo box of
recently opened files. If a file is currently being displayed it will be
closed.</para></listitem>
</varlistentry>
@ -199,7 +198,7 @
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
-<guimenuitem>Document Info...</guimenuitem>
+<guimenuitem>Document Info</guimenuitem>
</menuchoice></term>
<listitem><para><action>Display</action> some basic information about
the document.</para> </listitem>
@ -220,6 +219,81 @
</sect1>
+<sect1 id="menuedit">
+<title>The <guimenu>Edit</guimenu> Menu</title>
+
+<note>
+<para>
+You can also get this menu by &RMB; clicking anywhere in the Page List
+area.
+</para>
+</note>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;&Shift;
+<keycap>M</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Mark Current Page</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Toggle the page marked
+flag</action> for the current page.</para> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Mark All Pages</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Set the page marked
+flag</action> for all pages of the document.</para> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Mark Even Pages</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Set the page marked
+flag</action> for all even numbered pages in the document. Used in
+conjunction with <guimenuitem>Mark Odd Pages</guimenuitem> or
+<guimenuitem>Toggle Page Marks</guimenuitem> this provides a convenient way of
+double-sided printing a document on a single sided printer</para> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Mark Odd Pages</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Set the page marked
+flag</action> for all odd numbered pages in the document.</para> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Toggle Page Marks</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Toggle the page marked
+flags</action> for all pages in the document.</para> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Remove Page Marks</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Clear the page marked
+flags</action> for all pages in the document.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
<sect1 id="view">
<title>The <guimenu>View</guimenu> Menu</title>
@ -227,20 +301,42 @
<varlistentry>
<term><menuchoice>
+<shortcut>
+<keycap>F5</keycap>
+</shortcut>
<guimenu>View</guimenu>
-<guimenuitem>Redisplay</guimenuitem>
+<guimenuitem>Reload</guimenuitem>
</menuchoice></term>
<listitem><para><action>Re-render</action> the current document page.</para>
</listitem> </varlistentry>
<varlistentry>
<term><menuchoice>
-<guimenu>View</guimenu>
-<guimenuitem>Fit To Page Width</guimenuitem>
-</menuchoice></term>
-<listitem><para><action>Scale</action> the display so a page width fits
-exactly across the main display area.</para> </listitem> </varlistentry>
+<shortcut><keycap>M</keycap></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Maximize</guimenuitem></menuchoice>
+</term>
+<listitem>
+<para>This option maximizes the &kghostview; window.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;
+<keycap>F</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Full Screen Mode</guimenuitem></menuchoice>
+</term>
+<listitem>
+<para>This option maximizes the &kghostview; window and the currently shown page.
+Even the window decorations (titlebar etc) are temporarily removed.
+To switch back to normal window mode, press the <keycap>ESC</keycap> key or
+the shortcut <keycombo action="simul">&Ctrl;&Shift;
+<keycap>F</keycap></keycombo> again, or open the context menu with a &RMB; click
+and select <guimenuitem>Exit Full Screen Mode</guimenuitem>.
+</para>
+</listitem>
+</varlistentry>
<varlistentry>
<term><menuchoice>
@ -276,6 +372,15 @
document view.</para> </listitem> </varlistentry>
<varlistentry>
+<term><guiicon>Zoom</guiicon></term>
+<listitem>
+<para>
+<action>Select a predefined zoom factor.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;
<keycap>-</keycap></keycombo></shortcut>
@ -287,9 +392,26 @
<varlistentry>
<term><menuchoice>
-<shortcut><keycap>Page Up</keycap>
-</shortcut>
<guimenu>View</guimenu>
+<guimenuitem>Fit to Page Width</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Scale</action> the display so a page width fits
+exactly across the main display area.</para> </listitem> </varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycap>S</keycap></shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Fit To Screen</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Scale</action> the display so the entire page fits
+exactly across the main display area.</para> </listitem> </varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;
+<keycap>PageUp</keycap></keycombo></shortcut>
+<guimenu>View</guimenu>
<guimenuitem>Previous Page</guimenuitem>
</menuchoice></term>
<listitem><para>View the <action>previous page</action> of the
@ -297,8 +419,8 @
<varlistentry>
<term><menuchoice>
-<shortcut><keycap>Page Down</keycap>
-</shortcut>
+<shortcut><keycombo action="simul">&Ctrl;
+<keycap>PageDown</keycap></keycombo></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Next Page</guimenuitem>
</menuchoice></term>
@ -328,15 +450,14 @
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
-<guimenuitem>Go to Page...</guimenuitem>
+<guimenuitem>Go to Page</guimenuitem>
</menuchoice></term>
<listitem><para><action>Go to a selected page</action> of the
document.</para> </listitem> </varlistentry>
<varlistentry>
<term><menuchoice>
-<shortcut><keycombo action="simul">&Shift;
-<keycap>Space</keycap></keycombo></shortcut>
+<shortcut><keycap>PageUp</keycap></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Read Up</guimenuitem>
</menuchoice></term>
@ -345,120 +466,108 @
<varlistentry>
<term><menuchoice>
+<shortcut><keycap>PageDown</keycap></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Read Down</guimenuitem>
</menuchoice></term>
<listitem><para><action>Scroll forwards</action> through the
document.</para> </listitem> </varlistentry>
-
</variablelist>
</sect1>
-<sect1 id="pagemarks">
-<title>The <guimenu>PageMarks</guimenu> Menu</title>
+<sect1 id="settings">
+<title>The <guimenu>Settings</guimenu> Menu</title>
-<note>
-<para>
-You can also get this menu by &RMB; clicking anywhere in the Page List
-area.
-</para>
-</note>
-
<variablelist>
<varlistentry>
-<term><menuchoice>
-<shortcut><keycombo action="simul">&Ctrl;
-<keycap>M</keycap></keycombo></shortcut>
-<guimenu>PageMarks</guimenu>
-<guimenuitem>Mark Current Page</guimenuitem>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Ctrl;<keycap>M</keycap></keycombo></shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Menubar</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Toggle the page marked
-flag</action> for the current page.</para> </listitem>
+<listitem><para><action>Toggles the menubar on/off.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
-<guimenu>PageMarks</guimenu>
-<guimenuitem>Mark All Pages</guimenuitem>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Toolbar</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Set the page marked
-flag</action> for all pages of the document.</para> </listitem>
-</varlistentry>
+<listitem><para><action>Toggle the Toolbar display</action> on
+and off.</para></listitem> </varlistentry>
<varlistentry>
<term><menuchoice>
-<guimenu>PageMarks</guimenu>
-<guimenuitem>Mark Even Pages</guimenuitem>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Statusbar</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Set the page marked
-flag</action> for all even numbered pages in the document. Used in
-conjunction with <guimenuitem>Mark Odd Pages</guimenuitem> or
-<guimenuitem>Toggle Page Marks</guimenuitem> this provides a convenient way of
-double-sided printing a document on a single sided printer</para> </listitem>
-</varlistentry>
+<listitem><para><action>Toggle the Status bar display</action> on
+and off.</para></listitem> </varlistentry>
<varlistentry>
-<term><menuchoice>
-<guimenu>PageMarks</guimenu>
-<guimenuitem>Mark Odd Pages</guimenuitem>
-</menuchoice></term>
-<listitem><para><action>Set the page marked
-flag</action> for all odd numbered pages in the document.</para> </listitem>
+<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;
+<keycap>F</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Full Screen Mode</guimenuitem></menuchoice>
+</term>
+<listitem>
+<para>This option maximizes the &kghostview; window and the currently shown page.
+Even the window decorations (titlebar etc) are temporarily removed.
+To switch back to normal window mode, press the <keycap>ESC</keycap> key or
+the shortcut <keycombo action="simul">&Ctrl;&Shift;
+<keycap>F</keycap></keycombo> again, or open the context menu with a &RMB; click
+and select <guimenuitem>Exit Full Screen Mode</guimenuitem>.
+</para>
+</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
-<guimenu>PageMarks</guimenu>
-<guimenuitem>Toggle Page Marks</guimenuitem>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Shortcuts...</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Toggle the page marked
-flags</action> for all pages in the document.</para> </listitem>
+<listitem><para><action>Opens a dialog for changing the shortcuts.</action>
+Using this option you can change the standard key shortcut for &kghostview;'s commands
+or create new ones.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
-<guimenu>PageMarks</guimenu>
-<guimenuitem>Remove Page Marks</guimenuitem>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Toolbars...</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Clear the page marked
-flags</action> for all pages in the document.</para></listitem>
+<listitem><para><action>Opens a dialog for configuring the toolbar.</action> You
+can add and remove toolbuttons for &kghostview;'s commands with this
+option.</para></listitem>
</varlistentry>
-</variablelist>
-
-</sect1>
-
-<sect1 id="settings">
-<title>The <guimenu>Settings</guimenu> Menu</title>
-
-<variablelist>
-
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
-<guimenuitem>Show Toolbar</guimenuitem>
+<guimenuitem>Show/Hide Scrollbars</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Toggle the Toolbar display</action> on
-and off.</para></listitem> </varlistentry>
+<listitem><para><action>Toggle the horizontal and vertical scrollbars</action>
+on and off.</para></listitem> </varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
-<guimenuitem>Show Statusbar</guimenuitem>
+<guimenuitem>Show Page List</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Toggle the Statusbar display</action> on
-and off.</para></listitem> </varlistentry>
+<listitem><para><action>Toggle the Page List</action>
+on and off.</para></listitem> </varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
-<guimenuitem>Show Scrollbars</guimenuitem>
+<guimenuitem>Show Page Labels</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Toggle the horizontal and vertical scrollbars</action>
-on and off.</para></listitem> </varlistentry>
+<listitem><para>If this is selected the <action>name (if any) of the
+current page is displayed in the Status Bar</action>.</para></listitem>
+</varlistentry>
<varlistentry>
<term><menuchoice>
@ -472,23 +581,16 @
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
-<guimenuitem>Show Page List</guimenuitem>
+<guimenuitem>No Flicker</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Toggle the Page List</action>
-on and off.</para></listitem> </varlistentry>
+<listitem><para>
+If this is selected the display will start showing objects instantly as they are rendered,
+otherwise the whole page is rendered off-screen and then displayed.
+</para></listitem> </varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
-<guimenuitem>Show Page Labels</guimenuitem>
-</menuchoice></term>
-<listitem><para>If this is selected the <action>name (if any) of the
-current page is displayed in the Status Bar</action>.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><menuchoice>
-<guimenu>Settings</guimenu>
<guimenuitem>Configure &kghostview;...</guimenuitem>
</menuchoice></term>
<listitem><para>Brings up the &kghostview;
@ -514,8 +616,8 @
The configuration dialog box is accessed with the
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
&kghostview;...</guimenuitem></menuchoice> option. It has two pages;
-<guilabel>General settings</guilabel> and <guilabel>Ghostscript
-configuration</guilabel>
+<guilabel>General</guilabel> and <guilabel>Ghostscript
+Configuration</guilabel>
</para>
<sect1 id="general-settings">
@ -524,19 +626,19 @
<para>
You can select <guilabel>Enable anti-aliasing of fonts and
images</guilabel> to get smoothly rendered text, but note that
-antialiasing is memory intensive and slower than straightforward
+anti-aliasing is memory intensive and slower than straightforward
rendering of fonts. Early versions of
-<application>Ghostscript</application> could not perform antialiasing.
+<application>Ghostscript</application> could not perform anti-aliasing.
</para>
<para>
-Select <guilabel>Use Platform fonts</guilabel> if you wish to use your
+Select <guilabel>Use platform fonts</guilabel> if you wish to use your
native system fonts rather than those that come with
<application>Ghostscript</application>.
</para>
<para>
-Turn <guilabel>Show Ghostscript Messages in a separate box</guilabel>
+Turn <guilabel>Show Ghostscript messages in a separate box</guilabel>
on if you want to be informed of any output or error messages
generated by the <application>Ghostscript</application> interpreter.
</para>
@ -554,9 +656,9 @
<para>
In this dialog box page you can set the name of the
-<application>Ghostscript</application> <guilabel>Interpreter</guilabel>
+<application>Ghostscript</application> <guilabel>Interpreter:</guilabel>
executable and the <guilabel>Non-antialiasing arguments:</guilabel> and
-the <guilabel>Antialiasing arguments</guilabel> passed to it. The
+the <guilabel>Antialiasing arguments:</guilabel> passed to it. The
default settings should be suitable for most systems.
</para>
More information about the kde-doc-english
mailing list