<chapter id="guides-2">
<chapterinfo>
<authorgroup>
<author>
<firstname>Mike</firstname>
<surname>McBride</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</chapterinfo>
<title>Detailed Guides: Editing your Document</title>

<para>This section of the guide will cover more advanced features of
data editing.  This section focuses entirely on text data.  For working
with other types of data, please see the section entitled <link linkend="guides-4">More than just text</link>.</para>

<sect1 id="select">
<title>Selecting Text</title>
<indexterm><primary>selecting text</primary></indexterm>
<para>For many editing and formatting functions in &kword;, certain actions (bold face, underline,&etc;) should be
applied to a
certain section of text, not the document as a whole. You specify which
text should be altered by selecting (or highlighting) the text you want changed.</para>

<para>Selected text has a colored background to separate it from
unselected text.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="select1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>Select text by designating a start and an end
point.  All the text in between the start and end point is selected
text.</para>

<para>Text can be selected with either the <link linkend="select-with-mouse">mouse</link> or the <link linkend="select-with-keyboard">keyboard</link>. </para>

<sect2 id="select-with-mouse">
<title>Using The Mouse</title>

<para>To select text with the mouse, place the mouse pointer at the start point.  Click and hold down the
&LMB; and drag the mouse pointer. This
selects all text between the initial click of &LMB; and the
current position of the mouse cursor.  When the mouse pointer is at the desired end point, release the button. 
The start and endpoints will become fixed.</para>

</sect2>

<sect2 id="select-with-keyboard">
<title>Using The Keyboard</title>
<para>To use the keyboard, &kword; takes the initial position of the text cursor as the start point.  
Use the following key combinations to move the endpoint to the desired location.
</para>
<informaltable><tgroup cols="2" align="left">
<thead><row><entry align="center">Key Combination</entry><entry align="left">Function</entry></row></thead>
<tbody>
<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Left Arrow</keycap></keycombo></entry><entry>Moves the endpoint one character to the left.</entry></row>
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Left Arrow</keycap></keycombo></entry><entry>Moves the endpoint one word to the left.</entry></row>
<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Right Arrow</keycap></keycombo></entry><entry>Moves the endpoint one character to the Right.</entry></row>
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Right Arrow</keycap></keycombo></entry><entry>Moves the endpoint one word to the Right.</entry></row>

<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Up Arrow</keycap></keycombo></entry><entry>Selects all characters from the start of the selection, to the character directly up one line.</entry></row>
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Up Arrow</keycap></keycombo></entry><entry>Selects all characters from the start of the selection, to the first character of the line directly above.</entry></row>

<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Down Arrow</keycap></keycombo></entry><entry>Selects all characters from the start of the selection, to the character directly down one line.</entry></row>
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Down Arrow</keycap></keycombo></entry><entry>Selects all characters from the start of the selection, to the last character of the line directly below.</entry></row>

<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Home</keycap></keycombo></entry><entry>Selects all characters from the start of the selection, to the beginning of the line.</entry></row>
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Home</keycap></keycombo></entry><entry>Selects all characters from the start of the selection, to the beginning of the document.</entry></row>

<row><entry align="center"><keycombo action="simul">&Shift;<keycap>End</keycap></keycombo></entry><entry>Selects all characters from the start of the selection, to the end of the line.</entry></row>
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>End</keycap></keycombo></entry><entry>Selects all characters from the start of the selection, to the end of the document.</entry></row>

<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Page-Up</keycap></keycombo></entry><entry>Moves the current endpoint one screen up.</entry></row>
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Page-Up</keycap></keycombo></entry><entry>Moves the current endpoint one page up. The endpoint is located at the first character of this page.</entry></row>


<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Page-Down</keycap></keycombo></entry><entry>Moves the current endpoint down one screen.</entry></row>

<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Page-Down</keycap></keycombo></entry><entry>Moves the current endpoint down one page.  The endpoint is locate at the first character of this page.</entry></row>
<row><entry align="center"><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></entry><entry>Select all text in the current frameset.</entry></row>

</tbody></tgroup></informaltable>
<para>Once the start and endpoints have been defined, all text between the startpoint and endpoint is selected.</para>
</sect2>


</sect1>

<sect1 id="views">
<title>Using Multiple Views</title>
<indexterm><primary>views</primary><secondary>using multiple</secondary></indexterm>
<sect2 id="views-intro">
<title>Introduction</title>
<para>When editing very large documents, there will be times when it is helpful to 
edit two parts of the document.  In a situation such as this, 
&kword; can open additional windows to edit the <emphasis>same</emphasis> document.</para>
<para>These new windows are called <emphasis>Views</emphasis>, since they provide 
a different viewpoint of the the same document.</para>
<para>Views are very important tools when working with large documents.
Set one view to edit one part of the document, and using the other view, freely
move through the document making updates and changes.  These changes are automatically revealed in all views.</para>
</sect2>

<sect2 id="views-new">

<title>Creating a new view</title>
<indexterm><primary>views</primary><secondary>create new view</secondary></indexterm>
<para>Creating a new view creates an entirely new window, with toolbars, menubars etc.
Compare this with the <link linkend="views-split">Split View</link> command.</para>

<para>To create a new view select <menuchoice><guimenu>View</guimenu><guimenuitem>New View</guimenuitem>
</menuchoice> from the menubar. </para>

<para>A new window will be created.  Alterations to your document can be made in either view.
Updates in one window will be immediately visible in the other.</para>

</sect2>

<sect2 id="views-split">
<title>Splitting the current view into two separate views. </title>
<indexterm><primary>views</primary><secondary>split current view</secondary></indexterm>
<para>It is also possible to split one view into two views.  Both views are contained within one window, and
use the same toolbars, menubars, etc.  Contrast this to the effect of the <link linkend="views-new">New View</link> command.</para>

<para>To split the current view, select
<menuchoice><guimenu>View</guimenu><guimenuitem>Split View</guimenuitem></menuchoice> from the menubar. </para>

<para>The current document area will be split into two views. Alterations to your document can be made in either view.
Updates in one view will be immediately visible in the other.</para>

<tip><para>The views can either be split horizontally or vertically.  See the next section for instructions.</para></tip>
</sect2>

<sect2 id="views-split-orientation">

<title>Changing the split view orientation </title>
<indexterm><primary>views</primary><secondary>change split view orientation</secondary></indexterm>
<para>To change the direction that the views are split, simply select
<menuchoice><guimenu>View</guimenu><guisubmenu>Splitter Orientation</guisubmenu></menuchoice> from the menubar.
This will show a submenu.  Select either <guilabel>Horizontal</guilabel> or <guilabel>Vertical</guilabel>.</para>

<para>All views in the current window will immediately change to the new orientation.</para>
</sect2>

<sect2 id="views-adjust-size">

<title>Changing the size of views </title>
<indexterm><primary>views</primary><secondary>resizing</secondary></indexterm>
<para>The relative sizes of each view can be adjusted with your mouse.</para>
<para>To adjust the view size, look at the border between the scrollbar of one view
(the upper or right view) and the ruler of the other view (the lower or left view).  There is a
solid border which appears raised between the scrollbar and the ruler. As the mouse pointer passes
over this bar, it changes from an arrow to double lines with double arrows.</para>

<para><mediaobject><imageobject><imagedata format="PNG"
fileref="viewsize.png"/></imageobject>
<textobject><phrase>Screen shot</phrase></textobject></mediaobject></para>

<para>When the mouse pointer changes, click once with the &LMB; and hold the button
down.  Drag that border to the new location.  When the mouse button is released, the
views will change to the new proportions.</para>

</sect2>

<sect2 id="views-remove">

<title>Remove View </title>
<indexterm><primary>views</primary><secondary>removing</secondary></indexterm>
<para>To remove a view, simply place the mouse pointer in the view to be deleted and click with the &LMB;.
Then select <menuchoice><guimenu>View</guimenu><guimenuitem>Remove View</guimenuitem></menuchoice>
from the menubar.</para>
</sect2>

