# Detailed Guides: Editing your Document

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 next section.

## Selecting Text

For many editing and formatting functions in &kword;, you will want to perform a certain action (bold face, underline,&etc;) to a certain section of text, not the document as a whole. You specify which text you want by selecting (highlighting) text.

Selected text has a dark background to seperate it from unselected text. You select text by designating a start and an end point. All the text in between the start and end point is selected text.

The endpoint can be located before the start point. The text will not be in reverse order.

Selected text has a black background to seperate it from unselected text. You select text by designating a start and an end point. All the text in between the start and end point is selected text.

The endpoint can be located before the start point. The text will not be reversed.

You can select text with either the mouse or the keyboard.

### Using The Keyboard

&Shift;Left Arrow | Move selection one character to the left.
&Shift;Right Arrow | Move selection one character to the Right.
&Shift;Up Arrow | Selects all characters from the start of the selection, to the character directly up one line.
&Shift;Down Arrow | Selects all characters from the start of the selection, to the character directly down one line.
&Shift;Home | Selects all characters from the start of the selection, to the beginning of the line.
&Shift;End | Selects all characters from the start of the selection, to the end of the line.

### Using The Mouse

To select text with the mouse, hold down the left mouse button and drag the cursor. This selects all text between the initial click of the mouse button and the current position of the mouse cursor. When you release the mouse button, the start and endpoints will become fixed.

## Using Multiple Views

## Undo/Redo

It happens all the time. You are working on a document, and you make a change. Then you realize, thats not what you wanted to do at all!

Fortunately, &kword; has a solution for you.

Each time you make a change to a document, &kword; remembers what the change was. If you decide to remove some of the changes, you can Undo each change one at a a time.

As an example, William Shakespeare is using &kword; to write his new drama. He types in the following verse:

Chorus: | Two households, both alike in dignity,
| In fair Verona, where we lay our scene,
| From ancient grudge break to new mutiny,
| Where civil blood makes civil hands unclean.

Now he thinks to himself, Maybe Verona is not the ideal place?

So he changes the line:

Chorus: | Two households, both alike in dignity,
| In fair Constantinople, where we lay our scene,
| From ancient grudge break to new mutiny,
| Where civil blood makes civil hands unclean.

No, he says to himself, that screws up the meter of the poem, and decides to change it back.

He selects Edit Undo from the menubar.

The text now reads Verona again.

If, after you Undo a change, and then decide that was a mistake, you can select Edit Redo and the Undo is reversed.

Sometimes it is not possible for &kword; to undo an edit. You will be informed of this when you select the Edit function, it will replace the Undo function with No Undo Possible.

## Cut/Copy/Paste and the Clipboard

The clipboard 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. You can Cut or Copy text from your document into the clipboard. You can then move to another part of the document, and Paste this text back into the document at the new position.

The most common use for the clipboard is to move or coppy text which you have already entered into one part of your document to another part of the same document or to another document entirely.

This concept is probably best described with an example.

To do this, we will begin with a test sentence

The big, red fox jumped over the lazy dog.

Using the mouse or keyboard, you select the phrase big, red.

Now select Edit Copy from the menubar, click from the toolbar or press &Ctrl;C.

This has moved a copy of the selected text to the clipboard.

You now place the mouse cursor between lazy and dog and click once.

Now select Edit Paste from the menubar, click from the toolbar or press &Ctrl;V

The resulting sentence is:

The fox jumped over the lazy big, red dog

### The Copy Command

The Copy command can be invoked 4 ways:

- By selecting Edit Copy from the Menu bar

- By clicking on the toolbar.

- You can use the keyboard shortcut: &Ctrl;C

- You can use the mouse to highlight the text. That text is automatically moved into the clipboard.

The Copy command moves a copy of the selected text to the clipboard. The original sentance is unaffected.

### The Cut Command

The Cut command can be invoked 3 ways:

- By selecting Edit Cut from the Menu bar

- By clicking on the toolbar.

- You can use the keyboard shortcut: &Ctrl;X

