~ubuntu-branches/ubuntu/breezy/koffice/breezy-security

« back to all changes in this revision

Viewing changes to doc/kword/editing.docbook

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell
  • Date: 2005-10-11 14:49:50 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20051011144950-lwpngbifzp8nk0ds
Tags: 1:1.4.1-0ubuntu7
* SECURITY UPDATE: fix heap based buffer overflow in the RTF importer of KWord
* Opening specially crafted RTF files in KWord can cause
  execution of abitrary code.
* Add kubuntu_01_rtfimport_heap_overflow.diff
* References:
  CAN-2005-2971
  CESA-2005-005
  http://www.koffice.org/security/advisory-20051011-1.txt

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<chapter id="guides-2">
 
2
<chapterinfo>
 
3
<authorgroup>
 
4
<author>
 
5
<firstname>Mike</firstname>
 
6
<surname>McBride</surname>
 
7
</author>
 
8
<!-- TRANS:ROLES_OF_TRANSLATORS -->
 
9
</authorgroup>
 
10
</chapterinfo>
2
11
<title>Detailed Guides: Editing your Document</title>
3
12
 
4
13
<para>This section of the guide will cover more advanced features of
11
20
<para>For many editing and formatting functions in &kword;, certain actions (bold face, underline,&etc;) should be
12
21
applied to a
13
22
certain section of text, not the document as a whole. You specify which
14
 
text should be altered by selecting (highlighting) the text you want changed.</para>
 
23
text should be altered by selecting (or highlighting) the text you want changed.</para>
15
24
 
16
 
<para>Selected text has a dark background to separate it from
 
25
<para>Selected text has a colored background to separate it from
17
26
unselected text.</para>
18
27
 
19
28
<screenshot>
48
57
<informaltable><tgroup cols="2" align="left">
49
58
<thead><row><entry align="center">Key Combination</entry><entry align="left">Function</entry></row></thead>
50
59
<tbody>
51
 
<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Left Arrow</keycap></keycombo></entry><entry>Move endpoint one character to the left.</entry></row>
52
 
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Left Arrow</keycap></keycombo></entry><entry>Move endpoint one word to the left.</entry></row>
53
 
<row><entry align="center"><keycombo action="simul">&Shift;<keycap>Right Arrow</keycap></keycombo></entry><entry>Move endpoint one character to the Right.</entry></row>
54
 
<row><entry align="center"><keycombo action="simul">&Ctrl;&Shift;<keycap>Right Arrow</keycap></keycombo></entry><entry>Move endpoint one word to the Right.</entry></row>
 
60
<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>
 
61
<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>
 
62
<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>
 
63
<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>
55
64
 
56
65
<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>
57
66
<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>
121
130
<menuchoice><guimenu>View</guimenu><guimenuitem>Split View</guimenuitem></menuchoice> from the menubar. </para>
122
131
 
123
132
<para>The current document area will be split into two views. Alterations to your document can be made in either view.
124
 
Updates in one window will be immediately visible in the other.</para>
 
133
Updates in one view will be immediately visible in the other.</para>
125
134
 
126
135
<tip><para>The views can either be split horizontally or vertically.  See the next section for instructions.</para></tip>
127
136
</sect2>
142
151
<title>Changing the size of views </title>
143
152
<indexterm><primary>views</primary><secondary>resizing</secondary></indexterm>
144
153
<para>The relative sizes of each view can be adjusted with your mouse.</para>
145
 
<para>To adjust the view size, look at the border between the scrollbar of one window
 
154
<para>To adjust the view size, look at the border between the scrollbar of one view
146
155
(the upper or right view) and the ruler of the other view (the lower or left view).  There is a
147
156
solid border which appears raised between the scrollbar and the ruler. As the mouse pointer passes
148
157
over this bar, it changes from an arrow to double lines with double arrows.</para>
 
158
 
 
159
<para><mediaobject><imageobject><imagedata format="PNG"
 
160
fileref="viewsize.png"/></imageobject>
 
161
<textobject><phrase>Screen shot</phrase></textobject></mediaobject></para>
 
162
 
149
163
<para>When the mouse pointer changes, click once with the &LMB; and hold the button
150
164
down.  Drag that border to the new location.  When the mouse button is released, the
151
165
views will change to the new proportions.</para>
156
170
 
157
171
<title>Remove View </title>
158
172
<indexterm><primary>views</primary><secondary>removing</secondary></indexterm>
159
 
<para>To remove a view, simply click the mouse pointer in the view to be deleted.
 
173
<para>To remove a view, simply place the mouse pointer in the view to be deleted and click with the &LMB;.
160
174
Then select <menuchoice><guimenu>View</guimenu><guimenuitem>Remove View</guimenuitem></menuchoice>
161
175
from the menubar.</para>
162
176
</sect2>
201
215
 
202
216
<informalexample><para>It is a pleasure for me to give you this letter of introduction to your newest employee.</para></informalexample>
203
217
 
204
 
<para>If, after you Undo a change, and then decide the <guimenuitem>Undo</guimenuitem> was a mistake,
 
218
<para>If, after you Undo a change, and then want to reverse that decision,
205
219
select
206
220
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice> and
207
221
the Undo is reversed.</para>
246
260
who have used modern word processors. It is a piece of your computers
247
261
memory which is set aside as a temporary storage space.  Text can be
248
262
<quote>Cut</quote> or <quote>Copied</quote> from your document into
249
 
the clipboard.  Now move to another part of the document or to
 
263
the clipboard.  You can move to another part of the document or to
250
264
another application entirely, and <quote>Paste</quote> this text at the new
251
265
location. </para>
252
266
 
260
274
 
261
275
<informalexample><para>The big, red fox jumped over the lazy dog.</para></informalexample>
262
276
 
263
 
<para>Using the mouse or keyboard, select the phrase <quote>big,
264
 
red</quote>.</para>
 
277
<para>Using the mouse or keyboard, select the phrase 
 
278
<quote> big, red</quote> (notice the space before <quote>big</quote> is selected).</para>
265
279
 
266
280
<para>Now select <menuchoice>
267
281
<guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice> from
270
284
<para><emphasis>This has moved a copy of the selected text to the
271
285
clipboard.</emphasis></para>
272
286
 
273
 
<para>Now place the mouse cursor between <quote>lazy</quote> and
 
287
<para>Now place the mouse cursor directly behind the word 
274
288
<quote>dog</quote> and click once.</para>
275
289
 
276
290
<para>Now select <menuchoice>
339
353
fileref="editcut.png" format="PNG"/></imageobject></inlinemediaobject>
340
354
on the toolbar.</para>
341
355
</listitem>
342
 
<listitem>
343
 
<para>After the text is selected, click once with the &RMB; and hold the button down. 
344
 
A small submenu will appear.  Simply select <guilabel>Cut</guilabel></para>
345
 
</listitem>
 
356
 
346
357
<listitem>
347
358
<para>Using the keyboard shortcut: <keycombo
348
359
action="simul">&Ctrl;<keycap>X</keycap></keycombo> or the alternate keyboard shortcut: 
349
360
<keycombo
350
361
action="simul">&Shift;<keycap>Delete</keycap></keycombo></para>
351
362
</listitem>
352
 
</itemizedlist>
 
363
<listitem>
 
364
<para>After the text is selected, click once with the &RMB; and hold the button down. 
 
365
A small submenu will appear.  Simply select <guilabel>Cut</guilabel></para>
 
366
</listitem></itemizedlist>
353
367
 
354
368
<para>The <guimenuitem>Cut</guimenuitem> command moves a copy of the selected data
355
369
to the clipboard.  <emphasis>The selected data is then deleted from the
376
390
</listitem>
377
391
 
378
392
<listitem>
 
393
<para>Using the keyboard shortcut: <keycombo
 
394
action="simul">&Ctrl;<keycap>V</keycap></keycombo> or the alternate keyboard shortcut: 
 