<sect2 id="views-close">

<title>Close all views </title><para>To close all views,  select
<indexterm><primary>views</primary><secondary>closing all views</secondary></indexterm>
<menuchoice><guimenu>View</guimenu><guimenuitem>Close All Views</guimenuitem></menuchoice>
from the menubar.</para>
</sect2>
</sect1>

<sect1 id="undo-redo">
<title>Undo/Redo</title>
<indexterm><primary>undoing last edit</primary></indexterm>
<indexterm><primary>redoing previously undone edit</primary></indexterm>
<para>It happens all the time.  While working on a document, a change is made.
The change was wrong, now you want to back out of your changes.</para>

<para>Fortunately, &kword; has a solution.</para>

<para>Each time a change is made to a document, &kword; remembers what
the change was.  &kword; can
<emphasis>Undo</emphasis> each change once a time. </para>

<para>As an example, you are writing a business letter and type in the following sentence:</para>

<informalexample><para>It is a pleasure for me to give you this letter of introduction to your newest employee.</para></informalexample>

<para>But that doesn't seem right, so you change it:</para>

<informalexample><para>It is a joy for me to give you this letter of introduction to your newest employee.</para></informalexample>

<para>You decide it was better the first time and you want to change it back.</para>

<para>Simply select
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem></menuchoice> from
the menubar.</para>

<para>The text now reads <quote>pleasure</quote> again.</para>

<informalexample><para>It is a pleasure for me to give you this letter of introduction to your newest employee.</para></informalexample>

<para>If, after you Undo a change, and then want to reverse that decision,
select
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice> and
the Undo is reversed.</para>

<note>
<para>Sometimes it is not possible for &kword; to undo an edit.  In these instances, &kword; 
will display the <guimenuitem>Undo</guimenuitem> function gray and the function is not
accessible.</para>

<para>Othertimes, &kword; will only perform a partial undo of the previous task.
This is because &kword; processes changes to documents differently then might
initially be expected.  Simply select
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem></menuchoice>
again, and more of the edits will be undone.</para>
</note>
<para>By default, &kword; keeps track of the last 30 edits to the document.
This number can be adjusted up or down.  For details, see <link linkend="opt-misc">Configuring &kword;</link>.</para>
<para>The <emphasis>Undo</emphasis> and <emphasis>Redo</emphasis> commands can
be accessed from the menubar (as in the examples above), by using keyboard shortcuts or from the toolbar.</para>

<informaltable><tgroup cols="3">
<thead>
<row><entry>Command</entry><entry>Toolbar Button</entry><entry>Keyboard Shortcut</entry></row>
</thead><tbody>
<row><entry>Undo</entry><entry><inlinemediaobject><imageobject><imagedata fileref="undo.png" format="PNG"/>
</imageobject></inlinemediaobject></entry><entry><keycombo
action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry></row>
<row><entry>Redo</entry><entry><inlinemediaobject><imageobject><imagedata fileref="redo.png" format="PNG"/>
</imageobject></inlinemediaobject></entry><entry><keycombo
action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></entry></row>
</tbody>
</tgroup>
</informaltable>
</sect1>

<sect1 id="clipboard">

<title>Cut/Copy/Paste and the Clipboard</title>
<indexterm><primary>clipboard</primary><secondary>using</secondary></indexterm>

<para>The <quote>clipboard</quote> is a concept familiar to most people
who have used modern word processors. It is a piece of your computers
memory which is set aside as a temporary storage space.  Text can be
<quote>Cut</quote> or <quote>Copied</quote> from your document into
the clipboard.  You can move to another part of the document or to
another application entirely, and <quote>Paste</quote> this text at the new
location. </para>

<para>The most common use for the clipboard is to move or copy text
which has already entered into one part of the document to another
part of the same document or to another document entirely.</para>

<para>This concept is probably best described with an example.</para>

<para>To do this, we begin with a test sentence</para>

<informalexample><para>The big, red fox jumped over the lazy dog.</para></informalexample>

<para>Using the mouse or keyboard, select the phrase 
<quote> big, red</quote> (notice the space before <quote>big</quote> is selected).</para>

<para>Now select <menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice> from
the menubar.</para>

<para><emphasis>This has moved a copy of the selected text to the
clipboard.</emphasis></para>

<para>Now place the mouse cursor directly behind the word 
<quote>lazy</quote> and click once.</para>

<para>Now select <menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice>
from the menubar.</para>

<para>The resulting sentence is: </para>

<informalexample><para>The big, red fox jumped over the lazy big, red dog</para></informalexample>

<para>The clipboard is not limited to text.
The clipboard can contain tables, pictures, spreadsheets or any other type of information.</para>
<sect2 id="local-copy">

<title>The <guimenuitem>Copy</guimenuitem> Command</title>
<indexterm><primary>clipboard</primary><secondary>copying text to</secondary></indexterm>
<para>The <guimenuitem>Copy</guimenuitem> command can be invoked 4 ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice> from
the menubar</para>
</listitem>

<listitem>
<para>By clicking <inlinemediaobject><imageobject><imagedata
fileref="editcopy.png" format="PNG"/></imageobject></inlinemediaobject>
on the toolbar.</para>
</listitem>

<listitem>
<para>Using the keyboard shortcut: <keycombo
action="simul">&Ctrl;<keycap>C</keycap></keycombo> or the alternate keyboard shortcut: 
<keycombo
action="simul">&Ctrl;<keycap>Insert</keycap></keycombo></para>
</listitem>

<listitem>
<para>After the text is selected, click once with the &RMB; and hold the button down. 
A small popup menu will appear.  Simply select <guilabel>Copy</guilabel></para>
</listitem>

</itemizedlist>

<para>The <guimenuitem>Copy</guimenuitem> command moves a copy of the selected data
to the clipboard.  <emphasis>The original data is
unaffected.</emphasis></para>

</sect2>

<sect2 id="local-cut">
<title>The <guimenuitem>Cut</guimenuitem> Command</title>
<indexterm><primary>clipboard</primary><secondary>moving text to</secondary></indexterm>
<para>The <guimenuitem>Cut</guimenuitem> command can be invoked 4 ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem></menuchoice> from
the menubar</para>
</listitem>

<listitem>
<para>By clicking <inlinemediaobject><imageobject><imagedata
fileref="editcut.png" format="PNG"/></imageobject></inlinemediaobject>
on the toolbar.</para>
</listitem>

<listitem>
<para>Using the keyboard shortcut: <keycombo
action="simul">&Ctrl;<keycap>X</keycap></keycombo> or the alternate keyboard shortcut: 
<keycombo
action="simul">&Shift;<keycap>Delete</keycap></keycombo></para>
</listitem>
<listitem>
<para>After the text is selected, click once with the &RMB; and hold the button down. 
A small popup menu will appear.  Simply select <guilabel>Cut</guilabel></para>
</listitem></itemizedlist>

<para>The <guimenuitem>Cut</guimenuitem> command moves a copy of the selected data
to the clipboard.  <emphasis>The selected data is then deleted from the
document.</emphasis></para>

</sect2>

<sect2 id="local-paste">
<title>The <guimenuitem>Paste</guimenuitem> Command</title>
<indexterm><primary>clipboard</primary><secondary>moving text from</secondary></indexterm>
<para>The <guimenuitem>Paste</guimenuitem> command can be invoked 4 ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice>
from the menubar</para>
</listitem>

<listitem>
<para>By clicking <inlinemediaobject><imageobject><imagedata
fileref="editpaste.png" format="PNG"/></imageobject></inlinemediaobject>
on the toolbar.</para>
</listitem>

