summaryrefslogtreecommitdiffstats
path: root/doc/kedit/index.docbook
blob: 68213adc1a15bbbaa727e820d2f2ed1d7634a0fc (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
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kedit;">
  <!ENTITY package "tdeutils">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title>The &kedit; Handbook</title>
<authorgroup>

<author><firstname>Thad</firstname><surname>McGinnis</surname>
<affiliation>
<address><email>ctmcginnis@compuserve.com</email></address>
</affiliation>
</author>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation><address><email>lauri@kde.org</email></address></affiliation>
<contrib>Reviewer</contrib>
</othercredit>
</authorgroup>

<date>2003-09-16</date>
<releaseinfo>1.3</releaseinfo>

<legalnotice>&FDLNotice;</legalnotice>

<abstract><para>This Handbook describes &kedit;, a simple
text editor for &kde;</para> </abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>KEdit</keyword>
<keyword>text editor</keyword>
</keywordset>

<copyright>
<year>2000</year>
<holder>Thad McGinnis</holder>
</copyright>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>&kedit; is a text editor for the &kde; Desktop. It is a
small editor which can be used with &konqueror; for text and
configuration file browsing. &kedit; also serves well for creating small
plain text documents. It is not meant to be a programmers editor, in
particular it is not meant to replace any of the more powerful editors
such as &kate;, <application>XEmacs</application> or
<application>Emacs</application>. &kedit;'s functionality will
intentionally remain rather limited to ensure a reasonably fast
start.</para>

</chapter>

<chapter id="on-screen-fundamentals"> 
<title>Some Fundamentals</title>  

<para>&kedit; is very simple to use. Anyone that has used a text editor
should have no problems. </para>

<sect1 id="drag-and-drop">
<title>Drag and Drop</title>  

<para>&kedit; uses the &kde; Drag and Drop protocol. Files may be
dragged and dropped onto &kedit; from the Desktop, &konqueror;, or some
remote &FTP; site opened in one of &konqueror;'s windows. </para>

</sect1>  

<sect1 id="command-line-options"> 
<title>Command Line Options</title>  

<para>Though &kedit; may most often be started from the &kde; program
menu, or a desktop icon, it can also be opened at the command line
prompt of a terminal window.  There are a few useful options that are
available when doing this.</para>

<sect2 id="specify-a-file"> 
<title>Specify a File</title>  

<para>By specifying the path and name of a particular file the user can
have &kedit; open (or create) that file immediately upon startup.This
option might look something like the following:</para>

<informalexample>
<screen><prompt>%</prompt><userinput><command>kedit</command> <replaceable>/home/myhome/docs/myfile.txt</replaceable></userinput></screen>
</informalexample> 

</sect2> 

<sect2 id="editing-files-on-the-internet"> 
<title>Specify a file on the Internet</title>  

<para>The above-mentioned method could even be used to open files on the
internet (if the user has an active connection at the time.)  An example
of this might look like the following:</para>

<informalexample>
<screen><prompt>%</prompt><userinput><command>kedit</command> <replaceable>ftp://ftp.kde.org/pub/kde/Welcome.msg</replaceable></userinput></screen>
</informalexample>  

</sect2>   

<sect2> 
<title>Other Command Line Options</title>  

<para>The following command line help options are available</para>  

<variablelist> 
<varlistentry> 
<term><command>kedit</command> <option>--help</option></term> 
<listitem>
<para>This lists the most basic options available at the command
line.</para>
</listitem> 
</varlistentry> 

<varlistentry> 
<term><command>kedit</command> <option>--help-qt</option></term> 
<listitem>
<para>This lists the options available for changing the way &kedit;
interacts with &Qt;.</para>
</listitem> 
</varlistentry> 

<varlistentry> 
<term><command>kedit</command> <option>--help-kde</option></term> 
<listitem>
<para>This lists the options available for changing the way &kedit;
interacts with &kde;.</para>
</listitem> 
</varlistentry> 

<varlistentry> 
<term><command>kedit</command> <option>--help-all</option></term> 
<listitem>
<para>This lists all of the command line options.</para>
</listitem>
</varlistentry> 

<varlistentry> 
<term><command>kedit</command> <option>--author</option></term> 
<listitem>
<para>Lists &kedit;'s authors in the terminal window</para>
</listitem> 
</varlistentry> 

<varlistentry> 
<term><command>kedit</command> <option>--version</option></term> 
<listitem>
<para>Lists version information for &Qt;, &kde;, and &kedit;. Also
available through <command>kedit</command> <option>-V</option></para>
</listitem> 
</varlistentry> 
</variablelist> 

</sect2> 

</sect1> 

<sect1 id="keybindings">
<title>Key Bindings</title>

<para>Many of the key bindings (shortcuts) are configurable by way of
the <link linkend="settings">Settings</link> menu.  By default &kedit;
honors the following key bindings.</para> 

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Key Binding</entry>
<entry>Action</entry>
</row>
</thead>
<tbody>
<!--  Insert mode appears to have disappeared again
<row>
<entry><keycap>Insert</keycap></entry>
<entry><action>Toggle between Insert and Overwrite mode.</action></entry>
</row>
-->
<row>
<entry><keycap>Left Arrow</keycap></entry>
<entry><action>Move the cursor one character leftwards.</action></entry>
</row>

<row>
<entry><keycap>Right Arrow</keycap></entry>
<entry><action>Move the cursor one character rightwards.</action></entry>
</row>

<row>
<entry><keycap>Up Arrow</keycap></entry>
<entry><action>Move the cursor one line upwards</action></entry>
</row>

<row>
<entry><keycap>Down Arrow</keycap></entry>
<entry><action>Move the cursor one line downwards.</action></entry>
</row>

<row>
<entry><keycap>Page Up</keycap></entry>
<entry><action>Move the cursor one page upwards.</action></entry>
</row>

<row>
<entry><keycap>Page Down</keycap></entry>
<entry><action>Move the cursor one page downwards.</action></entry>
</row>

<row>
<entry><keycap>Backspace</keycap></entry>
<entry><action>Delete the character to the left of the cursor.</action></entry>
</row>

<row>
<entry><keycap>Home</keycap></entry>
<entry><action>Move the cursor to the beginning of the line.</action></entry>
</row>

<row>
<entry><keycap>End</keycap></entry>
<entry><action>Move the cursor to the end of the line.</action></entry>
</row>

<row>
<entry><keycap>Delete</keycap></entry>
<entry><action>Delete the character to the right of the cursor.</action></entry>
</row>

<row>
<entry><keycombo action="simul">&Shift;<keycap>Left
Arrow</keycap></keycombo></entry>
<entry><action>Mark text one character leftwards.</action></entry>
</row>

<row>
<entry><keycombo action="simul">&Shift;<keycap>Right
Arrow</keycap></keycombo></entry>
<entry><action>Mark text one character rightwards.</action></entry>
</row>

<row>
<entry><keycombo
action="simul">&Ctrl;<keycap>A</keycap></keycombo></entry>
<entry><action>Select all the text in the document.</action></entry>
</row>

<row>
<entry><keycombo
action="simul">&Ctrl;<keycap>B</keycap></keycombo></entry>
<entry><action>Move the cursor one character leftwards.</action></entry>
</row>

<row>
<entry><keycombo action="simul">
&Ctrl;<keycap>C</keycap></keycombo></entry>
<entry><action>Copy the marked text to the clipboard.</action></entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;
<keycap>D</keycap></keycombo></entry>
<entry><action>Delete the character to the right of the
cursor.</action></entry>
</row>

<row>
<entry><keycombo
action="simul">&Ctrl;<keycap>E</keycap></keycombo></entry>
<entry><action>Move the cursor to the end of the line.</action></entry>
</row>

<row>
<entry><keycombo
action="simul">&Ctrl;<keycap>F</keycap></keycombo></entry>
<entry><action>Search for text in the document.</action></entry>
</row>

<row>
<entry><keycombo
action="simul">&Ctrl;<keycap>G</keycap></keycombo></entry>
<entry><action>Go to line.</action></entry>
</row>


<row>
<entry><keycombo
action="simul">&Ctrl;<keycap>H</keycap></keycombo></entry>
<entry><action>Delete the character to the left of the
cursor.</action></entry>
</row>

<row>
<entry><keycombo
action="simul">&Ctrl;<keycap>K</keycap></keycombo></entry>
<entry><action>Create a new document</action></entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;
<keycap>N</keycap></keycombo></entry>
<entry><action>Move the cursor one line downwards.</action></entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;
<keycap>P</keycap></keycombo></entry>
<entry><action>Print.</action></entry>
</row>

<row>
<entry><keycombo
action="simul">&Ctrl;<keycap>V</keycap></keycombo></entry>
<entry><action>Paste the clipboard text into the document at the text
cursor position.</action></entry>
</row>

<row>
<entry><keycombo action="simul">
&Ctrl;<keycap>X</keycap></keycombo></entry>
<entry><action>Cut the marked text, copying it to the
clipboard.</action></entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;
<keycap>Y</keycap></keycombo></entry>
<entry><action>Yank (paste) the content of the kill-buffer (clipboard)
into the document, at the current cursor position.</action></entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>

</chapter>

<chapter id="the-menu-entries">
<title>The Menu Entries</title>

<sect1 id="file">
<title>The <guimenu>File</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><anchor id="new"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice></term>
<listitem>
<para><action>This starts a new Document in a new instance of the
editor.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="open"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>Open...</guimenuitem>
</menuchoice></term> 
<listitem>
<para><action>This command opens a file.</action> It does this by means
of a dialog box which allows the user to navigate the file
system.</para>

<para>The dialog operates like a small file manager. Clicking on
folders displayed in the central window directs the dialog to enter
that folder - displaying its contents.  There is an entry/drop down
box which can be used to directly type in the location and name of the
file or by clicking the arrow at the side choose from a drop down list of
recently used locations.</para>

<para> Below this is a filter which similarly may have data entered
directly or chosen from a drop down list of recent filter types.  The
filter facility lets only files that meet its specifications be
displayed in the central window. If the filter contained text such as
<literal role="extension">*.txt</literal> then only files with the txt
extension would be visible in the selection window.</para>

<para>The toolbar has left and right arrow buttons that let the user
move back and forth through previously selected folders as well as
an up arrow button for moving up the folder tree. The button with the
little house takes the user to his or her home folder, and the one
with the two arrows curved in on each other updates the view of the
current folder. The flag button lets the user set a new bookmark at
the current folder or go to one that was previously set. The icon of
the folder with the sparkle on it, allows you to create a new
folder. Finally there is drop down box on the toolbar with a list of
some commonly frequented folders.</para></listitem>
</varlistentry>

<varlistentry>
<term><anchor id="open-recent"/><menuchoice>
<guimenu>File</guimenu><guimenuitem>Open
Recent</guimenuitem></menuchoice> 
</term>

<listitem>
<para><action>This is a shortcut to open recently saved
documents.</action> Clicking on this item opens a list to the side of
the menu with a list of several of the most recently saved
files. Clicking on a specific file will open it in &kedit; - if the file
still resides at the same location.  </para>
</listitem> 
</varlistentry>

<varlistentry> 
<term><anchor id="save"/><menuchoice><shortcut><keycombo
action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice></term>
<listitem>
<para><action>This saves the current document.</action> If there has
already been a save of the document then this will overwrite the
previously saved file without asking for the user's consent.</para>

<note>
<para>The editor can be configured to make a <link
linkend="backuppref">backup</link>.</para>
</note>

<para>If it is the first save of a new document the save as dialog
(described below) will be invoked.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="save-as"/><menuchoice>
<guimenu>File</guimenu><guimenuitem>Save
As...</guimenuitem></menuchoice></term>
<listitem>
<para><action>This allows a document to be saved with a new file
name.</action> This is done by means of the file dialog box described
above in the <link linkend="open">Open</link> section of this help
file.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="print"/><menuchoice>
<shortcut><keycombo
action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut> 
<guimenu>File</guimenu><guimenuitem>Print...</guimenuitem></menuchoice></term> 
<listitem>
<para><action>This opens a simple print dialog allowing the user to
specify what, where, and how to print.</action> The user can choose
between the standard <command>lpr</command> or a custom command as well
as whether to print the whole document or a selected section.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="mail"/><menuchoice>
<guimenu>File</guimenu><guimenuitem>Mail...</guimenuitem></menuchoice></term>
<listitem>
<para><action>This is used to email the current document.</action> It
calls a mail dialog whereby the user can enter the address and subject
for the message.</para>

<para>You may set your preferred mail client in &kcontrol;</para>

</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="close"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>W</keycap> </keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>Close</guimenuitem></menuchoice></term>
<listitem>
<para><action>This will close the editor window</action>, if you have
more than one instance of &kedit; running, those instances will not be
closed.</para> 
</listitem> 
</varlistentry>

<varlistentry>
<term><anchor id="quit"/><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap>
</keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem></menuchoice></term>
<listitem>
<para><action>This closes the editor.</action></para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="edit">
<title>The <guimenu>Edit</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><anchor id="undo"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem></menuchoice></term>
<listitem>
<para><action>This is used to eliminate or reverse the most recent user
action or operation.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="redo"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice></term>
<listitem>
<para><action>This will reverse the most recent change</action> (if any)
made using <guimenuitem>Undo</guimenuitem>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="cut"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem></menuchoice></term>
<listitem>
<para><action>This command deletes the current selection and places it
on the clipboard.</action> The clipboard is a feature of &kde; that
works invisibly to provide a way to transfer data between
applications.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="copy"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice></term>
<listitem>
<para><action>This copies the currently selected text to the clipboard
so that it may be pasted elsewhere.</action> The clipboard is a feature
of &kde; that works invisibly to provide a way to transfer data between
applications.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="paste"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice></term>
<listitem>
<para><action>This will insert the contents of the clipboard at the
cursor position.</action> The clipboard is feature of &kde; that works
invisibly to provide a way to transfer data between applications.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="select-all"/><menuchoice>
<shortcut><keycombo
	  action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Select
All</guimenuitem></menuchoice></term>
<listitem>
<para><action>This will select the entire document.</action> This could
be very useful for copying the entire file to another
application.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="find"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice></term>
<listitem>
<para><action>This opens the find dialog</action> which is used to
specify the text to <guilabel>Find</guilabel> in the document. There is
small text box for entering the search pattern. Two other options are
included to make the search more efficient. Selecting <guilabel>Case
sensitive</guilabel> will limit finds to entries that match the case
(upper or lower) of each of the characters in the search
pattern. <guilabel>Find backwards</guilabel> directs the search to
proceed in an upwardly direction.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="find-again"/><menuchoice> <shortcut><keycombo
action="simul"><keycap>F3</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Find
Next</guimenuitem></menuchoice></term>
<listitem>
<para><action>This repeats the last find operation, if any, without
calling the find dialog box.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="replace"/><menuchoice> <shortcut><keycombo
action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Replace...</guimenuitem></menuchoice></term>
<listitem>
<para><action>This command opens the replace dialog box.</action> The
replace dialog is similar to the above-mentioned find dialog but with
the addition of a <guilabel>Replace with:</guilabel> text box.  Using
this dialog the user can specify both the text to be found and text with
which to replace it. This dialog also contains two additional buttons.
The <guilabel>Replace</guilabel> button allows the user to make one
replacement at a time which is useful when not all instances of the
searched for text should be replaced.  The <guilabel>Replace
All</guilabel> button should be used with caution as it will immediately
replace every instance of the specified text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="insertfile"/>
<menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Insert
File...</guimenuitem></menuchoice></term>
<listitem>
<para>This opens the <guimenu>File</guimenu><link
linkend="open"><guimenuitem>Open</guimenuitem></link> dialog box whereby
the user can <action>insert a complete file in the open
document.</action> The file will be entered at the position of the
blinking text cursor.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="insertdate"/>
<menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Insert
Date</guimenuitem></menuchoice></term>
<listitem>
<para><action>This will enter the current date at the position of the
blinking text cursor.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="cleanspaces"/>
<menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Clean
Spaces</guimenuitem></menuchoice></term>
<listitem>
<para>Choosing this item will remove from any <emphasis>selected
text</emphasis> any extra spaces and all carriage returns (the code for
the end of a paragraph brought about by pressing the
<keycap>Enter</keycap> key.)<action> In other words, any occurrences of
two or more spaces will be reduced to one space; and all paragraphs and
blank lines will be reduced to one single
paragraph.</action></para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="Go">
<title>The <guimenu>Go</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><anchor id="go-to-line"/><menuchoice>
<shortcut><keycombo action="simul">
&Ctrl;<keycap>G</keycap></keycombo></shortcut>
<guimenu>Go</guimenu><guimenuitem>Go to
Line...</guimenuitem></menuchoice></term>
<listitem>
<para><action>This opens the goto line dialog box which is used to have
the cursor jump to a particular line (specified by number) in the
document.</action> The line number may be entered directly into the text
box or graphically by clicking on the up or down arrow spin controls at
the side of the text box. The little up arrow will increase the line
number and the down arrow decrease it.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="tools">
<title>The <guimenu>Tools</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><anchor id="Spelling..."/><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Spelling...</guimenuitem></menuchoice></term>
<listitem>
<para><action>This initiates the spell checking program - a program
designed to help the user catch and correct any spelling
errors.</action> Clicking on this entry will start the checker and bring
up the speller dialog box through which the user can control the
process.  There are three text boxes lined up vertically just to the
left of center with their corresponding labels further to the left.
Starting at the top they are:</para>

<variablelist>
<varlistentry>
<term><guilabel>Misspelled word:</guilabel></term>
<listitem>
<para>Here, the spell checker indicates the word currently under
consideration.  This happens when the checker encounters a word not in
its dictionary - a file containing a list of correctly spelled words
against which it compares each word in the editor.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Replacement:</guilabel></term>
<listitem>
<para> If the checker has any similar words in its dictionary the first
one will be listed here.  The user can accept the suggestion, type in
his or her own correction, or choose a different suggestion from the
next box.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Suggestions:</guilabel></term>
<listitem>
<para>The checker may list here a number of possible replacements for
the word under consideration.  Clicking on any one of the suggestions
will cause that word to be entered in the
<guilabel>Replacement:</guilabel> box, above.</para>
</listitem>
</varlistentry>
</variablelist>

<para>On dialog box are 8 buttons that allow the user to control the
spell check process.  They are:</para>

<variablelist>
<varlistentry>
<term><guibutton>Replace</guibutton></term>
<listitem>
<para>This button has the checker replace the word under consideration
in the document with the word in the <guilabel>Replacement:</guilabel>
box.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Replace All</guibutton></term>
<listitem>
<para>This button causes the checker to replace not only the current
<guilabel>Misspelled Word:</guilabel> but to automatically make the same
substitution for any other occurrences of this <guilabel>Misspelled
Word:</guilabel> in the document.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Ignore</guibutton></term>
<listitem>
<para>Activating this button will have the checker move on without
making any changes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Ignore All</guibutton></term>
<listitem>
<para>This button tells the checker to do nothing with the current
<guilabel>Misspelled Word:</guilabel> and to pass over any other
instances of the same word.</para>

<note>
<para>This only applies to the current spell check run.  If the checker
is run again later it will stop on this same word.</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Add</guibutton></term>
<listitem>
<para>Pressing this button adds the word in the <guilabel>Misspelled
Word:</guilabel> box to the checker's dictionary. This means that in the
future the checker will always consider this word to be correctly
spelled.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Help</guibutton></term>
<listitem>
<para>This invokes the &kde; help system starting at the &kedit; help
pages (this document).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Stop</guibutton></term>
<listitem>
<para>This button stops the spell check process.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Cancel</guibutton></term>
<listitem>
<para>This button cancels the spell check process.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Located horizontally along the bottom of the spell check dialog is
a progress bar.  As the checking process proceeds the bar will fill from
left to right providing a graphical representation of how far along in
the document the process has reached.</para>

<note>
<para>A numerical display of the spell check process is simultaneously
displayed in the status bar of the editor.  The <link
linkend="show-statusbar">status bar</link> is the horizontal strip at
the bottom of the editor just outside of the text entry area.</para>
</note>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings">
<title>The <guimenu>Settings</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><anchor id="show-toolbar"/><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Show
Toolbar</guimenuitem></menuchoice></term>
<listitem>
<para><action>When checked, this displays a movable toolbar containing
buttons used to initiate frequently used commands. The toolbar is most
commonly located at the top of the editor just under the menu.  When
unchecked the toolbar is hidden.</action> Clicking on the striated grip
will hide or unhide the bar. Clicking and dragging on this grip allows
the user to move the bar.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="show-statusbar"/><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Show
Statusbar</guimenuitem></menuchoice></term>
<listitem>
<para><action>When checked, this displays a small bar at the bottom of
the editor containing information about the status of the current
document. When unchecked the status bar is hidden.</action> </para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="save-options"/><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Save
Settings</guimenuitem></menuchoice></term>
<listitem>
<para><action>This saves the current editor settings to be used for
future documents.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="configure-keybindings"/><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure
Shortcuts...</guimenuitem></menuchoice></term>
<listitem>
<para>This command opens a dialog box whereby the <link
linkend="keybindings">key bindings</link> may be changed. A display
window at the top of the dialog box shows the list of commands
available. Below the display are three radio buttons.  The user may
choose a modifier key from <guilabel>None</guilabel>,
<guilabel>Default</guilabel>, and <guilabel>Custom</guilabel>.</para>

<note>
<para>Note that a set of radio buttons only allows the selection of one
of the offered items - in the way that buttons on a car radio only offer
the selection of one preset station.  Also, the Default Key selection is
only available for those commands that actually have a
<quote>default</quote> shortcut.)</para>
</note>