395
<keycombo
 
396
action="simul">&Shift;<keycap>Insert</keycap></keycombo></para>
 
397
</listitem>
 
398
 
 
399
<listitem>
379
400
<para>Place the cursor where the contents of the clipboard
380
401
should be inserted. Click once with the &RMB; and hold the button down. A small
381
402
submenu will appear.  Simply select <guilabel>Paste</guilabel></para>
382
403
</listitem>
383
404
 
384
 
<listitem>
385
 
<para>Using the keyboard shortcut: <keycombo
386
 
action="simul">&Ctrl;<keycap>V</keycap></keycombo> or the alternate keyboard shortcut: 
387
 
<keycombo
388
 
action="simul">&Shift;<keycap>Insert</keycap></keycombo></para>
389
 
</listitem>
390
405
</itemizedlist>
391
406
 
392
407
<para>The <guimenuitem>Paste</guimenuitem> command inserts a copy of all the data in
407
422
 
408
423
<tip><para>The clipboard is not limited to the bounds of the current document.  If
409
424
text is copied (or cut) from a document, this text can be pasted
410
 
into another open document, or another &kde; application entirely.</para></tip>
 
425
into another open document, or another application entirely.</para></tip>
411
426
 
412
427
</sect2>
413
428
</sect1>
451
466
</screenshot>
452
467
 
453
468
<sect3><title>Basic Text Search</title>
454
 
<para>The drop-down box labelled <guilabel>Text to Find</guilabel>,
 
469
<para>The combo box labelled <guilabel>Text to Find</guilabel>,
455
470
provides a place for you to enter the text of your search command. (In
456
471
the screenshot, that box is currently filled with
457
 
<emphasis>KDE</emphasis>)</para> <para>If you click on
458
 
<guibutton>OK</guibutton>, then &kword; will search the document until it
 
472
<emphasis>KDE</emphasis>).</para> 
 
473
 
 
474
<para>If you click on
 
475
<guibutton>F</guibutton>, then &kword; will search the document until it
459
476
finds a match to your text.  If &kword; cannot find a match, a dialog
460
477
box will appear that says <guilabel>No match found</guilabel>.  </para>
461
478
<tip><para>If you want to repeat a recent search, simply select the arrow in the drop-down
462
479
box and a list of your most recent searches will appear.  Simply select your search
463
 
from the list and click <guibutton>OK</guibutton>.</para></tip>
 
480
from the list and click <guibutton>Find</guibutton>.</para></tip>
464
481
 
465
482
</sect3>
466
483
<sect3>
472
489
want.</para>
473
490
 
474
491
<sect4>
475
 
<title>Pattern Matching</title>
 
492
<title>Regular Expressions in &kword;</title>
476
493
 
477
494
<para>The default action for &kword; is to search for an exact match of
478
495
the text.  &kword; has the ability to match text
479
496
that follows a <emphasis>pattern</emphasis> or a set of rules.  </para>
480
497
 
481
 
<para>To enable patterns, place a mark in the box labeled <guilabel>Use
482
 
Patterns</guilabel>.</para>
483
 
 
484
 
<para>This will enable the <guibutton>Insert Pattern</guibutton> button.
485
 
This button can be a quick way to add patterns for people unfamiliar
486
 
with &UNIX; pattern matching.</para>
487
 
 
488
 
<note>
489
 
<para>You do not need to use the <guibutton>Insert Pattern</guibutton>
490
 
button, to insert your text string.  You can type it into the search
491
 
line.  The <guibutton>Insert Pattern</guibutton> button is a convenience
492
 
for people unfamiliar with pattern matching.</para>
493
 
</note>
494
 
 
495
 
<para>You should now type the text in place, stopping to insert the
496
 
pattern elements where necessary.  </para>
497
 
 
498
 
<para>For specific information on pattern matching, take a look at the
499
 
section entitled <link linkend="patterns">Pattern Matching</link></para>
 
498
<para>To enable patterns, place a mark in the box labeled <guilabel>Regular expression</guilabel>.</para>
 
499
 
 
500
<para>This will enable the <guibutton>Edit</guibutton> button.
 
501
This button can be a quick way to create regular expressions for people unfamiliar
 
502
with &UNIX; regular expressions.</para>
 
503
 
 
504
<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>
500
505
 
501
506
</sect4>
502
507
 
517
522
</screenshot>
518
523
 
519
524
<para>You can use this dialog to select the options you want to include in your search.</para>
520
 
<para>The left column consists of nine checkboxes.  If there is a mark in the checkbox, then &kword; will evaluate
521
 
any searchable text for that property.  If no mark is in the checkbox, &kword; does not consider that property when performing a search.</para>
 
525
<para>The left column consists of 13 check boxes.  If there is a mark in the check box, then &kword; will evaluate
 
526
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>
522
527
 
523
528
<variablelist>
524
529
 
525
530
<varlistentry>
526
531
<term><guilabel>Family:</guilabel></term>
527
532
<listitem>
528
 
<para>Use this drop down box to select the font family you want to include in your search text.</para>
 
533
<para>Use this combo box to select the font family you want to include in your search text.</para>
529
534
</listitem>
530
535
</varlistentry>
531
536
 
557
562
<varlistentry>
558
563
<term><guilabel>Strikeout:</guilabel></term>
559
564
<listitem>
560
 
<para>You can select <guilabel>Simple</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
 
565
<para>You can select <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
561
566
<guilabel>Without</guilabel> to modify your search.</para>
562
567
</listitem>
563
568
</varlistentry>
565
570
<varlistentry>
566
571
<term><guilabel>Underline:</guilabel></term>
567
572
<listitem>
568
 
<para>You can select <guilabel>Simple</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
 
573
<para>You can select <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel>, <guilabel>Wave</guilabel> or
569
574
<guilabel>Without</guilabel> to modify your search.</para>
570
575
</listitem>
571
576
</varlistentry>
577
582
<guilabel>Subscript</guilabel> to determine what font alignment you want &kword; to search for.</para>
578
583
</listitem>
579
584
</varlistentry>
580
 
</variablelist>
 
585
 
 
586
<varlistentry>
 
587
<term><guilabel>Shadow:</guilabel> and <guilabel>Word by Word:</guilabel></term>
 
588
<listitem>
 
589
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
 
590
to include shadow text in the search text and whether to search for word by word underlining and strikethrough text.</para>
 
591
</listitem>
 
592
</varlistentry>
 
593
 
 
594
<varlistentry>
 
595
<term><guilabel>Capitalization:</guilabel></term>
 
596
<listitem>
 
597
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>,  or
 
598
<guilabel>Small caps</guilabel> to determine what capitalization you want &kword; to search for.</para>
 
599
</listitem>
 
600
</varlistentry>
 
601
 
 
602
<varlistentry>
 
603
<term><guilabel>Language:</guilabel></term>
 
604
<listitem>
 
605
<para>You can select the language of the text you want &kword; to search for using this dropdown box.</para>
 
606
</listitem>
 
607
</varlistentry></variablelist>
581
608
 
582
609
<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your search options.</para>
583
610
<para>Click <guibutton>Cancel</guibutton> to ignore all changes.</para>
598
625
<listitem>
599
626
<para>When this option is selected, &kword; will not only search for the
600
627
string of letters, but will verify that the case of the letters is the
601
 
same.  For example.  Searching for:</para><para>
602
 
<emphasis>KDE</emphasis></para><para>will match:</para><para>
 
628
same.  For example.  Searching for:
 
629
<emphasis>KDE</emphasis></para><para>will match:
603
630
<emphasis>KDE</emphasis> and
604
 
<emphasis>hiddenKDEinwords</emphasis> but not: </para><para><emphasis>Kde,
 