<listitem>
<para>Using the keyboard shortcut: <keycombo
action="simul">&Ctrl;<keycap>V</keycap></keycombo> or the alternate keyboard shortcut: 
<keycombo
action="simul">&Shift;<keycap>Insert</keycap></keycombo></para>
</listitem>

<listitem>
<para>Place the cursor where the contents of the clipboard
should be inserted. Click once with the &RMB; and hold the button down. A small
popup menu will appear.  Simply select <guilabel>Paste</guilabel></para>
</listitem>

</itemizedlist>

<para>The <guimenuitem>Paste</guimenuitem> command inserts a copy of all the data in
the clipboard at the current position of the cursor.  The clipboard is
unaffected. (So another paste command will produce yet another copy of
the data in the document.)</para>

<note>
<para>If no text in the document is currently highlighted, the
<guimenuitem>Paste</guimenuitem> command <emphasis>inserts</emphasis>
the data at the current position of the cursor.</para>

<para>If there is selected text when the
<guimenuitem>Paste</guimenuitem> command is executed, the selected text
is <emphasis>replaced</emphasis> with the contents of the
clipboard.</para> 
</note>

<tip><para>The clipboard is not limited to the bounds of the current document.  If
text is copied (or cut) from a document, this text can be pasted
into another open document, or another application entirely.</para></tip>

</sect2>
</sect1>

<sect1 id="search-and-replace">
<title>Finding and Replacing Text</title>

<sect2 id="find">
<title>The <guimenuitem>Find</guimenuitem> Command</title>
<indexterm><primary>searching for text</primary></indexterm>
<indexterm><primary>finding text in a document</primary></indexterm>

<para>The <quote>Find</quote> command can be invoked 3 ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice>
from the menubar</para>
</listitem>

<listitem>
<para>You can use the keyboard shortcut:<keycombo
action="simul">&Ctrl;<keycap>F</keycap></keycombo></para>
</listitem>

<listitem>
<para>By clicking <inlinemediaobject><imageobject><imagedata
fileref="find.png" format="PNG"/></imageobject></inlinemediaobject> on
the toolbar.</para>
</listitem>
</itemizedlist>

<para>When the Find Command is invoked, a dialog appears.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="finddlg.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<sect3><title>Basic Text Search</title>
<para>The combo box labelled <guilabel>Text to find</guilabel>,
provides a place for you to enter the text of your search command. (In
the screenshot, that box is currently filled with
<emphasis>KDE</emphasis>).</para> 

<para>If you click on
<guibutton>Find</guibutton>, then &kword; will search the document until it
finds a match to your text.  If &kword; cannot find a match, a dialog
box will appear that says <guilabel>No matches found for "Text to find"</guilabel>.  </para>
<tip><para>If you want to repeat a recent search, simply select the arrow in the drop-down
box and a list of your most recent searches will appear.  Simply select your search
from the list and click <guibutton>Find</guibutton>.</para></tip>

</sect3>
<sect3>
<title>Refining Your Search</title>

<para>&kword;'s find feature is much more sophisticated than we
discussed above.  Using the options in the dialog box, you can narrow
down your search to find <emphasis>exactly</emphasis> what you
want.</para>

<sect4>
<title>Regular Expressions in &kword;</title>

<para>The default action for &kword; is to search for an exact match of
the text.  &kword; has the ability to match text
that follows a <emphasis>pattern</emphasis> or a set of rules.  </para>

<para>To enable patterns, place a mark in the box labeled <guilabel>Regular expression</guilabel>.</para>

<para>This will enable the <guibutton>Edit</guibutton> button.
This button can be a quick way to create regular expressions for people unfamiliar
with &UNIX; regular expressions.</para>

<para>A more thourough discussion of regular expressions in KDE can be found in the help manual for &kregexpeditor;, which can be found in the &khelpcenter;.</para>

</sect4>

<sect4 id="find-formatting"><title>Formatting options</title>
<para>&kword; also has the ability to search your document for text that matches
certain formatting options as well as the text itself.</para>

<para>To include formatting options in your search, click the button labeled
<guibutton>Show Formatting Options</guibutton>. </para>

<para>Once <guibutton>Show Formatting Options</guibutton> has been clicked,  a new dialog will appear.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="finddlg2.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>You can use this dialog to select the options you want to include in your search.</para>
<para>The left column consists of 13 check boxes.  If there is a mark in the check box, then &kword; will evaluate
any searchable text for that property.  If no mark is in the check box, &kword; does not consider that property when performing a search.</para>

<variablelist>

<varlistentry>
<term><guilabel>Family:</guilabel></term>
<listitem>
<para>Use this combo box to select the font family you want to include in your search text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Size:</guilabel></term>
<listitem>
<para>Use this spin box to set the font size you want &kword; to search for.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Color:</guilabel> and <guilabel>Background color:</guilabel></term>
<listitem>
<para>Clicking on either of these two buttons allows you to select the font color and/or background color respectively,
you want &kword; to search
for.  For more information on selecting a color, see the
section on <link linkend="select-colors">Selecting Colors from the Color Dialog</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Bold:</guilabel> and <guilabel>Italic:</guilabel></term>
<listitem>
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
to include boldface or italicized fonts in the search text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Strikeout:</guilabel></term>
<listitem>
<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel> 
or <guilabel>Simple Bold</guilabel> to modify your search.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Underline:</guilabel></term>
<listitem>
<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple Bold</guilabel> 
or <guilabel>Wave</guilabel> to modify your search.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Vertical alignment:</guilabel></term>
<listitem>
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Subscript</guilabel> or
<guilabel>Superscript</guilabel> to determine what font alignment you want &kword; to search for.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Shadow:</guilabel> and <guilabel>Word by word:</guilabel></term>
<listitem>
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
to include shadow text in the search text and whether to search for word by word underlining and strikethrough text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Capitalization:</guilabel></term>
<listitem>
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>,  or
<guilabel>Small Caps</guilabel> to determine what capitalization you want &kword; to search for.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Language:</guilabel></term>
<listitem>
<para>You can select the language of the text you want &kword; to search for using this dropdown box.</para>
</listitem>
</varlistentry></variablelist>

<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your search options.</para>
<para>Click <guibutton>Cancel</guibutton> to ignore all changes.</para>
<para>Click <guibutton>Reset</guibutton> to restore the options dialog box to the default values.</para>
<para>Click <guibutton>Clear</guibutton> to remove all marks from the checked options.</para>

</sect4>

<sect4>
<title>Other Search options</title>

<para>In addition to pattern matching, you can limit the search results
with a few useful options.</para>

<variablelist>
<varlistentry>
<term><guilabel>Case sensitive</guilabel></term>
<listitem>
<para>When this option is selected, &kword; will not only search for the
string of letters, but will verify that the case of the letters is the
same.  For example.  Searching for:
<emphasis>KDE</emphasis></para><para>will match:
<emphasis>KDE</emphasis> and
<emphasis>hiddenKDEinwords</emphasis> </para><para>but not: <emphasis>Kde,
kde</emphasis> or <emphasis> hiddenkdeinwords</emphasis>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Find backwards</guilabel></term>
<listitem>
<para>This option changes the direction of the search.  This can be
useful when you only want to search for a string of text before the
current cursor position, not after.  This option is usually used in
conjunction with <guilabel>From cursor</guilabel>, but if that option is
not specified, &kword; will start searching from the end of the document
backwards.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Whole words only</guilabel></term>
<listitem>
<para>When this option is selected, &kword; will only return search
items that are surrounded by spaces, paragraph marks or punctuation. For
example.  Searching for:  <emphasis>KDE</emphasis></para><para>will
match: <emphasis>KDE</emphasis></para><para> but not: <emphasis>
hiddenKDEinwords</emphasis> or <emphasis>KDElike</emphasis>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Selected Text</guilabel></term>
<listitem><para>If you want to limit your search to a specific part of
the document (a few paragraphs, for example), you can select the part of
the document you want to search <emphasis>prior</emphasis> to selecting
the <guilabel>Find</guilabel> command.  When text is selected, &kword;
will default to only searching the selected text.  You can use this
option to enable or disable this restriction.</para>
<note>
<para>This option will not be available if you have not selected text
prior to selecting the <guilabel>Find</guilabel> command.</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>From cursor</guilabel></term>
<listitem>
<para>By default, &kword; begins searching at the beginning of the
document.  If this option is selected, &kword; begins its search from
the current position of the cursor. The direction that &kword; searches
is, by default forward in the document, but can be changed with the
<guilabel>Find backwards</guilabel> option.</para>
</listitem>
</varlistentry>
</variablelist>
</sect4>
</sect3>
</sect2>