<para>
Selecting the Custom key option activates the three check boxes and key
button at the bottom of the dialog. The user may then select a
combination of keys for the command in question by means of the check
boxes and key button. For example, with the About &kde; command selected
in the display window, the user could select &Ctrl; and &Alt;, click on
the key button, and then press the <keycap>K</keycap> key on the
keyboard.  This would mean that anytime he or she held down the &Ctrl;
and &Alt; buttons and pressed <keycap>K</keycap> (while using &kedit;)
the About &kde; display box would be called. </para>
</listitem>
</varlistentry>
<varlistentry>

<term><anchor id="configure-toolbars"/><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure
Toolbars...</guimenuitem></menuchoice></term>

<listitem>
<para><action>This will open the dialog whereby the toolbar
configuration may be changed.</action> The user can choose which
shortcut buttons should appear on the toolbar, as well as whether and
where any text should appear with the buttons. Other choices include
button (icon) size and toolbar location (top, left, right, floating, or
flat.)  Flat causes the toolbar to be retracted. A click on the striated
grip icon will extend it for use and another click retract it again.  A
display window on the left lists the commands available to be placed on
the toolbar.  A display on the right lists those commands already on the
toolbar.  A set of four arrow buttons between the two displays
manipulates the selections.  The right pointing arrow places any command
selected in the left pane onto the right pane, &ie;, it is added to the
toolbar.  The left arrow does just the opposite, removing any action
selected in the right window from the toolbar.  The up and down pointing
arrows change the position of an action selected in the right window
which changes the position of its button in the toolbar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="preferences"/><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure KEdit...</guimenuitem></menuchoice></term>
<listitem>
<para>This menu item opens a dialog whereby several different <link
linkend="pref-dialog">settings</link> may be adjusted.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="help">
<title>The <guimenuitem>Help</guimenuitem> Menu</title>

