From 47d455dd55be855e4cc691c32f687f723d9247ee Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegraphics@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kghostview/Makefile.am | 4 + doc/kghostview/index.docbook | 755 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 759 insertions(+) create mode 100644 doc/kghostview/Makefile.am create mode 100644 doc/kghostview/index.docbook (limited to 'doc/kghostview') diff --git a/doc/kghostview/Makefile.am b/doc/kghostview/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kghostview/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kghostview/index.docbook b/doc/kghostview/index.docbook new file mode 100644 index 00000000..41258728 --- /dev/null +++ b/doc/kghostview/index.docbook @@ -0,0 +1,755 @@ + + + + + +]> + + + +The &kghostview; Handbook + + +Pamela +Roberts + +
&Pamela.Roberts.mail;
+ + + + + + + +2001 2002 +&Pamela.Roberts; + + +&FDLNotice; + +2006-02-28 +0.20 + + +&kghostview; displays and prints &PostScript; (.ps, .eps) and Portable Document Format +(.pdf) files. +This document describes &kghostview; version 0.20 + + + +KDE +linux +postscript +ghostview + + + + + +Introduction + + +&kghostview; displays and prints &PostScript; (.ps, .eps) and Portable Document Format (.pdf) files. It is a port to &kde; of Tim +Theisen's Ghostview program which uses Alladin +Ghostscript to view documents prepared in +Adobe's &PostScript; page +description language. &PostScript; is the major page description language +for printing on &UNIX; systems and this application can be used to preview +material intended for printing or for reading documents online. + + + +You can use &kghostview; with all recent versions of +Ghostscript. Newer versions offer much +improved performance which you can take advantage of with &kghostview;. + + + +If a document does not conform to the Adobe document structuring convention the +functionality of the viewer is limited. For example, if there is no +table of contents, skipping around the document and marking pages is not +possible. + + + + + + +Fundamentals + + +This section describes what you see in the main &kghostview; window, the +actions of the Toolbar buttons and how to use the Page List. + + + +You can open multiple instances of &kghostview; to view multiple +documents. The titlebar at the top of a window shows you the name of +the document in that window. + + + +The main area displays a page of the current document. If the page is +too large to fit inside the window, scrollbars are automatically added +to the sides of the display, although these can be disabled with the +Settings menu. + + +Note that the Toolbar and the Page List can be hidden with the Settings menu options to give more space on +the screen for the content area. + + + +You can scroll up and down in a page with the Up +Arrow and Down Arrow keys, or use the +ViewRead Up +(PageUp) and View +Read Down +(PageDown) options to scroll through the entire document. + + +The +Read Up and Read Down +-Toolbar buttons do what they say, or you can go +immediately to any page with a &LMB; click on the appropriate entry in +the Page List. + + + +If selected in the Settings menu a Page List will be +displayed at the left side of the window. This list has two columns: the +first may contain a flag indicating that the page has been marked, the +second contains the page numbers. You can use this page list to navigate +through the document or to mark pages for printing. + + + +You can toggle the page marked flag for the currently +displayed page with &Ctrl;&Shift;M or for +any page by &LMB; clicking on it in the Page List. You can also clear or +change your page marks using the context menu that is activated by +&RMB; clicking anywhere in the Page List area or by selecting the Edit menu. + + + + + +The Menubar + + +The <guimenu>File</guimenu> Menu + + + + + +&Ctrl; +O +File +Open... + +Open a file. If a file +is currently being displayed it will be closed. + + + + + +File +Open Recent + +Open a file selected from a combo box of +recently opened files. If a file is currently being displayed it will be +closed. + + + + +File +Save As... + +Save the currently open file. + + + + + +&Ctrl; +P +File +Print... + +Print the currently displayed document. +The Print dialog box will let you choose to print all or selected +(marked) pages. + + + + +File +Document Info + +Display some basic information about +the document. + + + + +&Ctrl; +Q +File +Quit + +Close down &kghostview;. + + + + + + + + +The <guimenu>Edit</guimenu> Menu + + + +You can also get this menu by &RMB; clicking anywhere in the Page List +area. + + + + + + + +&Ctrl;&Shift; +M +Edit +Mark Current Page + +Toggle the page marked +flag for the current page. + + + + +Edit +Mark All Pages + +Set the page marked +flag for all pages of the document. + + + + +Edit +Mark Even Pages + +Set the page marked +flag for all even numbered pages in the document. Used in +conjunction with Mark Odd Pages or +Toggle Page Marks this provides a convenient way of +double-sided printing a document on a single sided printer + + + + +Edit +Mark Odd Pages + +Set the page marked +flag for all odd numbered pages in the document. + + + + +Edit +Toggle Page Marks + +Toggle the page marked +flags for all pages in the document. + + + + +Edit +Remove Page Marks + +Clear the page marked +flags for all pages in the document. + + + + + + + +The <guimenu>View</guimenu> Menu + + + + + + +F5 + +View +Reload + +Re-render the current document page. + + + + +M +View +Maximize + + +This option maximizes the &kghostview; window. + + + + +&Ctrl;&Shift; +F +View +Full Screen Mode + + +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 ESC key or +the shortcut &Ctrl;&Shift; +F again, or open the context menu with a &RMB; click +and select Exit Full Screen Mode. + + + + + + +View +Orientation + +Change the orientation of the +displayed page. You can choose between Auto, +Portrait, +Landscape, Upside +Down and Seascape which is like +Landscape but the other way up. + + + + +View +Paper Size + +Lets you view the document as if it +were printed on different paper sizes without changing the +scale. You should normally choose Auto. + + + + +&Ctrl;+ + +View +Zoom In + +Increase the magnification of the +document view. + + + +View +Zoom + + +Select a predefined zoom factor. + + + + + +&Ctrl; +- +View +Zoom Out + +Decrease the magnification of the +document view. + + + +View +Fit to Page Width + +Scale the display so a page width fits +exactly across the main display area. + + + +S +View +Fit to Screen + +Scale the display so the entire page fits +exactly across the main display area. + + + +&Ctrl; +PageUp +View +Previous Page + +View the previous page of the +document. + + + +&Ctrl; +PageDown +View +Next Page + +View the next page of the +document. + + + +&Ctrl; +Home +View +First Page + +Go to the first page of the +document. + + + +&Ctrl; +End +View +Last Page + +Go to the last page of the +document. + + + +View +Go to Page + +Go to a selected page of the +document. + + + +PageUp +View +Read Up + +Scroll backwards through the +document. + + + +PageDown +View +Read Down + +Scroll forwards through the +document. + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + + +&Ctrl;M +Settings +Show/Hide Menubar + +Toggles the menubar on/off. + + + + +Settings +Show/Hide Toolbar + +Toggle the Toolbar display on +and off. + + + +Settings +Show/Hide Statusbar + +Toggle the Status bar display on +and off. + + +&Ctrl;&Shift; +F +Settings +Full Screen Mode + + +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 ESC key or +the shortcut &Ctrl;&Shift; +F again, or open the context menu with a &RMB; click +and select Exit Full Screen Mode. + + + + + + +Settings +Configure Shortcuts... + +Opens a dialog for changing the shortcuts. +Using this option you can change the standard key shortcut for &kghostview;'s commands +or create new ones. + + + + +Settings +Configure Toolbars... + +Opens a dialog for configuring the toolbar. You +can add and remove toolbuttons for &kghostview;'s commands with this +option. + + + + +Settings +Show/Hide Scrollbars + +Toggle the horizontal and vertical scrollbars +on and off. + + + +Settings +Show Page List + +Toggle the Page List +on and off. + + + +Settings +Show Page Labels + +If this is selected the name (if any) of the +current page is displayed in the Status Bar. + + + + +Settings +Watch File + +If this is selected the display will +automatically update if the document file +changes. + + + +Settings +No Flicker + + +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. + + + + +Settings +Configure &kghostview;... + +Brings up the &kghostview; +configuration dialog +box. + + + + + + +The <guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + + + +Configuration + + +The configuration dialog box is accessed with the +SettingsConfigure +&kghostview;... option. It has two pages; +General and Ghostscript +Configuration + + + +General Settings + + +You can select Enable anti-aliasing of fonts and +images to get smoothly rendered text, but note that +anti-aliasing is memory intensive and slower than straightforward +rendering of fonts. Early versions of +Ghostscript could not perform anti-aliasing. + + + +Select Use platform fonts if you wish to use your +native system fonts rather than those that come with +Ghostscript. + + + +Turn Show Ghostscript messages in a separate box +on if you want to be informed of any output or error messages +generated by the Ghostscript interpreter. + + + +You can choose whether &kghostview; uses a +Monochrome, Grayscale or +Color Palette for the display. + + + + + +<application>Ghostscript</application> Configuration + + +In this dialog box page you can set the name of the +Ghostscript Interpreter: +executable and the Non-antialiasing arguments: and +the Antialiasing arguments: passed to it. The +default settings should be suitable for most systems. + + + + + + + + +Credits and License + + +&kghostview; + + + +Program Copyright: +&Mark.Donohoe; &Mark.Donohoe.mail; (original author) 1998 + +&David.Sweet; &David.Sweet.mail; +Maintainer 1999-2000 + +&Wilco.Greven; &Wilco.Greven.mail; +Current maintainer + +&David.Faure; &David.Faure.mail; (basis for +shell) + +Daniel Duley mosfet@kde.org (port to +Kparts) + +&Espen.Sand; &Espen.Sand.mail; (dialog boxes) + + + + + +Documentation copyright 2001, 2002 &Pamela.Roberts; +&Pamela.Roberts.mail; + + + + + +&underFDL; + +&underGPL; + + + + + +Installation + + +&kghostview; is part of the &kde; 3 project, details of which can be found at +http://www.kde.org. + + + +To use &kghostview;, you must have the Ghostscript +program as well as &kde; 3 installed on your machine. The +Ghostscript home page is at +http://www.cs.wisc.edu/~ghost/ + + + +Most distributions will include &kghostview;, but if you want to roll your own +the source code can be found in the &package; package on &kde-ftp;, the main +ftp site of the &kde; project. + + + +&install.compile.documentation; + + + +&documentation.index; + + + + -- cgit v1.2.1