The Cut command moves a copy of the selected text to the clipboard. The selected text is then deleted from the sentance in your document.

### The Paste Command

The Paste command can be invoked 3 ways:

- By selecting Edit Paste from the Menu bar

- By clicking on the toolbar.

- You can use the keyboard shortcut: &Ctrl;V

The Paste command inserts a copy of all the text 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 text in the document.)

If no text in the document is currently highlighted, the Paste command inserts the text at the current position of the cursor.

If there is selected text when the Paste command is executed, the selected text is replaced with the contents of the clipboard.

Remember: You are not limited to the bounds of one document. If you Copy (or Cut) text from a document, you can Paste this text into another open document.

## Finding and Replacing Text

### The Find Command

The Find command can be invoked 3 ways:

- By selecting Edit Find... from the Menu bar

- You can use the keyboard shortcut:&Ctrl;F

- By clicking on the toolbar.

When the Find Command is invoked, a dialog appears.

The drop-down box labelled Text to Find, provides a place for you to enter the text of your search command. In the screenshot, that box is currently filled with KDE)

If you click on OK, then &kde; 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 No match found.

#### Refining Your Search

&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 exactly what you want.

##### Pattern Matching

The default action for &kword; is to search for an exact match of the text. Fortunatly, however, &kword; has the ability to match text according to patterns.

To enable patterns, place a mark in the box labeld Use Patterns.

This will enable the Insert Pattern button. This button can be a quick way to add patterns for people unfamiliar with &UNIX; pattern matching.

You do not need to use the Insert Pattern button, to insert your text string. You can type it into the search line. The Insert Pattern button is a convenience for people unfamiliar with pattern matching.

You should now type the text in place, stopping to insert the pattern elements where necessary.

For specific information on pattern matching, take a look at the section entitled Pattern Matching

##### Other Search options

In addition to pattern matching, you can limit the search results with a few miscellaneous options.

Case Sensitive

  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: KDE

  will match: KDE and hiddenKDEinwords but not: Kde, kde or hiddenkdeinwords.

Whole words only

  When this option is selected, &kword; will only return search items that are surrounded by spaces, paragraph marks or punctuation. For example. Searching for: KDE

  will match: KDE

  but not: hiddenKDEinwords or KDElike.

From Cursor

  By default, &kword; begins searching at the beginning of the document. If this option is selected, &kword; begins its search from the current possition of the cursor. The direction that &kword; searches is, by default forward in the document, but can be changed with the Find Backwards option.

Find backwards

  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 From Cursor, but if that option is not specified, &kword; will start searching from the end of the document backwards.

Selected Text

  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 prior to selecting the Find 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.

  This option will not be available if you have not selected text prior to selecting the Find command.

### The Replace Command

The replace command is an extension of the find command. If you are familiar with the find command, you will see many similarities.

The Replace command can be invoked 2 ways:

- By selecting Edit Replace... from the Menu bar

- You can use the keyboard shortcut: &Ctrl;R

When the Replace command is invoked, a dialog appears.

The drop-down box labeled Text to Find, provides a place for you to enter the text of your search command. In the screenshot, that box is currently filled with KDE)

#### Entering Replacement Text

You can enter your replacement text in the text box labeled Replacement Text. You can now click OK to replace all occurences in the document, or you can further refine your search.

#### Refining Your Search

&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 exactly what you want.

##### Pattern Matching

The default action for &kword; is to search for an exact match of the text. Fortunatly, however, &kword; has the ability to match text according to patterns.

To enable patterns, place a mark in the box labeld Use Patterns.

This will enable the Insert Pattern button. This button can be a quick way to add patterns for people unfamiliar with &UNIX; pattern matching.

You do not need to use the Insert Pattern button, to insert your text string. You can type it into the search line. The Insert Pattern button is a convenience for people unfamiliar with pattern matching.

For specific information on pattern matching, take a look at the section entitled Pattern Matching

##### Other Replace Options

In addition to pattern matching, you can limit the search results with a few miscellaneous options.