&help.menu.documentation;

</sect1>
</chapter>

<chapter id="pref-dialog">
<title>The Preferences Dialog</title>

<para>Selecting
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
KEdit</guimenuitem></menuchoice> from the menu brings up the preferences
dialog box.  This dialog can be used to alter a number of different
settings.  The settings available for change vary according to which
category the user chooses from a vertical list on the left side of the
dialog.  By means of a row of five buttons along the bottom of the box
the user can control the process.  She or he may invoke the
<guilabel>Help</guilabel> system, set the options to their
<guilabel>Default</guilabel> values, accept the current settings and
close the dialog by means of the <guibutton>OK</guibutton> button,
<guibutton>Apply</guibutton> the current choices to the document without
closing the dialog, or <guibutton>Cancel</guibutton> the process. The
categories <guilabel>Font</guilabel>, <guilabel>Color</guilabel>,
<guilabel>Spelling</guilabel>, and <guilabel>Miscellaneous</guilabel>
are detailed below.</para>

<sect1 id="preffont">
<title>Font</title>

<para>The preferences dialog opens with this, the first category,
chosen.  Here the user can change four settings and see the effects of
any changes in the text sample displayed in the rectangle at the bottom
or the box.  The settings are:</para>

<variablelist>

<varlistentry>
<term><guilabel>Font:</guilabel></term>
<listitem>
<para>This scroll box allows the user to select by name from among the
various fonts available.  The appearance of any selected font may be
seen in the sample text displayed in the rectangle at the bottom of the
dialog.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Font style:</guilabel></term>
<listitem>
<para>This, the center, selection box is used to choose between the four
basic styles of Regular, Italic, Bold, and Bold Italic.  The appearance
of the selected style may be seen in the sample text displayed in the
rectangle at the bottom of the dialog. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Size:</guilabel></term>
<listitem> 
<para>This, the rightmost scroll/selection box allows the user to change
font size.  The larger the number chosen the larger the font size will
be.  The sample text displayed in the rectangle at the bottom of the
dialog will reflect the choice of size.</para> 
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="prefcolors">
<title>Color</title>

