Added old abandoned KDE3 version of koffice

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

1 files changed, 1903 insertions, 0 deletions

diff --git a/doc/kword/editing.docbook b/doc/kword/editing.docbook
new file mode 100644
index 00000000..733da667
--- /dev/null
+++ b/doc/kword/editing.docbook
@@ -0,0 +1,1903 @@
+<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>