Added old abandoned KDE3 version of koffice

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/koffice@1077364 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

6 files changed, 580 insertions, 0 deletions

diff --git a/doc/kivio/Makefile.am b/doc/kivio/Makefile.am
new file mode 100644
index 00000000..085981d9
--- /dev/null
+++ b/doc/kivio/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kivio/credits.docbook b/doc/kivio/credits.docbook
new file mode 100644
index 00000000..1a85a4e6
--- /dev/null
+++ b/doc/kivio/credits.docbook
@@ -0,0 +1,64 @@
+<chapter id="credits">
+<chapterinfo>
+<authorgroup>
+<author><firstname>Ben</firstname>
+<surname>Lamb</surname>
+<affiliation>
+<address>
+<email>kde@zurgy.org</email>
+</address>
+</affiliation>
+</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+</chapterinfo>
+
+<title>Credits and License</title>
+
+<para>
+&kivio;
+</para>
+
+<para>
+Program copyright 2000-2003 The &kivio; Team
+</para>
+
+<para>
+Current maintainer is Peter Simonsonn <email>psn@linux.se</email>.
+</para>
+
+<itemizedlist>
+<title>Contributors</title>
+
+<listitem>
+<para>Ian Reinhart Geiser <email>geiseri@kde.org</email></para>
+</listitem>
+
+<listitem>
+<para>Laurent Montel <email>montel@kde.org</email></para>
+</listitem>
+
+<listitem>
+<para>Frauke Oster <email>frauke@frsv.de</email></para>
+</listitem>
+
+<listitem>
+<para>Dave Marotti <email>lndshark@verticaladdiction.net</email></para>
+</listitem>
+
+<listitem>
+<para>The Kompany.com - "<trademark>Where Open Source is at Home</trademark>" <email>info@thekompany.com</email></para>
+</listitem>
+
+<listitem>
+<para>Current documentation is maintained by Ben Lamb
+<email>kde@zurgy.org</email></para>
+</listitem>
+
+</itemizedlist>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+&underFDL;
+&underGPL;
+
+</chapter>
diff --git a/doc/kivio/index.docbook b/doc/kivio/index.docbook
new file mode 100644
index 00000000..02300ced
--- /dev/null
+++ b/doc/kivio/index.docbook
@@ -0,0 +1,64 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY package "koffice">
+  <!ENTITY kappname "&kivio;">
+  <!ENTITY introduction SYSTEM "introduction.docbook">
+  <!ENTITY usage SYSTEM "usage.docbook">
+  <!ENTITY working SYSTEM "working.docbook">
+  <!ENTITY credits SYSTEM "credits.docbook">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+<title>The &kivio; Handbook</title>
+
+<authorgroup>
+
+<author>
+<firstname>Ben</firstname>
+<surname>Lamb</surname>
+<affiliation>
+<address>
+<email>kde@zurgy.org</email>
+</address>
+</affiliation>
+</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2006-01-30</date>
+<releaseinfo>1.5.0</releaseinfo>
+
+<copyright>
+<year>2003</year><year>2000</year>
+<holder>Ben Lamb</holder>
+</copyright>
+
+
+<legalnotice>&FDLNotice;</legalnotice>
+<abstract>
+<para>
+&kivio; is the &koffice; flowchart and diagram creation tool.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>Kivio</keyword>
+<keyword>KOffice</keyword>
+<keyword>Flowchart</keyword>
+<keyword>Diagram</keyword>
+</keywordset>
+
+</bookinfo>
+
+&introduction;
+&usage;
+&working;
+&credits;
+
+</book>
diff --git a/doc/kivio/introduction.docbook b/doc/kivio/introduction.docbook
new file mode 100644
index 00000000..0fac6914
--- /dev/null
+++ b/doc/kivio/introduction.docbook
@@ -0,0 +1,33 @@
+<chapter id="introduction">
+<chapterinfo>
+<authorgroup>
+<author><firstname>Ben</firstname>
+<surname>Lamb</surname>
+<affiliation>
+<address>
+<email>kde@zurgy.org</email>
+</address>
+</affiliation>
+</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+</chapterinfo>
+<title>Introduction</title>
+
+<sect1 id="what-is">
+<title>What is &kivio;?</title>
+
+<para>&kivio; is the &koffice; flowchart and diagram creation tool. It allows you to create accurate scale diagrams by arranging pre-drawn shapes and stencils on a page. The stencils might represent stages of a process, office furniture or components on an electronic circuit. &kivio; comes with a large collection of different stencils which are grouped into collections, known as stencil sets, by subject area.</para>
+</sect1>
+
+<sect1 id="this-document">
+<title>About this Document</title>
+<para>This document describes the features of &kivio; and how to use them. There are often several ways to perform a particular task. Where possible the appropriate menu option is described as this is the easiest to explain without the aid of screenshots. Users are encouraged to explore the menus and to try right-clicking on stencils to reveal shortcut menus.</para>
+</sect1>
+
+<sect1 id="contributing">
+<title>Contributing to &kivio;</title>
+<para>&kivio; is a volunteer project. Your contributions are welcome. If you find a bug whilst using the software please report it by selecting <menuchoice><guimenu>Help</guimenu><guimenuitem>Report Bug...</guimenuitem></menuchoice>.</para>
+<para>Contributions to the documentation, stencils, translations into other languages and the code itself are welcome. Please see the &koffice; website for more information about how to contribute.</para>
+</sect1>
+</chapter>
diff --git a/doc/kivio/usage.docbook b/doc/kivio/usage.docbook
new file mode 100644
index 00000000..7714ef43
--- /dev/null
+++ b/doc/kivio/usage.docbook
@@ -0,0 +1,203 @@
+<chapter id="usage">
+<chapterinfo>
+<authorgroup>
+<author><firstname>Ben</firstname>
+<surname>Lamb</surname>
+<affiliation>
+<address>
+<email>kde@zurgy.org</email>
+</address>
+</affiliation>
+</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+</chapterinfo>
+
+<title>Basic Usage</title>
+
+<sect1 id="starting">
+<title>Starting &kivio;</title>
+<para>Like other &koffice; applications, on startup &kivio; presents a startup dialog. The dialog offers a choice of creating a new document, opening a saved document or choosing a document from a list of recently saved files.</para>
+<para>If you're new to &kivio; begin by creating an empty document by double-clicking on the <guilabel>Empty Document</guilabel> template.</para>
+<para>&kivio;'s main window contains a view of the current document. The page outline and margins are shown, as is a grid. Surrounding this view are horizontal and vertical rules. By default a tools toolbar is placed on the left-hand side and beneath the document view is a page selector. Beneath that is the status bar which shows the current position of the mouse pointer as a location on the page.</para>
+<para>At the top of the window are the two main toolbars. These contain buttons for the most commonly used features of &kivio;.</para>
+</sect1>
+
+<sect1 id="stencils">
+<title>Using Stencils</title>
+<para>Diagrams are created by placing different pre-drawn shapes and stencils on the page. Stencils can represent many different things and &kivio; comes with a wide selection. For ease of reference they are grouped into collections known as stencil sets. To use a stencil set select <menuchoice><guimenu>Tools</guimenu><guisubmenu>Add Stencil Set</guisubmenu></menuchoice>. The stencil sets have been sub-divided into several groups; a sub-menu lists these. The shapes in the stencil set are shown on the left-hand side of the document view.</para>
+<para>Stencils are grouped into stencil sets for organizational purposes only; it is perfectly okay to add several stencil sets to a document and &kivio; allows you to mix and match stencils from different sets freely.</para>
+<para>To place a stencil onto the document simply drag it from the stencil area to the page.</para>
+
+<sect2>
+<title>Selecting Stencils</title>
+<para>
+&kivio; identifies the stencil currently being edited by displaying eight green squares on the corners and edges of a square around the stencil. Stencils shown in this manner are described as being selected. The green rectangles are known as handles.
+To change the currently selected stencil move the mouse pointer over the stencil you wish to select and press the &LMB;.
+To select all the stencils on the current page select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Select All</guimenuitem></menuchoice>.
+To deselect all stencils select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Deselect</guimenuitem></menuchoice>.
+</para>
+</sect2>
+
+<sect2>
+<title>Moving Stencils</title>
+<para>
+To move a stencil to another position on the page, select the stencil. Note the pointer will change to a hand icon. Hold down the &LMB; and move the mouse to the new position. Release the mouse button to place the stencil at the new position.</para>
+</sect2>
+
+<sect2>
+<title>Resizing a Stencil</title>
+<para>Select the stencil, and then move the mouse pointer over one of the handles.  Note the mouse pointer change. Hold down the &LMB; and move the mouse. The coordinates of the stencil will be adjusted continuously as the mouse is moved. When you are happy with the new size release the mouse button to give the stencil its new final size.</para>
+</sect2>
+
+<sect2>
+<title>Undoing a Mistake</title>
+<para>If at any time you are unhappy with a change you have made to the document you can select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem></menuchoice> to revert the change. There is also an icon on the toolbar.</para>
+<para>If you undo an action and decide that was a mistake, select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice> to restore the change. &kivio; stores multiple actions to undo/redo several changes.</para>
+</sect2>
+
+<sect2>
+<title>Limitations of the Stencils</title>
+<para>Note that stencils cannot currently be rotated.</para>
+</sect2>
+
+<sect2>
+<title>Labeling Stencils</title>
+<para>A lot of stencils in the <guilabel>Flowcharting Collections</guilabel>, <guilabel>Geographic Collections</guilabel>, <guilabel>Hardware Collections</guilabel>, <guilabel>Miscellaneous Collections</guilabel> and <guilabel>UML Collections</guilabel> can contain text to describe their function. To add text to a stencil move the mouse pointer over the stencil and double-click it or open the context menu with the &RMB; and select <guimenuitem>Edit Text...</guimenuitem>. A dialog box will appear prompting for some text. Enter some text and click <guibutton>OK</guibutton>. The text should be shown inside the stencil.</para>
+<para>The item <guimenuitem>Edit Text...</guimenuitem> in the menu is disabled, if a stencil cannot be labeled.</para>
+<para>The font, size, alignment and style of the text can be adjusted by selecting <menuchoice><guimenu>Format</guimenu><guimenuitem>Text...</guimenuitem></menuchoice>. Alternatively use the buttons on the Format toolbar.
+The adjustments will only affect the currently selected stencil.</para>
+</sect2>
+
+<sect2>
+<title>Selecting Several Stencils</title>
+<para>There are two ways to select multiple stencils in &kivio;.</para>
+<orderedlist>
+<listitem>
+<para>Click once inside the first stencil you wish to select.
+	Hold down &Ctrl; as you click inside subsequent stencils.
+	All the stencils will be shown with handles around them.</para>
+</listitem>
+<listitem>
+<para>Move the mouse pointer to a blank area of the document near the stencils you want to select.</para>
+<para>Hold down the &LMB; and move the mouse to the other side of the stencils you want to select, drawing a rectangle around them.</para>
+<para>The rectangle must completely encompass the stencils for them to be selected.
+</para>
+</listitem>
+</orderedlist>
+</sect2>
+
+<sect2>
+<title>Adjusting the Fill Color and Line Color</title>
+<para>Stencils can be filled with a solid color and the color of the outline can be changed. Select a stencil then select <menuchoice><guimenu>Format</guimenu><guimenuitem>Stencils &amp; Connectors...</guimenuitem></menuchoice>.</para>
+<!--para>There is also a <guibutton>Set Background Color</guibutton> button on the Format toolbar. Clicking on the arrow to the right-hand side of this button will display a drop-down color selector. Clicking on the button itself will display a color palette allowing you to choose any color. A similar toolbar button exists to adjust the line color.</para-->
+</sect2>
+
+<sect2>
+<title>Adjusting the Line Thickness</title>
+<para>The width of a stencil's border can be adjusted by selecting <menuchoice><guimenu>Format</guimenu><guimenuitem>Stencils &amp; Connectors...</guimenuitem></menuchoice>. The line width can be entered in centimeters or increased/decreased using the arrows of the spin box. Or use the <guibutton>Line Width</guibutton> button on the <guilabel>Format</guilabel> toolbar. Select a width from the drop down box or select <guilabel>Custom...</guilabel> to open enter the width in the spin box.</para>
+</sect2>
+
+<sect2>
+<title>Connecting Shapes Together</title>
+<para>&kivio;'s connector tool allows lines to be drawn between shapes. The lines remain connected to the shapes even when the shapes are moved to new positions on the page.</para>
+<para>To draw a connector select <menuchoice><guimenu>Tools</guimenu><guimenuitem>Straight Connector</guimenuitem></menuchoice> or <menuchoice><guimenu>Tools</guimenu><guimenuitem>Polyline Connector</guimenuitem></menuchoice>.</para>
+<para>The <guilabel>Polyline Connector</guilabel> tool is also available from the <guilabel>Tools</guilabel> toolbar; by default shown on the top side of the window. Click on this tool to begin using it; the mouse pointer will change shape.</para>
+<para>Notice that all stencils have little blue crosses around their edges. These crosses mark points where connectors can be attached.</para>
+<para>To connect two stencils move to one of the connection points on the first stencil, hold down the &LMB; and drag a line to one of the connection points on the second stencil. The green square at the end of the line will change to red when it is over a connection point indicating that the line is attached to a stencil. </para>
+<para>When you have finished using the connector tool, click on the <guiicon>Arrow</guiicon> tool to regain normal selection functionality.</para>
+<note><para>A stencil can have multiple connectors attached to it, even at the same connection point.</para></note>
+<para>Various properties of the connector can be adjusted including line thickness and color, this is done in the same way as for stencils.</para>
+<para><guilabel>Straight Connectors</guilabel> may also be labeled with text. To add text to a straight connector open the context menu with the &RMB; and select <guimenuitem>Edit Text...</guimenuitem>. Enter the text in the dialog that appears. The text will be shown with a green handle next to it. Use this to modify the position of the text.</para>
+<para>Arrowheads can be added to either end of a connector. Select the connector and then select <menuchoice><guimenu>Format</guimenu><guimenuitem>Arrowheads...</guimenuitem></menuchoice>.</para>
+<para>Limitations: Connectors do not currently reroute around stencils, you need to adjust them manually. Text is always displayed horizontally; rotated text is not currently possible. </para>
+</sect2>
+
+<sect2>
+<title>Grouping Stencils</title>
+<para>Several stencils may be semi-permanently grouped together. Once this has been done any changes made to one stencil will affect the others in the group.</para>
+<para>To make a group select the stencils and select <menuchoice><guimenu>Format</guimenu><guimenuitem>Group Selection</guimenuitem></menuchoice>.</para>
+<para>The procedure can be reversed by selecting a group of stencils and select <menuchoice><guimenu>Format</guimenu><guimenuitem>Ungroup</guimenuitem></menuchoice>.</para>
+</sect2>
+
+<sect2>
+<title>Overlaying Stencils</title>
+<para>Stencils can be positioned on top of one another. A stencil drawn on top of another stencil will obscure the stencil underneath it. To adjust the drawing order select one of the stencils and select either <menuchoice><guimenu>Format</guimenu><guimenuitem>Bring to Front</guimenuitem></menuchoice> or <menuchoice><guimenu>Format</guimenu><guimenuitem>Send to Back</guimenuitem></menuchoice>.</para>
+<para><guimenuitem>Send to Back</guimenuitem> will cause the stencil to be obscured by any stencil which overlaps it. <guimenuitem>Bring to Front</guimenuitem> will cause the stencil to obscure any stencil which it overlaps.</para>
+</sect2>
+
+<sect2>
+<title>Locking Stencils</title>
+<para>A stencil's properties may be <quote>locked</quote> to prevent accidental changes. To alter a stencil's protection use the protection palette. This can be displayed by selecting <menuchoice><guimenu>View</guimenu><guisubmenu>Palettes</guisubmenu><guimenuitem>Show Protection</guimenuitem></menuchoice>. Select the stencil or stencils you wish to protect and then tick the properties you want to protect on the protection palette.</para>
+<para>The protections available are: <guilabel>Width</guilabel>, <guilabel>Height</guilabel>, <guilabel>Aspect ratio</guilabel>, <guilabel>X position</guilabel>, <guilabel>Y position</guilabel> and <guilabel>Deletion</guilabel>. Deletion prevents a stencil from being deleted from the document.</para>
+</sect2>
+
+<sect2>
+<title>Stencil Geometry</title>
+<para>For accurately specifying the dimensions of a stencil use the Geometry palette. To display the palette select <menuchoice><guimenu>View</guimenu><guisubmenu>Palettes</guisubmenu><guimenuitem>Show Geometry</guimenuitem></menuchoice>. The palette contains four spin boxes for specifying the horizontal (<guilabel>X:</guilabel>) and vertical (<guilabel>Y:</guilabel>) position of the stencil and the <guilabel>Width:</guilabel> and <guilabel>Height:</guilabel>.</para>
+
+<tip><para>Although the measurements are displayed in centmeters it is possible to enter other units into the textbox. For example, entering 2.5 mm will be converted into centimeter. Points (pt) and inches (in) are also accepted.</para></tip>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="viewing">
+<title>Viewing the Document</title>
+
+<sect2>
+<title>Zooming In and Out</title>
+<para>To adjust the zoom level select <menuchoice><guimenu>View</guimenu><guisubmenu>Zoom Level</guisubmenu></menuchoice>. This submenu contains a list of percentages from 33% to 500%; selecting one of these magnify the document by that percentage.</para>
+<para>There is also a list of zoom levels in a spin box on the <guilabel>Edit</guilabel> toolbar, by default shown at the top of the screen.</para>
+<para>A second method of controlling the magnification is to use the zoom tool. This is available on the <guilabel>Tools</guilabel> toolbar. This tool can be used in two ways. Clicking on the document with the zoom tool active will increase the magnification. Holding down the &Shift; key whilst clicking will decrease the magnification, &ie; zoom out.</para>
+<para>Alternatively, holding down the &LMB; and dragging out a box then releasing the mouse button will increase the magnification so that that portion of the document fills the available space.</para>
+</sect2>
+
+<sect2>
+<title>Panning the Document</title>
+<para>The <guiicon>Pan Document</guiicon> tool lets you move the document around, adjusting the portion that is visible. This is very useful when working at high magnifications where the entire document is not completely visible. To pan a document select <guiicon>Pan Document</guiicon> from the <guilabel>Tools</guilabel> toolbar or <menuchoice><guimenu>Tools</guimenu><guisubmenu>Pan Document</guisubmenu></menuchoice> in the menu. Once activated the mouse pointer turns into a hand. To move the document move the mouse over the currently visible portion, hold down the &LMB; and drag.</para>
+</sect2>
+
+<sect2>
+<title>The Overview</title>
+<para>The <guilabel>Overview</guilabel> palette provides a quick way of adjusting the zoom level and moving around the document. To enable it select <menuchoice><guimenu>View</guimenu><guisubmenu>Palettes</guisubmenu><guimenuitem>Overview</guimenuitem></menuchoice>.</para>
+<para>A miniature representation of the document itself is shown underneath. A red rectangle indicates the portion that is currently visible. Clicking anywhere on this representation pans the view to that area. The rectangle can also be dragged.</para>
+<para>At the bottom of the palette there is a slider and two buttons to zoom 25% in or out.</para>
+</sect2>
+
+<sect2>
+<title>Using Palettes</title>
+<para>All palettes have a handle on the top side which enables them to be moved around and positioned on any edge of the main view. They can also float anywhere on the screen. To hide or show a palette select it from  <menuchoice><guimenu>View</guimenu><guisubmenu>Palettes</guisubmenu></menuchoice>.</para>
+</sect2>
+
+<sect2>
+<title>Multiple Views</title>
+<para>It is possible to have multiple views of the same document displayed simultaneously.</para>
+<para>Select <guimenuitem>New View</guimenuitem> from the <guimenu>View</guimenu> menu and a new &kivio; window showing the same document will appear. This is very useful for multiple monitor setups.</para>
+<para>The additional windows can be closed and &kivio; will only prompt you to save the document when the last window is closed. All windows pertaining to a particular document can be closed simultaneously by selecting <menuchoice><guimenu>View</guimenu><guimenuitem>Close All Views</guimenuitem></menuchoice>.</para>
+</sect2>
+
+<sect2>
+<title>Split Views</title>
+<para>It is also possible to split the window into two or more portions which can be used to view two areas of a document at once.
+To split a window select <menuchoice><guimenu>View</guimenu><guimenuitem>Split View</guimenuitem></menuchoice>. The orientation of the split can be changed from horizontal to vertical using <menuchoice><guimenu>View</guimenu><guisubmenu>Splitter Orientation</guisubmenu></menuchoice>. To restore the window to its original state select <menuchoice><guimenu>View</guimenu><guimenuitem>Remove View</guimenuitem></menuchoice>.</para>
+</sect2>
+
+<!--sect2>
+<title>The View Manager</title>
+<para>The View Manager allows you to store the current display settings, including zoom level and position. You can then adjust the view and still be able to revert back to the previous settings. A number of different settings can be stored and given names for ease of reference.</para>
+<para>To display the View Manager choose <menuchoice><guimenu>View</guimenu><guisubmenu>Docker</guisubmenu><guimenuitem>View Manager</guimenuitem></menuchoice>. The docker contains five buttons and a list of stored views.</para>
+<para>The first button, <guibutton>Add Current View</guibutton>, stores the current display settings. Once the settings have been stored you can modify the display settings. To revert to any one of the stored settings click on its name in the list.</para>
+<para>By default &kivio; labels the settings with the page number and the magnification level, to enter a more descriptive name click on the middle button, <guibutton>Rename Item</guibutton>; this lets you enter your own text.</para>
+<para>The second button, <guibutton>Remove Item</guibutton>, removes the currently selected set of stored settings.</para>
+<para>The final two buttons, <guibutton>Move Item Up</guibutton> and <guibutton>Move Item Down</guibutton>, allow the order of the settings in the list to be adjusted.</para>
+</sect2-->
+
+<sect2>
+<title>Customizing the Display</title>
+<para>The <guimenu>View</guimenu> menu contains options for toggling the display of page margins, rulers, guides and the grid.</para>
+</sect2>
+
+</sect1>
+
+</chapter>
diff --git a/doc/kivio/working.docbook b/doc/kivio/working.docbook
new file mode 100644
index 00000000..809b8aeb
--- /dev/null
+++ b/doc/kivio/working.docbook
@@ -0,0 +1,212 @@
+<chapter id="working">
+<chapterinfo>
+<authorgroup>
+<author><firstname>Ben</firstname>
+<surname>Lamb</surname>
+<affiliation>
+<address>
+<email>kde@zurgy.org</email>
+</address>
+</affiliation>
+</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+</chapterinfo>
+
+<title>Working with &kivio;</title>
+
+<sect1 id="opening">
+<title>Opening a Document</title>
+<para>To open a previously saved document select <menuchoice><guimenu>File</guimenu><guimenuitem>Open...</guimenuitem></menuchoice>, a standard &kde; file dialog box will appear.</para>
+<para>Recently used documents are listed under <menuchoice><guimenu>File</guimenu><guisubmenu>Open Recent</guisubmenu></menuchoice>.</para>
+</sect1>
+
+<sect1 id="saving">
+<title>Saving a Document</title>
+<para>To save the current document select <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> or <menuchoice><guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice> to give an existing file a different name.</para>
+<note><para>It is possible to save the document in a format that can be opened by earlier versions of &kivio;. Select the version you require from the <guilabel>Filter:</guilabel> combo box in the save file dialog.</para></note>
+</sect1>
+
+<sect1 id="printing">
+<title>Printing</title>
+<para>The document can be printed by selecting <menuchoice><guimenu>File</guimenu><guimenuitem>Print...</guimenuitem></menuchoice>. The standard &kde; printing dialog appears. A preview of the printed output can be obtained by selecting <menuchoice><guimenu>File</guimenu><guimenuitem>Print Preview...</guimenuitem></menuchoice>.</para>
+</sect1>
+
+<sect1 id="import-export">
+<title>Importing/Exporting Documents</title>
+<para>The <guimenuitem>Import...</guimenuitem> menu option on the <guimenu>File</guimenu> menu currently loads a &kivio; or &XML; document into a new &kivio; application.</para>
+<para>The <guimenuitem>Export...</guimenuitem> menu option on the <guimenu>File</guimenu> menu currently perform the same functions as <menuchoice><guimenu>File</guimenu> <guimenuitem>Save As...</guimenuitem></menuchoice>. These options let you save a document under a different name or into an other format.</para>
+</sect1>
+
+<sect1 id="multiple-pages">
+<title>Documents with Multiple Pages</title>
+<para>A &kivio; document can contain several pages of diagrams.</para>
+
+<sect2>
+<title>Adding Pages</title>
+<para>To <action>add additional pages</action> to a document select <menuchoice><guimenu>Page</guimenu><guimenuitem>Insert Page</guimenuitem></menuchoice> or click with the &RMB; on the page tab and select <guimenuitem>Insert Page</guimenuitem> from the context menu. The selector beneath the document view shows tabs for all the pages in the document that have not been hidden.</para>
+</sect2>
+
+<sect2>
+<title>Removing Pages</title>
+<para>Unwanted pages can be removed by selecting <menuchoice><guimenu>Page</guimenu><guimenuitem>Remove Page</guimenuitem></menuchoice> or click with the &RMB; on the page tab and select <guimenuitem>Remove Page</guimenuitem> from the context menu.</para>
+</sect2>
+
+<sect2>
+<title>Renaming Pages</title>
+<para>The names given to each page can be adjusted by double-clicking on the page name on the page selector or by clicking with the &RMB; on the page tab and select <guimenuitem>Rename Page...</guimenuitem> from the context menu. A dialog box will appear allowing the name to be edited.</para>
+</sect2>
+
+<sect2>
+<title>Working with Pages</title>
+<para>The order of the pages can be adjusted by dragging the tabs on the page selector bar.</para>
+<note><para>The arrow buttons on the page selector bar are for scrolling through the page tabs, they do not cycle through the pages themselves.</para></note>
+<para>If you have a lot of pages in a document and you do not want to see them all on the page selector you can hide pages by selecting <menuchoice><guimenu>Page</guimenu><guimenuitem>Hide Page</guimenuitem></menuchoice>. This will remove the currently selected page from the page selector bar.</para>
+<para>To reveal a hidden page select <menuchoice><guimenu>Page</guimenu><guimenuitem>Show Page...</guimenuitem></menuchoice> and choose the page you want to see from the list box.</para>
+</sect2>
+
+</sect1>
+
+<sect1 id="page-export">
+<title>Exporting a Page</title>
+<para>Individual pages can be exported as bitmap graphics files. To export the current page select <menuchoice><guimenu>File</guimenu> <guimenuitem>Export...</guimenuitem></menuchoice> or <menuchoice><guimenu>File</guimenu> <guimenuitem>Save As...</guimenuitem></menuchoice>. A standard &kde; file dialog box appears. The export format is determined by the name extension you give the file, it must end with one of the extensions listed below.</para>
+<para>The following formats are supported:</para>
+
+<itemizedlist>
+<listitem><para>PNG Image (.png)</para></listitem>
+<listitem><para>JPEG Image (.jpg)</para></listitem>
+<listitem><para>BMP Image (.bmp)</para></listitem>
+<listitem><para>Encapsulated Postscript Image (.eps)</para></listitem>
+<listitem><para>Portable Bitmap (.pbm)</para></listitem>
+<listitem><para>PCX Image (.pcx)</para></listitem>
+<listitem><para>Portable Pixmap Image (.ppm)</para></listitem>
+<listitem><para>SGI Image (RGB) (.rgb)</para></listitem>
+<listitem><para>X PixMap Image (.xpm)</para></listitem>
+<listitem><para>JPEG 2000 Image (.jp2)</para></listitem>
+<listitem><para>Krita Document (.kra)</para></listitem>
+<listitem><para>Adobe Illustrator Document (.ai)</para></listitem>
+<listitem><para>TIFF Image (.tiff)</para></listitem>
+<listitem><para>ILM EXR Image (.exr)</para></listitem>
+<listitem><para>Karbon14 Document (.karbon)</para></listitem>
+<listitem><para>GIMP Native Image Format (.xcf)</para></listitem>
+<listitem><para>Scalable Vector Graphics (.svg)</para></listitem>
+<listitem><para>&Windows; MetaFile (.wmf)</para></listitem>
+</itemizedlist>
+
+<para>You have to confirm the export, because this may result in some loss of formatting. Click the button <guibutton>Save</guibutton> and the <guilabel>Export to Image</guilabel> dialog is displayed. In this dialog you can set some export options: <guilabel>Page:</guilabel> range, the <guilabel>Area to export:</guilabel>, the  <guilabel>Custom size (in pixels):</guilabel> and the <guilabel>Margin:</guilabel> of the page.</para>
+</sect1>
+
+<sect1 id="grid">
+<title>The Grid</title>	
+<para>&kivio; displays a regularly spaced grid over the document to aid stencil positioning. The visibility of the grid can be toggled by selecting <menuchoice><guimenu>View</guimenu><guimenuitem>Show Grid</guimenuitem></menuchoice>.</para>
+<para>Objects edges are snapped to the nearest point on the grid regardless of whether it is visible. To toggle this behavior select <menuchoice><guimenu>View</guimenu><guimenuitem>Snap Grid</guimenuitem></menuchoice>.</para>
+<para>To customize the grid select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kivio;...</guimenuitem></menuchoice> and click on the <guiicon>Grid</guiicon> on the icon list.</para>
+<para>This dialog box will let you adjust the color the grid is drawn in, the horizontal and vertical spacing and the snap distance.</para>
+<para>Tip: It is possible to have a non-square grid by specifying different horizontal and vertical spacings.</para>
+</sect1>
+
+<sect1 id="text-tool">
+<title>Freestanding Text</title>
+<para>The text tool can be used to add text to a document that is not associated with any object. This is useful for noting general information about a drawing.</para>
+<para>To add freestanding text make sure no object is selected by selecting <menuchoice><guimenu>Edit</guimenu><guimenuitem>Deselect </guimenuitem></menuchoice>, then activate the text tool by selecting <menuchoice><guimenu>Tools</guimenu><guimenuitem>Text Tool</guimenuitem></menuchoice>. The mouse pointer will change to indicate the text tool is activated.</para>
+<para>Drag a box to contain the text. A dialog box will appear prompting for the text, enter some text and click <guibutton>OK</guibutton>. The formatting of the text can be adjusted by selecting <menuchoice><guimenu>Format</guimenu><guimenuitem>Text...</guimenuitem></menuchoice> or by using the toolbars.</para>
+</sect1>
+
+<sect1 id="page-layout">
+<title>Page Layout</title>
+<para>The page size, margins and orientation, portrait or landscape, can be adjusted using the <guilabel>Page Size &amp; Margins</guilabel> dialog box. This is accessible by selecting <menuchoice><guimenu>Format</guimenu><guimenuitem>Page Layout...</guimenuitem></menuchoice>.</para>
+</sect1>
+
+<sect1 id="guides">
+<title>Using Guides</title>
+<para>Guides are lines used to help you position  stencils. Not only can you use guides as a visual reference when aligning items but, optionally, &kivio; will snap stencils to guides. This means that as soon as the edge of a stencil is within a certain distance to a guide it will immediately move to the guide's position.</para>
+
+<sect2>
+<title>Adding Guides</title>
+<para>To add a guide move the mouse pointer over either the horizontal or vertical ruler, depending on the type of guide you require. Hold down the &LMB; and drag the mouse over the document and release the mouse button where you want to position the guide. As you drag the mouse the guide will move accordingly.
+Or use <menuchoice><guimenu>View</guimenu><guimenuitem>Add Guide Line...</guimenuitem></menuchoice> to open a dialog to select the <guilabel>Orientation</guilabel> and the <guilabel>Position</guilabel> of the guide.</para>
+</sect2>
+
+<sect2>
+<title>Repositioning Guides</title>
+<para>Once a guide is in place you can reposition it by moving the mouse over it, holding down the &LMB; and dragging. Release the mouse button when the guide is in its new position.</para>
+</sect2>
+
+<sect2>
+<title>Visibility and Snapping</title>
+<para>To hide guides select <menuchoice><guimenu>View</guimenu><guimenuitem>Guide Lines</guimenuitem></menuchoice>, this toggles the visibility.</para>
+<para>By default stencil edges are snapped to the nearest guide, to toggle this behavior select <menuchoice><guimenu>View</guimenu><guimenuitem>Snap Grid</guimenuitem></menuchoice>.</para>
+</sect2>
+
+</sect1>
+
+<sect1 id="layers">
+<title>Layers</title>
+<para>&kivio; allows complex diagrams to be split into multiple layers. The visibility of layers can be turned on and off. This functionality is useful if you have a basic diagram, for example a floorplan, and need to create several versions of it for different audiences. The information for each audience can be placed in a different layer.
+Each page of the document has its own set of layers.</para>
+
+<sect2>
+<title>The Layer Palette</title>
+<para>To adjust the current page's layers select <menuchoice><guimenu>View</guimenu><guisubmenu>Palettes</guisubmenu><guimenuitem>Show Layers </guimenuitem></menuchoice>. The layer palette allows layers to be created, deleted and renamed. It can also be used to adjust layer visibility, drawing order and select the current layer.</para>
+<para>&kivio; has the concept of the currently active layer which is the one affected by any editing actions. By default a page contains only one layer which is the active layer.</para>
+</sect2>
+
+<sect2>
+<title>Adding Layers</title>
+<para>Using the <guilabel>Layers</guilabel> palette you can add new layers by clicking the <guibutton>New Layer</guibutton> button, the first from the left. Layers can be deleted by clicking the second button, <guibutton>Remove Layer</guibutton>. &kivio; numbers the layers consecutively, to rename a layer select it in the list and click <guibutton>Rename Layer</guibutton>.</para>
+</sect2>
+
+<sect2>
+<title>Layer Settings</title>
+<para>Layers are drawn in the order they are listed. The drawing occurs from the top down so objects in the layer at the bottom of the list are drawn on top of objects in all the other layers. The order of the list can be changed by selecting a layer and using the <guibutton>Move Layer Up</guibutton> and <guibutton>Move Layer Down</guibutton> buttons to change its position.</para>
+<para>Each layer is listed with four small icons next to its name. From left
+to right they represent:</para>
+<variablelist>
+<varlistentry>
+<term>Visibility (shown as a small eye)</term>
+<listitem><para>Clicking on the icon will toggle the layer's visibility.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>Printable (shown as a small printer)</term>
+<listitem><para>Toggles if the layer should be printed with the document or
+not.  You might use a non-printing layer to keep notes to yourself, or as a
+scrapbook to hold images you're not ready to use yet.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Editable (shown as a small pencil)</term>
+<listitem><para>Toggles if you can edit a layer or not.  You might want to
+mark some layers non-editable while you work on others, to prevent
+inadvertant changes.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Connectable (shown as a small connector)</term>
+<listitem><para>You can permit connecting of items that lie on different
+layers with this icon.</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+</sect1>
+
+<sect1 id="arranging">
+<title>Arranging Stencils</title>
+
+<sect2>
+<title>The Align Tool</title>
+<para>The <guilabel>Align</guilabel> tool rearranges a group of stencils so that they are aligned on one edge or on an invisible centerline. To use the tool select several stencils, then select <menuchoice><guimenu>Format</guimenu><guimenuitem>Align &amp; Distribute...</guimenuitem></menuchoice>. If the stencils are arranged in a horizontal row you the choice of aligning along the top or bottom edges or the centerline. For stencils that are arranged in a vertical row the choice is left or right edge or the centerline.</para>
+</sect2>
+
+<sect2>
+<title>The Distribute Tool</title>
+<para>The <guilabel>Distribute</guilabel> tool arranges a group of stencils so that there is an even amount of spacing between each stencil.</para>
+<para>First select the stencils you want to rearrange, then select <menuchoice><guimenu>Format</guimenu><guimenuitem>Align &amp; Distribute...</guimenuitem></menuchoice> and click on the <guilabel>Distribute</guilabel> tab in the tabbed window that appears.</para>
+<para>You can choose whether the items should be spaced so that there is equal spacing between two edges, for example, the distance between the lefthand edge of each stencil should be the same. Or, whether the gap between each item should be identical. Choose the <guilabel>Spacing</guilabel> option if you desire this.</para>
+<para>The second choice is whether the spacing should use the entire extent of the page or just the extent of the selection. If the latter is chosen the stencils will not occupy any more space than they did originally.</para>
+<note><para>The option to use the extent of the page takes the page margins into consideration.</para></note>
+</sect2>
+</sect1>
+
+</chapter>