631
<emphasis>hiddenKDEinwords</emphasis> </para><para>but not: <emphasis>Kde,
605
632
kde</emphasis> or <emphasis> hiddenkdeinwords</emphasis>.</para>
606
633
</listitem>
607
634
</varlistentry>
694
721
<sect3><title>Basic Search and Replace</title>
695
722
<indexterm><primary>replacing text</primary></indexterm>
696
723
 
697
 
<para>The drop-down box labeled <guilabel>Text to find:</guilabel>,
 
724
<para>The combo box labeled <guilabel>Text to find:</guilabel>,
698
725
provides a place for you to enter the text of your search command. (In
699
726
the screenshot, that box is currently filled with
700
727
<emphasis>KDE</emphasis>)</para>
715
742
want.</para>
716
743
 
717
744
<sect4>
718
 
<title>Pattern Matching</title>
 
745
<title>Regular Expressions in &kword;</title>
719
746
 
720
747
<para>The default action for &kword; is to search for an exact match of
721
 
the text.  Fortunately, however, &kword; has the ability to match text
722
 
according to patterns.  </para>
723
 
 
724
 
<para>To enable patterns, place a mark in the box labeled <guilabel>Use
725
 
Patterns</guilabel>.</para>
726
 
 
727
 
<para>This will enable the <guibutton>Insert Pattern</guibutton> button.
728
 
This button can be a quick way to add patterns for people unfamiliar
729
 
with &UNIX; pattern matching.</para>
730
 
 
731
 
<note>
732
 
<para>You do not need to use the <guibutton>Insert Pattern</guibutton>
733
 
button, to insert your text string.  You can type it into the search
734
 
line.  The <guibutton>Insert Pattern</guibutton> button is a convenience
735
 
for people unfamiliar with pattern matching.</para>
736
 
</note>
737
 
 
738
 
<para>For specific information on pattern matching, take a look at the
739
 
section entitled <link linkend="patterns">Pattern Matching</link></para>
 
748
the text.  &kword; has the ability to match text
 
749
that follows a <emphasis>pattern</emphasis> or a set of rules.  </para>
 
750
 
 
751
<para>To enable patterns, place a mark in the box labeled <guilabel>Regular expression</guilabel>.</para>
 
752
 
 
753
<para>This will enable the <guibutton>Edit</guibutton> button.
 
754
This button can be a quick way to create regular expressions for people unfamiliar
 
755
with &UNIX; regular expressions.</para>
 
756
 
 
757
<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>
740
758
 
741
759
</sect4>
742
760
 
743
 
<sect4 id="replace-formatting"><title>Formatting options</title>
 
761
<sect4><title>Formatting options</title>
744
762
<para>&kword; also has the ability to search your document for text that matches
745
763
certain formatting options as well as the text itself.</para>
746
764
 
757
775
</screenshot>
758
776
 
759
777
<para>You can use this dialog to select the options you want to include in your search.</para>
760
 
<para>The left column consists of nine checkboxes.  If there is a mark in the checkbox, then &kword; will evaluate
761
 
any searchable text for that property.  If no mark is in the checkbox, &kword; does not consider that property when performing a search.</para>
 
778
<para>The left column consists of 13 check boxes.  If there is a mark in the check box, then &kword; will evaluate
 
779
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>
762
780
 
763
781
<variablelist>
764
782
 
765
783
<varlistentry>
766
784
<term><guilabel>Family:</guilabel></term>
767
785
<listitem>
768
 
<para>Use this drop down box to select the font family you want to include in your search text.</para>
 
786
<para>Use this combo box to select the font family you want to include in your search text.</para>
769
787
</listitem>
770
788
</varlistentry>
771
789
 
797
815
<varlistentry>
798
816
<term><guilabel>Strikeout:</guilabel></term>
799
817
<listitem>
800
 
<para>You can select <guilabel>Simple</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
 
818
<para>You can select <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
801
819
<guilabel>Without</guilabel> to modify your search.</para>
802
820
</listitem>
803
821
</varlistentry>
805
823
<varlistentry>
806
824
<term><guilabel>Underline:</guilabel></term>
807
825
<listitem>
808
 
<para>You can select <guilabel>Simple</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
 
826
<para>You can select <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel>, <guilabel>Wave</guilabel> or
809
827
<guilabel>Without</guilabel> to modify your search.</para>
810
828
</listitem>
811
829
</varlistentry>
817
835
<guilabel>Subscript</guilabel> to determine what font alignment you want &kword; to search for.</para>
818
836
</listitem>
819
837
</varlistentry>
 
838
 
 
839
<varlistentry>
 
840
<term><guilabel>Shadow:</guilabel> and <guilabel>Word by Word:</guilabel></term>
 
841
<listitem>
 
842
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
 
843
to include shadow text in the search text and whether to search for word by word underlining and strikethrough text.</para>
 
844
</listitem>
 
845
</varlistentry>
 
846
 
 
847
<varlistentry>
 
848
<term><guilabel>Capitalization:</guilabel></term>
 
849
<listitem>
 
850
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>,  or
 
851
<guilabel>Small caps</guilabel> to determine what capitalization you want &kword; to search for.</para>
 
852
</listitem>
 
853
</varlistentry>
 
854
 
 
855
<varlistentry>
 
856
<term><guilabel>Language:</guilabel></term>
 
857
<listitem>
 
858
<para>You can select the language of the text you want &kword; to search for using this dropdown box.</para>
 
859
</listitem>
 
860
</varlistentry></variablelist>
 
861
 
 
862
<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your search options.</para>
 
863
<para>Click <guibutton>Cancel</guibutton> to ignore all changes.</para>
 
864
<para>Click <guibutton>Reset</guibutton> to restore the options dialog box to the default values.</para>
 
865
<para>Click <guibutton>Clear</guibutton> to remove all marks from the checked options.</para>
 
866
 
 
867
</sect4>
 
868
 
 
869
<sect4>
 
870
<title>Other Search options</title>
 
871
 
 
872
<para>In addition to pattern matching, you can limit the search results
 
873
with a few useful options.</para>
 
874
 
 
875
<variablelist>
 
876
<varlistentry>
 
877
<term><guilabel>Case Sensitive</guilabel></term>
 
878
<listitem>
 
879
<para>When this option is selected, &kword; will not only search for the
 
880
string of letters, but will verify that the case of the letters is the
 
881
same.  For example.  Searching for:
 
882
<emphasis>KDE</emphasis></para><para>will match:
 
883
<emphasis>KDE</emphasis> and
 
884
<emphasis>hiddenKDEinwords</emphasis> </para><para>but not: <emphasis>Kde,
 
885
kde</emphasis> or <emphasis> hiddenkdeinwords</emphasis>.</para>
 
886
</listitem>
 
887
</varlistentry>
 
888
 
 
889
<varlistentry>
 
890
<term><guilabel>Find backwards</guilabel></term>
 
891
<listitem>
 
892
<para>This option changes the direction of the search.  This can be
 
893
useful when you only want to search for a string of text before the
 
894
current cursor position, not after.  This option is usually used in
 
895
conjunction with <guilabel>From Cursor</guilabel>, but if that option is
 
896
not specified, &kword; will start searching from the end of the document
 
897
backwards.</para>
 
898
</listitem>
 
899
</varlistentry>
 
900
 
 
901
<varlistentry>
 
902
<term><guilabel>Whole words only</guilabel></term>
 
903
<listitem>
 
904
<para>When this option is selected, &kword; will only return search
 
905
items that are surrounded by spaces, paragraph marks or punctuation. For
 
906
example.  Searching for:  <emphasis>KDE</emphasis></para><para>will
 
907
match: <emphasis>KDE</emphasis></para><para> but not: <emphasis>
 
908
hiddenKDEinwords</emphasis> or <emphasis>KDElike</emphasis>.</para>
 
909
</listitem>
 
910
</varlistentry>
 
911
 
 
912
<varlistentry>
 
913
<term><guilabel>Selected Text</guilabel></term>
 
914
<listitem><para>If you want to limit your search to a specific part of
 