<sect2 id="replace">
<title>The <guimenuitem>Replace</guimenuitem> Command</title>

<para>The <guimenuitem>Replace</guimenuitem> command is an extension of the <guimenuitem>Find</guimenuitem> command. If you
are familiar with the <guimenuitem>Find</guimenuitem> command, you will see many
similarities.</para>

<para>The <guilabel>Replace</guilabel> command can be invoked 2
ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Replace...</guimenuitem></menuchoice>
from the menubar</para>
</listitem>

<listitem>
<para>You can use the keyboard shortcut: <keycombo
action="simul">&Ctrl;<keycap>R</keycap></keycombo></para>
</listitem>
</itemizedlist>

<para>When the <guilabel>Replace</guilabel> command is invoked, a dialog
appears.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="repldlg.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<sect3><title>Basic Search and Replace</title>
<indexterm><primary>replacing text</primary></indexterm>

<para>The combo box labeled <guilabel>Text to find:</guilabel>,
provides a place for you to enter the text of your search command. (In
the screenshot, that box is currently filled with
<emphasis>KDE</emphasis>)</para>

<para>You can enter your replacement text in the text box labeled
<guilabel>Replacement text:</guilabel>. You can now click
<guibutton>OK</guibutton> to replace all occurrences in the document, or
you can further refine your search.</para>

</sect3>

<sect3>
<title>Refining Your Search</title>

<para>&kword;'s find feature is much more sophisticated than we
discussed above.  Using the options in the dialog box, you can narrow
down your search to find <emphasis>exactly</emphasis> what you
want.</para>

<sect4>
<title>Regular Expressions in &kword;</title>

<para>The default action for &kword; is to search for an exact match of
the text.  &kword; has the ability to match text
that follows a <emphasis>pattern</emphasis> or a set of rules.  </para>

<para>To enable patterns, place a mark in the box labeled <guilabel>Regular expression</guilabel>.</para>

<para>This will enable the <guibutton>Edit</guibutton> button.
This button can be a quick way to create regular expressions for people unfamiliar
with &UNIX; regular expressions.</para>

<para>A more thourough discussion of regular expressions in KDE can be found in the help manual for &kregexpeditor;, which can be found in the &khelpcenter;.</para>

</sect4>

<sect4><title>Formatting options</title>
<para>&kword; also has the ability to search your document for text that matches
certain formatting options as well as the text itself.</para>

<para>To include formatting options in your search, click the button labeled
<guibutton>Show Formatting Options</guibutton>. </para>

<para>Once <guibutton>Show Formatting Options</guibutton> has been clicked,  a new dialog will appear.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="finddlg2.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>You can use this dialog to select the options you want to include in your search.</para>
<para>The left column consists of 13 check boxes.  If there is a mark in the check box, then &kword; will evaluate
any searchable text for that property.  If no mark is in the check box, &kword; does not consider that property when performing a search.</para>

<variablelist>

<varlistentry>
<term><guilabel>Family:</guilabel></term>
<listitem>
<para>Use this combo box to select the font family you want to include in your search text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Size:</guilabel></term>
<listitem>
<para>Use this spin box to set the font size you want &kword; to search for.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Color:</guilabel> and <guilabel>Background color:</guilabel></term>
<listitem>
<para>Clicking on either of these two buttons allows you to select the font color and/or background color respectively,
you want &kword; to search
for.  For more information on selecting a color, see the
section on <link linkend="select-colors">Selecting Colors from the Color Dialog</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Bold:</guilabel> and <guilabel>Italic:</guilabel></term>
<listitem>
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
to include boldface or italicized fonts in the search text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Strikeout:</guilabel></term>
<listitem>
<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel> 
or <guilabel>Simple Bold</guilabel> to modify your search.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Underline:</guilabel></term>
<listitem>
<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, 
<guilabel>Simple Bold</guilabel> or <guilabel>Wave</guilabel> to modify your search.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Vertical alignment:</guilabel></term>
<listitem>
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Subscript</guilabel> or
<guilabel>Superscript</guilabel> to determine what font alignment you want &kword; to search for.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Shadow:</guilabel> and <guilabel>Word by word:</guilabel></term>
<listitem>
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
to include shadow text in the search text and whether to search for word by word underlining and strikethrough text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Capitalization:</guilabel></term>
<listitem>
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>,  or
<guilabel>Small Caps</guilabel> to determine what capitalization you want &kword; to search for.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Language:</guilabel></term>
<listitem>
<para>You can select the language of the text you want &kword; to search for using this dropdown box.</para>
</listitem>
</varlistentry></variablelist>

<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your search options.</para>
<para>Click <guibutton>Cancel</guibutton> to ignore all changes.</para>
<para>Click <guibutton>Reset</guibutton> to restore the options dialog box to the default values.</para>
<para>Click <guibutton>Clear</guibutton> to remove all marks from the checked options.</para>

</sect4>

<sect4>
<title>Other Search options</title>

<para>In addition to pattern matching, you can limit the search results
with a few useful options.</para>

<variablelist>
<varlistentry>
<term><guilabel>Case sensitive</guilabel></term>
<listitem>
<para>When this option is selected, &kword; will not only search for the
string of letters, but will verify that the case of the letters is the
same.  For example.  Searching for:
<emphasis>KDE</emphasis></para><para>will match:
<emphasis>KDE</emphasis> and
<emphasis>hiddenKDEinwords</emphasis> </para><para>but not: <emphasis>Kde,
kde</emphasis> or <emphasis> hiddenkdeinwords</emphasis>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Find backwards</guilabel></term>
<listitem>
<para>This option changes the direction of the search.  This can be
useful when you only want to search for a string of text before the
current cursor position, not after.  This option is usually used in
conjunction with <guilabel>From cursor</guilabel>, but if that option is
not specified, &kword; will start searching from the end of the document
backwards.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Whole words only</guilabel></term>
<listitem>
<para>When this option is selected, &kword; will only return search
items that are surrounded by spaces, paragraph marks or punctuation. For
example.  Searching for:  <emphasis>KDE</emphasis></para><para>will
match: <emphasis>KDE</emphasis></para><para> but not: <emphasis>
hiddenKDEinwords</emphasis> or <emphasis>KDElike</emphasis>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Selected Text</guilabel></term>
<listitem><para>If you want to limit your search to a specific part of
the document (a few paragraphs, for example), you can select the part of
the document you want to search <emphasis>prior</emphasis> to selecting
the <guilabel>Find</guilabel> command.  When text is selected, &kword;
will default to only searching the selected text.  You can use this
option to enable or disable this restriction.</para>
<note>
<para>This option will not be available if you have not selected text
prior to selecting the <guilabel>Find</guilabel> command.</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>From cursor</guilabel></term>
<listitem>
<para>By default, &kword; begins searching at the beginning of the
document.  If this option is selected, &kword; begins its search from
the current position of the cursor. The direction that &kword; searches
is, by default forward in the document, but can be changed with the
<guilabel>Find backwards</guilabel> option.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your search options.</para>
<para>Click <guibutton>Cancel</guibutton> to ignore all changes.</para>
<para>Click <guibutton>Reset</guibutton> to restore the options dialog box to the default values.</para>
<para>Click <guibutton>Clear</guibutton> to remove all marks from the checked options.</para>