<para>This section provides access to <link
linkend="pref-color-settings">two different color settings</link>,
described below.  Each of these settings may be changed by clicking on
its corresponding button.  These are special wide buttons that are the
color of the current setting.  Clicking on one of the buttons calls a
special color dialog box used to change the setting.</para>

<para>The color dialog box provides a convenient and graphical way to
select a color.  In the upper left of the box is a rectangular display
of a spectrum of colors. To the immediate right of this, is a vertical
bar displaying a range of intensity from the most dark at the bottom to
the most light at the top.  The user may select and adjust a color by
clicking in these two boxes. Clicking in the rectangular display selects
a particular mix of red, green, and blue colors and in the vertical bar
selects a level of intensity (value).  The various color attributes are
displayed in numerical form in small text boxes located directly below
the spectral rectangle and the user can see them change as the color is
adjusted.  These attributes include the mix of the basic color
components (red, green, and blue) as well as hue and saturation levels.
Alternatively the user can enter figures directly in these boxes.  There
is also a square at the bottom center of the dialog box which displays
the color which is under consideration at any time.  To the right of
this display is another text box labeled <guilabel>HTML</guilabel>: This
shows the user the color code that would be used to specify the
particular displayed color in <acronym>HTML</acronym> code which is
widely used for web pages.</para>