915
the document (a few paragraphs, for example), you can select the part of
 
916
the document you want to search <emphasis>prior</emphasis> to selecting
 
917
the <guilabel>Find</guilabel> command.  When text is selected, &kword;
 
918
will default to only searching the selected text.  You can use this
 
919
option to enable or disable this restriction.</para>
 
920
<note>
 
921
<para>This option will not be available if you have not selected text
 
922
prior to selecting the <guilabel>Find</guilabel> command.</para>
 
923
</note>
 
924
</listitem>
 
925
</varlistentry>
 
926
 
 
927
<varlistentry>
 
928
<term><guilabel>From Cursor</guilabel></term>
 
929
<listitem>
 
930
<para>By default, &kword; begins searching at the beginning of the
 
931
document.  If this option is selected, &kword; begins its search from
 
932
the current position of the cursor. The direction that &kword; searches
 
933
is, by default forward in the document, but can be changed with the
 
934
<guilabel>Find Backwards</guilabel> option.</para>
 
935
</listitem>
 
936
</varlistentry>
820
937
</variablelist>
821
938
 
822
939
<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your search options.</para>
831
948
 
832
949
<para>To include formatting options in your search, click the button labeled
833
950
<guibutton>Show Formatting Options</guibutton> in the <guilabel>Replace with</guilabel> section. </para>
834
 
<para>Clicking <guibutton>No options</guibutton> disables all previous formatting options selections. This ensures that &kword; 
835
 
changes the text, but not the formatting of the text (bold text will remain boldface, superscript text will remain superscript, etc).</para>
836
951
 
837
952
<para>Once <guibutton>Show Formatting Options</guibutton> has been clicked,  a new dialog will appear.</para>
838
953
 
844
959
</screenshot>
845
960
 
846
961
<para>You can use this dialog to select the format of the replaced text.</para>
847
 
<para>The left column consists of nine checkboxes.  If there is a mark in the checkbox, then &kword; will change
 
962
<para>The left column consists of 13 check boxes.  If there is a mark in the check box, then &kword; will change
848
963
any replaced text to match the property selected.  
849
 
If no mark is in the checkbox, &kword; does not consider that property when replacing text.</para>
 
964
If no mark is in the check box, &kword; does not consider that property when replacing text.</para>
850
965
 
851
966
<variablelist>
852
967
 
853
968
<varlistentry>
854
 
<term><guilabel>Family</guilabel></term>
 
969
<term><guilabel>Family:</guilabel></term>
855
970
<listitem>
856
 
<para>Use this drop down box to select the font family you want your replacement text to use.</para>
 
971
<para>Use this combo box to select the font family you want your replacement text to use.</para>
857
972
</listitem>
858
973
</varlistentry>
859
974
 
860
975
<varlistentry>
861
 
<term><guilabel>Size</guilabel></term>
 
976
<term><guilabel>Size:</guilabel></term>
862
977
<listitem>
863
978
<para>Use this spin box to set the font size you want &kword; to use for your replaced text.</para>
864
979
</listitem>
865
980
</varlistentry>
866
981
 
867
982
<varlistentry>
868
 
<term><guilabel>Color</guilabel> and <guilabel>Background Color</guilabel></term>
 
983
<term><guilabel>Color:</guilabel> and <guilabel>Background Color:</guilabel></term>
869
984
<listitem>
870
985
<para>Clicking on either of these two buttons allows you to select the font color and/or background color respectively,
871
986
you want &kword; to use.  For more information on selecting a color, see the
874
989
</varlistentry>
875
990
 
876
991
<varlistentry>
877
 
<term><guilabel>Bold</guilabel> and <guilabel>Italic</guilabel></term>
 
992
<term><guilabel>Bold:</guilabel> and <guilabel>Italic:</guilabel></term>
878
993
<listitem>
879
994
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
880
995
to change the fonts to boldface or italicized fonts.</para>
882
997
</varlistentry>
883
998
 
884
999
<varlistentry>
885
 
<term><guilabel>Strikeout</guilabel></term>
886
 
<listitem>
887
 
<para>You can select <guilabel>Simple</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
888
 
<guilabel>Without</guilabel> to use for the replacement text.</para>
889
 
</listitem>
890
 
</varlistentry>
891
 
 
892
 
<varlistentry>
893
 
<term><guilabel>Underline</guilabel></term>
894
 
<listitem>
895
 
<para>You can select <guilabel>Simple</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
896
 
<guilabel>Without</guilabel> to use for the replacement text.</para>
897
 
</listitem>
898
 
</varlistentry>
899
 
 
900
 
<varlistentry>
901
 
<term><guilabel>Vertical Alignment</guilabel></term>
 
1000
<term><guilabel>Strikeout:</guilabel></term>
 
1001
<listitem>
 
1002
<para>You can select <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
 
1003
<guilabel>Without</guilabel> to use for the replacement text.</para>
 
1004
</listitem>
 
1005
</varlistentry>
 
1006
 
 
1007
<varlistentry>
 
1008
<term><guilabel>Underline:</guilabel></term>
 
1009
<listitem>
 
1010
<para>You can select <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel>, <guilabel>Wave</guilabel>,  or
 
1011
<guilabel>Without</guilabel> to use for the replacement text.</para>
 
1012
</listitem>
 
1013
</varlistentry>
 
1014
 
 
1015
<varlistentry>
 
1016
<term><guilabel>Vertical Alignment:</guilabel></term>
902
1017
<listitem>
903
1018
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Superscript</guilabel> or
904
1019
<guilabel>Subscript</guilabel> to determine what font alignment you want &kword; to use.</para>
905
1020
</listitem>
906
1021
</varlistentry>
 
1022
<varlistentry>
 
1023
<term><guilabel>Shadow:</guilabel> and <guilabel>Word by Word:</guilabel></term>
 
1024
<listitem>
 
1025
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
 
1026
to use shadow text and/or word by word underlining and strikethrough in the replacement text.</para>
 
1027
</listitem>
 
1028
</varlistentry>
 
1029
 
 
1030
<varlistentry>
 
1031
<term><guilabel>Capitalization:</guilabel></term>
 
1032
<listitem>
 
1033
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>,  or
 
1034
<guilabel>Small caps</guilabel> to determine what capitalization to use for the replacement text.</para>
 
1035
</listitem>
 
1036
</varlistentry>
 
1037
 
 
1038
<varlistentry>
 
1039
<term><guilabel>Language:</guilabel></term>
 
1040
<listitem>
 
1041
<para>You can select the language of the text you will use to replace the found text.</para>
 
1042
</listitem>
 
1043
</varlistentry>
907
1044
</variablelist>
908
1045
 
909
1046
<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your text options.</para>
918
1055
<emphasis>Complete text string</emphasis>.</para>
919
1056
<para>This placeholder will contain the entire text string matched by the find command.</para>
920
1057
<para>For example:</para>
921
 
<para>You create a search string, using patterns:  <emphasis>Reference \d</emphasis></para>
922
 
<para>Now in the <guilabel>Replace With</guilabel> section of the replace dialog, you place a mark in the checkbox labeled
 
1058
<para>You create a search string, using regular expressions:  <emphasis>Reference \d</emphasis></para>
 
1059
<note><para>In order for this string example to work, a mark must be placed in the check box labeled 
 
1060
<guilabel>Regular expression</guilabel></para>
 
1061
<para>Regular expressions are available by placing a mark in this checkbox. The use of regular expressions is beyond the 
 
1062
scope of this manual.  For more information see the KDE Regular Expression Manual (Available in the &kde; help center).</para></note>
 
1063
<para>Now in the <guilabel>Replace With</guilabel> section of the replace dialog, you place a mark in the check box labeled
923
1064
<guilabel>Use placeholders</guilabel>.  Click the <guibutton>Insert Placeholder</guibutton> button and select
924
 