</sect4>

<sect4 id="replace-formatting-text"><title>Replace with formatted text</title>
<para>&kword; also has the ability to replace the found text with formatted text.</para>

<para>To include formatting options in your search, click the button labeled
<guibutton>Show Formatting Options</guibutton> in the <guilabel>Replace With</guilabel> section. </para>

<para>Once <guibutton>Show Formatting Options</guibutton> has been clicked,  a new dialog will appear.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="finddlg2.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>You can use this dialog to select the format of the replaced text.</para>
<para>The left column consists of 13 check boxes.  If there is a mark in the check box, then &kword; will change
any replaced text to match the property selected.  
If no mark is in the check box, &kword; does not consider that property when replacing text.</para>

<variablelist>

<varlistentry>
<term><guilabel>Family:</guilabel></term>
<listitem>
<para>Use this combo box to select the font family you want your replacement text to use.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Size:</guilabel></term>
<listitem>
<para>Use this spin box to set the font size you want &kword; to use for your replaced text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Color:</guilabel> and <guilabel>Background color:</guilabel></term>
<listitem>
<para>Clicking on either of these two buttons allows you to select the font color and/or background color respectively,
you want &kword; to use.  For more information on selecting a color, see the
section on <link linkend="select-colors">Selecting Colors from the Color Dialog</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Bold:</guilabel> and <guilabel>Italic:</guilabel></term>
<listitem>
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
to change the fonts to boldface or italicized fonts.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Strikeout:</guilabel></term>
<listitem>
<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel> 
or <guilabel>Simple Bold</guilabel> to use for the replacement text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Underline:</guilabel></term>
<listitem>
<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, 
<guilabel>Simple Bold</guilabel> or <guilabel>Wave</guilabel> to use for the replacement text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Vertical alignment:</guilabel></term>
<listitem>
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Subscript</guilabel> or
<guilabel>Superscript</guilabel> to determine what font alignment you want &kword; to use.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Shadow:</guilabel> and <guilabel>Word by word:</guilabel></term>
<listitem>
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
to use shadow text and/or word by word underlining and strikethrough in the replacement text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Capitalization:</guilabel></term>
<listitem>
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>,  or
<guilabel>Small Caps</guilabel> to determine what capitalization to use for the replacement text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Language:</guilabel></term>
<listitem>
<para>You can select the language of the text you will use to replace the found text.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your text options.</para>
<para>Click <guibutton>Cancel</guibutton> to ignore all changes.</para>
<para>Click <guibutton>Reset</guibutton> to restore the options dialog box to the initial values prior to making any changes.</para>
<para>Click <guibutton>Clear</guibutton> to remove all marks from the checked options.</para>

</sect4>
<sect4 id="replace-placeholders">
<title>Using placeholders</title>
<para>Placeholders are useful when you want to add text to complex search strings.  Currently &kword; has only one placeholder:  
<emphasis>Complete text string</emphasis>.</para>
<para>This placeholder will contain the entire text string matched by the <guimenuitem>Find</guimenuitem> command.</para>
<para>For example:</para>
<para>You create a search string, using regular expressions:  <emphasis>Reference \d</emphasis></para>
<note><para>In order for this string example to work, a mark must be placed in the check box labeled 
<guilabel>Regular expression</guilabel></para>
<para>Regular expressions are available by placing a mark in this checkbox. The use of regular expressions is beyond the 
scope of this manual.  For more information see the KDE Regular Expression Manual (Available in the &kde; help center).</para></note>
<para>Now in the <guilabel>Replace With</guilabel> section of the replace dialog, you place a mark in the check box labeled
<guilabel>Use placeholders</guilabel>.  Click the <guibutton>Insert Placeholder</guibutton> button and select
<guilabel>Complete Match</guilabel>.  &kword; will insert a <emphasis>\0</emphasis> in the 
<guilabel>Replacement text:</guilabel> text box.</para>
<para>Now surround the placeholder with parentheses, so your text string is:  <emphasis>(\0)</emphasis></para>
<para>When this is executed, whenever &kword; encounters the find text (ie. <quote>Reference 0</quote>, <quote>Reference 1</quote>,
<quote>Reference 2</quote>, etc) it will surround the text in parenthesis (<quote>(Reference 0)</quote>, <quote>(Reference 1)</quote>,
<quote>(Reference 2)</quote>, respectively). </para>
<para>As you can see, the placeholder will maintain a copy of the search text.  You can use this placeholder to add text to the ends of any
search string you can imagine.</para>

</sect4>
<sect4>
<title>Other Replace Options</title>

<para>Additional options in the dialog are:</para>
<variablelist>
<varlistentry>
<term><guilabel>Case sensitive</guilabel></term>
<listitem>
<para>When this option is selected, &kword; will not only
search for the string of letters, but will verify that the case of the
letters is the same.  For example.  Searching for:
<emphasis>KDE</emphasis></para><para>will match:
<emphasis>KDE</emphasis> and <emphasis>hiddenKDEinwords</emphasis> but
not: <emphasis>Kde, kde</emphasis> or <emphasis>
hiddenkdeinwords</emphasis>.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Find backwards</guilabel></term>
<listitem>
<para>This option changes the direction of the search.  This can be
useful when you only want to search for a string of text before the
current cursor position, not after.  This option is usually used in
conjunction with <guilabel>From cursor</guilabel>, but if that option is
not specified, &kword; will start searching from the end of the document
backwards.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Whole words only</guilabel></term>
<listitem>
<para>When this option is selected, &kword; will only return search
items that are surrounded by spaces, paragraph marks or punctuation. For
example.  Searching for:  <emphasis>KDE</emphasis></para><para>will
match: <emphasis>KDE</emphasis></para><para> but not: <emphasis>
hiddenKDEinwords</emphasis> or <emphasis>KDElike</emphasis>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Selected Text</guilabel></term>
<listitem><para>If you want to limit your search to a specific part of
the document (a few paragraphs, for example), you can select the part of
the document you want to search <emphasis>prior</emphasis> to selecting
the <guilabel>Find</guilabel> command.  When text is selected, &kword;
will default to only searching the selected text.  You can use this
option to enable or disable this restriction.</para>

<note>
<para>This option will not be available if you have not selected text
prior to selecting the <guilabel>Find</guilabel> command.</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>From cursor</guilabel></term>
<listitem>
<para>By default, &kword; begins searching at the beginning of the
document.  If this option is selected, &kword; begins its search from
the current position of the cursor. The direction that &kword; searches
is, by default forward in the document, but can be changed with the
<guilabel>Find backwards</guilabel> option.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Prompt on replace</guilabel></term>
<listitem>
<para>If this option is selected, &kword; will prompt the user 
<emphasis>before</emphasis> each replacement.  This allows you to 
approve or disapprove each replacement. </para>
</listitem>
</varlistentry>

</variablelist>

</sect4>
</sect3>
</sect2>


</sect1>

<sect1 id="spell-check">
<title>Spellchecking</title>
<indexterm><primary>spelling</primary><secondary>check spelling of document</secondary></indexterm>
<para>&kword; can compare each word in your document to several commonly available dictionaries.  It will offer you 
the opportunity to change any words it believes are misspelled.</para>
<note><para>By default, if any text in the document is selected, 
&kword; only checks the spelling of currently selected text.</para>  
<para>If you want to check the spelling of a 
specific part of your document, simply <link linkend="select">select the text</link> you want to check the 
spelling of.</para>
<para>To check the entire document, leave all text in the document unsellected, and &kword; will check 
the entire document.</para></note>
<para>You can check the spelling of text 2 ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice>
<guimenu>Tools</guimenu><guisubmenu>Spellcheck</guisubmenu><guimenuitem>Spelling...</guimenuitem></menuchoice>
from the menubar</para>
</listitem>