<para>In addition to the above, the color dialog allows the capture of
any color currently displayed on the desktop or in another program.
Clicking on the button with the dropper icon (located on the right side
of the dialog box) changes the shape of the mouse cursor to a set of
cross hairs.  Clicking again will pick up the color attributes of
whatever color is displayed under the cross hairs.</para>

<para>Furthermore the user has the option of adding any color to a
personal palette of <guilabel>Use custom colors</guilabel> by clicking on
the wide button labeled <guibutton>Add to Custom Colors</guibutton>
(which is located above the display square.)  This adds the current
color to the custom color palette.  This palette and any other available
palettes can be displayed using the drop down selection box located
directly above the palette display at the top right of the dialog box.
Besides the custom colors, the user can access a number of pre-prepared
palettes.</para>

<variablelist>
<varlistentry>
<term><guilabel>Use custom colors</guilabel></term>
<listitem>
<para>By default &kedit; will use your system color scheme.  If this
is enabled, you may choose a Foreground and background color below.</para>
</listitem>
</varlistentry>

<varlistentry id="pref-color-settings">
<term><guilabel>Foreground color:</guilabel></term>
<listitem>
<para>Here the user can specify a color for the text used in
&kedit;.</para>
</listitem> 
</varlistentry>

<varlistentry>
<term><guilabel>Background color:</guilabel></term>
<listitem>
<para>Here the user can specify a color for the general background of
&kedit;.</para>
</listitem> 
</varlistentry>