<guilabel>Complete text found</guilabel>.  &kword; will insert a <emphasis>/0</emphasis> in the 
 
1065
<guilabel>Complete text found</guilabel>.  &kword; will insert a <emphasis>\0</emphasis> in the 
925
1066
<guilabel>Replacement text</guilabel> text box.</para>
926
 
<para>Now surround the placeholder with parentheses, so your text string is:  <emphasis>(/0)</emphasis></para>
 
1067
<para>Now surround the placeholder with parentheses, so your text string is:  <emphasis>(\0)</emphasis></para>
927
1068
<para>When this is executed, whenever &kword; encounters the find text (ie. <quote>Reference 0</quote>, <quote>Reference 1</quote>,
928
 
<quote>Reference 2</quote>, etc) it will surround the text in parethesis (<quote>(Reference 0)</quote>, <quote>(Reference 1)</quote>,
 
1069
<quote>Reference 2</quote>, etc) it will surround the text in parenthesis (<quote>(Reference 0)</quote>, <quote>(Reference 1)</quote>,
929
1070
<quote>(Reference 2)</quote>, respectively). </para>
930
1071
<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
931
1072
search string you can imagine.</para>
1014
1155
</sect3>
1015
1156
</sect2>
1016
1157
 
1017
 
<sect2 id="patterns">
1018
 
<title>Pattern Matching</title>
1019
 
<para>Sometimes, you want to find or replace text that is similar, but not exactly the same.</para>
1020
 
<para>&kword; allows you to search for words that are similar 
1021
 
in certain very well defined ways.
1022
 
This is done through <emphasis>pattern matching</emphasis>.</para>
1023
 
<para>Each pattern matching string is detailed below.  The true power of pattern matching is 
1024
 
combining multiple elements into a single search string.</para>
1025
 
 
1026
 
<variablelist>
1027
 
<varlistentry>
1028
 
<term><guilabel>Any Character</guilabel></term>
1029
 
<listitem>
1030
 
<para>Will find any <emphasis>one</emphasis> letter, number,
1031
 
punctuation or symbol. Once selected, &kword; will insert a period (.) into your string.
1032
 
</para>
1033
 
<para>Thus:  <emphasis>KW.rd</emphasis> will find or replace <emphasis>KWord</emphasis>,
1034
 
<emphasis>KW2rd</emphasis>, <emphasis>KWOrd</emphasis> or <emphasis>KW*rd</emphasis>.</para>
1035
 
<para>It will not find or replace: <emphasis>KWoord</emphasis>.</para>
1036
 
</listitem>
1037
 
</varlistentry>
1038
 
 
1039
 
<varlistentry>
1040
 
<term><guilabel>Start of Line</guilabel></term>
1041
 
<listitem>
1042
 
<para>Will find any instance where the start of the line is at this point in the search string. 
1043
 
Once selected, &kword; will insert a (^) into your string.
1044
 
</para>
1045
 
<para>Thus:  <emphasis>^KWord</emphasis> will find or replace any instance of
1046
 
<emphasis>KWord</emphasis> which begins a new line.</para>
1047
 
</listitem>
1048
 
</varlistentry>
1049
 
 
1050
 
<varlistentry>
1051
 
<term><guilabel>End of Line</guilabel></term>
1052
 
<listitem>
1053
 
<para>Will find any instance where the end of the line is at this point in the search string.
1054
 
Once selected, &kword; will insert a dollar sign ($) into your string.
1055
 
</para>
1056
 
<para>Thus:  <emphasis>KWord$</emphasis> will find or replace any instance of <emphasis>KWord</emphasis>
1057
 
which occurs at the end of a line.</para>
1058
 
</listitem>
1059
 
</varlistentry>
1060
 
 
1061
 
<varlistentry>
1062
 
<term><guilabel>Set of characters</guilabel></term>
1063
 
<listitem>
1064
 
<para>Once selected, &kword; will insert a set of square brackets into your string. &kword; will
1065
 
match any characters contained within that set of brackets.
1066
 
</para>
1067
 
<para>Thus:  <emphasis>KW[ao]rd</emphasis> will find or replace any instance of <emphasis>KWord</emphasis>
1068
 
or <emphasis>KWard</emphasis>.</para>
1069
 
<para>It will not match:  <emphasis>KWaord</emphasis> or <emphasis>KWird</emphasis>.</para>
1070
 
</listitem>
1071
 
</varlistentry>
1072
 
 
1073
 
<varlistentry>
1074
 
<term><guilabel>Repeats, zero or more times</guilabel></term>
1075
 
<listitem>
1076
 
<para>Once selected, &kword; will insert an asterisk (*) into your string. &kword; will
1077
 
match any string of text that contains <emphasis>zero or more</emphasis> of the previous 
1078
 
characters behind the asterisk.</para>
1079
 
<para>Thus:  <emphasis>KWo*rd</emphasis> will find or replace any instance of <emphasis>KWrd</emphasis> (zero)
1080
 
or <emphasis>KWord</emphasis> (one), or <emphasis>KWoooooooooord</emphasis> (ten).</para>
1081
 
<para>It will not match:  <emphasis>KWaord</emphasis> or <emphasis>KWird</emphasis>.</para>
1082
 
</listitem>
1083
 
</varlistentry>
1084
 
 
1085
 
<varlistentry>
1086
 
<term><guilabel>Repeats, one or more times</guilabel></term>
1087
 
<listitem>
1088
 
<para>Once selected, &kword; will insert a plus sign (+) into your string. &kword; will
1089
 
match any string of text that contains <emphasis>one or more</emphasis> of the previous 
1090
 
characters behind the asterisk.</para>
1091
 
<para>Thus:  <emphasis>KWo*rd</emphasis> will find or replace any instance of 
1092
 
<emphasis>KWord</emphasis> (one), or <emphasis>KWoooooooooord</emphasis> (ten).</para>
1093
 
<para>It will not match:  <emphasis>KWrd</emphasis> (zero).</para>
1094
 
</listitem>
1095
 
</varlistentry>
1096
 
 
1097
 
<varlistentry>
1098
 
<term><guilabel>Optional</guilabel></term>
1099
 
<listitem>
1100
 
<para>Once selected, &kword; will insert a question mark (?) into your string. &kword; will match any instance
1101
 
of the string if the previous character exists <emphasis>and if it does not</emphasis></para>
1102
 
<para>Thus:  <emphasis>KWo?rd</emphasis> will find or replace any instance of <emphasis>KWord</emphasis>, 
1103
 
or <emphasis>KWrd</emphasis>.</para>
1104
 
<para>It will not match:  <emphasis>KWoord</emphasis>.</para>
1105
 
</listitem>
1106
 
</varlistentry>
1107
 
 
1108
 
<varlistentry>
1109
 
<term><guilabel>Escape</guilabel></term>
1110
 
<listitem>
1111
 
<para>Once selected, &kword; will insert a back slash (\) into your string.
1112
 
This backward slash tells &kword; to not perform pattern matching with the next character.  
1113
 
This is useful when you want to search for a string of text using patterns, but you need to match one of the 
1114
 
reserved pattern matching characters.  </para>
1115
 
<para>For example:  <emphasis>KW\.rd</emphasis> will find or
1116
 
replace any instance of <emphasis>KW.rd</emphasis>.</para>
1117
 
<para>It will not match:  <emphasis>KWrd</emphasis>.</para>
1118
 
<tip><para>This character is obviously most useful when you 
1119
 
combine it with other pattern matching (not like the example above).</para>
1120
 
<para>Example:  <emphasis>KWord\.*</emphasis> which will match <emphasis>KWord</emphasis>,
1121
 
<emphasis>KWord.</emphasis> and <emphasis>KWord...</emphasis></para>
1122
 
<para>This string tells &kword; to look for any instance of <emphasis>KWord</emphasis> 
1123
 
with zero or more periods (.) at the end.</para>
1124
 
</tip>
1125
 