<listitem>
<para>By clicking <inlinemediaobject><imageobject><imagedata
fileref="spell.png" format="PNG"/></imageobject></inlinemediaobject> on
the toolbar.</para>
</listitem>
</itemizedlist>

<para>Spellchecking your document is controlled through a dialog
box.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="spelldlg.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>In this example, the misspelled word &kword; found, was
<emphasis>youve</emphasis>.  The currently suggested replacement word is listed in the text box labeled
<guilabel>Replace with:</guilabel>.  In the list box labeled <guilabel>Suggested Words</guilabel> is a list of words
the spelling program has determined as possible correct spellings.</para>

<para>From here you have eight options:</para>

<variablelist>
<varlistentry>
<term><guibutton>Replace</guibutton></term>
<listitem>
<para>Replaces the current word with the suggested word.  Only replaces this
occurrence.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Replace All</guibutton></term>
<listitem>
<para>Replaces all occurrences of the current word with the
suggested word through the entire document.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Ignore</guibutton></term>
<listitem>
<para>Do not make any changes to this occurrence.  Ask again if this
word appears further down in the document.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Ignore All</guibutton></term>
<listitem>
<para>Do not make any changes to this or any other occurrence of this word.  Do not
ask about this word again.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Add</guibutton></term>
<listitem>
<para>Add the current word to the dictionary.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Stop</guibutton></term>
<listitem>
<para>Keep the current changes, but stop any further checking.</para>
</listitem>
</varlistentry>
<!-- FIXME lueck 08.11.2006 -->
<varlistentry>
<term><guibutton>Cancel</guibutton></term>
<listitem>
<para>Stop spellchecking.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Help</guibutton></term>
<listitem>
<para>Loads a help file for the spellchecker.</para>
</listitem>
</varlistentry>
</variablelist>

<para>When the entire document has been checked, &kword; will return the cursor to the same spot 
in the document that the spellchecking was begun.</para>

<note>
<para>If the document does not have any spelling errors, &kword; does
not show a dialog box informing you there were no spelling errors.</para>

<para>When spellchecking is started, it
will proceed to check all of the document against the dictionary, and
if there are no spelling errors it will close the spellcheck dialog box.  With short documents, 
this may happen quickly. &kword; has spellchecked the document!</para>
</note>

<para>There are several options for configuring the spelling application used.
For more details, please see the section entitled
<link linkend="opt-spell">Configure Spelling</link>.</para>

<sect2 id="auto-spell-check">
<title>Automatically mark misspelled words</title>
<indexterm><primary>spelling</primary><secondary>automatically mark misspelled words</secondary></indexterm>

<para>&kword; can check the spelling of your document as you edit it.  It will underline in red any word which 
it cannot find in the dictionary.  This behavior can be turned on and off by the user. By selecting <menuchoice>
<guimenu>Tools</guimenu><guisubmenu>Spellcheck</guisubmenu><guimenuitem>Autospellcheck</guimenuitem></menuchoice>
from the menubar you can toggle autospellchecking on and off. </para> 
</sect2>

</sect1>

<sect1 id="thesaurus">
<title>Finding related word (Thesaurus)</title>
<indexterm><primary>thesaurus, using</primary></indexterm>
<indexterm><primary>Wordnet</primary></indexterm>
<indexterm><primary>related words</primary></indexterm>

<para>&kword; comes with a small thesaurus based on the Wordnet project. For more information on Wordnet, visit the 
<ulink url="http://www.cogsci.princeton.edu/~wn/">Wordnet homepage</ulink>.</para>
<para>You can invoke the thesaurus two ways:  </para>

<itemizedlist>
<listitem><para>Simply click on the desired word with the &RMB;.  A popup menu will appear.  Select
<guimenuitem>Show Related Words</guimenuitem> from the menu and a dialog will appear.</para></listitem>
<listitem><para>By selecting <menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Show Related Words</guimenuitem></menuchoice>
from the menubar</para></listitem>
</itemizedlist>

<para>Which ever method you choose, &kword; opens the &kthesaurus; dialog box.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="thesaurus.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>The word you selected from your document appears in the combo box labeled <guilabel>Search for:</guilabel>.</para>
<para>There are three columns of alternate words:  <guilabel>Synonyms</guilabel>, <guilabel>More General words</guilabel> (hypernyms), <guilabel>More Specific Words</guilabel> (hyponyms).</para>
<para>If you find an appropriate alternate word, simply click on the word in the list, and this word will now be listed in the text box labeled
<guilabel>Replace With:</guilabel>.</para>
<para>To finalize the replacement click <guibutton>Replace</guibutton>.</para>
<para>To keep your original word, click <guibutton>Cancel</guibutton>.</para>
<para>To obtain more specific help, or for help on using the full version of Wordnet, click the <guibutton>Help</guibutton> button for help with
&kthesaurus; (including additional thesauri for non-english languages).</para>

</sect1>

<sect1 id="autocorrect">
<title>Autocorrection</title>
<indexterm><primary>autocorrection</primary><secondary>using</secondary></indexterm>

<para>Auto correction is a system for correcting common typing errors,
converting abbreviations to their full spelling and adjusting
capitalization. As you could guess from its name, this all occurs
automatically, while you are editing your document.</para>

<sect2 id="autocorrection-enable">
<title>Enabling/Disabling Autocorrection</title>

<para>To toggle autocorrection on, select <menuchoice>
<guimenu>Tools</guimenu><guisubmenu>Autocorrection</guisubmenu>
<guimenuitem>Enable Autocorrection</guimenuitem></menuchoice>
from the menubar.  When enabled, autocorrection makes changes to your document <emphasis>as you type</emphasis>.  You can
determine which changes to make by <link linkend="configure-autocorrection">configuring autocorrection</link>.</para>

<para>To toggle autocorrection off, select <menuchoice>
<guimenu>Tools</guimenu><guisubmenu>Autocorrection</guisubmenu>
<guimenuitem>Disable Autocorrection</guimenuitem></menuchoice>
from the menubar. When disabled, autocorrection changes are not made. You can, however,
<link linkend="autoformat">apply autocorrection manually</link>.</para>
</sect2>

<sect2 id="configure-autocorrection">
<title>Configuring Autocorrection Options</title>
<indexterm><primary>autocorrection</primary><secondary>configuring</secondary></indexterm>

<para>To adjust the options for autocorrection, select <menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure Autocorrection...</guimenuitem></menuchoice>
from the menubar.  </para>

<para>A dialog window appears to help you set your options.</para>

<sect3 id="simple-autocorrection">
<title>Simple Autocorrection</title>

<screenshot>
<mediaobject>
<imageobject><imagedata fileref="auto1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<variablelist>