</variablelist>

</sect1>

<sect1 id="prefspellchecker">
<title>Spelling</title> 

<para>A spell checker is a program designed to help the user catch and
correct any spelling errors.  This section of the preferences dialog
allows certain key settings to be adjusted in this regard.</para>

<variablelist>
<varlistentry>
<term><guilabel>Create root/affix combinations not in
dictionary</guilabel></term>
<listitem>
<para>Selecting this option allows the spell checker to register as
<quote>correct</quote> combinations of root words with suffixes or
prefixes even if the particular combination is not listed in its
dictionary database of words. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Consider run-together words as spelling
errors</guilabel></term>
<listitem>
<para>Selecting this will cause the spell checker to register as
<quote>misspelled</quote> two or more correctly spelled words that are
<quote>run-together</quote>, &ie;, that do not have spaces separating
them.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Dictionary:</guilabel></term> 
<listitem>
<para>Depending on the user's installation, one or more different
language spelling dictionaries may be available.  This drop down box
allows the user to choose which language the spell checker should
use.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Encoding:</guilabel></term> 
<listitem>
<para>There are different coding systems used to associate particular
codes with particular characters and symbols.  If the user knows which
code he or she is using this drop down box allows this code to be
specified so that the spell checker can do its job correctly. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Client:</guilabel></term> 
<listitem>
<para>Since &kedit; does not contain its own spell checker, an external
one must be chosen. This is where the user may specify which spell check
program to use.</para> 
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="prefmisc">
<title>Miscellaneous</title>