</listitem>
1126
 
</varlistentry>
1127
 
 
1128
 
<varlistentry>
1129
 
<term><guilabel>TAB</guilabel></term>
1130
 
<listitem>
1131
 
<para>Once selected, &kword; will insert a back slash folllowed by a t (\t) into your string. &kword; will match any
1132
 
string of characters with a tab character (for use with tab stops) in that portion of the string.</para>
1133
 
</listitem>
1134
 
</varlistentry>
1135
 
 
1136
 
<varlistentry>
1137
 
<term><guilabel>Newline</guilabel></term>
1138
 
<listitem>
1139
 
<para>Once selected, &kword; will insert a back slash folllowed by a <emphasis>n</emphasis> (\n) into your string.
1140
 
&kword; will match any string of characters with a newline character in that portion of the string. (Newline characters are also referred to 
1141
 
as <emphasis>Line Breaks</emphasis>).</para>
1142
 
<tip><para>A newline character is inserted into a &kword; document by clicking <keycombo
1143
 
action="simul">&Shift;<keycap>Return</keycap></keycombo></para></tip>
1144
 
</listitem>
1145
 
</varlistentry>
1146
 
 
1147
 
<varlistentry>
1148
 
<term><guilabel>Carriage Return</guilabel></term>
1149
 
<listitem>
1150
 
<para>Once selected, &kword; will insert a back slash folllowed by a <emphasis>r</emphasis> (\r) into your string.
1151
 
&kword; will match any string of characters with a carrage return character in that portion of the string.</para>
1152
 
<note><para>A carrage return is the same thing as a new paragraph.  When you press the <keycap>Enter</keycap> key,
1153
 
you are entering a carrage return.</para></note>
1154
 
<!-- Lauri, should that previous line be a <keycap>, <keysymbol>, or what?  -->
1155
 
</listitem>
1156
 
</varlistentry>
1157
 
 
1158
 
<varlistentry>
1159
 
<term><guilabel>Whitespace</guilabel></term>
1160
 
<listitem>
1161
 
<para>Once selected, &kword; will insert a back slash folllowed by a <emphasis>s</emphasis> (\s) into your string.
1162
 
&kword; will match any string of characters with a whitespace character in that portion of the string.</para>
1163
 
<note><para>Whitespace characters is a group of characters that change the flow or move the text around.
1164
 
Examples of whitespace characters are spaces, tabs, and carrage returns.</para></note>
1165
 
</listitem>
1166
 
</varlistentry>
1167
 
 
1168
 
<varlistentry>
1169
 
<term><guilabel>Digit</guilabel></term>
1170
 
<listitem>
1171
 
<para>Once selected, &kword; will insert a back slash folllowed by a <emphasis>d</emphasis> (\d) into your string.
1172
 
&kword; will match any string of characters with a numerical digit (any number 0-9) in that portion of the string.</para>
1173
 
</listitem>
1174
 
</varlistentry>
1175
 
</variablelist>
1176
 
</sect2>
 
1158
 
1177
1159
</sect1>
1178
1160
 
1179
1161
<sect1 id="spell-check">
1180
 
<title>Spell Checking</title>
 
1162
<title>Spellchecking</title>
1181
1163
<indexterm><primary>spelling</primary><secondary>check spelling of document</secondary></indexterm>
1182
1164
<para>&kword; can compare each word in your document to several commonly available dictionaries.  It will offer you 
1183
1165
the opportunity to change any words it believes are misspelled.</para>
1188
1170
spelling of.</para>
1189
1171
<para>To check the entire document, leave all text in the document unsellected, and &kword; will check 
1190
1172
the entire document.</para></note>
1191
 
<para>The <guilabel>Spell Checking...</guilabel> command can be invoked
1192
 
2 ways:</para>
 
1173
<para>You can check the spelling of text 2 ways:</para>
1193
1174
 
1194
1175
<itemizedlist>
1195
1176
<listitem>
1205
1186
</listitem>
1206
1187
</itemizedlist>
1207
1188
 
1208
 
<para>Spell checking your document is controlled through a dialog
 
1189
<para>Spellchecking your document is controlled through a dialog
1209
1190
box.</para>
1210
1191
 
1211
1192
<screenshot>
1220
1201
<guilabel>Replacement</guilabel>.  In the list box labeled <guilabel>Suggestion</guilabel> is a list of words
1221
1202
the spelling program has determined as possible correct spellings.</para>
1222
1203
 
1223
 
<para>There is a progress bar below the list of suggestions which tells
1224
 
you how much of the document has been spell checked. In this example, that is 28 percent.</para>
1225
 
 
1226
1204
<para>From here you have eight options:</para>
1227
1205
 
1228
1206
<variablelist>
1275
1253
<varlistentry>
1276
1254
<term><guibutton>Cancel</guibutton></term>
1277
1255
<listitem>
1278
 
<para>Stop spell checking.</para>
 
1256
<para>Stop spellchecking.</para>
1279
1257
</listitem>
1280
1258
</varlistentry>
1281
1259
 
1282
1260
<varlistentry>
1283
1261
<term><guibutton>Help</guibutton></term>
1284
1262
<listitem>
1285
 
<para>Loads a help file for the spell checker.</para>
 
1263
<para>Loads a help file for the spellchecker.</para>
1286
1264
</listitem>
1287
1265
</varlistentry>
1288
1266
</variablelist>
1289
1267
 
1290
1268
<para>When the entire document has been checked, &kword; will return the cursor to the same spot 
1291
 
in the document that the spell checking was begun.</para>
 
1269
in the document that the spellchecking was begun.</para>
1292
1270
 
1293
1271
<note>
1294
 
<para>If the document does not have any spelling errors, &kword; does
1295
 
not show a dialog box.  When spell checking is started, it
 
1272
<para>If the document does not have any spelling errors, &kword; immediatly returns you to your 
 
1273
document (It does not show a dialog box informing you there were no spelling errors).</para>
 
1274
 
 
1275
<para>When spellchecking is started, it
1296
1276
will proceed to check all of the document against the dictionary, and
1297
 
then exit the spell check dialog box.  With short documents, you may
1298
 
miss the dialog box.  &kword; has spell checked the document!</para>
 
1277
if there are no spelling errors it will close the spellcheck dialog box.  With short documents, 
 
1278
this may happen quickly. &kword; has spellchecked the document!</para>
1299
1279
</note>
1300
1280
 
1301
1281
<para>There are several options for configuring the spelling application used.
1307
1287
<indexterm><primary>spelling</primary><secondary>automatically mark misspelled words</secondary></indexterm>
1308
1288
 
1309
1289
<para>&kword; can check the spelling of your document as you edit it.  It will underline in red any word which 
1310
 
it can not find in the dictionary.  This behavior can be turned on and off by the user.  See the section 
1311
 
entitled <link linkend="opt-spell">Configure Spelling</link> for more information.</para>
 
1290
it cannot find in the dictionary.  This behavior can be turned on and off by the user. By selecting <menuchoice>
 
1291
<guimenu>Tools</guimenu><guimenuitem>Spellcheck</guimenuitem><guimenuitem>Autospellcheck</guimenuitem></menuchoice>
 
1292
from the menubar you can toggle autospellchecking on and off. </para> 
1312
1293
</sect2>
1313
1294
 
1314
1295
</sect1>
1337
1318
<imageobject><imagedata fileref="thesaurus.png" format="PNG"/></imageobject>
1338
1319
</mediaobject>
1339
1320
</screenshot>
1340
 
<para>The word you selected from your document appears in the drop down box labeled <guilabel>Search for:</guilabel>.</para>
 
1321
<para>The word you selected from your document appears in the combo box labeled <guilabel>Search for:</guilabel>.</para>
1341
1322
<para>There are three columns of alternate words:  Synonyms, More General words, More Specific Words.</para>
1342
1323
<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
1343
1324
<guilabel>Replace with:</guilabel>.</para>
1344
1325
<para>To finalize the replacement click <guibutton>Replace</guibutton>.</para>
1345
1326
<para>To keep your original word, click <guibutton>Cancel</guibutton>.</para>
1346
1327
<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
1347
 