Case Sensitive

  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: KDE

  will match: KDE and hiddenKDEinwords but not: Kde, kde or hiddenkdeinwords.

Whole words only

  When this option is selected, &kword; will only return search items that are surrounded by spaces, paragraph marks or punctuation. For example. Searching for: KDE

  will match: KDE

  but not: hiddenKDEinwords or KDElike.

From Cursor

  By default, &kword; begins searching at the beginning of the document. If this option is selected, &kword; begins its search from the current possition of the cursor. The direction that &kword; searches is, by default forward in the document, but can be changed with the Find Backwards option.

Find backwards

  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 From Cursor, but if that option is not specified, &kword; will start searching from the end of the document backwards.

Selected Text

  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 prior to selecting the Find 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.

  This option will not be available if you have not selected text prior to selecting the Find command.

### Pattern Matching

Any Character

  Will find any letter, number, punctuation or symbol.

## Spell Checking

The Spell Checking... command can be invoked 2 ways:

- By selecting Tools Spelling... from the Menu bar

- By clicking on the toolbar.

Spell Checking your document is controlled through a dialog box.

In this example, the mispelled word &kword; found, was youve. It has only one suggestion you've.

There is a progress bar below the list of suggestions which tells you how much of the document has been spell checked.

From here you have eight options:

Replace

  Replaces the current word with the suggestion. Only replaces this occurance.

Replace All

  Replaces all occurances of the current word with the suggestion.

Ignore

  Do not make any changes to this occurance. Ask me if this word appears again.

Ignore All

  Do not make any changes to this or any other occurance. Do not ask me about this word again.

Add

  Add the current word to the dictionary.

Stop

  Keep the current changes, but stop any further checking.

Close

  Stop spell checking.

Help

  Loads this help file.

When the entire document has been checked, &kword; will return you to editing your document.

If your document does not have any spelling errors, &kword; does not provide you with a dialog box. When you start the spell check, it will proceed to check all of your document against the dictionary, and then exit the spell check dialog box. With short documents, you may miss the dialog box. &kword; has spell checked the document!

## Autocorrection

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.

To adjust the options for auto correction, select Tools Autocorrection... from the Menu bar

A dialog window appears to help you set your options.

### Simple Autocorrection

Replace Quotes by Typographical Quotes

  When selected, this option will replace the standard keyboard quotes, with typographical quotation marks. If you want to change the quotation character, click on one of the buttons.

Convert the first letter from the first word of a sentance automatically to Upper Case

  When selected, &kword; will automatically capitalize the first letter after a period.

Convert two Upper Case letters to one Upper Case and one Lower Case letter

  When selected, &kword; will automatically convert a double capital letter (a common typographical error), into a single capital letter.

### Advanced Autocorrection

To switch to the Advanced Autocorrection, click on the tab labled Advanced Autocorrection.

This allows you to automatically have &kword; replace one string of text with another. This can be useful for special symbols, commonly used abbriviations that you want spelled out, or abbreviations.

&kword; comes standard with 4 autocorrection strings. Each string listed in the column labeled Find will be automatically replaced with the text in Replace.

#### Adding an autocorrection string

To add an autocorrection string, simply click on the Add button. This will bring up a dialog box.

Enter the text you want &kword; to search for in the text box labeled Find. Alternativly, you can click the button to the right of the Find text box, and you can select a special character from the table provided.

Now enter the text you want to replace it with in the text box labeled Replace. The button to the right of the Replace. text box works the same as the button next to the Find text box.

When these are entered, click OK. Your text strings are now added to the table.

If you select Cancel, your strings will not be added.

#### Editing an autocorrection string

Begin by clicking once on the string you want to edit. It will be highlighted. Now click on the Edit button. The dialog will appear with the familiar fields for you to edit. When you are done, simply select OK to keep your changes, or Cancel to forget your changes.

#### Deleting an autocorrection string.

Simply click on the string you want to delete. Now click the Remove button. The string is removed.

Be aware that &kword; does not give you a chance to back out once you have deleted a string. Be sure you have slected the correct string before you click the Remove button.