summaryrefslogtreecommitdiffstats
path: root/doc/kword/editing.docbook
blob: fc8e5c52239b9fbe0a30b10f7d500b2241445b5b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
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>TDE</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 TDE 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>TDE</emphasis></para><para>will match:
<emphasis>TDE</emphasis> and
<emphasis>hiddenTDEinwords</emphasis> </para><para>but not: <emphasis>Tde,
tde</emphasis> or <emphasis> hiddentdeinwords</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>TDE</emphasis></para><para>will
match: <emphasis>TDE</emphasis></para><para> but not: <emphasis>
hiddenTDEinwords</emphasis> or <emphasis>TDElike</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>TDE</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 TDE 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>TDE</emphasis></para><para>will match:
<emphasis>TDE</emphasis> and
<emphasis>hiddenTDEinwords</emphasis> </para><para>but not: <emphasis>Tde,
tde</emphasis> or <emphasis> hiddentdeinwords</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>TDE</emphasis></para><para>will
match: <emphasis>TDE</emphasis></para><para> but not: <emphasis>
hiddenTDEinwords</emphasis> or <emphasis>TDElike</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 TDE Regular Expression Manual (Available in the &tde; 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>TDE</emphasis></para><para>will match:
<emphasis>TDE</emphasis> and <emphasis>hiddenTDEinwords</emphasis> but
not: <emphasis>Tde, tde</emphasis> or <emphasis>
hiddentdeinwords</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>TDE</emphasis></para><para>will
match: <emphasis>TDE</emphasis></para><para> but not: <emphasis>
hiddenTDEinwords</emphasis> or <emphasis>TDElike</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>