&kthesaurus;.</para>
 
1328
&kthesaurus; (including additional thesauri for non-english languages).</para>
1348
1329
 
1349
1330
</sect1>
1350
1331
 
1358
1339
automatically, while you are editing your document.</para>
1359
1340
 
1360
1341
<sect2 id="autocorrection-enable">
1361
 
<title>Enable/Disable Autocorrection</title>
 
1342
<title>Enabling/Disabling Autocorrection</title>
1362
1343
 
1363
 
<para>To toggle autocorrection on and off, select <menuchoice>
 
1344
<para>To toggle autocorrection on, select <menuchoice>
1364
1345
<guimenu>Tools</guimenu><guimenuitem>Autocorrection</guimenuitem>
1365
1346
<guimenuitem>Enable Autocorrection</guimenuitem></menuchoice>
1366
1347
from the menubar.  When enabled, autocorrection makes changes to your document <emphasis>as you type</emphasis>.  You can
1367
 
determine which changes to make by <link linkend="configure-autocorrection">configuring autocorrection</link></para>
1368
 
<para>If disabled, autocorrection changes are not made. You can, however,
 
1348
determine which changes to make by <link linkend="configure-autocorrection">configuring autocorrection</link>.</para>
 
1349
 
 
1350
<para>To toggle autocorrection off, select <menuchoice>
 
1351
<guimenu>Tools</guimenu><guimenuitem>Autocorrection</guimenuitem>
 
1352
<guimenuitem>Disable Autocorrection</guimenuitem></menuchoice>
 
1353
from the menubar. When disabled, autocorrection changes are not made. You can, however,
1369
1354
<link linkend="autoformat">apply autocorrection manually</link>.</para>
1370
1355
</sect2>
1371
1356
 
1373
1358
<title>Configuring Autocorrection Options</title>
1374
1359
<indexterm><primary>autocorrection</primary><secondary>configuring</secondary></indexterm>
1375
1360
 
1376
 
<para>To adjust the options for auto correction, select <menuchoice>
 
1361
<para>To adjust the options for autocorrection, select <menuchoice>
1377
1362
<guimenu>Settings</guimenu><guimenuitem>Configure Autocorrection...</guimenuitem></menuchoice>
1378
1363
from the menubar.  </para>
1379
1364
 
1450
1435
</varlistentry>
1451
1436
 
1452
1437
<varlistentry>
1453
 
<term><guilabel>Replace 1/2... with ½</guilabel></term>
 
1438
<term><guilabel>Replace 1/2... with Â½</guilabel></term>
1454
1439
<listitem>
1455
1440
<para>When selected, &kword; will automatically change 1/2, 1/3 and 3/4 to their single character equivalents.</para>
1456
1441
</listitem>
1460
1445
<term><guilabel>Use autonumbering for numbered paragraphs</guilabel></term>
1461
1446
<listitem>
1462
1447
<para>If you start a paragraph with a number and a symbol (<emphasis> 1) </emphasis> for example).  &kword;  will automatically 
1463
 
convert that paragraph to a numbered paragraph.  All future paragraphs will be consecutivly numbered. </para>
 
1448
convert that paragraph to a numbered paragraph.  All future paragraphs will be consecutively numbered. </para>
1464
1449
</listitem>
1465
1450
</varlistentry>
1466
1451
 
1479
1464
</varlistentry>
1480
1465
 
1481
1466
<varlistentry>
1482
 
<term><guilabel>Use lists formatting for bulleted paragraphs</guilabel></term>
 
1467
<term><guilabel>Use list-formatting for bulleted paragraphs</guilabel></term>
1483
1468
<listitem>
1484
1469
<para>When selected, &kword; will look for lines that begin with <emphasis>- </emphasis>, and automatically convert the paragraph style
1485
1470
to a bulleted list.  The bullet is selected with the left button below this option.</para>
1524
1509
<sect3 id="advanced-autocorrection">
1525
1510
<title>Advanced Autocorrection</title>
1526
1511
 
1527
 
<para>To switch to the Advanced Autocorrection, click on the tab labled
 
1512
<para>To switch to the Advanced Autocorrection, click on the tab labeled
1528
1513
<guilabel>Advanced Autocorrection</guilabel>.</para>
1529
1514
 
1530
1515
<screenshot>
1536
1521
used abbreviations that you want spelled out, or abbreviations.</para>
1537
1522
 
1538
1523
<para>&kword; uses different autocorrection strings depending on the language.  
1539
 
Set the correct language using the drop down box labeled 
1540
 
<guilabel>Replacement and exception for language</guilabel>.</para>
 
1524
Set the correct language using the combo box labeled 
 
1525
<guilabel>Replacement and exceptions for language</guilabel>.</para>
1541
1526
 
1542
 
<para>The checkbox labeled <guilabel>Enable word replacement</guilabel> is used to 
1543
 
toggle on and off the autoreplacment features of &kword;.  If there is no mark in the checkbox, 
 
1527
<para>The check box labeled <guilabel>Enable word replacement</guilabel> is used to 
 
1528
toggle on and off the autoreplacement features of &kword;.  If there is no mark in the check box, 
1544
1529
then &kword; will not perform any autoreplacements from the list in this dialog.</para>
1545
1530
 
1546
 
<para>If there is a mark in the checkbox labeled <guilabel>Replace text with formatting</guilabel> 
 
1531
<para>If there is a mark in the check box labeled <guilabel>Replace text with formatting</guilabel> 
1547
1532
&kword; will not only change the text when it finds a match, but it will change the formatting of the new text. 
1548
 
If there is no mark in this checkbox, then
 
1533
If there is no mark in this check box, then
1549
1534
&kword; uses the same formatting options for the replaced text as it found in the search text.  For more information 
1550
1535
on setting the format options for replacement text, see the section on 
1551
1536
<link linkend="autocorrection-format-options">Changing the format of the autocorrection string</link>.</para>
1555
1540
 
1556
1541
<para>To add an autocorrection string, simply type the text you want &kword; to
1557
1542
check for in the text box labeled
1558
 
<guilabel>Find</guilabel> Then enter the text you want &kword;
 
1543
<guilabel>Find</guilabel>, then enter the text you want &kword;
1559
1544
to substitute in the text box labeled <guilabel>Replace</guilabel>.</para>
1560
1545
 
1561
1546
 
1610
1595
</mediaobject>
1611
1596
</screenshot>
1612
1597
<para>You can use this dialog to select the format of the replaced text.</para>
1613
 
<para>The left column consists of nine checkboxes.  If there is a mark in the checkbox, then &kword; will change
 
1598
<para>The left column consists of 13 check boxes.  If there is a mark in the check box, then &kword; will change
1614
1599
any replaced text to match the property selected.
1615
 
If no mark is in the checkbox, &kword; does not consider that property when replacing text.</para>
 
1600
If no mark is in the check box, &kword; does not consider that property when replacing text.</para>
1616
1601
 
1617
1602
<variablelist>
1618
1603
 
1619
1604
<varlistentry>
1620
1605
<term><guilabel>Family</guilabel></term>
1621
1606
<listitem>
1622
 
<para>Use this drop down box to select the font family you want your replacement text to use.</para>
 
1607
<para>Use this combo box to select the font family you want your replacement text to use.</para>
1623
1608
</listitem>
1624
1609
</varlistentry>
1625
1610
 
1650
1635
<varlistentry>
1651
1636
<term><guilabel>Strikeout</guilabel></term>
1652
1637
<listitem>
1653
 
<para>You can select <guilabel>Simple</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
 
