Warning, /office/kexi/doc/kexi/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003   <!ENTITY % addindex "IGNORE">
0004   <!ENTITY % English "INCLUDE">
0005   <!ENTITY calligra "Calligra">
0006   <!ENTITY ged.vertaald           '<othercredit role="translator"><firstname>Dit document is nog maar gedeeltelijk vertaald.</firstname> <surname>Wilt u meehelpen, stuur een bericht naar:</surname><affiliation><address> <email>kde-i18n-nl@kde.org</email></address></affiliation> <contrib>Nieuwe vertaler</contrib></othercredit>'>
0007 ]>
0008 <book id="kexi" lang="&language;">
0009 <bookinfo>
0010 <title>The &kexi; Handbook</title>
0011 <authorgroup>
0012 <author>
0013 <personname>
0014       <firstname>This documentation was converted from the KDE UserBase <ulink url=" http://userbase.kde.org/Kexi/Handbook/Introduction">Kexi/Handbook</ulink> page at 2012-09-14.</firstname>
0015 <surname></surname>
0016 </personname>
0017       </author>
0018 <author>
0019 <personname>
0020     <firstname>Update to 2.4 by the &kde; Documentation Team</firstname>
0021 <surname></surname>
0022 </personname>
0023  </author>
0024 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0025       </authorgroup>
0026 <legalnotice>&FDLNotice;</legalnotice>
0027 <date>2012-09-14</date>
0028       <releaseinfo>2.5</releaseinfo>
0029 <abstract>
0030   <para>
0031     &kexi; is the application for creating databases and for data management
0032     in the &calligra; productivity suite.
0033   </para>
0034 </abstract>
0035 
0036 <!-- Keywords -->
0037 <keywordset>
0038   <keyword>KDE</keyword>
0039   <keyword>Calligra</keyword>
0040   <keyword>Kexi</keyword>
0041   <keyword>database</keyword>
0042 </keywordset>
0043 </bookinfo>
0044 <!--userbase <timestamp>2012-09-14T07:13:33Z</timestamp>-->
0045 
0046 <!--userbase-content-->
0047 <chapter id="introduction"><title>Introduction</title> 
0048 <para>&kexi; is a database management application. It can be used for creating databases, inserting data, performing queries, and processing data. Forms can be created to provide a custom interface to your data. All database objects - tables, queries and forms - are stored in the database, making it easy to share data and design.
0049 </para>
0050 <para>&kexi; is part of the &calligra; productivity suite by KDE.
0051 </para>
0052 <para>In addition to storing your &kexi; databases in files, &kexi; can also store your data on a database server. Using a database server allows you to share your database with other people, and also allows more than one person to use the database at one time. The following database servers are supported by &kexi;:
0053 </para>
0054 <itemizedlist>
0055 <listitem><para><ulink url="http://www.mysql.com/">MySQL</ulink></para></listitem>
0056 <listitem><para><ulink url="http://www.postgresql.org/">PostgreSQL</ulink></para></listitem>
0057 </itemizedlist>
0058 <para>More information about &kexi; can be found at the &kexi; <ulink url="http://www.calligra-suite.org/kexi/">page on the Calligra website</ulink>, and on the <ulink url="http://www.kexi-project.org/about.html">website for Kexi itself</ulink>.
0059 </para>
0060 <para>If you have any questions about &kexi;, there are two mailing lists you can use. The &kexi; user mailing list can be used to ask questions about using &kexi; or about the &kexi; project. The &kexi; development mailing list can be used to ask questions about the development of &kexi;. Further information on how to subscribe to these lists, together with a few other ways of making contact with &kexi; developers, can be found  <ulink url="http://www.kexi-project.org/support.html">here</ulink>.
0061 </para>
0062 <para><note><para>This handbook for &kexi; 2.5 is meant to be based on the &kexi; Handbook for Kexi 1.1. Please coordinate any effort with Jarosław Staniek, email: kexi at kde.org</para></note>
0063 </para>
0064 </chapter>
0065 <chapter id="kexi-basics"><title>Kexi Basics</title> 
0066 <itemizedlist>
0067 <listitem><para><link linkend="kexi-databases">Kexi Databases</link>&nbsp;</para></listitem>
0068 <listitem><para><link linkend="creating-a-new-database-file">Creating a New Database File</link>&nbsp;</para></listitem>
0069 <listitem><para><link linkend="the-kexi-main-window">The Kexi Main Window</link>&nbsp;<itemizedlist>
0070 <listitem><para><link linkend="main-application-elements">Main application elements</link>&nbsp;</para></listitem>
0071 </itemizedlist>
0072 </para></listitem>
0073 <listitem><para><link linkend="opening-an-existing-kexi-database-file">Opening an existing Kexi database file</link>&nbsp;<itemizedlist>
0074 <listitem><para><link linkend="opening-a-database-file-in-the-open-existing-project-dialog">Opening a database file in the Open Project dialog</link>&nbsp;</para></listitem>
0075 <listitem><para><link linkend="opening-an-existing-kexi-database-file-by-clicking-on--kexi-files-icon">Opening an existing Kexi database file by clicking on .kexi file's icon</link>&nbsp;</para></listitem>
0076 </itemizedlist>
0077 </para></listitem>
0078 <listitem><para><link linkend="using-built-in-help">Using built-in help</link>&nbsp;</para></listitem>
0079 </itemizedlist>
0080 <sect1 id="kexi-databases"><title>Kexi Databases</title> 
0081 <para>Many applications such as <trademark class="registered">OpenOffice.org</trademark>, <trademark class="registered">LibreOffice</trademark> or <application>&Microsoft; Excel</application> create files which are called documents. &kexi; creates files too, but we refer to them as &kexi; database files, or simple database files here.
0082 </para>
0083 <para>In addition to storing your databases in database files, &kexi; can also use databases on database servers, which is why we refer to them as database files, and not simply as databases.
0084 </para>
0085 <para>The term &kexi; project, or simply project is also used to refer to a &kexi; database, regardless of whether it is stored in a file or on a database server.
0086 </para>
0087 <para><note><para>&kexi; database files usually have the extension <filename>.kexi</filename></para></note>
0088 </para>
0089 </sect1>
0090 <sect1 id="creating-a-new-database-file"><title>Creating a New Database File</title> 
0091 <para>
0092 <screenshot>
0093 <screeninfo></screeninfo>
0094   <mediaobject>
0095     <imageobject>
0096       <imagedata fileref="newproject.png" format="PNG"/>
0097     </imageobject>
0098     <textobject>
0099       <phrase></phrase>
0100     </textobject>
0101   </mediaobject>
0102 </screenshot>
0103 </para>
0104 <orderedlist>
0105 <listitem><para>Run &kexi;, or if it is already running, use <menuchoice><guimenu>Kexi</guimenu><guimenuitem>New... (Ctrl+N)</guimenuitem></menuchoice>.</para></listitem>
0106 <listitem><para>On the <guilabel>New Project</guilabel> page, under <guilabel>Blank Projects</guilabel> section, choose <guilabel>Blank Database</guilabel>.
0107 <screenshot>
0108 <screeninfo></screeninfo>
0109   <mediaobject>
0110     <imageobject>
0111       <imagedata fileref="projectstorage.png" format="PNG"/>
0112     </imageobject>
0113     <textobject>
0114       <phrase></phrase>
0115     </textobject>
0116   </mediaobject>
0117 </screenshot></para></listitem>
0118 <listitem><para>On the <guilabel>Storage Method</guilabel> page, click <guilabel>File</guilabel>.
0119 <screenshot>
0120 <screeninfo></screeninfo>
0121   <mediaobject>
0122     <imageobject>
0123       <imagedata fileref="projectfilename.png" format="PNG"/>
0124     </imageobject>
0125     <textobject>
0126       <phrase></phrase>
0127     </textobject>
0128   </mediaobject>
0129 </screenshot></para></listitem>
0130 <listitem><para>On the <guilabel>Project Title &amp; Filename</guilabel>, define a title and the filename for the project.</para></listitem>
0131 <listitem><para>Click <guilabel>Next</guilabel> to create the project.</para></listitem>
0132 </orderedlist>
0133 <para><note>
0134 <itemizedlist>
0135 <listitem><para>When you change the project title, the proposed filename automatically changes accordingly.</para></listitem>
0136 <listitem><para>You can use the file browser to choose a folder where you would like to save your database file.</para></listitem>
0137 </itemizedlist>
0138 </note></para>
0139 </sect1>
0140 <sect1 id="the-kexi-main-window"><title>The Kexi Main Window</title> 
0141 <para>
0142 <screenshot>
0143 <screeninfo></screeninfo>
0144   <mediaobject>
0145     <imageobject>
0146       <imagedata fileref="kexi_mainwindow.png" format="PNG"/>
0147     </imageobject>
0148     <textobject>
0149       <phrase></phrase>
0150     </textobject>
0151   </mediaobject>
0152 </screenshot>
0153 </para>
0154 <para>The <guilabel>Tabbed Toolbar</guilabel> on the top gives access to common actions and commands.
0155 </para>
0156 <para>The <guilabel>Project Navigator</guilabel> and <guilabel>Property Editor</guilabel> are shown in panes on each side of the child window. These can be resized or hidden as required. A pane can be hidden by clicking the small cross at the top of the pane (just below the toolbar).
0157 </para>
0158 <para>Database objects (tables, queries, &etc;) listed in the <guilabel>Project Navigator</guilabel> can be opened by clicking (or double-clicking, depending upon your global KDE settings) on their names.
0159 </para>
0160 <sect2 id="main-application-elements"><title>Main application elements</title> 
0161 <para>Main elements of &kexi; application's window are:
0162 </para>
0163 <variablelist>
0164   <varlistentry><term><emphasis role="bold">Tabbed Toolbar</emphasis></term>
0165     <listitem>
0166     <para>Contains available commands for the application. You will find detailed description of any of the commands in <link linkend="command-reference">the appendix</link>.</para>
0167      </listitem>
0168   </varlistentry>
0169   <varlistentry><term><emphasis role="bold">Project Navigator pane</emphasis></term>
0170     <listitem>
0171     <para>Contains a list of any object (tables, queries, forms, ...) created within the currently opened database project. The navigator also contains small toolbar with most usable commands related to the database objects.</para>
0172      </listitem>
0173   </varlistentry>
0174   <varlistentry><term><emphasis role="bold">Opened Database Objects Area / Tabbed Windows</emphasis></term>
0175     <listitem>
0176       <para>A central area of the application taking most of the screen space. <!--FIXME not in 2.4 For IDEAl user interface mode-->The user interface contains switchable tabs with windows that are always maximized.<!--FIXME not in 2.4  For Childframe user interface mode it contains floating windows.--></para>
0177      </listitem>
0178   </varlistentry>
0179   <varlistentry><term><emphasis role="bold">Property Editor pane</emphasis></term>
0180     <listitem>
0181     <para>Contains a list of properties of currently activated database object. For certain objects (&eg; form's widgets) it can have several tabs.</para>
0182      </listitem>
0183   </varlistentry>
0184 </variablelist>
0185 </sect2>
0186 <sect2 id="tabbed-toolbar"><title>Tabbed Toolbar</title> 
0187 <para>
0188 <screenshot>
0189 <screeninfo></screeninfo>
0190   <mediaobject>
0191     <imageobject>
0192       <imagedata fileref="kexi_tabbedtoolbar.png" format="PNG"/>
0193     </imageobject>
0194     <textobject>
0195       <phrase></phrase>
0196     </textobject>
0197   </mediaobject>
0198 </screenshot>
0199 </para>
0200 <para>The toolbar is the place that gives you access to most &kexi; commands and actions.
0201 </para>
0202 <para>Using the actions found in the different tabs on the toolbar you can:
0203 </para>
0204 <itemizedlist>
0205 <listitem><para>Create / Open / Close Kexi projects</para></listitem>
0206 <listitem><para>Create Database objects</para></listitem>
0207 <listitem><para>Import / Export Data</para></listitem>
0208 </itemizedlist>
0209 <para>Depending on the context, additional tabs can be visible:
0210 </para>
0211 <itemizedlist>
0212 <listitem><para><guilabel>Form Design</guilabel> tab is visible if the Form Designer is actually used.</para></listitem>
0213 <listitem><para><guilabel>Report Design</guilabel> tab is visible if the Report Designer is actually used.</para></listitem>
0214 </itemizedlist>
0215 </sect2>
0216 <sect2 id="project-navigator-pane"><title>Project Navigator pane</title> 
0217 <para>
0218 <screenshot>
0219 <screeninfo></screeninfo>
0220   <mediaobject>
0221     <imageobject>
0222       <imagedata fileref="kexi_projectnavigator.png" format="PNG"/>
0223     </imageobject>
0224     <textobject>
0225       <phrase></phrase>
0226     </textobject>
0227   </mediaobject>
0228 </screenshot>
0229 </para>
0230 <para>The <guilabel>Project Navigator</guilabel> pane is one of the most frequently used elements of the &kexi; main window. The pane contains a list of all objects created within the currently opened Kexi database project. The objects are split into groups: tables, queries, forms, reports and scripts.
0231 </para>
0232 <para>The Project Navigator pane also contains a small toolbar for most frequently used commands (from left to right): <guilabel>Open</guilabel> selected object, <guilabel>Design</guilabel> selected object, and <guilabel>Delete</guilabel> selected object.
0233 </para>
0234 <para>For each object on the list a context menu is available using the right mouse button.
0235 </para>
0236 <para>Double clicking with the left mouse button on the object's name on the list opens the object in <guilabel>Data View</guilabel>. If the object's window was already opened, the action just activates the window without switching it's view mode.
0237 </para>
0238 <para><note><para>Even though your operating system or window manager may be set up to handle single clicks instead of double clicks, &kexi; uses double clicks in <guilabel>Project Navigator</guilabel> to avoid accidentally opening large datasets or executing queries.</para></note>
0239 </para>
0240 </sect2>
0241 <sect2 id="opened-database-objects-area---tabbed-windows"><title>Opened database objects area / Tabbed Windows</title> 
0242 <para>
0243 <screenshot>
0244 <screeninfo></screeninfo>
0245   <mediaobject>
0246     <imageobject>
0247       <imagedata fileref="kexi_windowtabs.png" format="PNG"/>
0248     </imageobject>
0249     <textobject>
0250       <phrase></phrase>
0251     </textobject>
0252   </mediaobject>
0253 </screenshot>
0254 </para>
0255 <para>Whenever you double click an object in the project navigator, it opens in the <guilabel>Opened database objects area</guilabel>. Each window has its own tab in &kexi;.
0256 </para>
0257 <para>You can rearrange the tabs by drag and drop and close them using the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-tab-close.png" format="PNG"/> </imageobject> </inlinemediaobject> button located at the far right of the tab strip.
0258 </para>
0259 <para><note><para>Sometime later on there will be an option to detach tabs, creating somewhat something similar to an MDI interface. That could be useful for custom solutions or multiple displays.</para></note>
0260 </para>
0261 </sect2>
0262 <sect2 id="property-editor-pane"><title>Property Editor pane</title> 
0263 <para>
0264 <screenshot>
0265 <screeninfo></screeninfo>
0266   <mediaobject>
0267     <imageobject>
0268       <imagedata fileref="kexi_propertyeditor.png" format="PNG"/>
0269     </imageobject>
0270     <textobject>
0271       <phrase></phrase>
0272     </textobject>
0273   </mediaobject>
0274 </screenshot>
0275 </para>
0276 <para>In the <guilabel>Property Editor</guilabel> pane you can change properties of the object displayed in the active window. Depending on the context, the pane is consisted of one or more tabs. The first, always visible tab, <guilabel>Properties</guilabel>, contains the list of available properties.
0277 </para>
0278 <para>Rules for using the <guilabel>Property Editor</guilabel>:
0279 </para>
0280 <itemizedlist>
0281 <listitem><para>Each row contains a single property.</para></listitem>
0282 <listitem><para>You can use the mouse or the keyboard to change values of particular properties.</para></listitem>
0283 <listitem><para>Most frequently used types of property values are:<itemizedlist>
0284 <listitem><para>a number; you can enter the value directly or increase or decrease its value by clicking with the left mouse button on the arrows.</para></listitem>
0285 <listitem><para>text</para></listitem>
0286 <listitem><para>drop down list of values</para></listitem>
0287 <listitem><para>Yes/No; you can toggle the value by clicking on the button; Yes (true) means that the button is toggled on, No (false) means that the button is toggled off.</para></listitem>
0288 </itemizedlist>
0289 </para></listitem>
0290 </itemizedlist><para><note>
0291 <itemizedlist>
0292 <listitem><para>There is no need to confirm a changed value: changes are visible immediately after moving to a different row of the Property Editor's list or by pressing the &Enter; key.</para></listitem>
0293 <listitem><para>Names of the recently changed properties that not yet were stored in the database are marked with bold text.</para></listitem>
0294 <listitem><para>After changing the value of a property, a special <guilabel>Undo changes</guilabel> button appears on the right side of the Property Editor's list. By clicking it you can revert the value of the property to the original value that was loaded from the database upon opening the database object. The button is only visible when the property is actually highlighted.</para></listitem>
0295 </itemizedlist>
0296 </note></para>
0297 <para>The <guilabel>Property Editor</guilabel> pane is empty if:
0298 </para>
0299 <itemizedlist>
0300 <listitem><para>no single database object's window is opened, or</para></listitem>
0301 <listitem><para>the active database object's window does not offer properties; it is usually the case when it is opened in <guilabel>Data View</guilabel> instead of <guilabel>Design View</guilabel>.</para></listitem>
0302 </itemizedlist>
0303 </sect2>
0304 </sect1>
0305 <sect1 id="opening-an-existing-kexi-database-file"><title>Opening an existing Kexi database file</title> 
0306 <para>There are two ways to open an existing &kexi; database file:
0307 </para>
0308 <sect2 id="opening-a-database-file-in-the-open-existing-project-dialog"><title>Opening a database file in the Open Project dialog</title> 
0309 <itemizedlist>
0310 <listitem><para>Run &kexi;. You should see the <guilabel>Welcome to Kexi</guilabel> startup dialog, which allows you select one of the recently used projects to open.</para></listitem>
0311 <listitem><para>If the project is not on the page with recently used projects choose <guibutton>Open...</guibutton> (<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>). You will see the following dialog:</para>
0312 <para>
0313 <screenshot>
0314 <screeninfo></screeninfo>
0315   <mediaobject>
0316     <imageobject>
0317       <imagedata fileref="kexi_openproject.png" format="PNG"/>
0318     </imageobject>
0319     <textobject>
0320       <phrase></phrase>
0321     </textobject>
0322   </mediaobject>
0323 </screenshot>
0324 </para>
0325 </listitem>
0326 <listitem><para>From the location bar, pick a folder containing a file you are looking for.</para></listitem>
0327 <listitem><para>You can either pick a file which is immediately opened. Alternatively you enter its name in the <guilabel>Name:</guilabel> box and click on <guilabel>Next</guilabel>.</para></listitem>
0328 </itemizedlist>
0329 <para><guilabel>Notes</guilabel>
0330 </para>
0331 <itemizedlist>
0332 <listitem><para>By default the <guilabel>Filter:</guilabel> drop down list has <guilabel>All Supported Files (*.kexi, *.kexic, *.kexis, *.mdb)</guilabel> selected. In case the file you are looking for has another extension, you can change the selection of the <guilabel>Filter:</guilabel> drop down list to <guilabel>All Files</guilabel> to display all available files (regardless of an extension).</para></listitem>
0333 <listitem><para>If you have selected a file of an external type, like a <guilabel>MS Access</guilabel> <filename>.mdb</filename> file, &kexi; will provide you with the option to import the file.</para></listitem>
0334 <listitem><para>If you have selected a connection data file (with <filename>.kexic</filename> extension) or a shortcut to a project on database server file (with <filename>.kexis</filename> extension), &kexi; will display appropriate dialogs.</para></listitem>
0335 </itemizedlist>
0336 </sect2>
0337 <sect2 id="opening-an-existing-kexi-database-file-by-clicking-on--kexi-files-icon"><title>Opening an existing Kexi database file by clicking on .kexi file's icon</title> 
0338 <itemizedlist>
0339 <listitem><para>Click file's icon using your file manager or desktop. &kexi; will open this database project automatically.</para></listitem>
0340 </itemizedlist>
0341 <para><guilabel>Notes</guilabel>
0342 </para>
0343 <para>Note about database files accessed remotely. You may want to open a database file that is located on a remote source (&eg; a web or FTP server or a MS Windows network share). KDE allows you to open files from remote sources directly in applications and to save changes back to the source, but this is not the case with database files. By clicking on a database file located on a remote source, a copy of the file will be downloaded to a temporary directory on your computer and all your changes will be made to this local file. The remote original of the file will remain unchanged, so it's recommended to copy (download) the file to your computer first, then open the file and copy it back to the remote source if you want to make it up to date.
0344 </para>
0345 </sect2>
0346 </sect1>
0347 <sect1 id="using-built-in-help"><title>Using built-in help</title> 
0348 <para>The following ways to get built-in help in &kexi; are available:
0349 </para>
0350 <variablelist>
0351   <varlistentry><term><emphasis role="bold">The Handbook in form of electronic document.</emphasis></term>
0352     <listitem>
0353     <para>The Handbook is available by pressing <keycap>F1</keycap> key or click <inlinemediaobject> <imageobject> <imagedata fileref="Icon-help-contents.png" format="PNG"/> </imageobject> </inlinemediaobject> in the menubar and select <guilabel>Help</guilabel>.</para>
0354      </listitem>
0355   </varlistentry>
0356   <varlistentry><term><emphasis role="bold"><emphasis>What's This?</emphasis> hints.</emphasis></term>
0357     <listitem>
0358     <para>Select <guilabel>What's This?</guilabel> from the menu that pops up when you click  <inlinemediaobject> <imageobject> <imagedata fileref="Icon-help-contents.png" format="PNG"/> </imageobject> </inlinemediaobject> and then click on an area of the application to get hints about it.</para>
0359      </listitem>
0360   </varlistentry>
0361 </variablelist>
0362 </sect1>
0363 </chapter>
0364 <chapter id="building-simple-databases"><title>Building Simple Databases</title> 
0365 <itemizedlist>
0366 <listitem><para><link linkend="building-simple-databases">Introduction</link>&nbsp;</para></listitem>
0367 <listitem><para><link linkend="designing-database-tables">Designing Database Tables</link>&nbsp;<itemizedlist>
0368 <listitem><para><link linkend="the-table-designer-window">The Table Designer window</link>&nbsp;</para></listitem>
0369 </itemizedlist>
0370 </para></listitem>
0371 <listitem><para><link linkend="entering-data-into-tables">Entering Data Into Tables</link>&nbsp;</para></listitem>
0372 <listitem><para><link linkend="designing-database-queries">Designing Database Queries</link>&nbsp;</para></listitem>
0373 <listitem><para><link linkend="designing-forms">Designing Forms</link>&nbsp;<itemizedlist>
0374 <listitem><para><link linkend="most-important-terms">Most important terms</link>&nbsp;</para></listitem>
0375 <listitem><para><link linkend="forms-versus-tables">Forms versus tables</link>&nbsp;</para></listitem>
0376 <listitem><para><link linkend="working-with-form-design">Working with form design</link>&nbsp;</para></listitem>
0377 <listitem><para><link linkend="using-the-widgets-tab">Using the Widgets tab</link>&nbsp;</para></listitem>
0378 <listitem><para><link linkend="inserting-widgets---text-fields">Inserting widgets - text fields</link>&nbsp;</para></listitem>
0379 <listitem><para><link linkend="assigning-data-sources">Assigning data sources</link>&nbsp;</para></listitem>
0380 <listitem><para><link linkend="inserting-text-labels">Inserting text labels</link>&nbsp;</para></listitem>
0381 <listitem><para><link linkend="actions">Actions</link>&nbsp;</para></listitem>
0382 <listitem><para><link linkend="widget-layouts">Widget layouts</link>&nbsp;</para></listitem>
0383 <!--FIXME not implemented in kexi 2.4
0384 <listitem><para><link linkend="setting-widgets-size-and-position-by-hand">Setting widgets size and position by hand</link>&nbsp;</para></listitem>
0385 <listitem><para><link linkend="setting-the-tab-order">Setting the tab order</link>&nbsp;</para></listitem>
0386 -->
0387 </itemizedlist>
0388 </para></listitem>
0389 <listitem><para><link linkend="entering-data-using-forms">Entering Data Using Forms</link>&nbsp;</para></listitem>
0390 </itemizedlist>
0391 <sect1 id="introduction0"><title>Introduction</title> 
0392 <para>To learn the basics of &kexi;, you could build a simple database utilizing most elementary &kexi;'s features. To make things simpler, advanced database design topics will not be covered here.
0393 </para>
0394 <para>Start by creating a new empty Phone Book.
0395 </para>
0396 <para>Having a new empty database project, perform the following steps:
0397 </para>
0398 <orderedlist>
0399 <listitem><para>Design database tables. Read the section called <link linkend="designing-database-tables">Designing Database Tables</link>.</para></listitem>
0400 <listitem><para>Enter data into tables. Read the section called <link linkend="entering-data-into-tables">Entering Data Into Tables</link>.</para></listitem>
0401 <listitem><para>Design database queries. Read the section called <link linkend="designing-database-queries">Designing Database Queries</link>.</para></listitem>
0402 <listitem><para>Design forms. Read the section called <link linkend="designing-forms">Designing Forms</link>.</para></listitem>
0403 <listitem><para>Use forms to enter data. Read the section called <link linkend="entering-data-using-forms">Entering Data Using Forms</link>.</para></listitem>
0404 </orderedlist>
0405 </sect1>
0406 <sect1 id="designing-database-tables"><title>Designing Database Tables</title> 
0407 <!--FIXME to refer to these two tables later, sometimes the caption "Persons"/"Phones" and sometimes the Name "persons"/"phone_numbers" are used; together with different markup guilabel/replaceable, make that consistent. It is really confusing-->
0408 <para>First, there will be two tables added to your database: <replaceable>Persons</replaceable> and <replaceable>Phones</replaceable>. These are exactly the same tables as described in chapter <link linkend="database-and-spreadsheet">Database and Spreadsheet</link>. A layout for <replaceable>Persons</replaceable> can be found in section <link linkend="data-integrity-and-validity">Data integrity and validity</link> in that chapter.
0409 </para>
0410 <orderedlist>
0411 <listitem><para>Select <guilabel>Table</guilabel> from the toolbar. You can also use <guilabel>Create object: table</guilabel> in the context menu of the <guilabel>Tables</guilabel> item in the Project Navigator.</para></listitem>
0412 <listitem><para>The Table Designer's window will appear. Looking at the top of designer's window you will notice that &kexi; proposed you a generic name like <guilabel>Table1</guilabel> for the new table. The table design is not saved yet so you will be able to assign more proper name later. Moreover, because of the same reason, the table name is not yet visible in the <guilabel>Project Navigator</guilabel>.</para></listitem>
0413 </orderedlist>
0414 <sect2 id="the-table-designer-window"><title>The Table Designer window</title> 
0415 <sect3 id="table-designer-window-consists-of-following-columns-"><title>Table Designer window consists of following columns:</title> 
0416 <itemizedlist>
0417 <listitem><para><inlinemediaobject> <imageobject> <imagedata fileref="Icon-help-about-desaturated.png" format="PNG"/> </imageobject> </inlinemediaobject> - Additional Information about the field.</para></listitem>
0418 <listitem><para><guilabel>Field Caption</guilabel> - caption of the field which will be displayed during data entering.</para></listitem>
0419 <listitem><para><guilabel>Data Type</guilabel> - a combo box containing a list of data types, allowing to set a main rule for entered data for a given field. For example, when an integer number data type is set for a field, a database user will not able to enter letter characters into this field.</para></listitem>
0420 <listitem><para><guilabel>Comments</guilabel> - you can enter here any information useful for understanding what the given field is provided for. This additional text will be saved within the table design and only visible in design mode.</para></listitem>
0421 </itemizedlist>
0422 <para>In the Table designer window, every row corresponds to a single table field. You can recognize you are in design mode because the <guilabel>Design</guilabel> button is toggled on within the Table designer window toolbar.
0423 </para>
0424 </sect3>
0425 <sect3 id="designing-the-persons-table"><title>Designing the Persons table</title> 
0426 <para>In the first row click on the cell in the <guilabel>Field Caption</guilabel> column and enter <replaceable>Name</replaceable> as field caption. Filling the <guilabel>Field Caption</guilabel> field automatically fills the <guilabel>Name</guilabel> field as seen in the <guilabel>Property Editor</guilabel> pane.
0427 </para>
0428 <para>Notes about field names and captions
0429 </para>
0430 <itemizedlist>
0431 <listitem><para>Every table field must have a name and a caption, these cannot be empty.</para></listitem>
0432 <listitem><para>Field name is a word used by the database, usually not visible for users of the database application. The name may not contain special (national) characters (like ±, ¶, Ü) or space characters. The name must only contain roman letters, numbers and underscore sign <quote>_</quote>. Use the latter instead of spaces or dashes.</para></listitem>
0433 <listitem><para>Field names must be started with a letter or underscore sign <quote>_</quote>, never with a number.</para></listitem>
0434 <listitem><para>It does not matter whether you are using small or capital letters. For &kexi; the field name <replaceable>Persons</replaceable> is the same as <replaceable>persons</replaceable>.</para></listitem>
0435 <listitem><para>Field caption, on the other hand, allows you to enter any letters and special characters. It will be displayed for users of the database application.</para></listitem>
0436 </itemizedlist>
0437 <para>In a similar way, enter the following fields into the table design:
0438 </para>
0439 <itemizedlist>
0440 <listitem><para><replaceable>surname</replaceable></para></listitem>
0441 <listitem><para><replaceable>street</replaceable></para></listitem>
0442 <listitem><para><replaceable>house_number</replaceable></para></listitem>
0443 <listitem><para><replaceable>city</replaceable></para></listitem>
0444 </itemizedlist>
0445 <para>All the above fields, except <replaceable>house_number</replaceable>, are of type text. Change <replaceable>house_number</replaceable> field's type to integer number. To do this, click on a cell in the <guilabel>Data Type</guilabel> column, <replaceable>house_number</replaceable> row and then click on drop down list's button or press <keycap>F4</keycap>. The list of data types will appear. You can also use the arrow keys <keysym>Up</keysym> and <keysym>Down</keysym> to select another type. Select the <guilabel>Integer Number</guilabel> type.
0446 </para>
0447 <para>From now on, the <replaceable>house_number</replaceable> field only accepts numbers.
0448 </para>
0449 <para>Persons table design is ready. Click the <guilabel>Data</guilabel> button on the toolbar to finish designing and switch to <guilabel>Data View</guilabel> for the table. This allows you to enter data into the table.
0450 </para>
0451 <para>As the design is not yet saved in the database, the <guilabel>Save Object As</guilabel> dialog window appears. You need to specify the name for the new table.
0452 </para>
0453 <para>&kexi; offers a generic name like <guilabel>Table1</guilabel>. To change the name, enter <replaceable>Persons</replaceable> into the <guilabel>Caption</guilabel> field and press the &Enter; key or click the <keycap>OK</keycap> button. The <guilabel>Caption</guilabel> field will be used to display the table to database end-users, &eg; as a form. Unlike the name, the caption can contain any characters including spaces and special characters.
0454 </para>
0455 <para>Note that filling the <guilabel>Caption</guilabel> field automatically fills the <guilabel>Name</guilabel> field. For your convenience the rule for using only letters, numbers and the <quote>_</quote> character is kept. You can alter the contents of the <guilabel>Name</guilabel> field if you want to.
0456 </para>
0457 <orderedlist>
0458 <listitem><para>You are asked about an agreement for automatic adding of primary key to the table. Click <guilabel>Add primary key</guilabel> button to continue.</para></listitem>
0459 <listitem><para>The <replaceable>Persons</replaceable> table has been created and opened in Data View. Its name appears in the <guilabel>Project Navigator</guilabel> pane.</para></listitem>
0460 <listitem><para>Create the <replaceable>Phones</replaceable> table, in a similar way as <replaceable>Persons</replaceable> table.</para></listitem>
0461 <listitem><para>Create a <replaceable>person</replaceable> field of type <guilabel>Integer</guilabel> number and <replaceable>phone</replaceable> of type <guilabel>Text</guilabel>. Do not use a number type here because phone numbers can have many different forms and prefixes.</para></listitem>
0462 <listitem><para>Click the <guilabel>Data</guilabel> button on the toolbar and enter <replaceable>Phones</replaceable> caption for the table. As for your previous table, allow &kexi; to automatically create a primary key.</para></listitem>
0463 </orderedlist>
0464 </sect3>
0465 </sect2>
0466 </sect1>
0467 <sect1 id="entering-data-into-tables"><title>Entering Data Into Tables</title> 
0468 <para>You have designed the two tables <replaceable>Persons</replaceable> and <replaceable>Phones</replaceable>. None of them contain any data yet. You can enter some, and in this chapter you will learn how to do this fast and effectively.
0469 </para>
0470 <para>Start with the <replaceable>Persons</replaceable> table. Open it in Data View using <guilabel>Open</guilabel>  in the <guilabel>Project Navigator's</guilabel> context menu or the toolbar button. The current cell is marked with (usually black) thicker border, a cell cursor. The contents of the cell, if present, are highlighted with a different color. The current row, &ie; the one you have placed your rectangular cursor in, is marked on the left hand with an arrow symbol.
0471 </para>
0472 <para>You can navigate through table cells using the arrow keys, <keycap>Page Down</keycap>, <keycap>Page Down</keycap>, <keycap>Home</keycap>, <keycap>End</keycap> keys; you can also click with the mouse in a cell to select it.
0473 </para>
0474 <para>Initially, after opening the table <replaceable>Persons</replaceable>, the cursor is placed in the <replaceable>Id</replaceable> column. The column has autonumber property defined, marked with blue (autonumber) text in the last row. It means you do not have to enter values there by hand when entering data for a new row because the cell will be filled automatically with successive numbers.
0475 </para>
0476 <para>Inserting new rows and entering data for them in &kexi; is different from the way of doing this in spreadsheets. To enter data for a new row, you need to use the arrow keys or mouse, to move your cursor to the special empty last row marked with a plus sign. Place your cursor in the (second) <replaceable>name</replaceable> column and enter a person's name. Also enter surname, street, house number and city. When done, move the cell cursor to the last empty row either by using the <keycap>Down</keycap> key or by clicking in the last row with the mouse to append a new row.
0477 </para>
0478 <sect2 id="details-about-actions-available-while-entering-data-into-tables"><title>Details About Actions Available While Entering Data Into Tables</title> 
0479 <itemizedlist>
0480 <listitem><para>As soon as you enter the first character, the current row is being edited. A pencil symbol appears on the left side of the data table.</para></listitem>
0481 <listitem><para>Double clicking a cell with the left mouse button or pressing &Enter; or the <keycap>F2</keycap> key also starts editing of the current row.</para></listitem>
0482 <listitem><para>Pressing the &Esc; key when the contents of a cell is edited cancels changes made to this cell. However, the pencil symbol will not disappear because you can still move to a different cell of the edited row to change its contents. To cancel changes made to the entire edited row, press the &Esc; key again.</para></listitem><!--FIXME Esc does not work in master (2.4) as described here bug in docs or app?-->
0483 <listitem><para>Instead of pressing the &Esc; key, you can click the <guilabel>Cancel Record Changes</guilabel> toolbar button.</para></listitem>
0484 <listitem><para>Press the <keycombo>&Shift;&Enter;</keycombo> keys to accept changes made to all cells in the currently edited row.</para></listitem>
0485 </itemizedlist>
0486 <para>Fill the <replaceable>Phones</replaceable> table with data. In the <replaceable>person</replaceable> column you need to provide an <replaceable>Id</replaceable> number of the person existing in the <replaceable>Persons</replaceable> table.
0487 </para>
0488 </sect2>
0489 </sect1>
0490 <sect1 id="designing-database-queries"><title>Designing Database Queries</title> 
0491 <para>A database's primary purpose is to store and help extract information you are looking for. Unlike databases written on a paper sheets, &kexi; database allows you to specify more search criteria. Results are returned faster even for large data sets. All this is a power of databases, however to be able to perform effective queries in your database, you need to learn how to tell the database what you are looking for.
0492 </para>
0493 <para>With database queries you can limit data coming from a table to a predefined set of rows and columns as well as dynamically join data coming from multiple tables.
0494 </para>
0495 <para>To see how queries work in practice you will create a contacts query joining data from two tables: <replaceable>Persons</replaceable> and <replaceable>Phones</replaceable> (designed <link linkend="designing-database-tables">here</link> and filled with data <link linkend="entering-data-into-tables">here</link>).
0496 </para>
0497 <orderedlist>
0498 <listitem><para>Create a new empty query by selecting <guilabel>Query</guilabel> from the toolbar. The design window will appear. The window is split into two areas: query relationships at the top and query columns below.</para></listitem>
0499 <listitem><para>Select the table <replaceable>Persons</replaceable> in the drop down list <guilabel>Table:</guilabel> located at the top of the window and click the <guilabel>Insert</guilabel> button. A graphical representation of the table will appear in the relations area. Do the same for the <replaceable>Phones</replaceable> table to insert it too.</para></listitem>
0500 <listitem><para>Add query relationship using mouse drag &amp; drop technique: click the field <replaceable>id</replaceable> in the <replaceable>persons</replaceable> table, drag it and drop into the <replaceable>person</replaceable> field of the <replaceable>Phones</replaceable> table. This will join both fields by creating a new relationship.</para></listitem>
0501 <listitem><para>Double-click the <replaceable>name</replaceable> field in the <replaceable>Persons</replaceable> table, to add the field as a query column. In a similar way, add <replaceable>surname</replaceable>, <replaceable>street</replaceable>, <replaceable>house_number</replaceable>, <replaceable>city</replaceable> fields from the <replaceable>Persons</replaceable> table and <replaceable>phone</replaceable> from the <replaceable>Phones</replaceable> table.</para></listitem>
0502 <listitem><para>Query design is now ready for testing. Click the <guilabel>Data</guilabel> button on the toolbar, to switch from design to viewing the data provided as query results.</para></listitem>
0503 <listitem><para>Save the query design for later use by clicking the <guilabel>Save</guilabel> button on the toolbar. Because the query design has not been saved yet, you will be asked to specify a name for it. Enter <replaceable>Contacts</replaceable> text in the caption field and click the <guilabel>OK</guilabel> button.</para></listitem>
0504 </orderedlist>
0505 </sect1>
0506 <sect1 id="designing-forms"><title>Designing Forms</title> 
0507 <itemizedlist>
0508 <listitem><para><link linkend="most-important-terms">Most important terms</link>&nbsp;</para></listitem>
0509 <listitem><para><link linkend="forms-versus-tables">Forms versus tables</link>&nbsp;</para></listitem>
0510 <listitem><para><link linkend="working-with-form-design">Working with form design</link>&nbsp;</para></listitem>
0511 <listitem><para><link linkend="using-the-widgets-tab">Using the Widgets tab</link>&nbsp;</para></listitem>
0512 <listitem><para><link linkend="inserting-widgets---text-fields">Inserting widgets - text fields</link>&nbsp;</para></listitem>
0513 <listitem><para><link linkend="assigning-data-sources">Assigning data sources</link>&nbsp;</para></listitem>
0514 <listitem><para><link linkend="inserting-text-labels">Inserting text labels</link>&nbsp;</para></listitem>
0515 <listitem><para><link linkend="actions">Actions</link>&nbsp;</para></listitem>
0516 <listitem><para><link linkend="widget-layouts">Widget layouts</link>&nbsp;</para></listitem>
0517 <!--FIXME not implemented in kexi 2.4
0518 <listitem><para><link linkend="setting-widgets-size-and-position-by-hand">Setting widgets size and position by hand</link>&nbsp;</para></listitem>
0519 <listitem><para><link linkend="setting-the-tab-order">Setting the tab order</link>&nbsp;</para></listitem>
0520 -->
0521 </itemizedlist>
0522 <sect2 id="most-important-terms"><title>Most important terms</title> 
0523 <variablelist>
0524   <varlistentry><term><emphasis role="bold">Form</emphasis></term>
0525     <listitem>
0526     <para>A window provided for easy data entry and presentation on the computer screen.</para>
0527      </listitem>
0528   </varlistentry>
0529   <varlistentry><term><emphasis role="bold">Form's data source</emphasis></term>
0530     <listitem>
0531     <para>Database table or query providing data displayed in the form. The data source is needed because forms itself are only tools for displaying and entering data, while tables and queries are the source of data. New, empty forms have no data source assigned, so they are not displaying any data from your database unless you assign a data source to them.</para>
0532      </listitem>
0533   </varlistentry>
0534   <varlistentry><term><emphasis role="bold">Form field</emphasis></term>
0535     <listitem>
0536     <para>Direct equivalent of a column in a table or query. Most frequently used are fields for displaying text and numbers. Entering a new value or changing the existing value of such a field causes a change in the bound table or query column (after accepting the change).</para>
0537      </listitem>
0538   </varlistentry>
0539   <varlistentry><term><emphasis role="bold">Form design</emphasis></term>
0540     <listitem>
0541     <para>Tasks you are performing to define the appearance and functions of the form. To do this, you need to provide data source, insert form fields of various types and place them at the appropriate location.</para>
0542      </listitem>
0543   </varlistentry>
0544   <varlistentry><term><emphasis role="bold">Form widget</emphasis></term>
0545     <listitem>
0546     <para>Form's element. Main widget types are:</para>
0547 <itemizedlist>
0548 <listitem><para>Widgets displaying information, &eg; a text box or an image box. Each widget of this type can be bound to a data source field (a table or a query column). Therefore, such widgets are called in short form fields.</para></listitem>
0549 <listitem><para>Widgets able to perform a specified action, &eg; a push button that can close the current form. Within other applications this widget type is sometimes called form control because it can perform previously defined action of controlling your database application's behavior.</para></listitem>
0550 <listitem><para>Other widgets allowing to enrich a form's appearance, &eg; a “line widget” can visually separate two form areas.</para></listitem>
0551 </itemizedlist>
0552 
0553      </listitem>
0554   </varlistentry>
0555   <varlistentry><term><emphasis role="bold">Container widget</emphasis></term>
0556     <listitem>
0557     <para>A widget that can contain other widgets within its area. For example, frame widget or tab widget are containers. The form's surface itself is a container as well. A command button cannot be called as container because it is not possible to insert a widget inside it. In more complex cases, container widgets can be inserted inside a container, so nesting is possible.</para>
0558      </listitem>
0559   </varlistentry>
0560 </variablelist>
0561 </sect2>
0562 <sect2 id="forms-versus-tables"><title>Forms versus tables</title> 
0563 <para>In chapter <link linkend="entering-data-into-tables">Entering Data Into Tables</link> you learned about how to enter data directly into tables using their data sheet view. However, in many cases forms are better suited for data entry:
0564 </para>
0565 <itemizedlist>
0566 <listitem><para>A table can contain too many columns to display them on your screen. A form can display such a data using multiple rows.</para></listitem>
0567 <listitem><para>A form allows to visually split data fields into logical groups, thus increasing readability. Labels with additional information can be inserted to give users more hints on how to use the form or what given data fields mean.</para></listitem>
0568 <listitem><para>Command buttons can be used within forms for commonly used commands so users can use forms in a similar way as a standalone applications they know.</para></listitem>
0569 </itemizedlist>
0570 <para>In data sheet view displaying multi-row data text fields or images is as easy as within forms.
0571 </para>
0572 </sect2>
0573 <sect2 id="working-with-form-design"><title>Working with form design</title> 
0574 <para>As with table or query design, you are able to use Data View and Design View. Form designing is performed in Design View. We will often refer to the form design window as to <emphasis>Form Designer</emphasis>.
0575 </para>
0576 <orderedlist>
0577 <listitem><para>To create a new empty form, select <guilabel>Form</guilabel> from the toolbar. Optionally, you can use the <guilabel>Create Object: Form</guilabel> command from drop-down button on the Project Navigator's toolbar or <guilabel>Create Object: Form</guilabel> command from the context menu of the Project Navigator.</para></listitem>
0578 <listitem><para>A new frame will appear, you can resize the form by moving the borders. The form is covered with a grid which simplifies accurate positioning of the widgets.</para></listitem>
0579 </orderedlist>
0580 <para>As with table design, Form Designer provides a <guilabel>Property Editor</guilabel> pane. To save some space on the screen, the pane has three tabs related to the currently selected form:
0581 </para>
0582 <variablelist>
0583   <varlistentry><term><emphasis role="bold">The Properties tab</emphasis></term>
0584     <listitem>
0585     <para>Contains a list of properties for the currently selected widget.</para>
0586      </listitem>
0587   </varlistentry>
0588   <varlistentry><term><emphasis role="bold">The Data source tab <inlinemediaobject> <imageobject> <imagedata fileref="Icon-server-database.png" format="PNG"/> </imageobject> </inlinemediaobject></emphasis></term>
0589     <listitem>
0590     <para>Contains properties related specifically to the data source of the currently selected widget or the form itself.</para>
0591      </listitem>
0592   </varlistentry>
0593   <varlistentry><term><emphasis role="bold">The Widgets tab <inlinemediaobject> <imageobject> <imagedata fileref="Icon-action-widgets.png" format="PNG"/> </imageobject> </inlinemediaobject></emphasis></term>
0594     <listitem>
0595     <para>Contains a hierarchy of all widgets of the form. The list simplifies widgets lookup by name and navigation between them.</para>
0596      </listitem>
0597   </varlistentry>
0598 </variablelist>
0599 <para>There is information about currently selected widget's name and type displayed on the first and second tab.
0600 </para>
0601 <para>Additional toolbars are also available:
0602 </para>
0603 <itemizedlist>
0604 <listitem><para>The <guilabel>Widgets</guilabel> toolbar used for inserting new widgets into the form. Select <guibutton>Form Design</guibutton> to display it.</para></listitem>
0605 <!--FIXME no Format toolbar and Format menu in master/2.4
0606 <listitem><para>The <guilabel>Format</guilabel> toolbar used to format form's elements (&eg; adjusting widget's size, grouping). Formatting commands are also available in the <guilabel>Format</guilabel> menu.</para></listitem>-->
0607 </itemizedlist>
0608 </sect2>
0609 <sect2 id="using-the-widgets-tab"><title>Using the Widgets tab</title> 
0610 <para>The widgets tab <inlinemediaobject> <imageobject> <imagedata fileref="Icon-action-widgets.png" format="PNG"/> </imageobject> </inlinemediaobject> in the <guilabel>Properties</guilabel> pane provides a list of form widgets and their hierarchy. Each widget is presented within the hierarchy beside other widgets being on the same level (the same parent container). Child widgets (inside containers) are presented using indented names.
0611 </para>
0612 <para>Each widget has displayed its name and type. The type has also an icon displayed - the same as the one displayed on the toolbar used while form designing is performed.
0613 </para>
0614 <para><note>
0615 <itemizedlist>
0616 <listitem><para>Changing the current selection on the list causes appropriate selection on the designed form. This allows for easier widget lookup by name and easier navigation. For example, it is possible to select a widget by name, and then switch to the <guilabel>Properties</guilabel> tab to change the widget's properties.</para></listitem>
0617 <listitem><para>Keeping the &Ctrl; key pressed while an item on the widgets list is being selected allows to select multiple widgets at a time. Keeping the &Shift; key pressed allows to select entire lists of widgets.</para></listitem>
0618 </itemizedlist>
0619 </note></para>
0620 <para>Giving widgets reasonable names can be useful but is not mandatory. Note that widget's name is a property that is not visible to the user of your form. Users will only see a widget text, provided by <guilabel>Text</guilabel> property or similar.
0621 </para>
0622 </sect2>
0623 <sect2 id="inserting-widgets---text-fields"><title>Inserting widgets - text fields</title> 
0624 <para>Let's create a form providing information about persons, &ie; a form connected it with <replaceable>Persons</replaceable> table.
0625 </para>
0626 <para>If the form being designed should present data obtained from the database, you need to place appropriate fields on it. To do this, use the buttons on the <guilabel>Widgets</guilabel> toolbar. Each button corresponds to a single widget type.
0627 </para>
0628 <orderedlist>
0629 <listitem><para>Click <guilabel>Text Box</guilabel> button on the <guilabel>Widgets</guilabel> toolbar.</para></listitem>
0630 <listitem><para>Click on the form surface with the left mouse button. A new text box widget will be placed in the point where you clicked. Before you release you can drag your mouse to specify a desired size for the widget.</para></listitem>
0631 <listitem><para>If needed, move the inserted widget using drag &amp; drop to a desired position. You can resize the widget afterwards by dragging one of the small boxes appearing near its corners. Note that the boxes are only visible when the widget is selected. If you select another widget or the form surface, the boxes disappear.</para></listitem>
0632 <listitem><para>Click the <guilabel>Text Box</guilabel> toolbar button again and click on the form surface to insert another widget. Repeat this action once again until you get three more text boxes inserted in your form. For the sake of simplicity we will limit ourselves to five data fields.</para></listitem>
0633 </orderedlist>
0634 <para><note>
0635 <itemizedlist>
0636   <listitem><para>There is a context menu available in form's design mode, activated by a right mouse button click the desired widget or the form's surface. The menu offers commands like <guilabel>Cut</guilabel>, <guilabel>Copy</guilabel>, <guilabel>Paste</guilabel>, <guilabel>Delete</guilabel> and other, more complex. <!--FIXME no menubar in master/2.4 Many of the commands are also provided in the menubar, usually <guilabel>Edit</guilabel>. -->Keyboard shortcuts are also available for these commands. Some of the commands are only available for certain types of widgets.</para></listitem>
0637 <listitem><para>The commands <guilabel>Cut</guilabel>, <guilabel>Copy</guilabel> and <guilabel>Paste</guilabel> makes it possible to move or copy widgets between forms, even between separate database projects.</para></listitem>
0638 <listitem><para>Holding the &Ctrl; key down while clicking a widget allows to select multiple widgets.</para></listitem>
0639 <listitem><para>Instead of using <guilabel>Copy</guilabel> and <guilabel>Paste</guilabel> commands, to duplicate a widget within the same form you can hold down the &Ctrl; key while moving the widget. After the mouse button is released, the dragged widget will not be moved but copied in the new location.</para></listitem>
0640 </itemizedlist>
0641 </note></para>
0642 </sect2>
0643 <sect2 id="assigning-data-sources"><title>Assigning data sources</title> 
0644 <para>The fields you inserted have no data source assigned yet, so these are not able to display information from the database. To assign data source, use the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-server-database.png" format="PNG"/> </imageobject> </inlinemediaobject> (Data Source) tab of the <guilabel>Property Editor</guilabel> pane.
0645 </para>
0646 <para>The very first step is to specify the form's data source, &ie; a place the displayed data will be fetched from. As mentioned above, you will use table <replaceable>Persons</replaceable> as a data source for your new form.
0647 </para>
0648 <orderedlist>
0649 <listitem><para>Click on the form's surface, as you will alter its properties.</para></listitem>
0650 <listitem><para>Switch to the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-server-database.png" format="PNG"/> </imageobject> </inlinemediaobject> (Data Source) tab and enter <replaceable>persons</replaceable> table name in the <guilabel>Form's data source</guilabel> drop down list. Alternatively, you can select this name from the drop down list.</para></listitem>
0651 </orderedlist>
0652 <para>You have assigned form's data source. Now you need to do specify widget's data source.
0653 </para>
0654 <orderedlist>
0655 <listitem><para>Click the first text field widget at the top of the form.</para></listitem>
0656 <listitem><para>In the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-server-database.png" format="PNG"/> </imageobject> </inlinemediaobject> (Data Source) tab of the property pane enter field name <replaceable>name</replaceable> in the <guilabel>Widget's data source</guilabel> drop down list. Alternatively, you can select this name from the drop down list.</para></listitem>
0657 <listitem><para>Click on next text field widget and enter <replaceable>surname</replaceable> as the data source.</para></listitem>
0658 <listitem><para>Enter data sources for street, house_number and city text fields in a similar way.</para></listitem>
0659 </orderedlist>
0660 <para>You can now save the form's design (this is not mandatory to test the form in action). To save, click the <guilabel>Save</guilabel> toolbar button. Upon saving you will be asked for entering the form's name. Enter <replaceable>Persons</replaceable> as caption and click the <guilabel>OK</guilabel> button. The form's name will be filled automatically.
0661 </para>
0662 <para>This is the right moment for testing your form. Click the <guilabel>Data</guilabel> toolbar button. Unless you made a mistake while entering data sources, you should see the form's fields filled with data from the <replaceable>Persons</replaceable> table.
0663 </para>
0664 <para><note>
0665 <itemizedlist>
0666 <listitem><para>If you want to remove widget's data source assignment for a form widget, you can use the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-edit-clear-locationbar-rtl.png" format="PNG"/> </imageobject> </inlinemediaobject> button in the <guilabel>Widget's data source</guilabel> box.</para></listitem>
0667 <listitem><para>Use the <inlinemediaobject> <imageobject> <imagedata fileref="Icon-go-jump.png" format="PNG"/> </imageobject> </inlinemediaobject> (Go to selected form's data source) button to select appropriate table or query in the <guilabel>Project Navigator</guilabel>, so you can quickly open a table or query being the data source of the form.</para></listitem>
0668 </itemizedlist>
0669 </note></para>
0670 </sect2>
0671 <sect2 id="inserting-text-labels"><title>Inserting text labels</title> 
0672 <para>To make it easier for the form's user to identify the meaning of every field widget, these should have added text labels with appropriate titles. To create text labels the <guilabel>Label</guilabel> widget is used.
0673 </para>
0674 <para>Insert three text label widgets onto the form, placing them on the left side of the text fields (or on the right hand if your operating system uses right-to-left layout). On inserting a new label, a text cursor appears at the location where you can enter the desired title. Enter consecutively: <replaceable>Name</replaceable>, <replaceable>Surname</replaceable>, <replaceable>Street</replaceable>, <replaceable>House Number</replaceable> and <replaceable>City</replaceable>. Additionally, on the top of the form insert another label displaying name of the form, &ie; <replaceable>Persons</replaceable>. Enlarge this label's size and increase the font size using <guilabel>Font</guilabel>  in the <guilabel>Properties</guilabel> tab.
0675 </para>
0676 </sect2>
0677 <sect2 id="actions"><title>Actions</title> 
0678 <para>An Action is a single activity isolated in the application, available for the user to execute. It can also be executed automatically as a reaction for a given event (&eg; after opening a form).
0679 </para>
0680 <sect3 id="assigning-actions-to-form-buttons"><title>Assigning actions to form buttons</title> 
0681 <para>Many actions can be assigned to form button. The assigned action is executed after button is clicked.
0682 </para>
0683 <para>To assign action:
0684 </para>
0685 <orderedlist>
0686 <listitem><para>Switch to form's Design view if you have not done yet.</para></listitem>
0687 <listitem><para>Select the existing button widget by clicking on it or put a new button widget onto the form. If you inserted a new button, enter its title and press &Enter; key.</para></listitem>
0688 <listitem><para>Click the button widget with the right mouse button to display the context menu.</para></listitem>
0689 <listitem><para>From the context menu select <guilabel>Assign action...</guilabel> command.</para></listitem>
0690 <listitem><para>An <guilabel>Assigning Action to Button</guilabel> dialog window will appear presenting a list of available actions. One of the actions is selected if the widget already has action assigned. Otherwise the <guilabel>Action category</guilabel> list has the <guilabel>No action</guilabel> item selected.</para></listitem>
0691 <listitem><para>From the <guilabel>Action category</guilabel> list select <guilabel>Application actions</guilabel> item. Available application-wide actions will be listed.</para></listitem>
0692 <listitem><para>Select one of the actions on the list (&eg; <guilabel>Delete Selected object</guilabel>).</para></listitem>
0693 <!--dialog closes immediately after clicking an action in the list-->
0694 </orderedlist>
0695 <para>After switching to the form's data view you can try whether the action works.<!--FIXME not in master/2.4 For example, if you assigned <guilabel>Delete Row</guilabel> action, clicking the button, the current database row will be deleted, similarly to executing <menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete Row</guimenuitem></menuchoice> (<keycombo>&Ctrl;<keycap>Delete</keycap></keycombo>) menu command (depending on your settings you may be asked to confirm the removal).-->
0696 </para>
0697 <para><note>
0698 <itemizedlist>
0699 <listitem><para>To remove an action assignment, select the <guilabel>No action</guilabel> item from the <guilabel>Action category</guilabel> list of the <guilabel>Assigning Action to Button</guilabel> dialog window.</para></listitem>
0700 <listitem><para>Actions only work in the form's data view. Not every action's assignment is reasonable. For example, the <guilabel>Font...</guilabel> action is available in data view, but only if you have a widget selected in the Design view. If you make changes to the font settings the changes are applied to the text of that selected widget.</para></listitem>
0701 </itemizedlist>
0702 </note></para>
0703 </sect3>
0704 </sect2>
0705 <sect2 id="widget-layouts"><title>Widget layouts</title> 
0706 <para>In most cases form widgets should be conveniently arranged and aligned. Positioning, aligning and resizing widgets by hand is not easy and these parameters are not adjusted when the user resizes the form. In fact the situation is even worse because you cannot assume a given form requires a given space because users have different font sizes and display resolutions.
0707 </para>
0708 <para>Using special tool called widget layouts can help to automatically lay out the form widgets. Widget layout is an action of grouping two or more widgets so these are well positioned and have appropriate sizes.
0709 </para>
0710 <para>Using layout in a form improves alignment. Moreover, its space is better used. Text fields are closer to each other, spacing is constant.
0711 </para>
0712 <!--FIXME not implemented in kexi 2.4
0713 <para>There are two methods to create widget layout.
0714 </para>
0715 <itemizedlist>
0716 <listitem><para>Select two or more widgets that should be placed in a common layout, and select one of the layout types from the context menu item <guilabel>Layout Widgets</guilabel>.</para></listitem>
0717 <listitem><para>Click a container widget (or a form surface itself), where widgets are inserted and select one of the layout types from the context menu item <guilabel>Layout Widgets</guilabel>. All widgets existing within the container or within the form, being on the same level will be put into a single common layout.</para></listitem>
0718 </itemizedlist>
0719 <para>In each of these cases you can also use <menuchoice><guimenu>Format</guimenu><guimenuitem>Layout Widgets</guimenuitem></menuchoice> menu.
0720 </para>
0721 <para>Widget layout is presented in the design view using a blue, green or red box drawn with a broken line. This line is displayed only in the form's design view.
0722 </para>
0723 <para>Besides the grid type, there are other widget layout types.
0724 </para>
0725 <variablelist>
0726   <varlistentry><term><emphasis role="bold">vertical</emphasis></term>
0727     <listitem>
0728     <para>Vertical widget layout</para>
0729      </listitem>
0730   </varlistentry>
0731   <varlistentry><term><emphasis role="bold">horizontal</emphasis></term>
0732     <listitem>
0733     <para>Horizontal widget layout</para>
0734      </listitem>
0735   </varlistentry>
0736 </variablelist>
0737 <sect3 id="springs-in-widget-layouts"><title>Springs in widget layouts</title> 
0738 <para>A spring in widget layouts is a special, invisible element allowing to adjust widget's position and size within layouts. Such a spring stretches or squeezes a widget on the right, top, bottom or left hand, so it can have desired size and position.
0739 </para>
0740 <para>To use a spring:
0741 </para>
0742 <orderedlist>
0743 <listitem><para>Select spring icon on the <guilabel>Widgets</guilabel> toolbar.</para></listitem>
0744 <listitem><para>Click on a selected point of the form to insert the spring.</para></listitem>
0745 </orderedlist>
0746 <para>To make springs work you need to create a global widget layout, &ie; a layout for the form itself. Then, springs can use edges of the form as a boundary for expanding.
0747 </para>
0748 </sect3>
0749 <sect3 id="removing-widget-layouts"><title>Removing widget layouts</title> 
0750 <para>To remove widget layout without removing widgets, perform one of these actions:
0751 </para>
0752 <itemizedlist>
0753 <listitem><para>Click with the right mouse button on the layout's border and select <guilabel>Break Layout</guilabel> command from the context menu.</para></listitem>
0754 <listitem><para>Click with the left mouse button on the layout's border and select <menuchoice><guimenu>Format</guimenu><guimenuitem>Break Layout</guimenuitem></menuchoice> menu command.</para></listitem>
0755 </itemizedlist>
0756 <para><note><para>Removing widget layout using the Break Layout command will not remove widgets contained in the layout. If you want to remove the widgets as well, just select the layout by clicking on its border and press <keycap>Delete</keycap> key or use <menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete</guimenuitem></menuchoice> menu command or context menu command.</para></note>
0757 </para>
0758 </sect3>
0759 -->
0760 <sect3 id="size-policies-for-widgets-within-a-layout"><title>Size policies for widgets within a layout</title> 
0761 <para>Instead of setting a fixed size for your widgets, in &kexi; you can choose between various widget's size policies. A size policy is a flexible strategy for controlling how a widget is stretched (or shrunk) depending on other neighbouring widgets and space available within the form.
0762 </para>
0763 <para>After putting widgets into on a line will be resized to fit their visible text.
0764 </para>
0765 <para>For each widget inserted into the form, there are settings for size policy available in the <guilabel>Property Editor</guilabel>. The settings are presented as a group of properties called <guilabel>Size Policy</guilabel>.
0766 </para>
0767 <para>This group of properties contains:
0768 </para>
0769 <variablelist>
0770   <varlistentry><term><emphasis role="bold">Horizontal Size Policy</emphasis></term>
0771     <listitem>
0772     <para>defining horizontal size of the widget,</para>
0773      </listitem>
0774   </varlistentry>
0775   <varlistentry><term><emphasis role="bold">Vertical Size Policy</emphasis></term>
0776     <listitem>
0777     <para>defining vertical size of the widget,</para>
0778      </listitem>
0779   </varlistentry>
0780   <varlistentry><term><emphasis role="bold">Horizontal Stretch</emphasis></term>
0781     <listitem>
0782     <para>defining strength of activity of the Horizontal Size Policy,</para>
0783      </listitem>
0784   </varlistentry>
0785   <varlistentry><term><emphasis role="bold">Vertical Stretch</emphasis></term>
0786     <listitem>
0787     <para>defining strength of activity of the Vertical Size Policy</para>
0788      </listitem>
0789   </varlistentry>
0790 </variablelist>
0791 </sect3>
0792 <sect3 id="values-of-size-policies"><title>Values of size policies</title> 
0793 <para>The following values are available in the drop down list for <guilabel>Hor. Policy</guilabel> and <guilabel>Vert. Policy</guilabel> visible in the <guilabel>Property Editor</guilabel>:
0794 </para>
0795 <variablelist>
0796   <varlistentry><term><emphasis role="bold">Fixed</emphasis></term>
0797     <listitem>
0798     <para>this value means that the widget cannot be automatically resized; it should maintain the constant size defined at design time (width or height),</para>
0799      </listitem>
0800   </varlistentry>
0801   <varlistentry><term><emphasis role="bold">Minimum</emphasis></term>
0802     <listitem>
0803     <para>this value means that the original size of the widget is set as minimal allowed, it is sufficient and there is no need for expanding the widget, but the widget will be expanded if needed. This type of policy can be used to force the widget to be expanded to the whole width or height, especially if you set a stretch value greater than 0.</para>
0804      </listitem>
0805   </varlistentry>
0806   <varlistentry><term><emphasis role="bold">Maximum</emphasis></term>
0807     <listitem>
0808     <para>this value means that the original size of the widget is set as maximum allowed and can be decreased without breaking the widget's usability and readability if other widgets need more space,</para>
0809      </listitem>
0810   </varlistentry>
0811   <varlistentry><term><emphasis role="bold">Preferred</emphasis></term>
0812     <listitem>
0813     <para>this value means that the original size of the widget is the best and preferred; the widget can be shrunk or expanded however and it will stay readable,</para>
0814      </listitem>
0815   </varlistentry>
0816   <varlistentry><term><emphasis role="bold">Expanding</emphasis></term>
0817     <listitem>
0818     <para>this value means that the original size of the widget is reasonable but the widget can be also shrunk; it can be expanded as well to take as much space as possible,</para>
0819      </listitem>
0820   </varlistentry>
0821   <varlistentry><term><emphasis role="bold">Minimum Expanding</emphasis></term>
0822     <listitem>
0823     <para>this value means that the original size of the widget is allowed; it can be expanded to take as much space as possible,</para>
0824      </listitem>
0825   </varlistentry>
0826   <varlistentry><term><emphasis role="bold">Ignored</emphasis></term>
0827     <listitem>
0828     <para>this value means that the original size of the widget is ignored; the widget can be expanded to take as much space as possible but other widgets usually will not allow for that</para>
0829      </listitem>
0830   </varlistentry>
0831 </variablelist>
0832 <para>Different widget types have various default size policies; for example, button widgets have default size policy set to <guilabel>Minimum</guilabel> (in both directions), while text field widgets have vertical size policy set to <guilabel>Fixed</guilabel>.
0833 </para>
0834 <para>The most frequently used size policies are <guilabel>Preferred</guilabel>, <guilabel>Minimum</guilabel> and <guilabel>Maximum</guilabel>.
0835 </para>
0836 </sect3>
0837 <sect3 id="vertical-and-horizontal-stretch"><title>Vertical and horizontal stretch</title> 
0838 <para>The <guilabel>Vert. Stretch</guilabel> and <guilabel>Hor. Stretch</guilabel> properties accept integer values greater than or equal to 0. These properties allow to fine-tune the behavior of size policies. The default value for the properties is 0. A higher value of the stretch means that the widget will be expanded more than widgets for which a lower stretch value is set.
0839 </para>
0840 </sect3>
0841 </sect2>
0842 <!--FIXME No in master/2.4
0843 <sect2 id="setting-widgets-size-and-position-by-hand"><title>Setting widgets size and position by hand</title> 
0844 <para>In case when your form has no main layout set for auto-positioning and auto-resizing its widgets, you will probably want to modify the position and size of widgets so the form can look cleaner and be easier to use. The &kexi; form designer simplifies this task by offering the following groups of commands:
0845 </para>
0846 <itemizedlist>
0847 <listitem><para>Adjusting sizes of selected widgets. The commands are available in the <menuchoice><guimenu>Format</guimenu><guimenuitem>Adjust Widgets Size</guimenuitem></menuchoice> submenu of the menubar and in the <guilabel>Adjust Widgets Size</guilabel> submenu of the context menu. The toolbar's drop down button <guilabel>Adjust Widgets Size</guilabel> is also available.</para></listitem>
0848 </itemizedlist>
0849 <itemizedlist>
0850 <listitem><para>Aligning positions of the selected widgets. The commands are available in the <menuchoice><guimenu>Format</guimenu><guimenuitem>Align Widgets Position</guimenuitem></menuchoice> submenu of the menubar and in the <guilabel>Align Widgets Position</guilabel> submenu of the context menu. The toolbar's drop down button <guilabel>Align Widgets Position</guilabel> is also available.</para></listitem>
0851 </itemizedlist>
0852 
0853 <variablelist>
0854   <varlistentry><term><emphasis role="bold">To Fit</emphasis></term>
0855     <listitem>
0856     <para>The size of the selected widgets will be altered so each widget will be resized to its preferred size and its contents; for example, a text label's size will be changed to fit its text. The position of the widgets will not be changed.</para>
0857      </listitem>
0858   </varlistentry>
0859   <varlistentry><term><emphasis role="bold">To Grid</emphasis></term>
0860     <listitem>
0861     <para>The size of the selected widgets will be altered so each widget's corner will be placed on the form's (or other container's) grid point. The widget's position can be slightly altered.</para>
0862      </listitem>
0863   </varlistentry>
0864   <varlistentry><term><emphasis role="bold">To Shortest</emphasis></term>
0865     <listitem>
0866     <para>The height of the selected widgets will be altered so that each of them will have the same height as the shortest one. The position of the widgets will not be changed.</para>
0867      </listitem>
0868   </varlistentry>
0869   <varlistentry><term><emphasis role="bold">To Tallest</emphasis></term>
0870     <listitem>
0871     <para>The height of the selected widgets will be altered so that each of them will have the same height as the tallest one. The position of the widgets will not be changed.</para>
0872      </listitem>
0873   </varlistentry>
0874   <varlistentry><term><emphasis role="bold">To Narrowest</emphasis></term>
0875     <listitem>
0876     <para>The width of the selected widgets will be altered so that each of them will have the same height as the narrowest one. The position of the widgets will not be changed.</para>
0877      </listitem>
0878   </varlistentry>
0879   <varlistentry><term><emphasis role="bold">To Widest</emphasis></term>
0880     <listitem>
0881     <para>The width of the selected widgets will be altered so that each of them will have the same height as the widest one. The position of the widgets will not be changed.</para>
0882      </listitem>
0883   </varlistentry>
0884   <varlistentry><term><emphasis role="bold">To Left</emphasis></term>
0885     <listitem>
0886     <para>All the selected widgets' left positions will be moved to the position of the leftmost widget's left edge.</para>
0887      </listitem>
0888   </varlistentry>
0889   <varlistentry><term><emphasis role="bold">To Right</emphasis></term>
0890     <listitem>
0891     <para>All the selected widgets' right positions will be moved to the position of the rightmost widget's right edge.</para>
0892      </listitem>
0893   </varlistentry>
0894   <varlistentry><term><emphasis role="bold">To Top</emphasis></term>
0895     <listitem>
0896     <para>All the selected widgets' top positions will be moved to the position of the uppermost widget's upper edge.</para>
0897      </listitem>
0898   </varlistentry>
0899   <varlistentry><term><emphasis role="bold">To Bottom</emphasis></term>
0900     <listitem>
0901     <para>All the selected widgets' bottom positions will be moved to the position of the bottommost widget's bottom edge.</para>
0902      </listitem>
0903   </varlistentry>
0904   <varlistentry><term><emphasis role="bold">To Grid</emphasis></term>
0905     <listitem>
0906     <para>All the selected widgets' top-left corners will be moved so that they are positioned in the nearest grid point.</para>
0907      </listitem>
0908   </varlistentry>
0909 </variablelist>
0910 <para>None of the above commands resizes the widgets.
0911 </para>
0912 <para>There are also additional commands available: <guilabel>Bring Widget to Front</guilabel> (&ie; above all other widgets) and <guilabel>Send Widget to Back</guilabel> (&ie; below all other widgets). These two commands are rarely used, as it is not common to place one widget on top of an other (except when a container widget contains other widget inside). Also note that clicking a widget with a mouse button is enough to bring the widget to front.
0913 </para>
0914 </sect2>
0915 <sect2 id="setting-the-tab-order"><title>Setting the tab order</title> 
0916 <para>A widget's focus determines that widget's activity available using keyboard. Focus is related to widgets displayed in the form's data view. Exactly one form widget can have focus at the same time. The most frequent use of focus is text entry (when a given text field is active, &ie; it is focused). An other example is a button widget - when focused, it is possible to “press” it using the &Enter; or <keycap>Space</keycap> key instead of a mouse button.
0917 </para>
0918 <para>There are a few methods of making the widgets active (moving the focus to the widget): clicking with a mouse button, rotating the mouse wheel over the widget, or using the &Tab; key. The latter method is often used because of its speed and convenience for users. Availability of the focusing methods is controlled by <guilabel>Focus Policy</guilabel> property of a given widget.
0919 </para>
0920 <para>There is a relationship between focusing (activating) widgets using &Tab; key and tab order setting of a form. After pressing the &Tab; key, the next widget should be focused, so the form should know about the tab order.
0921 </para>
0922 <para>To alter tab order for a form's widget:
0923 </para>
0924 <orderedlist>
0925 <listitem><para>Switch to design view of the form.</para></listitem>
0926 <listitem><para>Execute <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit Tab Order...</guimenuitem></menuchoice> menu command. The <guilabel>Edit Tab Order</guilabel> dialog will appear with settings for this form.The window contains a list with two columns: the first column displays widget names, the second - types of the widgets. To make it easier to recognize meaning of the names and types for the user, icons related to the types are also displayed. The list contains only widgets having focus policy allowing to use the &Tab; key. The window allows you to change the tab order or set the automatic tab order.</para></listitem>
0927 <listitem><para>To change tab order, either:<itemizedlist>
0928 <listitem><para>Click a selected widget name in the widgets list and drag it to a desired position (up or down) using the mouse.</para></listitem>
0929 <listitem><para>Click a selected widget name on the widgets list and use <guilabel>Move Up</guilabel> or <guilabel>Move Down</guilabel> buttons, to move the widgets to a desired position.</para></listitem>
0930 <listitem><para>Click the <guilabel>Handle tab order automatically</guilabel> check box to set the automatic tab order for the form. If this option has been switched on, any changes made to the list of widgets by hand are not taken into account - &kexi; will be handling the tab orders on its own. The automatic ordering means that the top-left widget will be focused first (or the top-right if your operating system uses right-to-left layout), and the order comes from the left to right (from the right to left, respectively) and from the top to bottom.</para></listitem>
0931 </itemizedlist>
0932 </para></listitem>
0933 </orderedlist>
0934 <para>Click the <guilabel>OK</guilabel> button to accept the changes or <guilabel>Cancel</guilabel> button to dismiss the changes.
0935 </para>
0936 </sect2>
0937 -->
0938 </sect1>
0939 <sect1 id="entering-data-using-forms"><title>Entering Data Using Forms</title> 
0940 <para>Data entering and editing is usually the task of the user of the database application. The designer of the database should check the form in terms of valid data entry, and see whether the form works as expected.
0941 </para>
0942 <para>To test your form, switch to its data view. A single database row (record) of data will be displayed . You can move between fields using the left mouse button or the &Tab; and <keycombo>&Shift;&Tab;</keycombo> keys. While editing, there will be a pencil icon visible near the record navigator. After entering the row's (record) data you can press the <keycombo>&Shift;&Enter;</keycombo> keys or click the <guilabel>Save Record</guilabel> toolbar button to accept changes made to the current row. Clicking the <guilabel>Cancel Record Changes</guilabel> toolbar button discards changes made to the current row and restores the contents of the data fields. You can use the record navigator's button to move to a new row. All the navigator's functions are also available in a similar way as in the data table view.
0943 </para>
0944 </sect1>
0945 </chapter>
0946 <chapter id="configuring-kexi"><title>Configuring Kexi</title> 
0947 <itemizedlist>
0948 <listitem><para><link linkend="docking-and-undocking-side-panels">Docking and undocking side panels</link>&nbsp;</para></listitem>
0949 </itemizedlist>
0950 <sect1 id="docking-and-undocking-side-panels"><title>Docking and undocking side panels</title> 
0951 <para>The <guilabel>Project Navigator</guilabel> and <guilabel>Property Editor</guilabel> side panels may be undocked by either:
0952 </para>
0953 <itemizedlist>
0954 <listitem><para>Double-clicking on the 'grip' bar at the top of the panel; or</para></listitem>
0955 <listitem><para>Clicking once on the diamond button at the top of the panel, next to the x.</para></listitem>
0956 </itemizedlist>
0957 <para>Once undocked, panel windows may be docked into the main window again similarly to undocking:
0958 </para>
0959 <itemizedlist>
0960 <listitem><para>Double-clicking on the 'grip' bar at the top of the window; or</para></listitem>
0961 <listitem><para>Clicking once on the diamond button at the top of the panel, next to the x.</para></listitem>
0962 </itemizedlist>
0963 <para><tip><para>When undocking a panel, &kexi; remembers the last docked position so when you dock the panel again it will be placed at the location it was last docked.</para></tip>
0964 </para>
0965 </sect1>
0966 </chapter>
0967 <chapter id="command-reference"><title>Command Reference</title> 
0968 <itemizedlist>
0969 <listitem><para><link linkend="the-kexi-tab">The Kexi Tab</link>&nbsp;</para></listitem>
0970 <listitem><para><link linkend="the-create-tab">The Create Tab</link>&nbsp;</para></listitem>
0971 <listitem><para><link linkend="the-data-tab">The Data Tab</link>&nbsp;</para></listitem>
0972 <listitem><para><link linkend="the-external-data-tab">The External Data Tab</link>&nbsp;</para></listitem>
0973 <listitem><para><link linkend="the-tools-tab">The Tools Tab</link>&nbsp;</para></listitem>
0974 <listitem><para><link linkend="the-form-design-tab">The Form Design Tab</link>&nbsp;</para></listitem>
0975 <listitem><para><link linkend="the-report-design-tab">The Report Design Tab</link>&nbsp;</para></listitem>
0976 </itemizedlist>
0977 <sect1 id="the-kexi-tab"><title>The Kexi Tab</title> 
0978 <para>
0979 <screenshot>
0980 <screeninfo></screeninfo>
0981   <mediaobject>
0982     <imageobject>
0983       <imagedata fileref="kexi_kexi_tab.png" format="PNG"/>
0984     </imageobject>
0985     <textobject>
0986       <phrase></phrase>
0987     </textobject>
0988   </mediaobject>
0989 </screenshot>
0990 </para>
0991 <para>The &kexi; tab is the place where you interact with &kexi;'s projects.
0992 </para>
0993 <para>Selecting an action will open a screen right next to the menu, offering options about the action you chose.
0994 </para>
0995 <para>The options offered are:
0996 </para>
0997 <variablelist>
0998   <varlistentry><term><emphasis role="bold"><guilabel>Welcome</guilabel></emphasis></term>
0999     <listitem>
1000     <para>Here you can select to open a project you recently worked on.</para>
1001      </listitem>
1002   </varlistentry>
1003   <varlistentry><term><emphasis role="bold"><guilabel>Open</guilabel></emphasis></term>
1004     <listitem>
1005     <para>Here you can select to open a &kexi; Project whether stored in a file or a database server.</para>
1006      </listitem>
1007   </varlistentry>
1008   <varlistentry><term><emphasis role="bold"><guilabel>Close</guilabel></emphasis></term>
1009     <listitem>
1010     <para>This action closes the &kexi; project you have currently open.</para>
1011      </listitem>
1012   </varlistentry>
1013   <varlistentry><term><emphasis role="bold"><guilabel>New</guilabel></emphasis></term>
1014     <listitem>
1015     <para>Here you can follow the wizard to create a new &kexi; Project.</para>
1016      </listitem>
1017   </varlistentry>
1018   <varlistentry><term><emphasis role="bold"><guilabel>Import, Export or Send...</guilabel></emphasis></term>
1019     <listitem>
1020     <para>Here you can follow the wizard to Import existing data to the currently open &kexi; Project.</para>
1021      </listitem>
1022   </varlistentry>
1023   <varlistentry><term><emphasis role="bold"><guilabel>Quit</guilabel></emphasis></term>
1024     <listitem>
1025     <para>Closes &kexi;.</para>
1026      </listitem>
1027   </varlistentry>
1028 </variablelist>
1029 </sect1>
1030 <sect1 id="the-create-tab"><title>The Create Tab</title> 
1031 <para>
1032 <screenshot>
1033 <screeninfo></screeninfo>
1034   <mediaobject>
1035     <imageobject>
1036       <imagedata fileref="kexi_create_tab.png" format="PNG"/>
1037     </imageobject>
1038     <textobject>
1039       <phrase></phrase>
1040     </textobject>
1041   </mediaobject>
1042 </screenshot>
1043 </para>
1044 <para>From the <guilabel>Create</guilabel> tab you can create objects that will be added to your project.
1045 </para>
1046 <variablelist>
1047   <varlistentry><term><emphasis role="bold"><guilabel>Table</guilabel></emphasis></term>
1048     <listitem>
1049     <para>Selecting <guilabel>Table</guilabel> will take you to the table designer at the design view to allow you to add field definitions to your table.</para>
1050      </listitem>
1051   </varlistentry>
1052   <varlistentry><term><emphasis role="bold"><guilabel>Query</guilabel></emphasis></term>
1053     <listitem>
1054     <para>Selecting <guilabel>Query</guilabel> will take you to the query designer at the design view to allow you to design a query to get custom results from your tables in your project.</para>
1055      </listitem>
1056   </varlistentry>
1057   <varlistentry><term><emphasis role="bold"><guilabel>Form</guilabel></emphasis></term>
1058     <listitem>
1059     <para>Selecting <guilabel>Form</guilabel> will take you to the form designer at the design view to allow you to add widgets to your form.</para>
1060      </listitem>
1061   </varlistentry>
1062   <varlistentry><term><emphasis role="bold"><guilabel>Report</guilabel></emphasis></term>
1063     <listitem>
1064     <para>Selecting <guilabel>Report</guilabel> will take you to the report designer at the design view to allow you to add widgets to your report.</para>
1065      </listitem>
1066   </varlistentry>
1067   <varlistentry><term><emphasis role="bold"><guilabel>Script</guilabel></emphasis></term>
1068     <listitem>
1069     <para>Selecting <guilabel>Script</guilabel> will take you to the script editor to allow you to add custom code for your project and / or objects.</para>
1070      </listitem>
1071   </varlistentry>
1072 </variablelist>
1073 </sect1>
1074 <sect1 id="the-data-tab"><title>The Data Tab</title> 
1075 <para>
1076 <screenshot>
1077 <screeninfo></screeninfo>
1078   <mediaobject>
1079     <imageobject>
1080       <imagedata fileref="kexi_data_tab.png" format="PNG"/>
1081     </imageobject>
1082     <textobject>
1083       <phrase></phrase>
1084     </textobject>
1085   </mediaobject>
1086 </screenshot>
1087 </para>
1088 <para>From the <guilabel>Data</guilabel> Tab you can manipulate data in your tables or widgets in your objects (forms, reports, etc)
1089 </para>
1090 <variablelist>
1091   <varlistentry><term><emphasis role="bold"><guilabel>Cut</guilabel></emphasis></term>
1092     <listitem>
1093     <para><guilabel>Cut</guilabel>, places the data/widget on the clipboard and removes it from it's current position.</para>
1094      </listitem>
1095   </varlistentry>
1096   <varlistentry><term><emphasis role="bold"><guilabel>Copy</guilabel></emphasis></term>
1097     <listitem>
1098     <para><guilabel>Copy</guilabel>, places the data/widget on the clipboard without removing it from it's current position.</para>
1099      </listitem>
1100   </varlistentry>
1101   <varlistentry><term><emphasis role="bold"><guilabel>Paste</guilabel></emphasis></term>
1102     <listitem>
1103     <para><guilabel>Paste</guilabel>, places the data/widget found on the clipboard to the table/object accordingly.</para>
1104      </listitem>
1105   </varlistentry>
1106   <varlistentry><term><emphasis role="bold"><guilabel>Paste Special</guilabel></emphasis></term>
1107     <listitem>
1108     <para><guilabel>Paste Special</guilabel>, is used to place arbitrary data found on the clipboard to a table, in a way that is predictable so as to be correctly added according to the table's definition.</para>
1109      </listitem>
1110   </varlistentry>
1111   <varlistentry><term><emphasis role="bold"><guilabel>Find</guilabel></emphasis></term>
1112     <listitem>
1113     <para><guilabel>Find</guilabel>, opens the <guilabel>Find</guilabel> dialog so as to search for specific text in the database data.</para>
1114      </listitem>
1115   </varlistentry>
1116 </variablelist>
1117 </sect1>
1118 <sect1 id="the-external-data-tab"><title>The External Data Tab</title> 
1119 <para>
1120 <screenshot>
1121 <screeninfo></screeninfo>
1122   <mediaobject>
1123     <imageobject>
1124       <imagedata fileref="kexi_external_data_tab.png" format="PNG"/>
1125     </imageobject>
1126     <textobject>
1127       <phrase></phrase>
1128     </textobject>
1129   </mediaobject>
1130 </screenshot>
1131 </para>
1132 <para>From the External Data Tab you can you can import data from other sources into your &kexi; project.
1133 </para>
1134 <variablelist>
1135   <varlistentry><term><emphasis role="bold"><guilabel>Import Data From File</guilabel></emphasis></term>
1136     <listitem>
1137     <para><guilabel>Import Data From File</guilabel>, displays a dialog that allows you to import data from CSV or plain text files to a new table in your project.</para>
1138      </listitem>
1139   </varlistentry>
1140   <varlistentry><term><emphasis role="bold"><guilabel>Import Tables</guilabel></emphasis></term>
1141     <listitem>
1142       <para><guilabel>Import Tables</guilabel>, opens the <guilabel>Table Importing Wizard</guilabel> that allows you to import data either from a <!--FIXME no fods in 2.4 here--><filename>fods</filename>, <filename>mdb</filename>, <filename>ods</filename>, <filename>tsv</filename> file or from another database server, to a new table in your project.</para>
1143      </listitem>
1144   </varlistentry>
1145   <varlistentry><term><emphasis role="bold"><guilabel>Export Data to File</guilabel></emphasis></term>
1146     <listitem>
1147     <para><guilabel>Export Data to File</guilabel>, displays a dialog that allows you to export the current tables data to a plain text or CSV file.</para>
1148      </listitem>
1149   </varlistentry>
1150 </variablelist>
1151 <para><note><para>The table has to be open, in order to be able to export data from it to a file.</para></note>
1152 </para>
1153 </sect1>
1154 <sect1 id="the-tools-tab"><title>The Tools Tab</title> 
1155 <para>
1156 <screenshot>
1157 <screeninfo></screeninfo>
1158   <mediaobject>
1159     <imageobject>
1160       <imagedata fileref="kexi_tools_tab.png" format="PNG"/>
1161     </imageobject>
1162     <textobject>
1163       <phrase></phrase>
1164     </textobject>
1165   </mediaobject>
1166 </screenshot>
1167 </para>
1168 <para>From the <guilabel>Tools</guilabel> tab you can you can manipulate your projects.
1169 </para>
1170 <variablelist>
1171   <!--FIXME no aktion Import Database in the toolbar in kexi 2.7 here
1172   <varlistentry><term><emphasis role="bold"><guilabel>Import Database</guilabel></emphasis></term>
1173     <listitem>
1174     <para><guilabel>Import Database</guilabel>, opens the <guilabel>Database Importing Wizard</guilabel> that allows to import complete data from an <filename>mdb</filename> file or another database server.</para>
1175      </listitem>
1176   </varlistentry>
1177   -->
1178   <varlistentry><term><emphasis role="bold"><guilabel>Compact Database</guilabel></emphasis></term>
1179     <listitem>
1180     <para><guilabel>Compact Database</guilabel>, checks for minor error in the database and reduces the database's size.</para>
1181      </listitem>
1182   </varlistentry>
1183 </variablelist>
1184 <para><note><para>You should regularly compact your database to keep it in good shape, especially after extensive records operations (mass add, delete)</para></note>
1185 </para>
1186 </sect1>
1187 <sect1 id="the-form-design-tab"><title>The Form Design Tab</title> 
1188 <para>
1189 <screenshot>
1190 <screeninfo></screeninfo>
1191   <mediaobject>
1192     <imageobject>
1193       <imagedata fileref="kexi_form_design_tab.png" format="PNG"/>
1194     </imageobject>
1195     <textobject>
1196       <phrase></phrase>
1197     </textobject>
1198   </mediaobject>
1199 </screenshot>
1200 </para>
1201 <para>From the <guilabel>Form Design</guilabel> tab you can you select widgets to add to your form.
1202 </para>
1203 <variablelist>
1204   <varlistentry><term><emphasis role="bold"><guilabel>Pointer</guilabel></emphasis></term>
1205     <listitem>
1206     <para><guilabel>Pointer</guilabel>, switches to the widget selection mode.</para>
1207      </listitem>
1208   </varlistentry>
1209 </variablelist>
1210 <para><note><para>Selecting any widget, will switch to the widget add mode. Then you can click anywhere on the form to place the widget.</para></note>
1211 </para>
1212 <variablelist>
1213   <varlistentry><term><emphasis role="bold"><guilabel>Label</guilabel></emphasis></term>
1214     <listitem>
1215     <para>A <guilabel>Label</guilabel> widget displays predefined information on a form. Usually it is used as a caption next to other data-aware widgets.</para>
1216      </listitem>
1217   </varlistentry>
1218   <varlistentry><term><emphasis role="bold"><guilabel>Text Box</guilabel></emphasis></term>
1219     <listitem>
1220     <para>A <guilabel>Text Box</guilabel> is a single line container for data contained in your table.</para>
1221      </listitem>
1222   </varlistentry>
1223   <varlistentry><term><emphasis role="bold"><guilabel>Text Editor</guilabel></emphasis></term>
1224     <listitem>
1225     <para>A <guilabel>Text Editor</guilabel> is a multiline container for data contained in your table.</para>
1226      </listitem>
1227   </varlistentry>
1228   <varlistentry><term><emphasis role="bold"><guilabel>Combo Box</guilabel></emphasis></term>
1229     <listitem>
1230     <para>A <guilabel>Combo Box</guilabel> displays a list of options to choose from.</para>
1231      </listitem>
1232   </varlistentry>
1233   <varlistentry><term><emphasis role="bold"><guilabel>Check Box</guilabel></emphasis></term>
1234     <listitem>
1235     <para>A <guilabel>Check Box</guilabel> holds two or three states of data (&eg; On/Off)</para>
1236      </listitem>
1237   </varlistentry>
1238   <varlistentry><term><emphasis role="bold"><guilabel>Image Box</guilabel></emphasis></term>
1239     <listitem>
1240       <para>An <guilabel>Image Box</guilabel> holds an image, bound to a field in a table.<!--FIXME can also display an image loaded from file--></para>
1241      </listitem>
1242   </varlistentry>
1243   <varlistentry><term><emphasis role="bold"><guilabel>Button</guilabel></emphasis></term>
1244     <listitem>
1245     <para>A <guilabel>Button</guilabel> allows you to define actions to be executed upon clicking on it.</para>
1246      </listitem>
1247   </varlistentry>
1248   <varlistentry><term><emphasis role="bold"><guilabel>Frame</guilabel></emphasis></term>
1249     <listitem>
1250     <para>A <guilabel>Frame</guilabel> is used as a container for other widgets.</para>
1251      </listitem>
1252   </varlistentry>
1253   <varlistentry><term><emphasis role="bold"><guilabel>Group Box</guilabel></emphasis></term>
1254     <listitem>
1255     <para>A <guilabel>Group Box</guilabel> is used to group other widgets and control their state.</para>
1256      </listitem>
1257   </varlistentry>
1258   <varlistentry><term><emphasis role="bold"><guilabel>Tab Widget</guilabel></emphasis></term>
1259     <listitem>
1260     <para>A <guilabel>Tab Widget</guilabel> is used as a container for other widgets and can have many pages that contain different widgets.</para>
1261      </listitem>
1262   </varlistentry>
1263   <varlistentry><term><emphasis role="bold"><guilabel>Line</guilabel></emphasis></term>
1264     <listitem>
1265     <para>A <guilabel>Line</guilabel> is used as a logical separator between different parts of a form.</para>
1266      </listitem>
1267   </varlistentry>
1268   <varlistentry><term><emphasis role="bold"><guilabel>Web Browser</guilabel></emphasis></term>
1269     <listitem>
1270     <para>A <guilabel>Web Browser</guilabel> is a widget that allows to display a web page inside the form.</para>
1271      </listitem>
1272      <!--FIXME missing Map Browser + Slider + Progress Bar + Link Button + Date Picker-->
1273   </varlistentry>
1274   <varlistentry><term><emphasis role="bold"><guilabel>Assign Action</guilabel></emphasis></term>
1275     <listitem>
1276     <para><guilabel>Assign Action</guilabel> is used to assign an action to be executed when an event occurs (&eg; clicking on a button).</para>
1277      </listitem>
1278   </varlistentry>
1279 </variablelist>
1280 </sect1>
1281 <sect1 id="the-report-design-tab"><title>The Report Design Tab</title> 
1282 <para>
1283 <screenshot>
1284 <screeninfo></screeninfo>
1285   <mediaobject>
1286     <imageobject>
1287       <imagedata fileref="kexi_report_design_tab.png" format="PNG"/>
1288     </imageobject>
1289     <textobject>
1290       <phrase></phrase>
1291     </textobject>
1292   </mediaobject>
1293 </screenshot>
1294 </para>
1295 <para>From the <guilabel>Report Design</guilabel> tab you can you select widgets to add to your report.
1296 </para>
1297 <variablelist>
1298   <varlistentry><term><emphasis role="bold"><guilabel>Label</guilabel></emphasis></term>
1299     <listitem>
1300     <para>A <guilabel>Label</guilabel> widget displays predefined information on a report. Usually it is used as a caption next to other data-aware widgets.</para>
1301      </listitem>
1302   </varlistentry>
1303   <varlistentry><term><emphasis role="bold"><guilabel>Field</guilabel></emphasis></term>
1304     <listitem>
1305     <para>A <guilabel>Field</guilabel> widget is a single line container for data contained in your table.</para>
1306      </listitem>
1307   </varlistentry>
1308   <varlistentry><term><emphasis role="bold"><guilabel>Text</guilabel></emphasis></term>
1309     <listitem>
1310     <para>A <guilabel>Text</guilabel> widget is a multi line container for data contained in your table.</para>
1311      </listitem>
1312   </varlistentry>
1313   <varlistentry><term><emphasis role="bold"><guilabel>Image</guilabel></emphasis></term>
1314     <listitem>
1315     <para>An <guilabel>Image</guilabel> widget holds an image, bound to a field in a table.</para>
1316      </listitem>
1317   </varlistentry>
1318   <varlistentry><term><emphasis role="bold"><guilabel>Check</guilabel></emphasis></term>
1319     <listitem>
1320     <para>A <guilabel>Check</guilabel> widget holds two or three states of data (&eg; On/Off)</para>
1321      </listitem>
1322   </varlistentry>
1323   <varlistentry><term><emphasis role="bold"><guilabel>Line</guilabel></emphasis></term>
1324     <listitem>
1325     <para>A <guilabel>Line</guilabel> is used as a logical separator between different parts of a form.</para>
1326      </listitem>
1327   </varlistentry>
1328   <!--FIXME no Shape in 2.7
1329   <varlistentry><term><emphasis role="bold">Shape</emphasis></term>
1330     <listitem>
1331     <para>A <guilabel>Shape</guilabel> widget is used to add special shape visuals to your report.</para>
1332      </listitem>
1333   </varlistentry>
1334   -->
1335   <varlistentry><term><emphasis role="bold">Chart</emphasis></term>
1336     <listitem>
1337     <para>A <guilabel>Chart</guilabel> widget is used to add a visual representation of your data presented on a graph.</para>
1338      </listitem>
1339   </varlistentry>
1340   <varlistentry><term><emphasis role="bold">Web</emphasis></term>
1341     <listitem>
1342     <para>A <guilabel>Web</guilabel> widget is used to provide a minimal web browser component and print information from a local or web site on a report.</para>
1343      </listitem>
1344      <!--FIXME missing Map-->
1345   </varlistentry>
1346   <varlistentry><term><emphasis role="bold">Barcode</emphasis></term>
1347     <listitem>
1348     <para>A <guilabel>Barcode</guilabel> widget is used to create a barcode to be printed on a report, from data held in a field.</para>
1349      </listitem>
1350   </varlistentry>
1351 </variablelist>
1352 </sect1>
1353 </chapter>
1354 <chapter id="appendix-a--introduction-to-databases"><title>Appendix A. Introduction to Databases</title> 
1355 <itemizedlist>
1356 <listitem><para><link linkend="what-is-a-database">What Is a Database?</link>&nbsp;</para></listitem>
1357 <listitem><para><link linkend="database-and-spreadsheet">Database and Spreadsheet</link>&nbsp;</para></listitem>
1358 <listitem><para><link linkend="database-design">Database Design</link>&nbsp;</para></listitem>
1359 <listitem><para><link linkend="who-needs-a-database">Who Needs a Database?</link>&nbsp;</para></listitem>
1360 <listitem><para><link linkend="database-creation-software">Database Creation Software</link>&nbsp;</para></listitem>
1361 </itemizedlist>
1362 <sect1 id="what-is-a-database"><title>What Is a Database?</title> 
1363 <para>You can define a database as a collection of data on one topic. It is organised in a way allowing to easily browse the information, make changes or add new items.
1364 </para>
1365 <para>Look at this diagram for one of the above examples: a simple phone book.
1366 </para>
1367 
1368 <para>
1369 <screenshot>
1370 <screeninfo></screeninfo>
1371   <mediaobject>
1372     <imageobject>
1373       <imagedata fileref="contact-example.png" format="PNG"/>
1374     </imageobject>
1375     <textobject>
1376       <phrase></phrase>
1377     </textobject>
1378   </mediaobject>
1379 </screenshot>
1380 </para>
1381 
1382 <para>The above picture shows a set of two contacts each of which is presented on a separate card. It appears that such a card can constitute a single row in a table:
1383 </para>
1384 <para>
1385 <table>
1386   <title><emphasis>Contacts table</emphasis></title>
1387   <tgroup cols="2">
1388   <thead>
1389   <row>
1390     <entry><guilabel>Name</guilabel></entry>
1391     <entry><guilabel>Tel No.</guilabel></entry>
1392   </row>
1393   </thead>
1394   <tbody>
1395   <row>
1396     <entry>
1397     <para>Joan</para>
1398     </entry>
1399     <entry>
1400     <para>699 23 43 12</para>
1401     </entry>
1402   </row>
1403   <row>
1404     <entry>
1405     <para>Adam</para>
1406     </entry>
1407     <entry>
1408     <para>711 19 77 21</para></entry>
1409   </row>
1410   </tbody>
1411   </tgroup>
1412 </table>
1413 </para>
1414 <para>Terms and definitions: A single data which constitutes a part of a greater collection can be called a <emphasis>row</emphasis> or more professionally a <emphasis>record</emphasis>. The collection is normally called a <emphasis>table</emphasis>. Moreover, the most natural name for the table is one describing the data it offers/stores which is Contacts. Furthermore, each row in the table consists of columns often also called <emphasis>fields</emphasis>. In the table <replaceable>Contacts</replaceable> there are two columns (fields): <guilabel>Name</guilabel> and <guilabel>Tel No.</guilabel>.
1415 </para>
1416 <para>For simple uses a single table can make up a database. Many people consider these two equivalent. As you will see, for real databases we usually need more than one table.
1417 </para>
1418 <para>To sum up, you have already got a simple database with one table <replaceable>Contacts</replaceable>.
1419 </para>
1420 <para><note><para>Check content at <ulink url="https://www.zoho.com/creator/database-software-vs-spreadsheet.html"></ulink></para></note>
1421 </para>
1422 </sect1>
1423 <sect1 id="database-and-spreadsheet"><title>Database and Spreadsheet</title> 
1424 <para>It is very likely that you have already used spreadsheet applications like <guilabel>Calligra Sheets</guilabel>, <guilabel>LibreOffice Calc</guilabel> or <application>&Microsoft; Excel</application>. If so, you will probably wonder: since both spreadsheets and databases have tables, why should I use the latter?
1425 </para>
1426 <para>While comparing spreadsheets and databases you may encounter the following issues which you will later see in greater detail.
1427 </para>
1428 <sect2 id="how-is-a-database-different-from-a-spreadsheet"><title>How Is a Database Different From a Spreadsheet?</title> 
1429 <para>Gradually exceeding the capacity of a mobile phone, expand your table <replaceable>Contacts</replaceable> adding a column (field) <replaceable>Address</replaceable>. Add more telephone numbers (office, home) for each person and add surnames to names. To make it simpler we assume the following:
1430 </para>
1431 <itemizedlist>
1432 <listitem><para>The table is limited to two people (obviously, there could be hundreds and thousands of them in a real database)</para></listitem>
1433 <listitem><para>There are no two persons with the same name and surname</para></listitem>
1434 </itemizedlist>
1435 <para>
1436 <table>
1437   <title><emphasis>Contacts table</emphasis></title>
1438   <tgroup cols="3">
1439   <thead>
1440   <row>
1441     <entry><guilabel>Name and surname</guilabel></entry>
1442     <entry><guilabel>Tel</guilabel></entry>
1443     <entry><guilabel>Address</guilabel></entry>
1444   </row>
1445   </thead>
1446   <tbody>
1447   <row>
1448     <entry>
1449     <para>Joan Smith</para>
1450     </entry>
1451     <entry>
1452     <para>699 23 43 12</para>
1453     </entry>
1454     <entry>
1455     <para>Western Gate 1, Warsaw</para>
1456     </entry>
1457   </row>
1458   <row>
1459     <entry>
1460     <para>Adam Willson</para>
1461     </entry>
1462     <entry>
1463     <para>711 19 77 21</para>
1464     </entry>
1465     <entry>
1466     <para>London, Frogs Drive 5</para>
1467     </entry>
1468   </row>
1469   <row>
1470     <entry>
1471     <para>Joan Smith</para>
1472     </entry>
1473     <entry>
1474     <para>110 98 98 00</para>
1475     </entry>
1476     <entry>
1477     <para>Western Gate 1</para>
1478     </entry>
1479   </row>
1480   <row>
1481     <entry>
1482     <para>Smith Joan</para>
1483     </entry>
1484     <entry>
1485     <para>312 43 42 22</para>
1486     </entry>
1487     <entry>
1488     <para>Warsaw, Western Gate 1</para>
1489     </entry>
1490   </row>
1491   <row>
1492     <entry>
1493     <para>ADAM Willson</para>
1494     </entry>
1495     <entry>
1496     <para>231 83 02 04</para>
1497     </entry>
1498     <entry>
1499     <para>Frogs Drive 5, London</para></entry>
1500   </row>
1501   </tbody>
1502   </tgroup>
1503 </table>
1504 </para>
1505 <para>Such a table can be made both in a spreadsheet and in a database. Using a spreadsheet is very easy, of course. What problems do we encounter at this stage?
1506 </para>
1507 </sect2>
1508 <sect2 id="referential-data-integrity"><title>Referential data integrity</title> 
1509 <para>Suppose you are using a spreadsheet and you need to change the address of at least one person. You have a small problem: you often have to change the address in many rows. For example, Joan takes three rows. A real problem will arise if you forget to change one of the rows - the address assigned to this person will be ambiguous, hence your data loses integrity.
1510 </para>
1511 <para>Moreover there is no simple way of deleting a chosen person from the table since you have to remember about deleting all rows related to him or her.
1512 </para>
1513 </sect2>
1514 <sect2 id="data-redundancy"><title>Data redundancy</title> 
1515 <para>This is directly connected to the previous problem. In fields Name and surname and Address the same data is entered many times. This is typical of a spreadsheets' ineffective way of storing data because the database grows unnecessarily, thus requiring more computer resources (larger size of data and slower access).
1516 </para>
1517 <para>How can you solve these problems with a database? You can split information into smaller chunks by creating an additional table <replaceable>Persons</replaceable> with only two columns: <replaceable>Name and surname</replaceable> and <replaceable>Address</replaceable>:
1518 </para>
1519 <para>
1520 <table>
1521   <title><emphasis>Persons table</emphasis></title>
1522   <tgroup cols="2">
1523   <thead>
1524   <row>
1525     <entry><guilabel>Name and surname</guilabel></entry>
1526     <entry><guilabel>Address</guilabel></entry>
1527   </row>
1528   </thead>
1529   <tbody>
1530   <row>
1531     <entry>
1532     <para>Joan Smith</para>
1533     </entry>
1534     <entry>
1535     <para>Western Gate 1, Warsaw</para>
1536     </entry>
1537   </row>
1538   <row>
1539     <entry>
1540     <para>Adam Willson</para>
1541     </entry>
1542     <entry>
1543     <para>Frogs Drive 5, London</para></entry>
1544   </row>
1545   </tbody>
1546   </tgroup>
1547 </table>
1548 </para>
1549 <para>Each row in the table <replaceable>Persons</replaceable> corresponds to a single person. Table <replaceable>Contacts</replaceable> is from now on a relation to the table <replaceable>Persons</replaceable>.
1550 </para>
1551 </sect2>
1552 <sect2 id="data-integrity-and-validity"><title>Data integrity and validity</title> 
1553 <para>Note the way data is entered in the fields <replaceable>Name and surname</replaceable> and <replaceable>Address</replaceable>. People entering data can be fallible, sometimes even negligent. In our sample data we have both different sequence of entering name and surname (Joan Smith and Smith Joan; Adam and ADAM) and many more ways of entering the same address. Surely you can think of many other ways.
1554 </para>
1555 <para>The above problem shows that &eg; when searching the telephone number of a person whose address is <quote>Western Gate 1, Warsaw</quote> you will not get a full result. You will get only one row instead of three. Moreover You will also not find all the telephone numbers searching for the value <quote>Joan Smith</quote> in the field <replaceable>Name and surname</replaceable>, because <quote>Smith Joan</quote> will not fit to <quote>Joan Smith</quote>.
1556 </para>
1557 <para>How can you solve these problems using a database? You can do this by changing the design of the table <replaceable>Persons</replaceable> by:
1558 </para>
1559 <orderedlist>
1560 <listitem><para>Dividing data in the field <guilabel>Name and surname</guilabel> into two separate fields: <replaceable>Name</replaceable> and <replaceable>Surname</replaceable>.</para></listitem>
1561 <listitem><para>Dividing data in the field <replaceable>Address</replaceable> into three separate fields: <replaceable>Street</replaceable>, <replaceable>House number</replaceable> and <replaceable>City</replaceable>.</para></listitem>
1562 <listitem><para>Guaranteeing data correctness: by ensuring that no fields are empty, &eg; you must always enter house number.</para></listitem>
1563 </orderedlist>
1564 <para>A modified table looks something like this:
1565 </para>
1566 <para>
1567 <table>
1568   <title><emphasis>Persons table</emphasis></title>
1569   <tgroup cols="5">
1570   <thead>
1571   <row>
1572     <entry><guilabel>Name</guilabel></entry>
1573     <entry><guilabel>Surname</guilabel></entry>
1574     <entry><guilabel>Street</guilabel></entry>
1575     <entry><guilabel>House number</guilabel></entry>
1576     <entry><guilabel>City</guilabel></entry>
1577   </row>
1578   </thead>
1579   <tbody>
1580   <row>
1581     <entry>
1582     <para>Joan</para>
1583     </entry>
1584     <entry>
1585     <para>Smith</para>
1586     </entry>
1587     <entry>
1588     <para>Western Gate</para>
1589     </entry>
1590     <entry>
1591     <para>1</para>
1592     </entry>
1593     <entry>
1594     <para>Warsaw</para>
1595     </entry>
1596   </row>
1597   <row>
1598     <entry>
1599     <para>Adam</para>
1600     </entry>
1601     <entry>
1602     <para>Willson</para>
1603     </entry>
1604     <entry>
1605     <para>Frogs Drive</para>
1606     </entry>
1607     <entry>
1608     <para>5</para>
1609     </entry>
1610     <entry>
1611     <para>London</para>
1612     </entry>
1613   </row>
1614   <row>
1615     <entry>
1616     <para><emphasis>Conditions</emphasis></para>
1617     </entry>
1618   </row>
1619   <row>
1620     <entry>
1621     <para>required field</para>
1622     </entry>
1623     <entry>
1624     <para>required field</para>
1625     </entry>
1626     <entry>
1627     <para>required field</para>
1628     </entry>
1629     <entry>
1630     <para>required field</para>
1631     </entry>
1632     <entry>
1633     <para>required field</para></entry>
1634   </row>
1635   </tbody>
1636   </tgroup>
1637 </table>
1638 </para>
1639 <para>Thanks to introducing the condition required field we can be sure that the entered data is complete. In case of other tables you may of course allow omitting certain fields while entering data.
1640 </para>
1641 </sect2>
1642 <sect2 id="limiting-data-view"><title>Limiting data view</title> 
1643 <para>A spreadsheet displays all rows and columns of the table which is bothersome in case of very large data sheets. You may of course filter and sort rows in spreadsheets, however you must be extra careful while doing so. Spreadsheet users are in risk of forgetting that their data view has been filtered what can lead to mistakes. For example, while calculating sums you may think you have 100 rows of data while in fact there are 20 rows more hidden.
1644 </para>
1645 <para>If you want to work on a small subset of data, &eg; to send it for others to edit, you can copy and paste it to another spreadsheet and after editing paste the changed data back to the main spreadsheet. Such <quote>manual</quote> editing may cause data loss or incorrect calculations.
1646 </para>
1647 <para>To limit the data view database applications offer queries, forms and reports.
1648 </para>
1649 <para>A very practical way of limiting is the following extended version of the previously described table <replaceable>Persons</replaceable>:
1650 </para>
1651 <para>
1652 <table>
1653   <title><emphasis>Persons table</emphasis></title>
1654   <tgroup cols="6">
1655   <thead>
1656   <row>
1657     <entry><guilabel>Name</guilabel></entry>
1658     <entry><guilabel>Surname</guilabel></entry>
1659     <entry><guilabel>Street</guilabel></entry>
1660     <entry><guilabel>House number</guilabel></entry>
1661     <entry><guilabel>City</guilabel></entry>
1662     <entry><guilabel>Income</guilabel></entry>
1663   </row>
1664   </thead>
1665   <tbody>
1666   <row>
1667     <entry>
1668     <para>Joan</para>
1669     </entry>
1670     <entry>
1671     <para>Smith</para>
1672     </entry>
1673     <entry>
1674     <para>Western Gate</para>
1675     </entry>
1676     <entry>
1677     <para>1</para>
1678     </entry>
1679     <entry>
1680     <para>Warsaw</para>
1681     </entry>
1682     <entry>
1683     <para>2300</para>
1684     </entry>
1685   </row>
1686   <row>
1687     <entry>
1688     <para>Adam</para>
1689     </entry>
1690     <entry>
1691     <para>Willson</para>
1692     </entry>
1693     <entry>
1694     <para>Frogs Drive</para>
1695     </entry>
1696     <entry>
1697     <para>5</para>
1698     </entry>
1699     <entry>
1700     <para>London</para>
1701     </entry>
1702     <entry>
1703     <para>1900</para></entry>
1704   </row>
1705   </tbody>
1706   </tgroup>
1707 </table>
1708 </para>
1709 <para>Let's assume that the newly introduced column Income contains confidential data. How can you share &eg; contact details of the persons with your coworkers but without revealing their income? It is possible if you share only a query and not the whole table. The query could select all columns except for the column Income. In database world such a query is often known as a view.
1710 </para>
1711 </sect2>
1712 <sect2 id="performance-and-capacity"><title>Performance and capacity</title> 
1713 <para>Your computer is probably quite fast, however you will easily see that it doesn't help with slow, large spreadsheets. Their low efficiency is first of all due to lack of indexes accelerating the process of data search (databases do offer them). Moreover if you use things like system clipboard, even copying data may become troublesome with time.
1714 </para>
1715 <para>Spreadsheets containing large data sets may take ages to open. A spreadsheet loads lots of data to the computer's memory while opening. Most of the data loaded are probably useless/unnecessary for you at the moment. Databases unlike spreadsheets load data from computer storage only when needed.
1716 </para>
1717 <para>In most cases you will not have to worry how the database stores its data. This means that unlike spreadsheets, databases do not care about:
1718 </para>
1719 <itemizedlist>
1720 <listitem><para>The sequence of rows since you can order the rows according to your needs. Moreover, you can view the same data in many views with different orders.</para></listitem>
1721 <listitem><para>The same goes for columns (fields) of the table.</para></listitem>
1722 </itemizedlist>
1723 <para>Together with <link linkend="limiting-data-view">Limiting data view</link> described in the previous paragraph these qualities constitute the advantage of databases.
1724 </para>
1725 </sect2>
1726 <sect2 id="data-entry"><title>Data entry</title> 
1727 <para>The latest editions of applications for creating spreadsheets enable you to design data-entry forms. Such forms are most useful if your data cannot be conveniently displayed in tabular view, &eg; if the text occupies too many rows or if all the columns do not fit on the screen.
1728 </para>
1729 <para>In this case the very way the spreadsheet works is problematic. Fields for data entry are placed loosely within the spreadsheet and very often are not secure against the user's (intentional or accidental) intervention.
1730 </para>
1731 </sect2>
1732 <sect2 id="reports"><title>Reports</title> 
1733 <para>Databases enable grouping, limiting and summing up data in a form of a report. Spreadsheets are usually printed in a form of small tables without fully automatic control over page divisions and the layout of fields.
1734 </para>
1735 </sect2>
1736 <sect2 id="programming"><title>Programming</title> 
1737 <para>Applications for creating databases often contain full programming languages. Newer spreadsheets have this capability too, however calculations come down to modifying the spreadsheet's fields and simple data copying, regardless of the relevance and integrity rules mentioned in previous paragraphs.
1738 </para>
1739 <para>Data processing within a spreadsheet is usually done via a graphical user's interface which may slow down the data processing speed. Databases are capable of working in background, outside of graphical interfaces.
1740 </para>
1741 </sect2>
1742 <sect2 id="multiuse"><title>Multiuse</title> 
1743 <para>It is hard to imagine a multiuse of one spreadsheet. Even if it is technically possible in the case of the latest applications, it requires a lot of discipline, attention and knowledge from the users, and these cannot be guaranteed.
1744 </para>
1745 <para>A classical way to sharing data saved in a spreadsheet with other person is to send a file as a whole (usually using e-mail) or providing a spreadsheet file in a computer network. This way of work is ineffective for larger groups of people - data that could be needed in a particular time may be currently locked by another person.
1746 </para>
1747 <para>On the other hand, databases have been designed mainly with multiuser access in mind. Even for the simplest version locking at a particular table row's level is possible, which enables easy sharing of table data.
1748 </para>
1749 </sect2>
1750 <sect2 id="security"><title>Security</title> 
1751 <para>Securing a spreadsheet or its particular sections with a password is only symbolic activity. After providing a spreadsheet file in a computer network, every person being able to copy the file can try to break the password. It is sometimes not so hard as the password is stored in the same file as the spreadsheet.
1752 </para>
1753 <para>Features for edit locking or copy locking of a spreadsheet (or its part) is equally easy to break.
1754 </para>
1755 <para>Databases (except these saved in a file instead of a server) do not need to be available in a single file. You're accessing them using a computer network, usually by providing a user name and a password. You are gaining access only to these areas (tables, forms or even selected rows and columns) which were assigned to you by setting appropriate access rights.
1756 </para>
1757 <para>Access rights can affect ability of data editing or only data reading. If any data is not available to you, it will not be even sent to your computer, so there is no possibility of making a copy of the data in such easy way as in case of spreadsheet files.
1758 </para>
1759 </sect2>
1760 </sect1>
1761 <sect1 id="database-design"><title>Database Design</title> 
1762 <para>Database design needs careful planning. Note that <replaceable>Persons</replaceable> table redesign proposed in section <link linkend="data-integrity-and-validity">Data integrity and validity</link> can generate problems when the table is filled with data. For example, renaming a field is a simple task, but splitting the <replaceable>Address</replaceable> field into separate fields requires careful and tedious work.
1763 </para>
1764 <para>To avoid such situations, rethink your database project before you create it in your computer, and before you and others will start to use it. Thus, by investing some time initially, you will most probably save your time on everyday use.
1765 </para>
1766 </sect1>
1767 <sect1 id="who-needs-a-database"><title>Who Needs a Database?</title> 
1768 <sect2 id="stick-to-spreadsheets-if-"><title>Stick to spreadsheets if:</title> 
1769 <itemizedlist>
1770 <listitem><para>Your needs are limited and your data will never grow to large volumes (can you actually forecast that now?)</para></listitem>
1771 <listitem><para>You are unable to acquire the methodology of database construction. You may however consider either outsourcing this task to someone else or using simpler tools.</para></listitem>
1772 <listitem><para>You use complicated spreadsheets and you lack time or money to switch to databases. Think or ask someone whether this does not lead down a blind alley. Don't count on magical tools that would change your spreadsheet (regardless how well made) into a database.</para></listitem>
1773 </itemizedlist>
1774 </sect2>
1775 <sect2 id="consider-using-databases-if-"><title>Consider using databases if:</title> 
1776 <itemizedlist>
1777 <listitem><para>Your data collection expands every week.</para></listitem>
1778 <listitem><para>You often create new spreadsheets, copy within these and you feel that this work is getting more and more tedious. In this case the effort of switching to databases easily pays off.</para></listitem>
1779 <listitem><para>You create reports and statements for which the table view of a spreadsheet is not suitable. You can then consider switch to using a database with form views.</para></listitem>
1780 </itemizedlist>
1781 </sect2>
1782 </sect1>
1783 <sect1 id="database-creation-software"><title>Database Creation Software</title> 
1784 <para>So far you have learnt the general characteristics of databases without going into much detail about specific applications for designing them.
1785 </para>
1786 <para>The first databases were built together with large mainframe computers in the 60s, &eg; IBM System/360. Those were not the days of PCs, therefore these databases required a highly specialized personnel. Although the old computers' hardware was unreliable, they were immeasurably slower and had less storage capacity, one feature of databases still remains most attractive: the data access by many users through a network.
1787 </para>
1788 <para>In the 70s scientists formed the theory of relational databases (terms like: table, record, column (field) and relationality and many others). On the basis of this theory IBM DB2 and Oracle databases were created, which have been developed and used till today. In the late 70s the first PCs were constructed. Their users could (gradually) utilize many types of applications, including those for database construction.
1789 </para>
1790 <para>When it comes to large databases in companies, the situation hasn't changed: they still require powerful computers or computer complexes called clusters. This goes, however, beyond the topic of this manual.
1791 </para>
1792 <para>In the area of <quote>accessible</quote> databases with graphic user interface for PCs you can choose from the following:
1793 </para>
1794 <itemizedlist>
1795 <listitem><para><ulink url="http://www.dbase.com">DBase</ulink> - a tool for databases operation for DOS popular in the 80s. Files in DBase format are still used in some specific cases due to their simplicity.</para></listitem>
1796 <listitem><para><ulink url="http://msdn.microsoft.com/vfoxpro/">FoxPro</ulink> - an application similar to DBase (early 90s). After being taken over by Microsoft, graphic user interfaces were introduced and therefore it is used for creating databases on PCs. This product is still offered, though seems a bit obsolete.</para></listitem>
1797 <listitem><para><ulink url="http://office.microsoft.com/access/">Microsoft Access</ulink> - an application for databases (data and graphic interface design) with many simplifications, therefore suitable for beginners, designed in the late 80s, based on 16-Bit Architecture. This product is offered and widely used till today, especially by small companies, where efficiency and multiuser requirements are not very demanding.</para></listitem>
1798 <listitem><para><ulink url="http://www.filemaker.com">FileMaker</ulink> - popular application similar to MS Access in simplicity, operating on Windows and Macintosh platforms, offered since 1985.</para></listitem>
1799 <listitem><para><ulink url="http://www.calligra-suite.org/kexi">Kexi</ulink> - a multiplatform application (&UNIX;/&Linux;, Windows, &MacOS; X) designed in 2003, developed according to OpenSource principles, part of the global KDE community, that among other things provide a graphic environment for &UNIX;/&Linux; systems. A significant contributor to Kexi's development is the OpenOffice Poland company.</para></listitem>
1800 </itemizedlist>
1801 </sect1>
1802 </chapter>
1803 <chapter id="appendix-b--comparing-kexi-to-other-database-applications"><title>Appendix B. Comparing Kexi to other database applications</title> 
1804 <itemizedlist>
1805 <listitem><para><link linkend="data-types">Data types</link>&nbsp;</para></listitem>
1806 </itemizedlist>
1807 <sect1 id="data-types"><title>Data types</title> 
1808 <para>Although different database applications tend to provide similar functionality, they often use different terminology. For your convenience, this appendix shows how the terminology used in &kexi; corresponds to that used by other database applications. Thus, this chapter may be useful when migrating databases from one application to another.
1809 </para>
1810 <para>The table below shows how the data types in &kexi; correspond to data types in other database applications.
1811 </para>
1812 <para>Some of the data types listed here are sub-types of other types. For example, the <guilabel>Long text</guilabel> type is a sub-type of the <guilabel>Text</guilabel> type. To use a sub-type in &kexi;, you should select the corresponding basic type (in this case, <guilabel>Text</guilabel>) in the table designer, and then select the sub-type using the <guilabel>Subtype</guilabel> setting in the <guilabel>Property Editor</guilabel>.
1813 </para>
1814 <para>
1815 <table>
1816   <title><emphasis>Comparison of data types used in Kexi and other database applications</emphasis></title>
1817   <tgroup cols="4">
1818   <thead>
1819   <row>
1820     <entry>&kexi;</entry>
1821     <entry><guilabel>MS Access</guilabel></entry>
1822     <entry><guilabel>dBase/FoxPro</guilabel></entry>
1823     <entry><guilabel>Paradox</guilabel></entry>
1824   </row>
1825   </thead>
1826   <tbody>
1827   <row>
1828     <entry>
1829     <para>Text (Text)</para>
1830     </entry>
1831     <entry>
1832     <para>Text</para>
1833     </entry>
1834     <entry>
1835     <para>Character</para>
1836     </entry>
1837     <entry>
1838     <para>Alphanumeric</para>
1839     </entry>
1840   </row>
1841   <row>
1842     <entry>
1843     <para>Long text (Long text)</para>
1844     </entry>
1845     <entry>
1846     <para>Memo</para>
1847     </entry>
1848     <entry>
1849     <para>Memo</para>
1850     </entry>
1851     <entry>
1852     <para>Memo</para>
1853     </entry>
1854   </row>
1855   <row>
1856     <entry>
1857     <para>Date/Time (Date/Time)</para>
1858     </entry>
1859     <entry>
1860     <para>Date, Time</para>
1861     </entry>
1862     <entry>
1863     <para>Date</para>
1864     </entry>
1865     <entry>
1866     <para>DateTime</para>
1867     </entry>
1868   </row>
1869   <row>
1870     <entry>
1871     <para>Integer Number (Integer Number)</para>
1872     </entry>
1873     <entry>
1874     <para>Number (Integer)</para>
1875     </entry>
1876     <entry>
1877     <para>Numeric</para>
1878     </entry>
1879     <entry>
1880     <para>Integer</para>
1881     </entry>
1882   </row>
1883   <row>
1884     <entry>
1885     <para>Big Integer Number (Big Integer Number)</para>
1886     </entry>
1887     <entry>
1888     <para>Long Integer</para>
1889     </entry>
1890     <entry>
1891     <para>Numeric</para>
1892     </entry>
1893     <entry>
1894     <para>Long Integer</para>
1895     </entry>
1896   </row>
1897   <row>
1898     <entry>
1899     <para>Floating Point Number (Floating Point Number)</para>
1900     </entry>
1901     <entry>
1902     <para>Single/Double precision number</para>
1903     </entry>
1904     <entry>
1905     <para>Float</para>
1906     </entry>
1907     <entry>
1908     <para>Number</para></entry>
1909   </row>
1910   </tbody>
1911   </tgroup>
1912 </table>
1913 </para>
1914 </sect1>
1915 </chapter>
1916 <chapter id="reserved-words-for-sql"><title>Appendix C. Reserved words for SQL</title> 
1917 <para>The following lists contain words that are used internally by &kexi; when dealing with data sources.
1918 </para>
1919 <para><warning><para>When designing your database you should do your best to avoid using these reserved words because otherwise you might end up having problems with your database file or even corrupt it.</para></warning>
1920 </para>
1921 <para><tip><para>If you still want to use reserved words enclose them with double quotation marks <quote></quote>.</para></tip>
1922 </para>
1923 <sect1 id="kexi-sql-reserved-words"><title>Kexi SQL Reserved words</title> 
1924 <para>This list contains keywords that are reserved for use in Kexi SQL:
1925 </para>
1926 <itemizedlist>
1927 <listitem><para>AFTER</para></listitem>
1928 <listitem><para>ALL</para></listitem>
1929 <listitem><para>ASC</para></listitem>
1930 <listitem><para>BEFORE</para></listitem>
1931 <listitem><para>BEGIN</para></listitem>
1932 <listitem><para>BETWEEN</para></listitem>
1933 <listitem><para>BY</para></listitem>
1934 <listitem><para>CASCADE</para></listitem>
1935 <listitem><para>CASE</para></listitem>
1936 <listitem><para>CHECK</para></listitem>
1937 <listitem><para>COLLATE</para></listitem>
1938 <listitem><para>COMMIT</para></listitem>
1939 <listitem><para>CONSTRAINT</para></listitem>
1940 <listitem><para>CROSS</para></listitem>
1941 <listitem><para>DATABASE</para></listitem>
1942 <listitem><para>DEFAULT</para></listitem>
1943 <listitem><para>DELETE</para></listitem>
1944 <listitem><para>DESC</para></listitem>
1945 <listitem><para>DISTINCT</para></listitem>
1946 <listitem><para>DROP</para></listitem>
1947 <listitem><para>END</para></listitem>
1948 <listitem><para>ELSE</para></listitem>
1949 <listitem><para>EXPLAIN</para></listitem>
1950 <listitem><para>FOR</para></listitem>
1951 <listitem><para>FOREIGN</para></listitem>
1952 <listitem><para>FULL</para></listitem>
1953 <listitem><para>GROUP</para></listitem>
1954 <listitem><para>HAVING</para></listitem>
1955 <listitem><para>IGNORE</para></listitem>
1956 <listitem><para>INDEX</para></listitem>
1957 <listitem><para>INNER</para></listitem>
1958 <listitem><para>INSERT</para></listitem>
1959 <listitem><para>INTO</para></listitem>
1960 <listitem><para>KEY</para></listitem>
1961 <listitem><para>LIMIT</para></listitem>
1962 <listitem><para>MATCH</para></listitem>
1963 <listitem><para>NATURAL</para></listitem>
1964 <listitem><para>OFFSET</para></listitem>
1965 <listitem><para>ORDER</para></listitem>
1966 <listitem><para>OUTER</para></listitem>
1967 <listitem><para>PRIMARY</para></listitem>
1968 <listitem><para>REFERENCES</para></listitem>
1969 <listitem><para>REPLACE</para></listitem>
1970 <listitem><para>RESTRICT</para></listitem>
1971 <listitem><para>ROLLBACK</para></listitem>
1972 <listitem><para>ROW</para></listitem>
1973 <listitem><para>SET</para></listitem>
1974 <listitem><para>TEMPORARY</para></listitem>
1975 <listitem><para>THEN</para></listitem>
1976 <listitem><para>TRANSACTION</para></listitem>
1977 <listitem><para>UNION</para></listitem>
1978 <listitem><para>UNIQUE</para></listitem>
1979 <listitem><para>UPDATE</para></listitem>
1980 <listitem><para>USING</para></listitem>
1981 <listitem><para>VALUES</para></listitem>
1982 <listitem><para>WHEN</para></listitem>
1983 </itemizedlist>
1984 </sect1>
1985 <sect1 id="kexi-sqlite-driver-reserved-words"><title>Kexi SQLite Driver Reserved words</title> 
1986 <para>This list contains keywords that are reserved for use by Kexi SQLite Driver:
1987 </para>
1988 <itemizedlist>
1989 <listitem><para>ABORT</para></listitem>
1990 <listitem><para>ATTACH</para></listitem>
1991 <listitem><para>CLUSTER</para></listitem>
1992 <listitem><para>CONFLICT</para></listitem>
1993 <listitem><para>DEFERRED</para></listitem>
1994 <listitem><para>DEFERRABLE</para></listitem>
1995 <listitem><para>DETACH</para></listitem>
1996 <listitem><para>EACH</para></listitem>
1997 <listitem><para>EXCEPT</para></listitem>
1998 <listitem><para>FAIL</para></listitem>
1999 <listitem><para>GLOB</para></listitem>
2000 <listitem><para>IMMEDIATE</para></listitem>
2001 <listitem><para>INITIALLY</para></listitem>
2002 <listitem><para>INSTEAD</para></listitem>
2003 <listitem><para>INTERSECT</para></listitem>
2004 <listitem><para>ISNULL</para></listitem>
2005 <listitem><para>NOTNULL</para></listitem>
2006 <listitem><para>OF</para></listitem>
2007 <listitem><para>PRAGMA</para></listitem>
2008 <listitem><para>RAISE</para></listitem>
2009 <listitem><para>STATEMENT</para></listitem>
2010 <listitem><para>TEMP</para></listitem>
2011 <listitem><para>TRIGGER</para></listitem>
2012 <listitem><para>VACUUM</para></listitem>
2013 <listitem><para>VIEW</para></listitem>
2014 </itemizedlist>
2015 </sect1>
2016 <sect1 id="kexi-mysql-driver-reserved-words"><title>Kexi MySQL Driver Reserved words</title> 
2017 <para>This list contains keywords that are reserved for use by Kexi MySQL Driver:
2018 </para>
2019 <itemizedlist>
2020 <listitem><para>ACTION</para></listitem>
2021 <listitem><para>ADD</para></listitem>
2022 <listitem><para>AGAINST</para></listitem>
2023 <listitem><para>AGGREGATE</para></listitem>
2024 <listitem><para>ALTER</para></listitem>
2025 <listitem><para>ANALYZE</para></listitem>
2026 <listitem><para>ANY</para></listitem>
2027 <listitem><para>ASCII</para></listitem>
2028 <listitem><para>AUTO_INCREMENT</para></listitem>
2029 <listitem><para>AVG</para></listitem>
2030 <listitem><para>AVG_ROW_LENGTH</para></listitem>
2031 <listitem><para>BACKUP</para></listitem>
2032 <listitem><para>BDB</para></listitem>
2033 <listitem><para>BERKELEYDB</para></listitem>
2034 <listitem><para>BIGINT</para></listitem>
2035 <listitem><para>BINARY</para></listitem>
2036 <listitem><para>BINLOG</para></listitem>
2037 <listitem><para>BIT</para></listitem>
2038 <listitem><para>BLOB</para></listitem>
2039 <listitem><para>BOOL</para></listitem>
2040 <listitem><para>BOOLEAN</para></listitem>
2041 <listitem><para>BOTH</para></listitem>
2042 <listitem><para>BTREE</para></listitem>
2043 <listitem><para>BYTE</para></listitem>
2044 <listitem><para>CACHE</para></listitem>
2045 <listitem><para>CHANGE</para></listitem>
2046 <listitem><para>CHANGED</para></listitem>
2047 <listitem><para>CHAR</para></listitem>
2048 <listitem><para>CHARACTER</para></listitem>
2049 <listitem><para>CHARSET</para></listitem>
2050 <listitem><para>CHECKSUM</para></listitem>
2051 <listitem><para>CIPHER</para></listitem>
2052 <listitem><para>CLIENT</para></listitem>
2053 <listitem><para>CLOSE</para></listitem>
2054 <listitem><para>COLLATION</para></listitem>
2055 <listitem><para>COLUMN</para></listitem>
2056 <listitem><para>COLUMNS</para></listitem>
2057 <listitem><para>COMMENT</para></listitem>
2058 <listitem><para>COMMITTED</para></listitem>
2059 <listitem><para>COMPRESSED</para></listitem>
2060 <listitem><para>CONCURRENT</para></listitem>
2061 <listitem><para>CONVERT</para></listitem>
2062 <listitem><para>CUBE</para></listitem>
2063 <listitem><para>CURRENT_DATE</para></listitem>
2064 <listitem><para>CURRENT_TIME</para></listitem>
2065 <listitem><para>CURRENT_TIMESTAMP</para></listitem>
2066 <listitem><para>CURRENT_USER</para></listitem>
2067 <listitem><para>DATA</para></listitem>
2068 <listitem><para>DATABASES</para></listitem>
2069 <listitem><para>DATE</para></listitem>
2070 <listitem><para>DATETIME</para></listitem>
2071 <listitem><para>DAY</para></listitem>
2072 <listitem><para>DAY_HOUR</para></listitem>
2073 <listitem><para>DAY_MICROSECOND</para></listitem>
2074 <listitem><para>DAY_MINUTE</para></listitem>
2075 <listitem><para>DAY_SECOND</para></listitem>
2076 <listitem><para>DEALLOCATE</para></listitem>
2077 <listitem><para>DEC</para></listitem>
2078 <listitem><para>DECIMAL</para></listitem>
2079 <listitem><para>DELAYED</para></listitem>
2080 <listitem><para>DELAY_KEY_WRITE</para></listitem>
2081 <listitem><para>DESCRIBE</para></listitem>
2082 <listitem><para>DES_KEY_FILE</para></listitem>
2083 <listitem><para>DIRECTORY</para></listitem>
2084 <listitem><para>DISABLE</para></listitem>
2085 <listitem><para>DISCARD</para></listitem>
2086 <listitem><para>DISTINCTROW</para></listitem>
2087 <listitem><para>DIV</para></listitem>
2088 <listitem><para>DO</para></listitem>
2089 <listitem><para>DOUBLE</para></listitem>
2090 <listitem><para>DUAL</para></listitem>
2091 <listitem><para>DUMPFILE</para></listitem>
2092 <listitem><para>DUPLICATE</para></listitem>
2093 <listitem><para>DYNAMIC</para></listitem>
2094 <listitem><para>ENABLE</para></listitem>
2095 <listitem><para>ENCLOSED</para></listitem>
2096 <listitem><para>ENGINE</para></listitem>
2097 <listitem><para>ENGINES</para></listitem>
2098 <listitem><para>ENUM</para></listitem>
2099 <listitem><para>ERRORS</para></listitem>
2100 <listitem><para>ESCAPE</para></listitem>
2101 <listitem><para>ESCAPED</para></listitem>
2102 <listitem><para>EVENTS</para></listitem>
2103 <listitem><para>EXECUTE</para></listitem>
2104 <listitem><para>EXISTS</para></listitem>
2105 <listitem><para>EXPANSION</para></listitem>
2106 <listitem><para>EXTENDED</para></listitem>
2107 <listitem><para>FALSE</para></listitem>
2108 <listitem><para>FAST</para></listitem>
2109 <listitem><para>FIELDS</para></listitem>
2110 <listitem><para>FILE</para></listitem>
2111 <listitem><para>FIRST</para></listitem>
2112 <listitem><para>FIXED</para></listitem>
2113 <listitem><para>FLOAT</para></listitem>
2114 <listitem><para>FLOAT4</para></listitem>
2115 <listitem><para>FLOAT8</para></listitem>
2116 <listitem><para>FLUSH</para></listitem>
2117 <listitem><para>FORCE</para></listitem>
2118 <listitem><para>FULLTEXT</para></listitem>
2119 <listitem><para>FUNCTION</para></listitem>
2120 <listitem><para>GEOMETRY</para></listitem>
2121 <listitem><para>GEOMETRYCOLLECTION</para></listitem>
2122 <listitem><para>GET_FORMAT</para></listitem>
2123 <listitem><para>GLOBAL</para></listitem>
2124 <listitem><para>GRANT</para></listitem>
2125 <listitem><para>GRANTS</para></listitem>
2126 <listitem><para>HANDLER</para></listitem>
2127 <listitem><para>HASH</para></listitem>
2128 <listitem><para>HELP</para></listitem>
2129 <listitem><para>HIGH_PRIORITY</para></listitem>
2130 <listitem><para>HOSTS</para></listitem>
2131 <listitem><para>HOUR</para></listitem>
2132 <listitem><para>HOUR_MICROSECOND</para></listitem>
2133 <listitem><para>HOUR_MINUTE</para></listitem>
2134 <listitem><para>HOUR_SECOND</para></listitem>
2135 <listitem><para>IDENTIFIED</para></listitem>
2136 <listitem><para>IF</para></listitem>
2137 <listitem><para>IMPORT</para></listitem>
2138 <listitem><para>INDEXES</para></listitem>
2139 <listitem><para>INFILE</para></listitem>
2140 <listitem><para>INNOBASE</para></listitem>
2141 <listitem><para>INNODB</para></listitem>
2142 <listitem><para>INSERT_METHOD</para></listitem>
2143 <listitem><para>INT</para></listitem>
2144 <listitem><para>INT1</para></listitem>
2145 <listitem><para>INT2</para></listitem>
2146 <listitem><para>INT3</para></listitem>
2147 <listitem><para>INT4</para></listitem>
2148 <listitem><para>INT8</para></listitem>
2149 <listitem><para>INTERVAL</para></listitem>
2150 <listitem><para>IO_THREAD</para></listitem>
2151 <listitem><para>ISOLATION</para></listitem>
2152 <listitem><para>ISSUER</para></listitem>
2153 <listitem><para>KEYS</para></listitem>
2154 <listitem><para>KILL</para></listitem>
2155 <listitem><para>LAST</para></listitem>
2156 <listitem><para>LEADING</para></listitem>
2157 <listitem><para>LEAVES</para></listitem>
2158 <listitem><para>LEVEL</para></listitem>
2159 <listitem><para>LINES</para></listitem>
2160 <listitem><para>LINESTRING</para></listitem>
2161 <listitem><para>LOAD</para></listitem>
2162 <listitem><para>LOCAL</para></listitem>
2163 <listitem><para>LOCALTIME</para></listitem>
2164 <listitem><para>LOCALTIMESTAMP</para></listitem>
2165 <listitem><para>LOCK</para></listitem>
2166 <listitem><para>LOCKS</para></listitem>
2167 <listitem><para>LOGS</para></listitem>
2168 <listitem><para>LONG</para></listitem>
2169 <listitem><para>LONGBLOB</para></listitem>
2170 <listitem><para>LONGTEXT</para></listitem>
2171 <listitem><para>LOW_PRIORITY</para></listitem>
2172 <listitem><para>MASTER</para></listitem>
2173 <listitem><para>MASTER_CONNECT_RETRY</para></listitem>
2174 <listitem><para>MASTER_HOST</para></listitem>
2175 <listitem><para>MASTER_LOG_FILE</para></listitem>
2176 <listitem><para>MASTER_LOG_POS</para></listitem>
2177 <listitem><para>MASTER_PASSWORD</para></listitem>
2178 <listitem><para>MASTER_PORT</para></listitem>
2179 <listitem><para>MASTER_SERVER_ID</para></listitem>
2180 <listitem><para>MASTER_SSL</para></listitem>
2181 <listitem><para>MASTER_SSL_CA</para></listitem>
2182 <listitem><para>MASTER_SSL_CAPATH</para></listitem>
2183 <listitem><para>MASTER_SSL_CERT</para></listitem>
2184 <listitem><para>MASTER_SSL_CIPHER</para></listitem>
2185 <listitem><para>MASTER_SSL_KEY</para></listitem>
2186 <listitem><para>MASTER_USER</para></listitem>
2187 <listitem><para>MAX_CONNECTIONS_PER_HOUR</para></listitem>
2188 <listitem><para>MAX_QUERIES_PER_HOUR</para></listitem>
2189 <listitem><para>MAX_ROWS</para></listitem>
2190 <listitem><para>MAX_UPDATES_PER_HOUR</para></listitem>
2191 <listitem><para>MEDIUM</para></listitem>
2192 <listitem><para>MEDIUMBLOB</para></listitem>
2193 <listitem><para>MEDIUMINT</para></listitem>
2194 <listitem><para>MEDIUMTEXT</para></listitem>
2195 <listitem><para>MICROSECOND</para></listitem>
2196 <listitem><para>MIDDLEINT</para></listitem>
2197 <listitem><para>MINUTE</para></listitem>
2198 <listitem><para>MINUTE_MICROSECOND</para></listitem>
2199 <listitem><para>MINUTE_SECOND</para></listitem>
2200 <listitem><para>MIN_ROWS</para></listitem>
2201 <listitem><para>MOD</para></listitem>
2202 <listitem><para>MODE</para></listitem>
2203 <listitem><para>MODIFY</para></listitem>
2204 <listitem><para>MONTH</para></listitem>
2205 <listitem><para>MULTILINESTRING</para></listitem>
2206 <listitem><para>MULTIPOINT</para></listitem>
2207 <listitem><para>MULTIPOLYGON</para></listitem>
2208 <listitem><para>NAMES</para></listitem>
2209 <listitem><para>NATIONAL</para></listitem>
2210 <listitem><para>NDB</para></listitem>
2211 <listitem><para>NDBCLUSTER</para></listitem>
2212 <listitem><para>NCHAR</para></listitem>
2213 <listitem><para>NEW</para></listitem>
2214 <listitem><para>NEXT</para></listitem>
2215 <listitem><para>NO</para></listitem>
2216 <listitem><para>NONE</para></listitem>
2217 <listitem><para>NO_WRITE_TO_BINLOG</para></listitem>
2218 <listitem><para>NUMERIC</para></listitem>
2219 <listitem><para>NVARCHAR</para></listitem>
2220 <listitem><para>OLD_PASSWORD</para></listitem>
2221 <listitem><para>ONE_SHOT</para></listitem>
2222 <listitem><para>OPEN</para></listitem>
2223 <listitem><para>OPTIMIZE</para></listitem>
2224 <listitem><para>OPTION</para></listitem>
2225 <listitem><para>OPTIONALLY</para></listitem>
2226 <listitem><para>OUTFILE</para></listitem>
2227 <listitem><para>PACK_KEYS</para></listitem>
2228 <listitem><para>PARTIAL</para></listitem>
2229 <listitem><para>PASSWORD</para></listitem>
2230 <listitem><para>POINT</para></listitem>
2231 <listitem><para>POLYGON</para></listitem>
2232 <listitem><para>PRECISION</para></listitem>
2233 <listitem><para>PREPARE</para></listitem>
2234 <listitem><para>PREV</para></listitem>
2235 <listitem><para>PRIVILEGES</para></listitem>
2236 <listitem><para>PROCEDURE</para></listitem>
2237 <listitem><para>PROCESS</para></listitem>
2238 <listitem><para>PROCESSLIST</para></listitem>
2239 <listitem><para>PURGE</para></listitem>
2240 <listitem><para>QUERY</para></listitem>
2241 <listitem><para>QUICK</para></listitem>
2242 <listitem><para>RAID0</para></listitem>
2243 <listitem><para>RAID_CHUNKS</para></listitem>
2244 <listitem><para>RAID_CHUNKSIZE</para></listitem>
2245 <listitem><para>RAID_TYPE</para></listitem>
2246 <listitem><para>READ</para></listitem>
2247 <listitem><para>REAL</para></listitem>
2248 <listitem><para>REGEXP</para></listitem>
2249 <listitem><para>RELAY_LOG_FILE</para></listitem>
2250 <listitem><para>RELAY_LOG_POS</para></listitem>
2251 <listitem><para>RELAY_THREAD</para></listitem>
2252 <listitem><para>RELOAD</para></listitem>
2253 <listitem><para>RENAME</para></listitem>
2254 <listitem><para>REPAIR</para></listitem>
2255 <listitem><para>REPEATABLE</para></listitem>
2256 <listitem><para>REPLICATION</para></listitem>
2257 <listitem><para>REQUIRE</para></listitem>
2258 <listitem><para>RESET</para></listitem>
2259 <listitem><para>RESTORE</para></listitem>
2260 <listitem><para>RETURNS</para></listitem>
2261 <listitem><para>REVOKE</para></listitem>
2262 <listitem><para>RLIKE</para></listitem>
2263 <listitem><para>ROLLUP</para></listitem>
2264 <listitem><para>ROWS</para></listitem>
2265 <listitem><para>ROW_FORMAT</para></listitem>
2266 <listitem><para>RTREE</para></listitem>
2267 <listitem><para>SAVEPOINT</para></listitem>
2268 <listitem><para>SECOND</para></listitem>
2269 <listitem><para>SECOND_MICROSECOND</para></listitem>
2270 <listitem><para>SEPARATOR</para></listitem>
2271 <listitem><para>SERIAL</para></listitem>
2272 <listitem><para>SERIALIZABLE</para></listitem>
2273 <listitem><para>SESSION</para></listitem>
2274 <listitem><para>SHARE</para></listitem>
2275 <listitem><para>SHOW</para></listitem>
2276 <listitem><para>SHUTDOWN</para></listitem>
2277 <listitem><para>SIGNED</para></listitem>
2278 <listitem><para>SIMPLE</para></listitem>
2279 <listitem><para>SLAVE</para></listitem>
2280 <listitem><para>SMALLINT</para></listitem>
2281 <listitem><para>SOME</para></listitem>
2282 <listitem><para>SONAME</para></listitem>
2283 <listitem><para>SOUNDS</para></listitem>
2284 <listitem><para>SPATIAL</para></listitem>
2285 <listitem><para>SQL_BIG_RESULT</para></listitem>
2286 <listitem><para>SQL_BUFFER_RESULT</para></listitem>
2287 <listitem><para>SQL_CACHE</para></listitem>
2288 <listitem><para>SQL_CALC_FOUND_ROWS</para></listitem>
2289 <listitem><para>SQL_NO_CACHE</para></listitem>
2290 <listitem><para>SQL_SMALL_RESULT</para></listitem>
2291 <listitem><para>SQL_THREAD</para></listitem>
2292 <listitem><para>SSL</para></listitem>
2293 <listitem><para>START</para></listitem>
2294 <listitem><para>STARTING</para></listitem>
2295 <listitem><para>STATUS</para></listitem>
2296 <listitem><para>STOP</para></listitem>
2297 <listitem><para>STORAGE</para></listitem>
2298 <listitem><para>STRAIGHT_JOIN</para></listitem>
2299 <listitem><para>STRING</para></listitem>
2300 <listitem><para>STRIPED</para></listitem>
2301 <listitem><para>SUBJECT</para></listitem>
2302 <listitem><para>SUPER</para></listitem>
2303 <listitem><para>TABLES</para></listitem>
2304 <listitem><para>TABLESPACE</para></listitem>
2305 <listitem><para>TERMINATED</para></listitem>
2306 <listitem><para>TEXT</para></listitem>
2307 <listitem><para>TIME</para></listitem>
2308 <listitem><para>TIMESTAMP</para></listitem>
2309 <listitem><para>TINYBLOB</para></listitem>
2310 <listitem><para>TINYINT</para></listitem>
2311 <listitem><para>TINYTEXT</para></listitem>
2312 <listitem><para>TRAILING</para></listitem>
2313 <listitem><para>TRUE</para></listitem>
2314 <listitem><para>TRUNCATE</para></listitem>
2315 <listitem><para>TYPE</para></listitem>
2316 <listitem><para>TYPES</para></listitem>
2317 <listitem><para>UNCOMMITTED</para></listitem>
2318 <listitem><para>UNICODE</para></listitem>
2319 <listitem><para>UNLOCK</para></listitem>
2320 <listitem><para>UNSIGNED</para></listitem>
2321 <listitem><para>UNTIL</para></listitem>
2322 <listitem><para>USAGE</para></listitem>
2323 <listitem><para>USE</para></listitem>
2324 <listitem><para>USER</para></listitem>
2325 <listitem><para>USER_RESOURCES</para></listitem>
2326 <listitem><para>USE_FRM</para></listitem>
2327 <listitem><para>UTC_DATE</para></listitem>
2328 <listitem><para>UTC_TIME</para></listitem>
2329 <listitem><para>UTC_TIMESTAMP</para></listitem>
2330 <listitem><para>VALUE</para></listitem>
2331 <listitem><para>VARBINARY</para></listitem>
2332 <listitem><para>VARCHAR</para></listitem>
2333 <listitem><para>VARCHARACTER</para></listitem>
2334 <listitem><para>VARIABLES</para></listitem>
2335 <listitem><para>VARYING</para></listitem>
2336 <listitem><para>WARNINGS</para></listitem>
2337 <listitem><para>WITH</para></listitem>
2338 <listitem><para>WORK</para></listitem>
2339 <listitem><para>WRITE</para></listitem>
2340 <listitem><para>X509</para></listitem>
2341 <listitem><para>YEAR</para></listitem>
2342 <listitem><para>YEAR_MONTH</para></listitem>
2343 <listitem><para>ZEROFILL</para></listitem>
2344 </itemizedlist>
2345 </sect1>
2346 <sect1 id="kexi-postgresql-driver-reserved-words"><title>Kexi PostgreSQL Driver Reserved words</title> 
2347 <para>This list contains keywords that are reserved for use by Kexi pqxx Driver:
2348 </para>
2349 <itemizedlist>
2350 <listitem><para>ABORT</para></listitem>
2351 <listitem><para>ABSOLUTE</para></listitem>
2352 <listitem><para>ACCESS</para></listitem>
2353 <listitem><para>ACTION</para></listitem>
2354 <listitem><para>ADD</para></listitem>
2355 <listitem><para>AGGREGATE</para></listitem>
2356 <listitem><para>ALTER</para></listitem>
2357 <listitem><para>ANALYSE</para></listitem>
2358 <listitem><para>ANALYZE</para></listitem>
2359 <listitem><para>ANY</para></listitem>
2360 <listitem><para>ARRAY</para></listitem>
2361 <listitem><para>ASSERTION</para></listitem>
2362 <listitem><para>ASSIGNMENT</para></listitem>
2363 <listitem><para>AT</para></listitem>
2364 <listitem><para>AUTHORIZATION</para></listitem>
2365 <listitem><para>BACKWARD</para></listitem>
2366 <listitem><para>BIGINT</para></listitem>
2367 <listitem><para>BINARY</para></listitem>
2368 <listitem><para>BIT</para></listitem>
2369 <listitem><para>BOOLEAN</para></listitem>
2370 <listitem><para>BOTH</para></listitem>
2371 <listitem><para>CACHE</para></listitem>
2372 <listitem><para>CALLED</para></listitem>
2373 <listitem><para>CAST</para></listitem>
2374 <listitem><para>CHAIN</para></listitem>
2375 <listitem><para>CHAR</para></listitem>
2376 <listitem><para>CHARACTER</para></listitem>
2377 <listitem><para>CHARACTERISTICS</para></listitem>
2378 <listitem><para>CHECKPOINT</para></listitem>
2379 <listitem><para>CLASS</para></listitem>
2380 <listitem><para>CLOSE</para></listitem>
2381 <listitem><para>CLUSTER</para></listitem>
2382 <listitem><para>COALESCE</para></listitem>
2383 <listitem><para>COLUMN</para></listitem>
2384 <listitem><para>COMMENT</para></listitem>
2385 <listitem><para>COMMITTED</para></listitem>
2386 <listitem><para>CONSTRAINTS</para></listitem>
2387 <listitem><para>CONVERSION</para></listitem>
2388 <listitem><para>CONVERT</para></listitem>
2389 <listitem><para>COPY</para></listitem>
2390 <listitem><para>CREATEDB</para></listitem>
2391 <listitem><para>CREATEUSER</para></listitem>
2392 <listitem><para>CURRENT_DATE</para></listitem>
2393 <listitem><para>CURRENT_TIME</para></listitem>
2394 <listitem><para>CURRENT_TIMESTAMP</para></listitem>
2395 <listitem><para>CURRENT_USER</para></listitem>
2396 <listitem><para>CURSOR</para></listitem>
2397 <listitem><para>CYCLE</para></listitem>
2398 <listitem><para>DAY</para></listitem>
2399 <listitem><para>DEALLOCATE</para></listitem>
2400 <listitem><para>DEC</para></listitem>
2401 <listitem><para>DECIMAL</para></listitem>
2402 <listitem><para>DECLARE</para></listitem>
2403 <listitem><para>DEFAULTS</para></listitem>
2404 <listitem><para>DEFERRABLE</para></listitem>
2405 <listitem><para>DEFERRED</para></listitem>
2406 <listitem><para>DEFINER</para></listitem>
2407 <listitem><para>DELIMITER</para></listitem>
2408 <listitem><para>DELIMITERS</para></listitem>
2409 <listitem><para>DO</para></listitem>
2410 <listitem><para>DOMAIN</para></listitem>
2411 <listitem><para>DOUBLE</para></listitem>
2412 <listitem><para>EACH</para></listitem>
2413 <listitem><para>ENCODING</para></listitem>
2414 <listitem><para>ENCRYPTED</para></listitem>
2415 <listitem><para>ESCAPE</para></listitem>
2416 <listitem><para>EXCEPT</para></listitem>
2417 <listitem><para>EXCLUDING</para></listitem>
2418 <listitem><para>EXCLUSIVE</para></listitem>
2419 <listitem><para>EXECUTE</para></listitem>
2420 <listitem><para>EXISTS</para></listitem>
2421 <listitem><para>EXTERNAL</para></listitem>
2422 <listitem><para>EXTRACT</para></listitem>
2423 <listitem><para>FALSE</para></listitem>
2424 <listitem><para>FETCH</para></listitem>
2425 <listitem><para>FIRST</para></listitem>
2426 <listitem><para>FLOAT</para></listitem>
2427 <listitem><para>FORCE</para></listitem>
2428 <listitem><para>FORWARD</para></listitem>
2429 <listitem><para>FREEZE</para></listitem>
2430 <listitem><para>FUNCTION</para></listitem>
2431 <listitem><para>GLOBAL</para></listitem>
2432 <listitem><para>GRANT</para></listitem>
2433 <listitem><para>HANDLER</para></listitem>
2434 <listitem><para>HOLD</para></listitem>
2435 <listitem><para>HOUR</para></listitem>
2436 <listitem><para>ILIKE</para></listitem>
2437 <listitem><para>IMMEDIATE</para></listitem>
2438 <listitem><para>IMMUTABLE</para></listitem>
2439 <listitem><para>IMPLICIT</para></listitem>
2440 <listitem><para>INCLUDING</para></listitem>
2441 <listitem><para>INCREMENT</para></listitem>
2442 <listitem><para>INHERITS</para></listitem>
2443 <listitem><para>INITIALLY</para></listitem>
2444 <listitem><para>INOUT</para></listitem>
2445 <listitem><para>INPUT</para></listitem>
2446 <listitem><para>INSENSITIVE</para></listitem>
2447 <listitem><para>INSTEAD</para></listitem>
2448 <listitem><para>INT</para></listitem>
2449 <listitem><para>INTERSECT</para></listitem>
2450 <listitem><para>INTERVAL</para></listitem>
2451 <listitem><para>INVOKER</para></listitem>
2452 <listitem><para>ISNULL</para></listitem>
2453 <listitem><para>ISOLATION</para></listitem>
2454 <listitem><para>LANCOMPILER</para></listitem>
2455 <listitem><para>LANGUAGE</para></listitem>
2456 <listitem><para>LAST</para></listitem>
2457 <listitem><para>LEADING</para></listitem>
2458 <listitem><para>LEVEL</para></listitem>
2459 <listitem><para>LISTEN</para></listitem>
2460 <listitem><para>LOAD</para></listitem>
2461 <listitem><para>LOCAL</para></listitem>
2462 <listitem><para>LOCALTIME</para></listitem>
2463 <listitem><para>LOCALTIMESTAMP</para></listitem>
2464 <listitem><para>LOCATION</para></listitem>
2465 <listitem><para>LOCK</para></listitem>
2466 <listitem><para>MAXVALUE</para></listitem>
2467 <listitem><para>MINUTE</para></listitem>
2468 <listitem><para>MINVALUE</para></listitem>
2469 <listitem><para>MODE</para></listitem>
2470 <listitem><para>MONTH</para></listitem>
2471 <listitem><para>MOVE</para></listitem>
2472 <listitem><para>NAMES</para></listitem>
2473 <listitem><para>NATIONAL</para></listitem>
2474 <listitem><para>NCHAR</para></listitem>
2475 <listitem><para>NEW</para></listitem>
2476 <listitem><para>NEXT</para></listitem>
2477 <listitem><para>NO</para></listitem>
2478 <listitem><para>NOCREATEDB</para></listitem>
2479 <listitem><para>NOCREATEUSER</para></listitem>
2480 <listitem><para>NONE</para></listitem>
2481 <listitem><para>NOTHING</para></listitem>
2482 <listitem><para>NOTIFY</para></listitem>
2483 <listitem><para>NOTNULL</para></listitem>
2484 <listitem><para>NULLIF</para></listitem>
2485 <listitem><para>NUMERIC</para></listitem>
2486 <listitem><para>OF</para></listitem>
2487 <listitem><para>OFF</para></listitem>
2488 <listitem><para>OIDS</para></listitem>
2489 <listitem><para>OLD</para></listitem>
2490 <listitem><para>ONLY</para></listitem>
2491 <listitem><para>OPERATOR</para></listitem>
2492 <listitem><para>OPTION</para></listitem>
2493 <listitem><para>OUT</para></listitem>
2494 <listitem><para>OVERLAPS</para></listitem>
2495 <listitem><para>OVERLAY</para></listitem>
2496 <listitem><para>OWNER</para></listitem>
2497 <listitem><para>PARTIAL</para></listitem>
2498 <listitem><para>PASSWORD</para></listitem>
2499 <listitem><para>PATH</para></listitem>
2500 <listitem><para>PENDANT</para></listitem>
2501 <listitem><para>PLACING</para></listitem>
2502 <listitem><para>POSITION</para></listitem>
2503 <listitem><para>PRECISION</para></listitem>
2504 <listitem><para>PREPARE</para></listitem>
2505 <listitem><para>PRESERVE</para></listitem>
2506 <listitem><para>PRIOR</para></listitem>
2507 <listitem><para>PRIVILEGES</para></listitem>
2508 <listitem><para>PROCEDURAL</para></listitem>
2509 <listitem><para>PROCEDURE</para></listitem>
2510 <listitem><para>READ</para></listitem>
2511 <listitem><para>REAL</para></listitem>
2512 <listitem><para>RECHECK</para></listitem>
2513 <listitem><para>REINDEX</para></listitem>
2514 <listitem><para>RELATIVE</para></listitem>
2515 <listitem><para>RENAME</para></listitem>
2516 <listitem><para>RESET</para></listitem>
2517 <listitem><para>RESTART</para></listitem>
2518 <listitem><para>RETURNS</para></listitem>
2519 <listitem><para>REVOKE</para></listitem>
2520 <listitem><para>ROWS</para></listitem>
2521 <listitem><para>RULE</para></listitem>
2522 <listitem><para>SCHEMA</para></listitem>
2523 <listitem><para>SCROLL</para></listitem>
2524 <listitem><para>SECOND</para></listitem>
2525 <listitem><para>SECURITY</para></listitem>
2526 <listitem><para>SEQUENCE</para></listitem>
2527 <listitem><para>SERIALIZABLE</para></listitem>
2528 <listitem><para>SESSION</para></listitem>
2529 <listitem><para>SESSION_USER</para></listitem>
2530 <listitem><para>SETOF</para></listitem>
2531 <listitem><para>SHARE</para></listitem>
2532 <listitem><para>SHOW</para></listitem>
2533 <listitem><para>SIMPLE</para></listitem>
2534 <listitem><para>SMALLINT</para></listitem>
2535 <listitem><para>SOME</para></listitem>
2536 <listitem><para>STABLE</para></listitem>
2537 <listitem><para>START</para></listitem>
2538 <listitem><para>STATEMENT</para></listitem>
2539 <listitem><para>STATISTICS</para></listitem>
2540 <listitem><para>STDIN</para></listitem>
2541 <listitem><para>STDOUT</para></listitem>
2542 <listitem><para>STORAGE</para></listitem>
2543 <listitem><para>STRICT</para></listitem>
2544 <listitem><para>SUBSTRING</para></listitem>
2545 <listitem><para>SYSID</para></listitem>
2546 <listitem><para>TEMP</para></listitem>
2547 <listitem><para>TEMPLATE</para></listitem>
2548 <listitem><para>TIME</para></listitem>
2549 <listitem><para>TIMESTAMP</para></listitem>
2550 <listitem><para>TOAST</para></listitem>
2551 <listitem><para>TRAILING</para></listitem>
2552 <listitem><para>TREAT</para></listitem>
2553 <listitem><para>TRIGGER</para></listitem>
2554 <listitem><para>TRIM</para></listitem>
2555 <listitem><para>TRUE</para></listitem>
2556 <listitem><para>TRUNCATE</para></listitem>
2557 <listitem><para>TRUSTED</para></listitem>
2558 <listitem><para>TYPE</para></listitem>
2559 <listitem><para>UNENCRYPTED</para></listitem>
2560 <listitem><para>UNKNOWN</para></listitem>
2561 <listitem><para>UNLISTEN</para></listitem>
2562 <listitem><para>UNTIL</para></listitem>
2563 <listitem><para>USAGE</para></listitem>
2564 <listitem><para>USER</para></listitem>
2565 <listitem><para>VACUUM</para></listitem>
2566 <listitem><para>VALID</para></listitem>
2567 <listitem><para>VALIDATOR</para></listitem>
2568 <listitem><para>VARCHAR</para></listitem>
2569 <listitem><para>VARYING</para></listitem>
2570 <listitem><para>VERBOSE</para></listitem>
2571 <listitem><para>VERSION</para></listitem>
2572 <listitem><para>VIEW</para></listitem>
2573 <listitem><para>VOLATILE</para></listitem>
2574 <listitem><para>WITH</para></listitem>
2575 <listitem><para>WITHOUT</para></listitem>
2576 <listitem><para>WORK</para></listitem>
2577 <listitem><para>WRITE</para></listitem>
2578 <listitem><para>YEAR</para></listitem>
2579 <listitem><para>ZONE</para></listitem>
2580 </itemizedlist>
2581 </sect1>
2582 <sect1 id="kexi-oracle-driver-reserved-words"><title>Kexi Oracle Driver Reserved words</title> 
2583 <para>This list contains keywords that are reserved for use by Kexi Oracle Driver:
2584 </para>
2585 <itemizedlist>
2586 <listitem><para>ADMIN</para></listitem>
2587 <listitem><para>AFTER</para></listitem>
2588 <listitem><para>ALLOCATE</para></listitem>
2589 <listitem><para>ANALYZE</para></listitem>
2590 <listitem><para>ARCHIVE</para></listitem>
2591 <listitem><para>ARCHIVELOG</para></listitem>
2592 <listitem><para>AUTHORIZATION</para></listitem>
2593 <listitem><para>AVG</para></listitem>
2594 <listitem><para>BACKUP</para></listitem>
2595 <listitem><para>BECOME</para></listitem>
2596 <listitem><para>BEFORE</para></listitem>
2597 <listitem><para>BEGIN</para></listitem>
2598 <listitem><para>BLOCK</para></listitem>
2599 <listitem><para>BODY</para></listitem>
2600 <listitem><para>CACHE</para></listitem>
2601 <listitem><para>CANCEL</para></listitem>
2602 <listitem><para>CASCADE</para></listitem>
2603 <listitem><para>CHANGE</para></listitem>
2604 <listitem><para>CHARACTER</para></listitem>
2605 <listitem><para>CHECKPOINT</para></listitem>
2606 <listitem><para>CLOSE</para></listitem>
2607 <listitem><para>COBOL</para></listitem>
2608 <listitem><para>COMMIT</para></listitem>
2609 <listitem><para>COMPILE</para></listitem>
2610 <listitem><para>CONSTRAINT</para></listitem>
2611 <listitem><para>CONSTRAINTS</para></listitem>
2612 <listitem><para>CONTENTS</para></listitem>
2613 <listitem><para>CONTINUE</para></listitem>
2614 <listitem><para>CONTROLFILE</para></listitem>
2615 <listitem><para>COUNT</para></listitem>
2616 <listitem><para>CURSOR</para></listitem>
2617 <listitem><para>CYCLE</para></listitem>
2618 <listitem><para>DATABASE</para></listitem>
2619 <listitem><para>DATAFILE</para></listitem>
2620 <listitem><para>DATE</para></listitem>
2621 <listitem><para>DBA</para></listitem>
2622 <listitem><para>DEC</para></listitem>
2623 <listitem><para>DECLARE</para></listitem>
2624 <listitem><para>DISABLE</para></listitem>
2625 <listitem><para>DISMOUNT</para></listitem>
2626 <listitem><para>DOUBLE</para></listitem>
2627 <listitem><para>DUMP</para></listitem>
2628 <listitem><para>EACH</para></listitem>
2629 <listitem><para>ENABLE</para></listitem>
2630 <listitem><para>END</para></listitem>
2631 <listitem><para>ESCAPE</para></listitem>
2632 <listitem><para>EVENTS</para></listitem>
2633 <listitem><para>EXCEPT</para></listitem>
2634 <listitem><para>EXCEPTIONS</para></listitem>
2635 <listitem><para>EXEC</para></listitem>
2636 <listitem><para>EXECUTE</para></listitem>
2637 <listitem><para>EXPLAIN</para></listitem>
2638 <listitem><para>EXTENT</para></listitem>
2639 <listitem><para>EXTERNALLY</para></listitem>
2640 <listitem><para>FETCH</para></listitem>
2641 <listitem><para>FLUSH</para></listitem>
2642 <listitem><para>FORCE</para></listitem>
2643 <listitem><para>FOREIGN</para></listitem>
2644 <listitem><para>FORTRAN</para></listitem>
2645 <listitem><para>FOUND</para></listitem>
2646 <listitem><para>FREELIST</para></listitem>
2647 <listitem><para>FREELISTS</para></listitem>
2648 <listitem><para>FUNCTION</para></listitem>
2649 <listitem><para>GO</para></listitem>
2650 <listitem><para>GOTO</para></listitem>
2651 <listitem><para>GROUPS</para></listitem>
2652 <listitem><para>INCLUDING</para></listitem>
2653 <listitem><para>INDICATOR</para></listitem>
2654 <listitem><para>INITRANS</para></listitem>
2655 <listitem><para>INSTANCE</para></listitem>
2656 <listitem><para>INT</para></listitem>
2657 <listitem><para>KEY</para></listitem>
2658 <listitem><para>LANGUAGE</para></listitem>
2659 <listitem><para>LAYER</para></listitem>
2660 <listitem><para>LINK</para></listitem>
2661 <listitem><para>LISTS</para></listitem>
2662 <listitem><para>LOGFILE</para></listitem>
2663 <listitem><para>MANAGE</para></listitem>
2664 <listitem><para>MANUAL</para></listitem>
2665 <listitem><para>MAX</para></listitem>
2666 <listitem><para>MAXDATAFILES</para></listitem>
2667 <listitem><para>MAXINSTANCES</para></listitem>
2668 <listitem><para>MAXLOGFILES</para></listitem>
2669 <listitem><para>MAXLOGHISTORY</para></listitem>
2670 <listitem><para>MAXLOGMEMBERS</para></listitem>
2671 <listitem><para>MAXTRANS</para></listitem>
2672 <listitem><para>MAXVALUE</para></listitem>
2673 <listitem><para>MIN</para></listitem>
2674 <listitem><para>MINEXTENTS</para></listitem>
2675 <listitem><para>MINVALUE</para></listitem>
2676 <listitem><para>MODULE</para></listitem>
2677 <listitem><para>MOUNT</para></listitem>
2678 <listitem><para>NEW</para></listitem>
2679 <listitem><para>NEXT</para></listitem>
2680 <listitem><para>NOARCHIVELOG</para></listitem>
2681 <listitem><para>NOCACHE</para></listitem>
2682 <listitem><para>NOCYCLE</para></listitem>
2683 <listitem><para>NOMAXVALUE</para></listitem>
2684 <listitem><para>NOMINVALUE</para></listitem>
2685 <listitem><para>NONE</para></listitem>
2686 <listitem><para>NOORDER</para></listitem>
2687 <listitem><para>NORESETLOGS</para></listitem>
2688 <listitem><para>NORMAL</para></listitem>
2689 <listitem><para>NOSORT</para></listitem>
2690 <listitem><para>NUMERIC</para></listitem>
2691 <listitem><para>OFF</para></listitem>
2692 <listitem><para>OLD</para></listitem>
2693 <listitem><para>ONLY</para></listitem>
2694 <listitem><para>OPEN</para></listitem>
2695 <listitem><para>OPTIMAL</para></listitem>
2696 <listitem><para>OWN</para></listitem>
2697 <listitem><para>PACKAGE</para></listitem>
2698 <listitem><para>PARALLEL</para></listitem>
2699 <listitem><para>PCTINCREASE</para></listitem>
2700 <listitem><para>PCTUSED</para></listitem>
2701 <listitem><para>PLAN</para></listitem>
2702 <listitem><para>PLI</para></listitem>
2703 <listitem><para>PRECISION</para></listitem>
2704 <listitem><para>PRIMARY</para></listitem>
2705 <listitem><para>PRIVATE</para></listitem>
2706 <listitem><para>PROCEDURE</para></listitem>
2707 <listitem><para>PROFILE</para></listitem>
2708 <listitem><para>QUOTA</para></listitem>
2709 <listitem><para>READ</para></listitem>
2710 <listitem><para>REAL</para></listitem>
2711 <listitem><para>RECOVER</para></listitem>
2712 <listitem><para>REFERENCES</para></listitem>
2713 <listitem><para>REFERENCING</para></listitem>
2714 <listitem><para>RESETLOGS</para></listitem>
2715 <listitem><para>RESTRICTED</para></listitem>
2716 <listitem><para>REUSE</para></listitem>
2717 <listitem><para>ROLE</para></listitem>
2718 <listitem><para>ROLES</para></listitem>
2719 <listitem><para>ROLLBACK</para></listitem>
2720 <listitem><para>SAVEPOINT</para></listitem>
2721 <listitem><para>SCHEMA</para></listitem>
2722 <listitem><para>SCN</para></listitem>
2723 <listitem><para>SECTION</para></listitem>
2724 <listitem><para>SEGMENT</para></listitem>
2725 <listitem><para>SEQUENCE</para></listitem>
2726 <listitem><para>SHARED</para></listitem>
2727 <listitem><para>SNAPSHOT</para></listitem>
2728 <listitem><para>SOME</para></listitem>
2729 <listitem><para>SORT</para></listitem>
2730 <listitem><para>SQL</para></listitem>
2731 <listitem><para>SQLCODE</para></listitem>
2732 <listitem><para>SQLERROR</para></listitem>
2733 <listitem><para>SQLSTATE</para></listitem>
2734 <listitem><para>STATEMENT_ID</para></listitem>
2735 <listitem><para>STATISTICS</para></listitem>
2736 <listitem><para>STOP</para></listitem>
2737 <listitem><para>STORAGE</para></listitem>
2738 <listitem><para>SUM</para></listitem>
2739 <listitem><para>SWITCH</para></listitem>
2740 <listitem><para>SYSTEM</para></listitem>
2741 <listitem><para>TABLES</para></listitem>
2742 <listitem><para>TABLESPACE</para></listitem>
2743 <listitem><para>TEMPORARY</para></listitem>
2744 <listitem><para>THREAD</para></listitem>
2745 <listitem><para>TIME</para></listitem>
2746 <listitem><para>TRACING</para></listitem>
2747 <listitem><para>TRANSACTION</para></listitem>
2748 <listitem><para>TRIGGERS</para></listitem>
2749 <listitem><para>TRUNCATE</para></listitem>
2750 <listitem><para>UNDER</para></listitem>
2751 <listitem><para>UNLIMITED</para></listitem>
2752 <listitem><para>UNTIL</para></listitem>
2753 <listitem><para>USE</para></listitem>
2754 <listitem><para>USING</para></listitem>
2755 <listitem><para>WHEN</para></listitem>
2756 <listitem><para>WORK</para></listitem>
2757 <listitem><para>WRITE</para></listitem>
2758 </itemizedlist>
2759 </sect1>
2760 <sect1 id="kexi-sybase-driver-reserved-words"><title>Kexi Sybase Driver Reserved words</title> 
2761 <para>This list contains keywords that are reserved for use by Kexi Sybase Driver:
2762 </para>
2763 <itemizedlist>
2764 <listitem><para>ACTION</para></listitem>
2765 <listitem><para>ADD</para></listitem>
2766 <listitem><para>AGAINST</para></listitem>
2767 <listitem><para>AGGREGATE</para></listitem>
2768 <listitem><para>ALTER</para></listitem>
2769 <listitem><para>ANALYZE</para></listitem>
2770 <listitem><para>ANY</para></listitem>
2771 <listitem><para>ASCII</para></listitem>
2772 <listitem><para>AUTOINCREMENT</para></listitem>
2773 <listitem><para>AVG</para></listitem>
2774 <listitem><para>AVG_ROW_LENGTH</para></listitem>
2775 <listitem><para>BACKUP</para></listitem>
2776 <listitem><para>BDB</para></listitem>
2777 <listitem><para>BERKELEYDB</para></listitem>
2778 <listitem><para>BIGINT</para></listitem>
2779 <listitem><para>BINARY</para></listitem>
2780 <listitem><para>BINLOG</para></listitem>
2781 <listitem><para>BIT</para></listitem>
2782 <listitem><para>BLOB</para></listitem>
2783 <listitem><para>BOOL</para></listitem>
2784 <listitem><para>BOOLEAN</para></listitem>
2785 <listitem><para>BOTH</para></listitem>
2786 <listitem><para>BTREE</para></listitem>
2787 <listitem><para>BYTE</para></listitem>
2788 <listitem><para>CACHE</para></listitem>
2789 <listitem><para>CHANGE</para></listitem>
2790 <listitem><para>CHANGED</para></listitem>
2791 <listitem><para>CHAR</para></listitem>
2792 <listitem><para>CHARACTER</para></listitem>
2793 <listitem><para>CHARSET</para></listitem>
2794 <listitem><para>CHECKSUM</para></listitem>
2795 <listitem><para>CIPHER</para></listitem>
2796 <listitem><para>CLIENT</para></listitem>
2797 <listitem><para>CLOSE</para></listitem>
2798 <listitem><para>COLLATION</para></listitem>
2799 <listitem><para>COLUMN</para></listitem>
2800 <listitem><para>COLUMNS</para></listitem>
2801 <listitem><para>COMMENT</para></listitem>
2802 <listitem><para>COMMITTED</para></listitem>
2803 <listitem><para>COMPRESSED</para></listitem>
2804 <listitem><para>CONCURRENT</para></listitem>
2805 <listitem><para>CONVERT</para></listitem>
2806 <listitem><para>CUBE</para></listitem>
2807 <listitem><para>CURRENT_DATE</para></listitem>
2808 <listitem><para>CURRENT_TIME</para></listitem>
2809 <listitem><para>CURRENT_TIMESTAMP</para></listitem>
2810 <listitem><para>CURRENT_USER</para></listitem>
2811 <listitem><para>DATA</para></listitem>
2812 <listitem><para>DATABASES</para></listitem>
2813 <listitem><para>DATE</para></listitem>
2814 <listitem><para>DATETIME</para></listitem>
2815 <listitem><para>DAY</para></listitem>
2816 <listitem><para>DAY_HOUR</para></listitem>
2817 <listitem><para>DAY_MICROSECOND</para></listitem>
2818 <listitem><para>DAY_MINUTE</para></listitem>
2819 <listitem><para>DAY_SECOND</para></listitem>
2820 <listitem><para>DEALLOCATE</para></listitem>
2821 <listitem><para>DEC</para></listitem>
2822 <listitem><para>DECIMAL</para></listitem>
2823 <listitem><para>DELAYED</para></listitem>
2824 <listitem><para>DELAY_KEY_WRITE</para></listitem>
2825 <listitem><para>DESCRIBE</para></listitem>
2826 <listitem><para>DES_KEY_FILE</para></listitem>
2827 <listitem><para>DIRECTORY</para></listitem>
2828 <listitem><para>DISABLE</para></listitem>
2829 <listitem><para>DISCARD</para></listitem>
2830 <listitem><para>DISTINCTROW</para></listitem>
2831 <listitem><para>DIV</para></listitem>
2832 <listitem><para>DO</para></listitem>
2833 <listitem><para>DOUBLE</para></listitem>
2834 <listitem><para>DUAL</para></listitem>
2835 <listitem><para>DUMPFILE</para></listitem>
2836 <listitem><para>DUPLICATE</para></listitem>
2837 <listitem><para>DYNAMIC</para></listitem>
2838 <listitem><para>ENABLE</para></listitem>
2839 <listitem><para>ENCLOSED</para></listitem>
2840 <listitem><para>ENGINE</para></listitem>
2841 <listitem><para>ENGINES</para></listitem>
2842 <listitem><para>ENUM</para></listitem>
2843 <listitem><para>ERRORS</para></listitem>
2844 <listitem><para>ESCAPE</para></listitem>
2845 <listitem><para>ESCAPED</para></listitem>
2846 <listitem><para>EVENTS</para></listitem>
2847 <listitem><para>EXECUTE</para></listitem>
2848 <listitem><para>EXISTS</para></listitem>
2849 <listitem><para>EXPANSION</para></listitem>
2850 <listitem><para>EXTENDED</para></listitem>
2851 <listitem><para>FALSE</para></listitem>
2852 <listitem><para>FAST</para></listitem>
2853 <listitem><para>FIELDS</para></listitem>
2854 <listitem><para>FILE</para></listitem>
2855 <listitem><para>FIRST</para></listitem>
2856 <listitem><para>FIXED</para></listitem>
2857 <listitem><para>FLOAT</para></listitem>
2858 <listitem><para>FLOAT4</para></listitem>
2859 <listitem><para>FLOAT8</para></listitem>
2860 <listitem><para>FLUSH</para></listitem>
2861 <listitem><para>FORCE</para></listitem>
2862 <listitem><para>FULLTEXT</para></listitem>
2863 <listitem><para>FUNCTION</para></listitem>
2864 <listitem><para>GEOMETRY</para></listitem>
2865 <listitem><para>GEOMETRYCOLLECTION</para></listitem>
2866 <listitem><para>GET_FORMAT</para></listitem>
2867 <listitem><para>GLOBAL</para></listitem>
2868 <listitem><para>GRANT</para></listitem>
2869 <listitem><para>GRANTS</para></listitem>
2870 <listitem><para>HANDLER</para></listitem>
2871 <listitem><para>HASH</para></listitem>
2872 <listitem><para>HELP</para></listitem>
2873 <listitem><para>HIGH_PRIORITY</para></listitem>
2874 <listitem><para>HOSTS</para></listitem>
2875 <listitem><para>HOUR</para></listitem>
2876 <listitem><para>HOUR_MICROSECOND</para></listitem>
2877 <listitem><para>HOUR_MINUTE</para></listitem>
2878 <listitem><para>HOUR_SECOND</para></listitem>
2879 <listitem><para>IDENTIFIED</para></listitem>
2880 <listitem><para>IF</para></listitem>
2881 <listitem><para>IMPORT</para></listitem>
2882 <listitem><para>INDEXES</para></listitem>
2883 <listitem><para>INFILE</para></listitem>
2884 <listitem><para>INNOBASE</para></listitem>
2885 <listitem><para>INNODB</para></listitem>
2886 <listitem><para>INSERT_METHOD</para></listitem>
2887 <listitem><para>INT</para></listitem>
2888 <listitem><para>INT1</para></listitem>
2889 <listitem><para>INT2</para></listitem>
2890 <listitem><para>INT3</para></listitem>
2891 <listitem><para>INT4</para></listitem>
2892 <listitem><para>INT8</para></listitem>
2893 <listitem><para>INTERVAL</para></listitem>
2894 <listitem><para>IO_THREAD</para></listitem>
2895 <listitem><para>ISOLATION</para></listitem>
2896 <listitem><para>ISSUER</para></listitem>
2897 <listitem><para>KEYS</para></listitem>
2898 <listitem><para>KILL</para></listitem>
2899 <listitem><para>LAST</para></listitem>
2900 <listitem><para>LEADING</para></listitem>
2901 <listitem><para>LEAVES</para></listitem>
2902 <listitem><para>LEVEL</para></listitem>
2903 <listitem><para>LINES</para></listitem>
2904 <listitem><para>LINESTRING</para></listitem>
2905 <listitem><para>LOAD</para></listitem>
2906 <listitem><para>LOCAL</para></listitem>
2907 <listitem><para>LOCALTIME</para></listitem>
2908 <listitem><para>LOCALTIMESTAMP</para></listitem>
2909 <listitem><para>LOCK</para></listitem>
2910 <listitem><para>LOCKS</para></listitem>
2911 <listitem><para>LOGS</para></listitem>
2912 <listitem><para>LONG</para></listitem>
2913 <listitem><para>LONGBLOB</para></listitem>
2914 <listitem><para>LONGTEXT</para></listitem>
2915 <listitem><para>LOW_PRIORITY</para></listitem>
2916 <listitem><para>MASTER</para></listitem>
2917 <listitem><para>MASTER_CONNECT_RETRY</para></listitem>
2918 <listitem><para>MASTER_HOST</para></listitem>
2919 <listitem><para>MASTER_LOG_FILE</para></listitem>
2920 <listitem><para>MASTER_LOG_POS</para></listitem>
2921 <listitem><para>MASTER_PASSWORD</para></listitem>
2922 <listitem><para>MASTER_PORT</para></listitem>
2923 <listitem><para>MASTER_SERVER_ID</para></listitem>
2924 <listitem><para>MASTER_SSL</para></listitem>
2925 <listitem><para>MASTER_SSL_CA</para></listitem>
2926 <listitem><para>MASTER_SSL_CAPATH</para></listitem>
2927 <listitem><para>MASTER_SSL_CERT</para></listitem>
2928 <listitem><para>MASTER_SSL_CIPHER</para></listitem>
2929 <listitem><para>MASTER_SSL_KEY</para></listitem>
2930 <listitem><para>MASTER_USER</para></listitem>
2931 <listitem><para>MAX_CONNECTIONS_PER_HOUR</para></listitem>
2932 <listitem><para>MAX_QUERIES_PER_HOUR</para></listitem>
2933 <listitem><para>MAX_ROWS</para></listitem>
2934 <listitem><para>MAX_UPDATES_PER_HOUR</para></listitem>
2935 <listitem><para>MEDIUM</para></listitem>
2936 <listitem><para>MEDIUMBLOB</para></listitem>
2937 <listitem><para>MEDIUMINT</para></listitem>
2938 <listitem><para>MEDIUMTEXT</para></listitem>
2939 <listitem><para>MICROSECOND</para></listitem>
2940 <listitem><para>MIDDLEINT</para></listitem>
2941 <listitem><para>MINUTE</para></listitem>
2942 <listitem><para>MINUTE_MICROSECOND</para></listitem>
2943 <listitem><para>MINUTE_SECOND</para></listitem>
2944 <listitem><para>MIN_ROWS</para></listitem>
2945 <listitem><para>MOD</para></listitem>
2946 <listitem><para>MODE</para></listitem>
2947 <listitem><para>MODIFY</para></listitem>
2948 <listitem><para>MONTH</para></listitem>
2949 <listitem><para>MULTILINESTRING</para></listitem>
2950 <listitem><para>MULTIPOINT</para></listitem>
2951 <listitem><para>MULTIPOLYGON</para></listitem>
2952 <listitem><para>NAMES</para></listitem>
2953 <listitem><para>NATIONAL</para></listitem>
2954 <listitem><para>NDB</para></listitem>
2955 <listitem><para>NDBCLUSTER</para></listitem>
2956 <listitem><para>NCHAR</para></listitem>
2957 <listitem><para>NEW</para></listitem>
2958 <listitem><para>NEXT</para></listitem>
2959 <listitem><para>NO</para></listitem>
2960 <listitem><para>NONE</para></listitem>
2961 <listitem><para>NO_WRITE_TO_BINLOG</para></listitem>
2962 <listitem><para>NUMERIC</para></listitem>
2963 <listitem><para>NVARCHAR</para></listitem>
2964 <listitem><para>OLD_PASSWORD</para></listitem>
2965 <listitem><para>ONE_SHOT</para></listitem>
2966 <listitem><para>OPEN</para></listitem>
2967 <listitem><para>OPTIMIZE</para></listitem>
2968 <listitem><para>OPTION</para></listitem>
2969 <listitem><para>OPTIONALLY</para></listitem>
2970 <listitem><para>OUTFILE</para></listitem>
2971 <listitem><para>PACK_KEYS</para></listitem>
2972 <listitem><para>PARTIAL</para></listitem>
2973 <listitem><para>PASSWORD</para></listitem>
2974 <listitem><para>POINT</para></listitem>
2975 <listitem><para>POLYGON</para></listitem>
2976 <listitem><para>PRECISION</para></listitem>
2977 <listitem><para>PREPARE</para></listitem>
2978 <listitem><para>PREV</para></listitem>
2979 <listitem><para>PRIVILEGES</para></listitem>
2980 <listitem><para>PROCEDURE</para></listitem>
2981 <listitem><para>PROCESS</para></listitem>
2982 <listitem><para>PROCESSLIST</para></listitem>
2983 <listitem><para>PURGE</para></listitem>
2984 <listitem><para>QUERY</para></listitem>
2985 <listitem><para>QUICK</para></listitem>
2986 <listitem><para>RAID0</para></listitem>
2987 <listitem><para>RAID_CHUNKS</para></listitem>
2988 <listitem><para>RAID_CHUNKSIZE</para></listitem>
2989 <listitem><para>RAID_TYPE</para></listitem>
2990 <listitem><para>READ</para></listitem>
2991 <listitem><para>REAL</para></listitem>
2992 <listitem><para>REGEXP</para></listitem>
2993 <listitem><para>RELAY_LOG_FILE</para></listitem>
2994 <listitem><para>RELAY_LOG_POS</para></listitem>
2995 <listitem><para>RELAY_THREAD</para></listitem>
2996 <listitem><para>RELOAD</para></listitem>
2997 <listitem><para>RENAME</para></listitem>
2998 <listitem><para>REPAIR</para></listitem>
2999 <listitem><para>REPEATABLE</para></listitem>
3000 <listitem><para>REPLICATION</para></listitem>
3001 <listitem><para>REQUIRE</para></listitem>
3002 <listitem><para>RESET</para></listitem>
3003 <listitem><para>RESTORE</para></listitem>
3004 <listitem><para>RETURNS</para></listitem>
3005 <listitem><para>REVOKE</para></listitem>
3006 <listitem><para>RLIKE</para></listitem>
3007 <listitem><para>ROLLUP</para></listitem>
3008 <listitem><para>ROWS</para></listitem>
3009 <listitem><para>ROW_FORMAT</para></listitem>
3010 <listitem><para>RTREE</para></listitem>
3011 <listitem><para>SAVEPOINT</para></listitem>
3012 <listitem><para>SECOND</para></listitem>
3013 <listitem><para>SECOND_MICROSECOND</para></listitem>
3014 <listitem><para>SEPARATOR</para></listitem>
3015 <listitem><para>SERIAL</para></listitem>
3016 <listitem><para>SERIALIZABLE</para></listitem>
3017 <listitem><para>SESSION</para></listitem>
3018 <listitem><para>SHARE</para></listitem>
3019 <listitem><para>SHOW</para></listitem>
3020 <listitem><para>SHUTDOWN</para></listitem>
3021 <listitem><para>SIGNED</para></listitem>
3022 <listitem><para>SIMPLE</para></listitem>
3023 <listitem><para>SLAVE</para></listitem>
3024 <listitem><para>SMALLINT</para></listitem>
3025 <listitem><para>SOME</para></listitem>
3026 <listitem><para>SONAME</para></listitem>
3027 <listitem><para>SOUNDS</para></listitem>
3028 <listitem><para>SPATIAL</para></listitem>
3029 <listitem><para>SQL_BIG_RESULT</para></listitem>
3030 <listitem><para>SQL_BUFFER_RESULT</para></listitem>
3031 <listitem><para>SQL_CACHE</para></listitem>
3032 <listitem><para>SQL_CALC_FOUND_ROWS</para></listitem>
3033 <listitem><para>SQL_NO_CACHE</para></listitem>
3034 <listitem><para>SQL_SMALL_RESULT</para></listitem>
3035 <listitem><para>SQL_THREAD</para></listitem>
3036 <listitem><para>SSL</para></listitem>
3037 <listitem><para>START</para></listitem>
3038 <listitem><para>STARTING</para></listitem>
3039 <listitem><para>STATUS</para></listitem>
3040 <listitem><para>STOP</para></listitem>
3041 <listitem><para>STORAGE</para></listitem>
3042 <listitem><para>STRAIGHT_JOIN</para></listitem>
3043 <listitem><para>STRING</para></listitem>
3044 <listitem><para>STRIPED</para></listitem>
3045 <listitem><para>SUBJECT</para></listitem>
3046 <listitem><para>SUPER</para></listitem>
3047 <listitem><para>TABLES</para></listitem>
3048 <listitem><para>TABLESPACE</para></listitem>
3049 <listitem><para>TERMINATED</para></listitem>
3050 <listitem><para>TEXT</para></listitem>
3051 <listitem><para>TIME</para></listitem>
3052 <listitem><para>TIMESTAMP</para></listitem>
3053 <listitem><para>TINYBLOB</para></listitem>
3054 <listitem><para>TINYINT</para></listitem>
3055 <listitem><para>TINYTEXT</para></listitem>
3056 <listitem><para>TRAILING</para></listitem>
3057 <listitem><para>TRUE</para></listitem>
3058 <listitem><para>TRUNCATE</para></listitem>
3059 <listitem><para>TYPE</para></listitem>
3060 <listitem><para>TYPES</para></listitem>
3061 <listitem><para>UNCOMMITTED</para></listitem>
3062 <listitem><para>UNICODE</para></listitem>
3063 <listitem><para>UNLOCK</para></listitem>
3064 <listitem><para>UNSIGNED</para></listitem>
3065 <listitem><para>UNTIL</para></listitem>
3066 <listitem><para>USAGE</para></listitem>
3067 <listitem><para>USE</para></listitem>
3068 <listitem><para>USER</para></listitem>
3069 <listitem><para>USER_RESOURCES</para></listitem>
3070 <listitem><para>USE_FRM</para></listitem>
3071 <listitem><para>UTC_DATE</para></listitem>
3072 <listitem><para>UTC_TIME</para></listitem>
3073 <listitem><para>UTC_TIMESTAMP</para></listitem>
3074 <listitem><para>VALUE</para></listitem>
3075 <listitem><para>VARBINARY</para></listitem>
3076 <listitem><para>VARCHAR</para></listitem>
3077 <listitem><para>VARCHARACTER</para></listitem>
3078 <listitem><para>VARIABLES</para></listitem>
3079 <listitem><para>VARYING</para></listitem>
3080 <listitem><para>WARNINGS</para></listitem>
3081 <listitem><para>WITH</para></listitem>
3082 <listitem><para>WORK</para></listitem>
3083 <listitem><para>WRITE</para></listitem>
3084 <listitem><para>X509</para></listitem>
3085 <listitem><para>YEAR</para></listitem>
3086 <listitem><para>YEAR_MONTH</para></listitem>
3087 <listitem><para>ZEROFILL</para></listitem>
3088 </itemizedlist>
3089 </sect1>
3090 <sect1 id="kexi-xbase-driver-reserved-words"><title>Kexi xBase Driver Reserved words</title> 
3091 <para>This list contains keywords that are reserved for use by Kexi xBase Driver:
3092 </para>
3093 <itemizedlist>
3094 <listitem><para>ABORT</para></listitem>
3095 <listitem><para>ATTACH</para></listitem>
3096 <listitem><para>CLUSTER</para></listitem>
3097 <listitem><para>CONFLICT</para></listitem>
3098 <listitem><para>DEFERRED</para></listitem>
3099 <listitem><para>DEFERRABLE</para></listitem>
3100 <listitem><para>DETACH</para></listitem>
3101 <listitem><para>EACH</para></listitem>
3102 <listitem><para>EXCEPT</para></listitem>
3103 <listitem><para>FAIL</para></listitem>
3104 <listitem><para>GLOB</para></listitem>
3105 <listitem><para>IMMEDIATE</para></listitem>
3106 <listitem><para>INITIALLY</para></listitem>
3107 <listitem><para>INSTEAD</para></listitem>
3108 <listitem><para>INTERSECT</para></listitem>
3109 <listitem><para>ISNULL</para></listitem>
3110 <listitem><para>NOTNULL</para></listitem>
3111 <listitem><para>OF</para></listitem>
3112 <listitem><para>PRAGMA</para></listitem>
3113 <listitem><para>RAISE</para></listitem>
3114 <listitem><para>STATEMENT</para></listitem>
3115 <listitem><para>TEMP</para></listitem>
3116 <listitem><para>TRIGGER</para></listitem>
3117 <listitem><para>VACUUM</para></listitem>
3118 <listitem><para>VIEW</para></listitem>
3119 </itemizedlist>
3120 <para><note><para>Reserved words are kept separate for each driver so that they can also be used as reference.</para></note>
3121 </para>
3122 </sect1>
3123 </chapter>
3124 <chapter id="supported-file-formats"><title>Appendix D. Supported File Formats</title> 
3125 <sect1 id="comma-separated-values-format-csv"><title>Comma-separated values format (CSV)</title> 
3126 <para>&kexi; is capable of importing and exporting data from/to a variety of Comma-separated values formats (CSV files). Most spreadsheet and database applications can import and export in this format, making this an appropriate format to migrate textual data between different applications.
3127 </para>
3128 <para>&kexi; also supports a number of options that can be configured before performing import:
3129 </para>
3130 <itemizedlist>
3131 <listitem><para>data type for each column,</para></listitem>
3132 <listitem><para>other field delimiters such as tabs,</para></listitem>
3133 <listitem><para>different text quotes,</para></listitem>
3134 <listitem><para>given number of records can be skipped if needed,</para></listitem>
3135 <listitem><para>duplicated delimiters can be skipped,</para></listitem>
3136 <listitem><para>values from the first row can be used to set column names,</para></listitem>
3137 <listitem><para>text encoding (UTF-8 is the default),</para></listitem>
3138 <listitem><para>date format (defined by the operating system is the default),</para></listitem>
3139 <listitem><para>stripping leading and trailing blanks off of the text values.</para></listitem>
3140 </itemizedlist>
3141 <para>On importing &kexi; shows preview of imported data. Most suitable set of options is auto-detected by &kexi; based on provided CSV file.
3142 </para>
3143 </sect1>
3144 <sect1 id="microsoft-access-mdb-file-format"><title>Microsoft Access (MDB) file format</title> 
3145 <sect2 id="overview"><title>Overview</title> 
3146 <para>Support for importing <guilabel>Microsoft Access</guilabel> databases (2003 or older) is built into &kexi;. <guilabel>Access</guilabel> databases can be <emphasis>imported</emphasis> into a &kexi; database only. It cannot be used to edit the database, nor to export to an <guilabel>Access</guilabel> database. However, it should also be able to import databases created by other applications that use the JET database engine. Importing <filename>.accdb</filename> databases introduced in MS <guilabel>Access</guilabel> 2007 are not currently supported.
3147 </para>
3148 <para>To import a database:
3149 </para>
3150 <orderedlist>
3151 <listitem><para>In &kexi; menu select <guilabel>Import, Export or Send..</guilabel> command.</para></listitem>
3152 <listitem><para>Click <guilabel>Import Database</guilabel> button.</para></listitem>
3153 <listitem><para>Use the import wizard by selecting desired .mdb file.</para></listitem>
3154 </orderedlist>
3155 </sect2>
3156 <sect2 id="capabilities"><title>Capabilities</title> 
3157 <para>The import function has successfully been used to import <emphasis>Northwind</emphasis> database well known to MS <guilabel>Access</guilabel> users. Many other <guilabel>Access</guilabel> template databases can be also imported.
3158 </para>
3159 <para>
3160 <screenshot>
3161 <screeninfo></screeninfo>
3162   <mediaobject>
3163     <imageobject>
3164       <imagedata fileref="kexi_northwind.png" format="PNG"/>
3165     </imageobject>
3166     <textobject>
3167       <phrase></phrase>
3168     </textobject>
3169   </mediaobject>
3170 </screenshot>
3171 </para>
3172 </sect2>
3173 <sect2 id="supported-features"><title>Supported features</title> 
3174 <para>Importing the following field types has been tested, and generally works well:
3175 </para>
3176 <itemizedlist>
3177 <listitem><para>Text fields</para></listitem>
3178 <listitem><para>Memo fields</para></listitem>
3179 <listitem><para>Date fields</para></listitem>
3180 <listitem><para>Numeric values</para></listitem>
3181 </itemizedlist>
3182 </sect2>
3183 <sect2 id="unsupported-features"><title>Unsupported features</title> 
3184 <para>Currently, only tables are imported. During import &kexi; skips the following objects:
3185 </para>
3186 <itemizedlist>
3187 <listitem><para>Queries</para></listitem>
3188 <listitem><para>Forms</para></listitem>
3189 <listitem><para>Scripts</para></listitem>
3190 <listitem><para>Reports</para></listitem>
3191 </itemizedlist>
3192 <para>The following are untested:
3193 </para>
3194 <itemizedlist>
3195 <listitem><para>Importing binary objects</para></listitem>
3196 </itemizedlist>
3197 </sect2>
3198 </sect1>
3199 </chapter>
3200 <chapter id="credits-and-license"><title>Credits and License</title> 
3201 <para>&kexi; Copyright 2002-2012 The Kexi Team
3202 </para>
3203 <para>Kexi Developers:
3204 </para>
3205 <itemizedlist>
3206 <listitem><para>Jaroslaw Staniek (staniek kde.org)</para></listitem>
3207 <listitem><para>OpenOffice Polska, LLC (info openoffice.com.pl)</para></listitem>
3208 <listitem><para>Lucijan Busch (lucijan kde.org)</para></listitem>
3209 <listitem><para>Cedric Pasteur (cedric.pasteur free.fr)</para></listitem>
3210 <listitem><para>Adam Pigg (adam piggz.fsnet.co.uk)</para></listitem>
3211 <listitem><para>Martin Ellis (martin.ellis kdemail.net)</para></listitem>
3212 <listitem><para>Sebastian Sauer (mail dipe.org)</para></listitem>
3213 <listitem><para>Christian Nitschkowski (segfault_ii web.de)</para></listitem>
3214 <listitem><para>Peter Simonsson (psn linux.se)</para></listitem>
3215 <listitem><para>Joseph Wenninger (jowenn kde.org)</para></listitem>
3216 <listitem><para>Seth Kurzenberg (seth cql.com)</para></listitem>
3217 <listitem><para>Laurent Montel (montel kde.org)</para></listitem>
3218 <listitem><para>Till Busch (till bux.at)</para></listitem>
3219 </itemizedlist>
3220 <para>Documentation by Martin A. Ellis (martin.ellis kdemail.net), Jaroslaw Staniek (staniek kde.org) with contributions from Anne-Marie Mahfouf, Raphael Langerhorst, Michal Kubicki and Aron Stansvik.
3221 </para>
3222 <para>This program is licensed under the terms of the <ulink url="http://docs.kde.org/stable/common/lgpl-license.html">GNU Lesser General Public License</ulink>.
3223 </para>
3224 
3225 <!--userbase-content-->
3226 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->  
3227 &underFDL;
3228 </chapter>
3229 &documentation.index;
3230 </book>