<para>This category deals with three different properties detailed
below.</para>

<variablelist>
<varlistentry>
<term><guilabel>Word wrap:</guilabel></term>
<listitem>
<para>Word wrap is a feature that causes the editor to automatically
start a new line of text and move (wrap) the cursor to the beginning of
that new line.  The drop down box at the top of the dialog provides the
following three word wrap choices:</para>

<variablelist>
<varlistentry>
<term>Disable Wrapping</term>
<listitem>
<para>Choosing this will keep the editor from doing any wrapping.  The
user will have to start new lines manually (with the
<keycap>Enter</keycap> key.)</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Soft wrapping</term>
<listitem>
<para>This choice has the editor automatically adjust the line lengths
to fit its current width.  In other words, the wider the user makes the
editor the longer the lines will be; and the narrower the editor, the
shorter the lines will be.  These line breaks are not saved in the file.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>At specified column</term>
<listitem>
<para>Choosing this activates a text box immediately below, labeled
<guilabel>Wrap column:</guilabel>.  Here the user may specify the
maximum number of characters in a line of text.
</para>  

<note>
<para>Each character including spaces fills one column.</para>
</note>
</listitem>

</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term id="backuppref"><guilabel>Make backup when saving a
file</guilabel></term>
<listitem>
<para>This check box tells the editor to rename the last saved version of
the current document before carrying out a <command>save</command>
command.  The editor does this by adding a tilde (<keycap>~</keycap>) at
the end of the name of the original file.  In this way the user has a
chance to recover a document if she or he had mistakenly saved something
over it.</para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

</chapter>

<chapter id="credits">
<title>Credits and Licenses</title>

<para>&kedit; Copyright 2000 by Bernd Johannes Wuebben
<email>wuebben@math.cornell.edu</email></para>

<para>Documentation Copyright 2000 by Thad McGinnis
<email>ctmcginnis@compuserve.com</email>.</para>

<para>This version of the &kedit; Handbook is based on the original by:
Bernd Johannes Wuebben <email>wuebben@math.cornell.edu</email></para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title>Installation</title>  

<sect1 id="getting-kedit">
<title>How to obtain &kedit;</title>

&install.intro.documentation;

</sect1>

<sect1 id="compilation">
<title>Compilation and Installation</title>

&install.compile.documentation;

</sect1>

</appendix>

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->