<varlistentry>
<term><guilabel>Convert first letter of a
sentence automatically to uppercase</guilabel></term>
<listitem>
<para>When selected, &kword; will automatically capitalize the first
letter after a period. You can tell &kword; when not to alter capitalization
in certain instances (ie <quote>Sr.</quote> or <quote>Jr.</quote>.  For more details, see the section entitled
<link linkend="autocorrection-exceptions">Autocorrection Exceptions</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Convert two uppercase letters to one uppercase and one
lowercase letter</guilabel></term>
<listitem>
<para>When selected, &kword; will automatically convert a double capital
letter (a common typographical error), into a single capital
letter. You can tell &kword; when not to alter capitalization
in certain instances.  For more details, see the section entitled
<link linkend="autocorrection-exceptions">Autocorrection Exceptions</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Autoformat URLs</guilabel></term>
<listitem>
<para>When selected, &kword; will scan text for patterns which suggest a certain section
of text is a <glossterm linkend="defurl">URL</glossterm> and automatically creates a link.</para>
<para>For more details on links, see the section entitled
<link linkend="links">Document Links</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Suppress double spaces</guilabel></term>
<listitem>
<para>When checked, &kword; will ignore the second space typed.
This prevents users from adding double spaces between words or sentences</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Remove spaces at the beginning and end of paragraphs</guilabel></term>
<listitem>
<para>When selected, &kword; will automatically remove spaces at the beginning and/or the end of a line of text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Automatically do bold and underline formatting</guilabel></term>
<listitem>
<para>When selected, &kword; will look for words surrounded by asterisks ( * ).  It will remove the asterisks and change the font of all
words in between the two asterisks to bold face.</para>
<para>&kword; will also look for words surrounded by underscores ( _ ).  It will remove the underscores and underline all
words in between the two underscores.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Replace 1/2... with ½...</guilabel></term>
<listitem>
<para>When selected, &kword; will automatically change 1/2, 1/3 and 3/4 to their single character equivalents.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Use autonumbering for numbered paragraphs</guilabel></term>
<listitem>
<para>If you start a paragraph with a number and a symbol (<emphasis> 1) </emphasis> for example).  &kword;  will automatically 
convert that paragraph to a numbered paragraph.  All future paragraphs will be consecutively numbered. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Replace 1st with 1^st</guilabel></term>
<listitem>
<para>When selected, &kword; will automatically change 1st to 1<superscript>st</superscript>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Capitalize name of days</guilabel></term>
<listitem>
<para>Automatically capitalize the days of the week (Sunday, Monday, Tuesday, etc...).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Use list-formatting for bulleted paragraphs</guilabel></term>
<listitem>
<para>When selected, &kword; will look for lines that begin with <emphasis>- </emphasis>, and automatically convert the paragraph style
to a bulleted list.  The bullet is selected with the left button below this option.</para>
</listitem>
</varlistentry>


</variablelist>
</sect3>

<sect3 id="quotes-autocorrection"><title>Custom Quotes</title>
<para>Select the tab labeled <guilabel>Custom Quotes</guilabel></para>

<screenshot>
<mediaobject>
<imageobject><imagedata fileref="auto4.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term><guilabel>Replace double quotes with typographical quotes</guilabel></term>
<listitem>
<para>When selected, this option will replace the standard keyboard double
quotes, with typographical quotation marks.  If you want to change the
quotation character, click on one of the buttons. Clicking on
<guibutton>Default</guibutton>, restores the default paragraph marks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Replace single quotes with typographical quotes</guilabel></term>
<listitem>
<para>When selected, this option will replace the standard keyboard single
quotes, with typographical quotation marks.  If you want to change the
quotation character, click on one of the buttons. Clicking on
<guibutton>Default</guibutton>, restores the default paragraph marks.</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
<sect3 id="advanced-autocorrection">
<title>Advanced Autocorrection</title>

<para>To switch to the Advanced Autocorrection, click on the tab labeled
<guilabel>Advanced Autocorrection</guilabel>.</para>

<screenshot>
<mediaobject>
<imageobject><imagedata fileref="auto2.png" format="PNG"/></imageobject>
</mediaobject></screenshot>
<para>This allows you to automatically have &kword; replace one string
of text with another.  This can be useful for special symbols, commonly
used abbreviations that you want spelled out, or abbreviations.</para>

<para>&kword; uses different autocorrection strings depending on the language.  
Set the correct language using the combo box labeled 
<guilabel>Replacements and exceptions for language:</guilabel>.</para>

<para>The check box labeled <guilabel>Enable word replacement</guilabel> is used to 
toggle on and off the autoreplacement features of &kword;.  If there is no mark in the check box, 
then &kword; will not perform any autoreplacements from the list in this dialog.</para>

<para>If there is a mark in the check box labeled <guilabel>Replace text with format</guilabel> 
&kword; will not only change the text when it finds a match, but it will change the formatting of the new text. 
If there is no mark in this check box, then
&kword; uses the same formatting options for the replaced text as it found in the search text.  For more information 
on setting the format options for replacement text, see the section on 
<link linkend="autocorrection-format-options">Changing the format of the autocorrection string</link>.</para>

<sect4>
<title>Adding an autocorrection string</title>

<para>To add an autocorrection string, simply type the text you want &kword; to
check for in the text box labeled
<guilabel>Find</guilabel>, then enter the text you want &kword;
to substitute in the text box labeled <guilabel>Replace</guilabel>.</para>


<note><para>If you want to insert symbols or special characters not available on your
keyboard, you can click the
buttons with three periods on them and select a special character from the table provided.</para></note>

<para>When these are entered, click <guibutton>Add</guibutton>. Your text
strings are now added to the table.</para>
</sect4>

<sect4>
<title>Editing an autocorrection string</title>
<para><emphasis>Changing the text you want to find.</emphasis></para>
<para>&kword; does not allow you to change the text to search for.
This is to prevent disastrous mistakes.</para>
<para>Instead, you must delete the current autocorrection rule and
add a new text string with the corrected text to find.</para>

<para><emphasis>Changing the text you want to replace.</emphasis></para>
<para>Begin by clicking once on the string you want to edit.  It will be
highlighted and the find and replace text will be listed in the text boxes
above. You can alter the replacement text. When you
are done, simply select <guibutton>Modify</guibutton>.</para>

</sect4>

<sect4>
<title>Deleting an autocorrection string.</title>

<para>Simply click on the string you want to delete.  Now click the
<guibutton>Remove</guibutton> button.  The string is removed.</para>

<warning>
<para>Be aware that &kword; does not give you a chance to back out once
you have deleted a string.  Be sure you have selected the correct string
<emphasis>before</emphasis> you click the <guibutton>Remove</guibutton>
button.</para>
</warning>
</sect4>

<sect4 id="autocorrection-format-options">
<title>Changing the format of the autocorrection string.</title>
<note><para>Currently, you must create the autocorrection string <emphasis>before</emphasis> you can format it.</para></note>
<para>Once the autocorrection string has been created, simply click on it once with the &LMB;.</para>
<para>Now click on the <guibutton>Change Format...</guibutton> button.  A small dialog will appear:</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="finddlg2.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>You can use this dialog to select the format of the replaced text.</para>
<para>The left column consists of 13 check boxes.  If there is a mark in the check box, then &kword; will change
any replaced text to match the property selected.
If no mark is in the check box, &kword; does not consider that property when replacing text.</para>

<variablelist>

<varlistentry>
<term><guilabel>Family:</guilabel></term>
<listitem>
<para>Use this combo box to select the font family you want your replacement text to use.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Size:</guilabel></term>
<listitem>
<para>Use this spin box to set the font size you want &kword; to use for your replaced text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Color:</guilabel> and <guilabel>Background Color:</guilabel></term>
<listitem>
<para>Clicking on either of these two buttons allows you to select the font color and/or background color respectively,
you want &kword; to use.  For more information on selecting a color, see the
section on <link linkend="select-colors">Selecting Colors from the Color Dialog</link>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Bold:</guilabel> and <guilabel>Italic:</guilabel></term>
<listitem>
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
to change the fonts to boldface or italicized fonts.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Strikeout:</guilabel></term>
<listitem>
<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel> 
or <guilabel>Simple Bold</guilabel> to use for the replacement text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Underline</guilabel></term>
<listitem>
<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, 
<guilabel>Simple Bold</guilabel> or <guilabel>Wave</guilabel> to use for the replacement text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Vertical alignment:</guilabel></term>
<listitem>
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Subscript</guilabel> or
<guilabel>Superscript</guilabel> to determine what font alignment you want &kword; to use.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Shadow:</guilabel> and <guilabel>Word by word:</guilabel></term>
<listitem>
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
to use shadow text and/or word by word underlining and strikethrough in the replacement text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Capitalization:</guilabel></term>
<listitem>
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>,  or
<guilabel>Small Caps</guilabel> to determine what capitalization to use for the replacement text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Language:</guilabel></term>
<listitem>
<para>You can select the language of the text you will use to replace the found text.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your text options.</para>
<para>Click <guibutton>Cancel</guibutton> to ignore all changes.</para>
<para>Click <guibutton>Reset</guibutton> to restore the options dialog box to the initial values prior to making any changes.</para>
<para>Click <guibutton>Clear</guibutton> to remove all marks from the checked options.</para>
</sect4>