1638
<para>You can select <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
1654
1639
<guilabel>Without</guilabel> to use for the replacement text.</para>
1655
1640
</listitem>
1656
1641
</varlistentry>
1658
1643
<varlistentry>
1659
1644
<term><guilabel>Underline</guilabel></term>
1660
1645
<listitem>
1661
 
<para>You can select <guilabel>Simple</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel> or
 
1646
<para>You can select <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, <guilabel>Simple bold</guilabel>, <guilabel>Wave</guilabel>,  or
1662
1647
<guilabel>Without</guilabel> to use for the replacement text.</para>
1663
1648
</listitem>
1664
1649
</varlistentry>
1670
1655
<guilabel>Subscript</guilabel> to determine what font alignment you want &kword; to use.</para>
1671
1656
</listitem>
1672
1657
</varlistentry>
 
1658
<varlistentry>
 
1659
<term><guilabel>Shadow:</guilabel> and <guilabel>Word by Word:</guilabel></term>
 
1660
<listitem>
 
1661
<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio boxes to determine whether you want &kword;
 
1662
to use shadow text and/or word by word underlining and strikethrough in the replacement text.</para>
 
1663
</listitem>
 
1664
</varlistentry>
 
1665
 
 
1666
<varlistentry>
 
1667
<term><guilabel>Capitalization:</guilabel></term>
 
1668
<listitem>
 
1669
<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>,  or
 
1670
<guilabel>Small caps</guilabel> to determine what capitalization to use for the replacement text.</para>
 
1671
</listitem>
 
1672
</varlistentry>
 
1673
 
 
1674
<varlistentry>
 
1675
<term><guilabel>Language:</guilabel></term>
 
1676
<listitem>
 
1677
<para>You can select the language of the text you will use to replace the found text.</para>
 
1678
</listitem>
 
1679
</varlistentry>
1673
1680
</variablelist>
1674
1681
 
1675
1682
<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your text options.</para>
1684
1691
<indexterm><primary>autocorrection</primary><secondary>exceptions</secondary></indexterm>
1685
1692
 
1686
1693
<para>There are instances where &kword; will make autocorrection changes
1687
 
that are inappropriate.  You can use the third tab of this dialog to define
 
1694
that are inappropriate.  You can use the fourth tab of this dialog to define
1688
1695
<emphasis>exceptions</emphasis> to the rules previously discussed.</para>
1689
1696
<para>The dialog for exceptions is shown below:</para>
1690
1697
<screenshot>
1700
1707
<para><quote>Robert Jones Jr. is a friend of the family.</quote></para>
1701
1708
<para>from being changed to:</para>
1702
1709
<para><quote>Robert Jones Jr. Is a friend of the family.</quote></para>
1703
 
<para>To remove an erroneous entry, simply click once on the wrong entry with the &RMB;
 
1710
<para>To remove an erroneous entry, simply click once on the wrong entry with the &LMB;
1704
1711
and click on the <guibutton>Remove</guibutton> button.</para>
1705
 
<para>The second set of boxes performs a similar function to the first.  Only in
1706
 
this instance, text entered in these boxes will stay double capital letters.</para>
1707
 
<para>simply enter the text fragment in the text box below
 
1712
<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 
 
1713
is entered in this text box.</para>
 
1714
<para>Simply enter the word in the text box below
1708
1715
<guilabel>Accept two uppercase letters in</guilabel>.  Then click
1709
1716
<guibutton>Add</guibutton>.</para>
1710
 
<para>As an example:  Adding <quote>FL</quote> to this dialog prevents</para>
1711
 
<para><quote>Sarasota, FL </quote></para>
 
1717
<para>As an example:  Adding <quote>CD</quote> to this dialog prevents</para>
 
1718
<para><quote>CD</quote></para>
1712
1719
<para>from being changed to:</para>
1713
 
<para><quote>Sarasota, Fl </quote></para>
1714
 
<para>To remove an erroneous entry, simply click once on the wrong entry with the &RMB;
 
1720
<para><quote>Cd</quote></para>
 
1721
<para>To remove an erroneous entry, simply click once on the wrong entry with the &LMB;
1715
1722
and click on the <guibutton>Remove</guibutton> button.</para>
1716
1723
</sect3>
1717
1724
</sect2>
1720
1727
<title>Manually applying autocorrection</title>
1721
1728
<indexterm><primary>autocorrection</primary><secondary>manually applying</secondary></indexterm>
1722
1729
 
1723
 
<para>If autocorrection is turned off in your document, you can mannually enable <link linkend="autocorrect">autocorrection</link>.</para>
 
1730
<para>If autocorrection is turned off in your document, you can manually enable <link linkend="autocorrect">autocorrection</link>.</para>
1724
1731
<para>To manually apply autocorrection, first configure your options by using the
1725
1732
<link linkend="configure-autocorrection">autocorrection dialogs</link>.</para>
1726
1733
<para>Then select <menuchoice>
1729
1736
<para>&kword; will start at the beginning of the document and apply all selected autocorrection options to the entire document.</para>
1730
1737
<para>When &kword; is finished, it will return you to your document for further editing.</para>
1731
1738
<para>For more information on enabling and disabling autocorrection,
1732
 
see <link linkend="autocorrection-enable">Enable/Disable Autocorrection</link>.</para>
 
1739
see <link linkend="autocorrection-enable">Enabling/Disabling Autocorrection</link>.</para>
1733
1740
 
1734
1741
</sect2>
1735
1742
</sect1>
1773
1780
</mediaobject>
1774
1781
</screenshot>
1775
1782
 
1776
 
<para>The first checkbox labeled <guilabel>Enable completion</guilabel> is used to toggle autocompletion on and off.</para>
1777
 
<para>The second checkbox, labeled <guilabel>Automatically add new words to completion list</guilabel> will add any word equal to or longer
 
1783
<para>The first check box labeled <guilabel>Enable completion</guilabel> is used to toggle autocompletion on and off.</para>
 
1784
<para>The second check box, labeled <guilabel>Automatically add new words to completion list</guilabel> will add any word equal to or longer
1778
1785
than the <guilabel>Minimum word length</guilabel> to the list of proposed autocompletion words.</para>
1779
1786
<para>The large listbox in the center of the dialog contains the current proposed list of autocompletion words.</para>
1780
 
<note><para>Not all words listed in the list box will be replaced when autocompletion is selected.</para>
 
1787
<note><para>Not all words listed in the list box will be immediatly affected by autocompletion when entered into this dialog.</para>
1781
1788
<para>A word is not part of autocompletion until the list is <emphasis>saved</emphasis> to disk.  At that moment, &kword; 
1782
1789
will use that saved list for all autocompletion, until the list is replaced with another saved list.</para>
1783
1790
<para>Some of the words in the autocompletion list may not have been saved yet.</para></note>
1784
 
<para>By clicking the <guibutton>Add Completion Entry</guibutton> button you can add 
 
1791
<para>By clicking the <guibutton>Add Completion Entry...</guibutton> button you can add 
1785
1792
an individual word to the completion list.</para>
1786
1793
<para>To remove words from the completion list, select the word with the &LMB; from the list, then
1787
1794
click <guibutton>Remove Completion Entry</guibutton>.</para>
1793
1800
words into the autocompletion list.  This option is most important when
1794
1801
<guilabel>Automatically add words to completion list</guilabel> is enabled.
1795
1802
This option keeps the list from becoming too cumbersome. You can select any value from 1 to 500.</para>
1796
 
<para>If a mark is placed in the checkbox labeled <guilabel>Append space</guilabel>, then &kword; adds a single space to the 
 
1803
<para>If a mark is placed in the check box labeled <guilabel>Append space</guilabel>, then &kword; adds a single space to the 
1797
1804
end of a word after autocompletion, this means it is not necessary to add the space manually for the next word.</para>
1798
1805
<para>Click <guibutton>OK</guibutton> to save your options.  Click <guibutton>Cancel</guibutton> to abort all changes.</para>
1799
1806