</sect3>
<sect3 id="autocorrection-exceptions">
<title>Autocorrection Exceptions</title>
<indexterm><primary>autocorrection</primary>
<secondary>exceptions</secondary></indexterm>

<para>There are instances where &kword; will make autocorrection changes
that are inappropriate.  You can use the fourth tab of this dialog to define
<emphasis>exceptions</emphasis> to the rules previously discussed.</para>
<para>The dialog for exceptions is shown below:</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="auto3.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>To prevent &kword; from deciding an abbreviation or other text is
the end of a sentence, simply enter the text fragment in the text box below
<guilabel>Do not treat as the end of a sentence:</guilabel>. Then click
<guibutton>Add</guibutton>.</para>
<para>As an example:  Adding <quote>Jr.</quote> to this dialog prevents</para>
<para><quote>Robert Jones Jr. is a friend of the family.</quote></para>
<para>from being changed to:</para>
<para><quote>Robert Jones Jr. Is a friend of the family.</quote></para>
<para>To remove an erroneous entry, simply click once on the wrong entry with the &LMB;
and click on the <guibutton>Remove</guibutton> button.</para>
<para>The second set of boxes performs a similar function to the first except
text entered in these boxes will allow two capital letters in a word if it 
is entered in this text box.</para>
<para>Simply enter the word in the text box below
<guilabel>Accept two uppercase letters in:</guilabel>.  Then click
<guibutton>Add</guibutton>.</para>
<para>As an example:  Adding <quote>CD</quote> to this dialog prevents</para>
<para><quote>CD</quote></para>
<para>from being changed to:</para>
<para><quote>Cd</quote></para>
<para>To remove an erroneous entry, simply click once on the wrong entry with
the &LMB; and click on the <guibutton>Remove</guibutton> button.</para>
</sect3>
</sect2>

<sect2 id="autoformat">
<title>Manually applying autocorrection</title>
<indexterm><primary>autocorrection</primary><secondary>manually
applying</secondary></indexterm>

<para>If autocorrection is turned off in your document, you can manually enable <link linkend="autocorrect">autocorrection</link>.</para>
<para>To manually apply autocorrection, first configure your options by using the
<link linkend="configure-autocorrection">autocorrection dialogs</link>.</para>
<para>Then select <menuchoice>
<guimenu>Tools</guimenu><guisubmenu>Autocorrection</guisubmenu>
<guimenuitem>Apply Autocorrection</guimenuitem></menuchoice>
from the menubar.</para>
<para>&kword; will start at the beginning of the document and apply all selected
autocorrection options to the entire document.</para>
<para>When &kword; is finished, it will return you to your document for further editing.</para>
<para>For more information on enabling and disabling autocorrection,
see <link linkend="autocorrection-enable">Enabling/Disabling Autocorrection</link>.</para>

</sect2>
</sect1>

<sect1 id="autocomplete">
<title>Autocompletion</title>
<indexterm><primary>autocompletion</primary></indexterm>

<para>Autocompletion allows you to type the first few letters of a commonly
used word (often technical or job specific), and tell &kword; to
finish typing the word for you.  This is often very useful when you have lengthy
technical words.</para>
<sect2 id="autocomplete-using">
<title>Using autocompletion</title>
<para>Using autocompletion could not be easier.  Simply type the first few
letters of the word you want &kword; to finish, and press
<keycombo>&Ctrl;<keycap>E</keycap></keycombo>. &kword; will look 
through the list of autocompletion words and if it finds a word which begins 
with those letters, it will finish entering the remainder of the word.</para>
<sect3 id="autocomplete-using-add">
<title>Adding words to autocompletion</title>
<para>&kword; maintains a list of words for each user that will be used for
autocompletion.</para>
<para>You can add words to this list one of two ways:</para>
<itemizedlist>
<listitem><para>&kword; can automatically add new words to the completion list
for later approval.
This is selected using <link
linkend="autocomplete-dialog">the dialog</link>.</para></listitem>
<listitem><para>Individual words can be added to the list by using 
<link linkend="autocomplete-dialog">the dialog</link>.</para></listitem>
</itemizedlist>
</sect3>
</sect2>
<sect2 id="autocomplete-dialog">
<title>Configuring autocomplete</title>
<para>To configure autocompletion, select <menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure
Completion...</guimenuitem></menuchoice>
from the menubar.  This will bring up a dialog.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="autocompdlg.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term><guilabel>Enable word completion</guilabel></term>
<listitem><para>It is used to toggle autocompletion on and off.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Add</guilabel></term>
<listitem>
<para>By clicking this button you can manually add 
an individual word to the completion list.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Remove</guilabel></term>
<listitem>
<para>To remove words from the completion list, select the word with the &LMB;
from the list, then click this button.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Automatically add new words to suggestion list</guilabel></term>
<listitem>
<para>This option will add any word equal to or longer than
the <guilabel>Characters needed:</guilabel> to the list of proposed
autocompletion words.</para>
<para>The large listbox in the center of the dialog contains the current
proposed list of autocompletion words.</para>
<note><para>Not all words listed in the list box will be immediatly affected by
autocompletion when entered into this dialog.</para></note>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show words in tooltip</guilabel></term>
<listitem>
<para>If this option is enabled, a tool tip box will appear when you type the
beginning of a word that exists in the completion list. To complete the word,
press the key you set to accept suggestions in the <guilabel>Key to accept
suggestion:</guilabel> drop-down list.</para>
</listitem>
</varlistentry>


<varlistentry>
<term><guilabel>Characters needed:</guilabel></term>
<listitem>
<para>Use this spinbox/slider combination to prevent &kword; 
from automatically adding short words to the completion list.   You can select
any value from 5-100 and the words will need to be at least the number of
characters set here to be added in the list.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Suggest words:</guilabel></term>
<listitem>
<para>This spinbox/slider combination can be adjusted to allow more or less
words into the autocompletion list.  This option is most important when
<guilabel>Automatically add new words to suggestion list</guilabel> is enabled.
This option keeps the list from becoming too cumbersome. You can select any
value from 1 to 500.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Append space</guilabel></term>
<listitem>
<para>If checked, it adds a single space to the end of a word after
autocompletion, this means it is not necessary to add the space manually for the
next word.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Key to accept suggestion:</guilabel></term>
<listitem>
<para>Set the key you want to use when an autocompleted word is suggested to you
and you want to accept it. You can choose
<keycap>Enter</keycap>, <keycap>Tab</keycap>, <keycap>Space</keycap>,
<keycap>End</keycap> or <keycap>Right</keycap>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Make Default</guilabel></term>
<listitem>
<para>A word is not part of autocompletion until the list is
<emphasis>saved</emphasis> to disk.  At that moment, &kword; 
will use that saved list for all autocompletion, until the list is replaced with
another saved list.</para>
<para>Some of the words in the autocompletion list may not have been saved
yet.</para><para>To save the current list to disk and have &kword; begin using
this new list for autocompletion, 
click this button.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Click <guibutton>OK</guibutton> to save your options. Click
<guibutton>Cancel</guibutton> to abort all changes. Click 
<guibutton>Reset</guibutton> to reset to the state after you clicked on the 
<guibutton>Make Default</guibutton> button.</para>

</sect2>
</sect1>


</chapter>
