summaryrefslogtreecommitdiffstats
path: root/doc/knode/using-firststart.docbook
blob: 945b26fd257b467977642f04ec211dc9f16e67d5 (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
<!-- <?xml version="1.0" ?>
<!DOCTYPE sect1 PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN"
"dtd/kdex.dtd"> -->
<sect1 id="first-start">
<title>The first start</title>

<para>You can find &knode; in the <guimenu>K</guimenu> Menu under the
<guisubmenu>Internet</guisubmenu> entry: the menu entry
<guimenuitem>KNode</guimenuitem> launches the program.</para>

<tip>
<para>If the entry for &knode; can not be found or if &knode; does
not appear after clicking on the menu entry, read <link
linkend="faq">Questions and Answers</link>.</para>
</tip>

<para>The main window of &knode; should now be displayed on your
desktop as shown; on the first start, the settings dialog will be
invoked.</para>

<screenshot>
<screeninfo>Setting up &knode;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-start.png" format="PNG"/></imageobject>
<textobject>
<phrase>&knode; after first start</phrase>
</textobject>
<caption>
<para>&knode; after first start</para>
</caption>
</mediaobject>
</screenshot>

<para>The windows shows the menu bar, the toolbar below and the status
pane at the buttom. The area between the toolbar and the status pane
is occupied by a three-part window.</para>

<para>There is a folder view, which currently contains only three
entries:</para>

<simplelist>
<member>The folder <guilabel>Outbox</guilabel></member>
<member>The folder <guilabel>Drafts</guilabel></member>
<member>The folder <guilabel>Sent</guilabel></member>
</simplelist>

<para>When &knode; is completely and correctly configured, the news
servers and the subscribed news groups will appear there.</para>

<para>In the upper section is the article view; it is currently empty
and does not show any articles. Directly below the article view is the
article window; the body of the currently-selected article
appears there. These windows are also blank at the moment, as there
are no articles, of course. You should not be concerned, though, as before
reading and publishing news some things have to be configured; this
will be covered by the following section.</para>

<para>We are now beginning the setting up of &knode;. Most settings
are not important for daily use, but you should know what settings are
possible and what they are for. Some may skip the
<quote>Quickstart</quote> chapter but those who prefer a quick start
will just glance over the manual anyway. For others, especially those
who have not any or much experience with a news reader, this chapter
offers the chance to fully perform the configuration, although some
things may become clear only later on.</para>

<sect2 id="setting-your-identity">
<title>Personal settings</title>

<anchor id="anc-setting-your-identity"/>

<para>Via
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
KNode...</guimenuitem></menuchoice> you will enter the preferences
dialog of &knode;. The figure shows the dialog.</para>

<screenshot>
<screeninfo>Dialog for entering personal information</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-identity.png" format="PNG"/></imageobject>
<textobject>
<phrase>Entering personal information</phrase>
</textobject>
<caption>
<para>Entering personal information</para></caption>
</mediaobject>
</screenshot>

<para>The dialog is divided into two parts: in one part there is a treeview, in
which the top entry <guilabel>Identity</guilabel> is already
highlighted; in the other part is the corresponding input
dialog -- these settings relate to the identity with which you navigate
through the newsgroups.</para>

<tip>
<para>If you have already configured your personal settings in the
&kcontrolcenter; before the first start of &knode;, they will be
adopted.</para>
</tip>

<sect3>
<title><guilabel>Name</guilabel></title>

<para>In the field <guilabel>Name</guilabel> you enter your name, &eg;
<replaceable>Joe Miller</replaceable> or <replaceable>Mary
Gordon</replaceable>. This name will later appear in the newsgroups as
sender, and can be seen by anyone.</para>

<para>Filling out the field <guilabel>Name</guilabel> is
mandatory.</para>

<caution>
<para>
In most newsgroups, it is considered polite and appropriate to appear
with one's real name; other newsgroups are less strict about this. But,
there are also cases when one would not want to appear with one's real
name, &eg; in newsgroups where one would like to (and can) talk about
very personal matters without being exposed; these groups mostly do
tell you in their Charter that the anonymity of their members is
explicitly approved.</para>
</caution>

<tip>
<para>For those special cases, &knode; offers settings that can be
adjusted to each newsgroup individually; further information can be
found under <link linkend="group-identity">Group local
Identities</link>.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Organization</guilabel></title>

<para>The input field <guilabel>Organization</guilabel> is optional
and does not have to be filled out. You can enter, &eg;, the name of
your company or your university if you use &knode;
there; if you leave this field blank, it will often be filled out
later by your Internet service provider.</para>
</sect3>

<sect3>
<title><guilabel>Email address</guilabel></title>

<para>The email address you enter here will be used as sender in news
articles, &ie; as actual address of the author, in conjunction with
the real name (set in the field <guilabel>Name</guilabel>).</para>

<para>The field <guilabel>Email Address</guilabel> shows up when
someone wants to reply to you by email: the email will be sent to
the address entered here. Many newsreaders display the sender address
together with the name in the Header of the article.</para>

<para>Filling out the <guilabel>Email Address</guilabel> field is
mandatory.</para>
<tip>
<para>Note that the e-mail address will only be used for replies to you if
the field <guilabel>Reply-to Address</guilabel> is not filled out; in
this case, the field <guilabel>Email</guilabel> will be ignored for
replies and the address given under <guilabel>Reply-to
Address</guilabel> will be used.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Reply-to Address</guilabel></title>

<para><guilabel>Reply-to Address</guilabel> offers you the possibility
to enter a different address than your sender e-mail address: if
someone replies to you by email this address will be displayed as
target address in the reply. An example for using <guilabel>Reply-to
Address</guilabel> would be that you write the article at the office
during the day but want to receive the answer in your home inbox,
because your boss co-reads your mail.</para>

<para>Only enter an e-mail address in that field if it actually
differs from the field <guilabel>Email Address</guilabel>.</para>

<warning>
<para>Some news readers deliberately set this to an invalid e-mail
address in order to prevent spam mails from being received; what could
happen, though, is that a reader sends an e-mail to this invalid address
which you will therefore never receive. You should drop a note about
this in the signature.</para>
</warning>
</sect3>

<sect3>
<title><guilabel>Mail-Copies-To</guilabel></title>

<para>If you enter an email address here every article will be sent
to the usenet and to this email address.</para>
</sect3>

<sect3>
<title><guilabel>Signing Key</guilabel></title>

<para>If you have configured the use of <acronym>PGP</acronym> or
GnuPG you can chose your signing key with
<guibutton>Change...</guibutton>. </para>
</sect3>

<sect3>
<title><guilabel>Use a signature from file</guilabel></title>

<para>If this option is selected, the file specified under
<guilabel>Signature File</guilabel> will be used as Signature.</para>
</sect3>

<sect3>
<title><guilabel>Signature File</guilabel></title>

<para>The field <guilabel>Signature File</guilabel> determines the
file, the content of which is appended to each of your articles. The
field is only enabled if the option <guilabel>Use a signature from
file</guilabel> is selected.</para>

<para>The signature file is a simple text file, which should not
contain more than four lines; it can, for example, contain a reference
to your homepage with the corresponding link, your postal address with
your telephone number (which would then be of course visible to the
whole world with every article) or just a cool quote. The signature is
your brand, so to speak, which will mark all your articles; therefore,
your signature should not be designed sloppily or in the long run annoying
to others: an old joke that one would have to read over and over again
does not foster sympathy or the interest of the other newsgroup
subscribers.</para>

<para>You can directly enter the file name of the signature file but
it is more convenient to use the button
<guibutton>Choose...</guibutton>. This opens a file open dialog and
you can conveniently choose the signature file with the mouse. The
button <guibutton>Edit File</guibutton> enables you, after choosing
the file, to edit the signature.</para>

<tip>
<para>It is not necessary to include a separation line in the
signature file as &knode; inserts it automatically.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>The file is a program</guilabel></title>

<para>If this option is activated, the signature file is not handled
as a text file, but as a program. The signature file will be started
as a program and the output will be used as a signature. Through that
you'll be able to chose a signature by accident or to use fortune to
generate a cool slogan every time.</para>

</sect3>

<sect3>
<title><guilabel>Specify signature below</guilabel></title>

<para>If this option is selected you can enter the text of the
signature directly in the input field below.</para>

<tip>
<para>Please make sure that in this case also your
<glossterm>signature</glossterm> should not contain more than 4
lines. A separation line is not necessary as &knode; inserts it
automatically.</para>
</tip>
</sect3>

<sect3>
<title>General notes</title>

<para>You can later adapt the identity individually for each of the
subscribed groups via the <guilabel>Preferences</guilabel> dialog,
&eg; you can specify an English signature for English groups and a
German one for German groups. Apart from the language it is also
possible to have context-sensitive signatures, &eg; your favorite
recipe in a cooking group or the names of your twelve cats in a cat
owner group.</para>

<para>You find more in the section <link
linkend="group-identity">Group local identities</link>.</para>

<para>The next step in the configuration covers the news
account.</para>

</sect3>
</sect2>

<sect2 id="setting-the-news-account">
<title>Configuring the news account</title>
<anchor id="anc-setting-the-news-account"/>

<para>Now we must tell &knode; about where we get the news from or
where to send the articles to later on. In the tree view on the
right, there is an <guilabel>Accounts</guilabel> entry; click on it
with the mouse; then, two sub entries will be opened out. Choose the
<guilabel>News</guilabel> entry, because we first want to configure
the news account: the list of accounts is still empty.</para>

<para>To create a new account click on <guibutton>New...</guibutton>. The
following dialog appears:</para>

<screenshot>
<screeninfo>The <guilabel>New Account</guilabel> dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-news-account.png" format="PNG"/></imageobject>
<textobject>
<phrase>The <guilabel>New Account</guilabel> dialog</phrase>
</textobject>
<caption>
<para>The <guilabel>New Account</guilabel> dialog</para>
</caption>
</mediaobject>
</screenshot>

<sect3>
<title><guilabel>Name</guilabel></title>

<para>The <guilabel>Name</guilabel> field can be filled in as you
like; the text you enter will later be visible in the folder view. You
could, for example, enter the name of your Internet Provider; for our example we
enter the name <userinput>My News Account</userinput>.</para>

</sect3>

<sect3>
<title><guilabel>Server</guilabel></title>

<para>The next field is labelled <guilabel>Server</guilabel>. Unlike
the field <guilabel>Name</guilabel>, what you enter here is
important. The name of the news server is fixed and you should be able
to get it from your Internet service provider; if you do not know the name
of the news server, you should get it now: without this information you can
not read any news. If your Internet service provider doesn't own a
news server you can use a public one (universities often provide public news
servers.)</para>

<para>For our example configuration we enter the name
<userinput><systemitem
class="systemname">news.server.com</systemitem></userinput>; you will,
of course, enter the real name of your news server.</para>

<tip>
<para>If you want to use &knode; with a local news server, enter the name
<userinput><systemitem
class="systemname">localhost</systemitem></userinput> here.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Port</guilabel></title>

<para><guilabel>Port</guilabel>, the next field, has already a default
value. The Port designates, roughly speaking, a data channel on which
the server listens for whether someone wants to retrieve news: it
defaults to the value 119, which is applicable in most
cases; therefore, we do not change this default for our example.</para>
</sect3>

<sect3>
<title><guilabel>Hold connection for</guilabel></title>

<para>The time value you enter here is used if you have
established a connection to the news server and if, for whatever
reason, no data is received from or transmitted to the news
server: after the specified time has elapsed &knode; will automatically
disconnect. This, amongst other things, relieves the server of
unnecessary connections which would otherwise reduce its availability
for other subscribers; it also makes sure that an automatically-established
Internet connection is not held unnecessarily even if no data is
being sent or received.</para>

<tip>
<para>This settings mainly makes sense if one receives and reads
news online; for local news servers it is of almost no importance. If
this waiting time is set too low, there can be waiting periods if you
read a longer article and do not do <quote>anything</quote> for some
time: &knode; will have canceled the connection to the server by then (after
the time period has elapsed) and has to reestablish it, causing a delay.</para>
<para> If the waiting time is set too high you might waste online
time whilst doing nothing (perhaps increasing your phone bill).</para></tip>
</sect3>

<sect3>
<title><guilabel>Timeout</guilabel></title>

<para>If &knode; connects to the news server it waits no longer than the
time specified here for an answer; if the period is exceeded &knode; cancels
the connection attempt and you will get an error message stating that the
server is not responding.</para>

<tip>
<para>Depending on the quality of your Internet account and the
news server's current load there can be busy periods where
&knode; cancels the connection; if this happens frequently, you should
set this setting to a higher value.</para>
</tip>
</sect3>

<sect3>
<title>
<guilabel>Fetch group descriptions</guilabel></title>

<para>If this setting is selected, &knode; additionally requests the
available group descriptions; they will be displayed in the 
<guilabel>Subscribe to Newsgroups</guilabel> dialog.</para>

<tip>
<para>There is not a group description for every group, so it is not
an error if no group description is shown when subscribing to a group
later on.</para>
</tip>

</sect3>

<sect3>
<title><guilabel>Server requires authentication</guilabel></title>

<para>The option <guilabel>Server requires authentication</guilabel>
needs only to be selected if your news server requires a user name and
a password when retrieving articles; you can find out if this is the case
from your Internet service provider or the server's
maintainer.</para>

<tip>
<para>If you do not know if this setting is necessary forget
about selecting it for now: if you encounter an error later on, you can
try selecting it then. Otherwise, select this option and enter your user name
under <guilabel>User</guilabel> and the associated password
under <guilabel>Password</guilabel>.</para>
</tip>
</sect3>

<sect3>
<title>General notes</title>

<para>By now you have completed the setup of your news account. You can
confirm and save your settings by clicking on the
<guibutton>OK</guibutton> button: as soon as you have done that,
the account will appear in the list by the name that you entered in
<guilabel>Name</guilabel> earlier; and, if you have a close look, you
will see that the account also appears in the folder view.</para>

<para>Using the <guibutton>Subscribe</guibutton> button you could
get directly to the dialog for subscribing to news groups; but, we
still have more to do so we'll ignore it for now: there are several ways
that lead to the goal.</para>

<para>In the <link linkend="multiple-news-accounts"> Managing
multiple news accounts</link> chapter you can learn how to work with multiple
news accounts, but first we will stay with this one; in most cases,
one account is sufficient.</para>

<caution>
<para>Please note that some Internet providers only allow retrieving
news from their news server if you are connected to the Internet
through them.</para>
</caution>

<para>We will now move on to configuring the email account; in order
to do that, click on the <guilabel>Mail</guilabel> entry in the tree
view on the left.</para>

</sect3>
</sect2>

<sect2 id="setting-the-mail-account">
<title>Setting up the mail account</title>

<para>After selecting <guilabel>Mail</guilabel> in the tree view, the
following dialog box appears.</para>

<screenshot>
<screeninfo>Dialog box for setting up the mail account</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-mail-account.png" format="PNG"/></imageobject>
<textobject>
<phrase>Setting up the mail account</phrase>
</textobject>
<caption>
<para>Setting up the mail account</para>
</caption>
</mediaobject>
</screenshot>

<para>You will notice this dialog box is very similar to the news
account settings dialog box; but why do we need an email account in a
newsreader?</para>

<para>Sometimes you need to answer to the author of an article
directly, without posting to the newsgroup; for example, when you want
to make a very personal comment or want to correct an error. Sometimes
an email is more appropriate than a public remark.</para>

<para>That's why &knode; provides the possibility to reply by
email; if you want to use this feature you must tell &knode; how to
send emails: you just need to insert the mail server's address. If you have
already configured an email account, &eg; with &kmail;, you can reuse
the settings used there.</para>

<sect3>
<title><guilabel>Use external mail program</guilabel></title>

<para>If this option is active &knode; will use the mail program
which is configured in the control center; the other options in this
dialog will then be disabled.</para>

</sect3>

<sect3>
<title><guilabel>Server</guilabel></title>

<para>The name (address) of your mail server as provided by your Internet
service
provider or system administrator; all you have to do here is enter the mail
server's
name in the <guilabel>Server</guilabel> field.</para>

<para>In our example we enter<userinput><systemitem
class="systemname">mail.server.de</systemitem></userinput></para>

<tip>
<para>If you have one you can send your mail via a local mail
server; if this is the case local mail server enter <systemitem
class="systemname">localhost</systemitem> in the
<guilabel>Server</guilabel> field.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Port</guilabel></title>

<para>Again, the <guilabel>Port</guilabel> field has a default
value; in this case it's port 25. You should not need to change this,
unless your <acronym>ISP</acronym> has a very exotic configuration
and tells you to do so. We do not change this for the example.</para>

</sect3>

<sect3>
<title>Hold connection for</title>

<para>This value is important: if you have established a connection
with your mail server and there is no data transfer occurring &knode;
cancels the connection to your mailserver after the specified amount
of time has elapsed.</para>

</sect3>

<sect3>
<title><guilabel>Timeout</guilabel></title>

<para>When &knode; tries to connect to the mail server it will wait this
long for a reply from the server; if this time is exceeded, you will get a
error message.</para>

<tip>
<para>Depending on the quality of your connection and the actual load
of your mail server you might get long reply times; if &knode; cancels
the connection due to this, you should increase the timeout.</para>
</tip>
</sect3>

<sect3>
<title>General notes</title>

<caution>
<para>Some <acronym>ISP</acronym>s only allow you to send email using
their mail server after you have checked your mailbox for new mail: this
reduces spamming.</para>

<para>For the same reasons, some <acronym>ISP</acronym>s will only allow you
to send mail using their mailservers if you are online with them
or if you are logged in at the mailserver; for example, this is the normal
configuration at GMX and isn't supported by &knode; or &kmail; yet.</para>
</caution>

</sect3>
</sect2>

<sect2 id="knode-appearance">
<title>Defining the appearance</title>

<para>With the <guilabel>Appearance</guilabel> dialog you are given
the ability to set the colors, the character code and the font size of
the text in the article window; the picture below shows the
dialog.</para>

<screenshot>
<screeninfo>Setting up the Appearance dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-colors-fonts.png" format="PNG"/></imageobject>
<textobject>
<phrase>Setting up the Appearance dialog</phrase>
</textobject>
<caption>
<para>Setting up the Appearance dialog</para>
</caption>
</mediaobject>
</screenshot>

<sect3>
<title><guilabel>Use custom colors</guilabel></title>

<para>If you select this option you can adjust the color settings of
&knode; in the list field below; to change a color setting do a
double-click with the &LMB; on the list entry to open the &kde;
color-selection dialog.</para>

<para>The color selection can only be configured after the checkbox
has been checked; otherwise, a double-click on the list entries
won't do anything.</para>

<caution>
<para>If the <guilabel>Use custom colors</guilabel> setting is
selected &knode; won't use colors which have been changed later
globally for &kde; but will only use the colors defined here
instead.</para>
</caution>
</sect3>

<sect3>
<title><guilabel>Use custom fonts</guilabel></title>

<para>If you select this setting you can adjust the fonts which
&knode; uses for the display in the list field below; to choose a
font do a double-click with the &LMB; on the list entry to open the
&kde; font-selection dialog.</para>

<para>The font can only be configured after the checkbox has been
checked; otherwise, a double click on the list entries won't do
anything.</para>

<caution>
<para>If the setting <guilabel>Use custom fonts</guilabel> is
selected &knode; won't use later changes to the global font settings
for &kde; but will use the fonts defined here instead.</para>
</caution>
</sect3>

</sect2>

<sect2 id="setting-news-general">
<title>General News Settings</title>

<para>Now click on <guibutton>Reading news</guibutton> and then on the
<guibutton>General</guibutton> sub-entry; the figure below shows the dialog
containing the preferences you can configure there.</para>

<screenshot>
<screeninfo><guilabel>General Preferences</guilabel> dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-read-news-settings.png" format="PNG"/></imageobject>
<textobject>
<phrase>The <guilabel>General Preferences</guilabel> dialog</phrase>
</textobject>
<caption>
<para>The <guilabel>General Preferences</guilabel> dialog</para>
</caption>
</mediaobject>
</screenshot>

<para>You don't need to change most of these settings, but we will
discuss them step-by-step to give you an overview of the
possibilities of &knode;.</para>

<sect3>
<title><guilabel>Check for new articles
automatically</guilabel></title>

<para>If this box is checked &knode; tries to request new articles
from the server when selecting a newsgroup. These settings especially
make sense when you use &knode; together with a local news
server: downloading the messages obviously only works when the server
is reachable; for a server which is only reachable via an Internet
connection, this setting rarely makes sense and should stay
deactivated.</para>

<para>If your system isn't set up to establish an Internet connection
if necessary, you will get an error message each time you select a
newsgroup.</para>

<para>If you want to keep control over when a connection to the server
is established, the 
<menuchoice><guimenu>Group</guimenu><guimenuitem>Get new
articles</guimenuitem></menuchoice> menu option is appropriate.</para>

</sect3>

<sect3>
<title><guilabel>Maximal number of articles to fetch</guilabel></title>

<para>This sets a restriction on the number articles which are requested
from the server while downloading. The value configured here is for
each newsgroup separately. If this is set, for instance, to 300 only
the 300 newest articles of the newsgroup are requested; other articles will
be discarded.</para>

<warning>
<para>For newsgroups with relatively high traffic you might lose
articles if this value is too low; this especially occurs when you've
just subscribed to a newsgroup or only occasionally download articles
and the traffic for this reason rises above the value specified
here.</para>
</warning>
</sect3>

<sect3>
<title><guilabel>Mark article as read after</guilabel></title>

<para>Articles you have opened in the article window are marked as
read after the number of seconds specified here. If you set this value
to be relatively high you avoid articles you have just glanced at
being marked as read; on the other hand, it can be annoying for
relatively short articles, for which you need less time to read than
specified: if you browsed too quickly through the articles
they would stay unread even though you have read them. Therefore, you
should adjust this value to your personal preferences.</para>

</sect3>

<sect3>
<title><guilabel>Mark crossposted articles as read</guilabel></title>

<para>Sometimes an <glossterm>article</glossterm> will be posted to
more than one group; this is known as crossposting. If you activate this
option, those crossposted articles will be marked as read in all the
newsgroups to which they were posted if you read it in one newsgroup.</para>

</sect3>

<sect3>
<title><guilabel>Smart scrolling</guilabel></title>

<para>If this option is selected the lines in the article list are
scrolled smoothly instead of jerkily.
</para> <!-- LW: FIXME could be explained a tiny bit better -->

</sect3>

<sect3>
<title><guilabel>Show whole thread on expanding</guilabel></title>

<para>This setting lets a discussion be displayed completely (over
multiple answer levels) if you click on the plus in front of the
discussion; if this setting isn't checked, only the immediate answers
to the current article are displayed.</para>

</sect3>

<sect3>
<title><guilabel>Default to expanded threads</guilabel></title>

<para>Here you can toggle whether the threads are expanded by default or
not.</para>

</sect3>

<sect3>
<title><guilabel>Show article score</guilabel></title>

<para>Here you can toggle whether the scoring column should be shown
in the article view.</para>

</sect3>

<sect3>
<title><guilabel>Show line count</guilabel></title>

<para>Here you can toggle whether the column with the number of lines
should be shown in the article view.</para>

</sect3>

<sect3>
<title><guilabel>Cache size for headers</guilabel></title>

<para>Here you can configure how much memory &knode; should use for
the caching of the headers.</para>

</sect3>

<sect3>
<title><guilabel>Cache size for articles</guilabel></title>

<para>Here you can configure, how much memory &knode; should use for
the caching of the articles.</para>

</sect3>
</sect2>

<sect2>
<title><guilabel>Navigation</guilabel></title>

<para>Here you can change some navigation properties of &knode;.
Normally everything here is switched off, but if you don't like this
kind of navigation you can change it.</para>

<sect3>
<title><guilabel>General</guilabel></title>

<para>The keyboard behavior between &knode; and &kmail; is a bit
different; with the <guilabel>Emulate the keyboard behavior of
KMail</guilabel> switch you can activate the same keyboard behavior
as in &kmail; for &knode;.</para>

</sect3>

<sect3>
<title><guilabel>Mark All as Read</guilabel></title>

<para>If the box <guilabel>Switch to next group</guilabel> is checked,
&knode; automatically switches to the next group if you mark all
articles as read.</para>
</sect3>

<sect3>
<title><guilabel>Mark Thread as Read</guilabel></title>

<para>If <guilabel>Close the current thread</guilabel> is
checked, &knode; automatically closes a thread if you mark
it as read.</para>

<para>If <guilabel>Go to next unread thread</guilabel> is
checked, &knode; automatically shows the next thread if you mark the
the previous thread as read.</para>

</sect3>

<sect3>
<title><guilabel>Ignore Thread</guilabel></title>

<para>If <guilabel>Close the current thread</guilabel>is
checked, &knode; automatically closes a thread if you choose to
ignore it.</para>

<para>If <guilabel>Go to next unread thread</guilabel> is
checked, &knode; automatically shows the next thread if you choose
to ignore the previous one.</para>

</sect3>
</sect2>

<sect2 id="knode-scoring-settings">
<title>Scoring rules</title>

<para>To sort the articles you have the possibility to score them. The
standard score is 0: a higher score means that the
<glossterm>article</glossterm> is interesting; a lower score means
it is less interesting.</para>

<para>In the middle of the window you see a big, white area; here you
can see your scoring rules. Scoring rules are used by &knode; to score
the incoming articles automatically; if, for example, a person always
posts nonsense you can automatically score the articles of that person
down and hide them.</para>

<para>With the buttons below the list of scoring-rules you can
<guibutton>edit</guibutton>, <guibutton>add</guibutton>,
<guibutton>remove</guibutton> and <guibutton>copy</guibutton> a
rule. We will skip this feature for now, because it is not essential
for the setup of &knode;.</para>

<para>You can learn more about scoring; in the chapter <link
linkend="anc-score-watch-ignore">Scoring, watching and
ignoring</link>.</para>

<sect3>
<title><guilabel>Default score for ignored threads</guilabel></title>

<para>Normally you only need the functions ignore and watch; this
simply shows if a thread is interesting or not. Here you can configure
a default score for the ignored threads; choosing the 
<menuchoice><guimenu>Scoring</guimenu><guimenuitem>Ignore
Thread</guimenuitem></menuchoice> menu item will give this score to all the
posts in that thread, and will apply that score also to future posts
that follow up the thread.</para>

</sect3>

<sect3>
<title><guilabel>Default score for watched threads</guilabel></title>

<para>If an article is interesting, it will get a score above 0. Here
you can enter the default score for those articles; choosing the
<menuchoice><guimenu>Scoring</guimenu><guimenuitem>Watch
Thread</guimenuitem></menuchoice> menu item will give this score to all the
posts in that thread, and will apply that score also to future posts
that follow up the thread.</para>

<tip>
<para>You can use the <keycap>W</keycap> key to watch a thread or the
<keycap>I</keycap> key to ignore it.</para>
</tip>
</sect3>
</sect2>

<sect2 id="knode-filter-settings">
<title>Filter settings</title>

<para>This screenshot shows the filter settings.</para>

<screenshot>
<screeninfo>The filter settings</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-filters.png" format="PNG"/></imageobject>
<textobject>
<phrase>The filter settings</phrase>
</textobject>
<caption>
<para>The filter settings</para>
</caption>
</mediaobject>
</screenshot>

<para>This dialog shows two lists. The upper list, labeled <guilabel>
Filters</guilabel>, shows all defined filters; when you use &knode;
for the first time, you will only see the predefined filters.</para>

<para>With the buttons <guibutton>Add</guibutton>,
<guibutton>Delete</guibutton>, <guibutton>Edit</guibutton> and
<guibutton>Copy</guibutton> you can add new filters or delete filters
which are no longer needed; we will skip this feature for now, because
it is not essential for the setup of &knode;.</para>

<para>You can find more-detailed information about filters in <link
linkend="using-filters">Defining and using filters</link>.</para>

<para>The lower list, labeled <guilabel>Menu</guilabel>, shows the
appearance of the <menuchoice><guimenu>View</guimenu>
<guisubmenu>Filter</guisubmenu></menuchoice> menu, which you can reach from
the menu bar; the order of the filters in the this menu can be
configured in this list.</para>

<para>The <guibutton>Up</guibutton> button shifts the selected filter
one position up. Try it: select the second filter and press
<guibutton>Up</guibutton>; this entry will then go up one position.</para>

<para>The <guibutton>Down</guibutton> button does the opposite
action: select the filter you just shifted one up and
press<guibutton>Down</guibutton> until it reaches its old
position.</para>

<para>With the two buttons <guibutton>Add Separator</guibutton> and
<guibutton>Remove Separator</guibutton> you can visually group
the filters on the menu. The separators are shown as <literal>====</literal>
in the list; in the Menu they show up as some more-appealing
horizontal lines. Try adding separator; then, select the
separator and remove it by pressing <guibutton>Remove
separator</guibutton>.</para>

<para>Any changes you make here, you can see in
<menuchoice><guimenu>View</guimenu><guisubmenu>Filter</guisubmenu></menuchoice>
after closing this dialog.</para>

</sect2>

<sect2 id="knode-headers">
<title><guilabel>Customize displayed article headers</guilabel></title>

<anchor id="anc-knode-headers"/>

<para>In this dialog you can set how the single header lines are
displayed in the article window.</para>

<screenshot>
<screeninfo>The <guilabel>Customize displayed article
headers</guilabel> dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-header-settings.png" format="PNG"/></imageobject>
<textobject>
<phrase>The <guilabel>Customize displayed article
headers</guilabel> dialog</phrase>
</textobject>
<caption>
<para>The <guilabel>Customize displayed article
headers</guilabel> dialog</para>
</caption>
</mediaobject>
</screenshot>

<para>This list shows all the header lines which are to be
display in the article window. The identifiers at the left will be
displayed alongside the header lines in &lt; &gt; to their right;
the header lines are taken from each message, &eg; for
<guilabel>From</guilabel> the From header line will be used (indicating
who send the message).</para>

<para>Using <guibutton>Edit</guibutton> you can alter the shown
identifiers, alter the header line shown by each identifier and
change the font settings of the text used. To make things clearer,
we'll now simply select the
<guilabel>From:&lt;From&gt;</guilabel> entry in the list and open the dialog
for editing the header display by clicking on
<guibutton>Edit</guibutton>.</para>

<screenshot>
<screeninfo>The Header Properties dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-edit-header1.png" format="PNG"/></imageobject>
<textobject>
<phrase>The Header Properties dialog</phrase>
</textobject>
<caption>
<para>The Header Properties dialog</para>
</caption>
</mediaobject>
</screenshot>

<sect3>
<title><guilabel>Header</guilabel></title>

<para>The <guilabel>Header</guilabel> selection box shows the entry
<guilabel>From</guilabel>: that is the name of the header line for the
sender, as present in the article and evaluated by the
newsreader. If you drop down the selection box &knode; shows a range
of other identifiers, which stand all for a certain header lines in the
article: for now, we'll leave the <guilabel>From</guilabel> identifier
configured; we'll work with this list later, when we add a header line
to the display.</para>
</sect3>

<sect3>
<title><guilabel>Displayed Name</guilabel></title>

<para>This field holds the name you'd like to be later shown in the article
window as a label alongside the actual header
line text; for example, for the <guilabel>From</guilabel> header line the
label <guilabel>From</guilabel> is used. If you leave this field blank, only the
content of the header line appears in the article window; this is, for
example, the default setting for the <guilabel>Subject</guilabel>
header line. We won't change anything here either, for now.</para>

</sect3>

<sect3>
<title><guilabel>Name</guilabel></title>

<para>Here you can influence the way the 'Displayed Name'
text is displayed; in our case, the <guilabel>Bold</guilabel> attribute
is selected for the name <guilabel>From</guilabel>, &ie; the text will
be shown in bold letters in the article window. Of course, you can
combine different attributes, for example <guilabel>Bold</guilabel>
and <guilabel>Underlined</guilabel>.</para>

</sect3>

<sect3>
<title>Value</title>

<para>Here you can influence the way the header text is displayed
in the article window; for example, if the
<guilabel>Italic</guilabel> entry is selected the sender, &eg; <quote>John Doe
&lt;johndoe@doubleguns.com&gt;</quote> will appears in an italic
font.</para>

</sect3>

<sect3>
<title>Add and remove header lines to the display</title>

<para>To explain the possibilities of this dialog to you we're going
to add a new header line to the display.</para>

<example>
<title>Show the newsreader used for a post in the article window</title>

<para>This pictures shows the dialog with the header line
<literal>X-Newsreader</literal>.</para>
<screenshot>
<screeninfo>The Header Properties dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-edit-header2.png" format="PNG"/></imageobject>
<textobject>
<phrase>The Header Properties dialog</phrase>
</textobject>
<caption>
<para>The Header Properties dialog</para>
</caption>
</mediaobject>
</screenshot>

<para>It would be nice if one could see which newsreader another
subscriber uses in the article window; it is actually quite easy
to do this because there is a (optional) header line which contains
the necessary information.</para>

<para>Drop down the <guilabel>Header</guilabel> selection field and
select the <guilabel>X-Newsreader</guilabel> entry from the
list.</para>

<para>In the <guilabel>Displayed name</guilabel> field, enter
<userinput>Newsreader</userinput>.</para>

<para>Now you can select any attribute for the display of the field
and its content; next, acknowledge your input with the
<guibutton>OK</guibutton>: the new header line appears now in the list
and will later be shown in the article window.</para>

</example>

<para>Use the <guibutton>up</guibutton> and
<guibutton>Down</guibutton> buttons to arrange the order of the
headers in the article window.</para>

<tip>
<para>The statement that the new header line will be shown in the
article window is actually pretty optimistic, because the entry
X-Newsreader isn't required for Usenet articles; therefore, not all
articles will contain that header line: if the line doesn't exist, the
according entry simply won't be shown. You can get more information
about headers at <ulink
url="http://www.kirchwitz.de/~amk/dni/headerzeilen">http://www.kirchwitz.de/~amk
/dni/headerzeilen</ulink>
(german)</para>
</tip>
</sect3>
</sect2>

<sect2>
<title><guilabel>Viewer</guilabel></title>

<sect3>
<title><guilabel>Show fancy header decorations</guilabel></title>

<para>If this is active, the headers will be 'beautified' a
bit; otherwise, only the plain text is shown.</para>

</sect3>

<sect3>
<title><guilabel>Rewrap text when necessary</guilabel></title>

<para>If this option is active, the text wrapping in the viewer will
be automatically corrected.</para>

</sect3>

<sect3>
<title><guilabel>Remove trailing empty lines</guilabel></title>

<para>If this is active empty lines at the end of the article will
be automatically hidden.</para>

</sect3>

<sect3>
<title><guilabel>Show signature</guilabel></title>

<para>If this setting is activated, the
<glossterm>signature</glossterm> of the sender is displayed in the
article window; if it isn't, the signature is surpressed.</para>

<caution>
<para>Please notice that &knode; can display the signature
correctly only if it can be separated correctly from the article
content in the current article: there are newsreaders which do this
separation incorrectly. Two <quote>-</quote> characters followed by a
<quote>&nbsp;</quote> (space) is correct.</para>
</caution>

<tip>
<para>Many participants in the newsgroups give hints on their homepage
or say that they have intentionally erroneously specified their Email addresses
in the header fields: if you disable displaying the signature, you might
lose this information; on the other hand, you might save yourself
from reading strange quotes.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Interpret text-format tags</guilabel></title>

<para>If this is active, all text format tags in the message like
<literal>*bold*</literal>, <literal>/italic/</literal> and
<literal>_underline_</literal> are shown directly in the viewer. These
text-format tags are an unofficial standard.</para>

</sect3>

<sect3>
<title><guilabel>Recognize quote characters</guilabel></title>

<para>To display the quoted text in another size or color, &knode;
needs to recognize that it's quoted text. Quoted text is normally
marked with a <quote>&gt;</quote> at the beginning of the line, but
sometimes there are other characters. In this field you can enter all
characters that should mark quoted text.</para>

</sect3>

<sect3>
<title><guilabel>Show attachments inline if
possible</guilabel></title>

<para>If this setting is marked, &knode; tries to display the contents
of possible attachment directly in the window when opening an
article; for instance, a picture would be displayed directly below the
article text.</para>

<para>Additionally, you have the possibility to save the attachment or
open it with the application you have associated with the
<acronym>MIME</acronym> type of the attachment by using the context
menu.</para>

</sect3>

<sect3>
<title><guilabel>Open attachments on click</guilabel></title>

<para>If this box is checked, attachments are opened with the external
program which is configured for the <acronym>MIME</acronym> type; if
there is no such association, a dialog for saving a file is opened and
you can save the attachment to a separate file.</para>

</sect3>

<sect3>
<title><guilabel>Show alternative contents as
attachments</guilabel></title>

<para>Articles which are sent as Multipart <acronym>MIME</acronym>
contain the text of the message in multiple formats, for example as
raw text and <acronym>HTML</acronym>; the newsreader decides which
part of the article is displayed. This setting makes it possible for
the other formats to be opened as if they were attachments with a
mouse click.</para>

<para>If this setting is disabled, alternative contents are not
displayed.</para>

</sect3>

<sect3>
<title><guilabel>Open links with</guilabel></title>

<para>Here you can select which browser is used for displaying links
you clicked on in a message. Currently, you can either select the
<application>Netscape Navigator</application> or the default,
&konqueror;; the selected browser has to be installed, of
course.</para>

</sect3>
</sect2>

<sect2 id="knode-post-news-settings">
<title>Settings for publishing articles</title>

<para>When you post articles with &knode; the settings in the
following dialog box are used.</para>

<screenshot>
<screeninfo>The Technical Settings dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-post-settings.png" format="PNG"/></imageobject>
<textobject>
<phrase>The Technical Settings dialog</phrase>
</textobject>
<caption>
<para>The Technical Settings dialog</para>
</caption>
</mediaobject>
</screenshot>

<caution>
<para>If you choose the wrong settings here your articles could be
unreadable or not sendable at all, so please be careful with these
settings.</para>
</caution>

<sect3>
<title><guilabel>Charset</guilabel></title>

<para>Here you can choose the charset used for encoding your
articles. Normally this is <acronym>US-ASCII</acronym> for English
speaking countries, but your charset may differ. The default is the
charset used in your global &kde; settings, so you should not have to
change this.</para>

<para>When you want to post articles in newsgroups with other charsets
(&eg; eastern European or Asian) you can set the required charset
here.</para>

</sect3>

<sect3>
<title><guilabel>Encoding</guilabel></title>

<para>Here you set the encoding of the characters for the message
transfer; you can choose between 8-bit and 7-bit
(quoted-printable).</para>

<para>If you choose 8-bit encoding most special characters are
transfered correctly; this is, for example, the normal option for the
German groups (de.*).</para>

<para>If you choose quoted-printable 8-bit characters (&eg; German
umlauts or special characters) are send as encoded 7-bit
characters.</para>

<tip>
<para>In the English newsgroups 7-bit encoding is quite
normal.</para>
</tip>

</sect3>

<sect3>
<title><guilabel>Use own default charset when
replying</guilabel></title>

<para>If this option is active, &knode; uses your default charset for
replying instead of the charset of the article you're answering
on.</para>

</sect3>

<sect3>
<title><guilabel>Generate Message-ID</guilabel></title>

<para>When this is active, &knode; generates its own Message-IDs for
all articles you post.</para>

<caution>
<para>The Message-ID must be unique worldwide: there would
otherwise be collisions between messages with the same Message-ID and the
news server would reject the second article because it thinks
this article has already been received.</para>

<para>A Message-ID consists of a valid <acronym>FQDN</acronym> (Full
Qualified Domain Name); this means it looks similar to an email
address with an identification before the <literal>@</literal> and the
domain.</para>

<para>The identification is generated by &knode; automatically, but
you must provide a valid domain name in <guilabel>Hostname</guilabel>;
if you do not have your own domain, you should not activate this
option &mdash; let the newsserver generate a Message-ID for you.</para>

<example>
<title>Message-ID</title>

<para>An example for a valid domain would be:
<literal>kde.org</literal>; a Message-ID generated with this domain
would look like:</para>

<screen>934lek9934@kde.org</screen>
</example>

<para>An unique identification is only guaranteed if you have your
own domain. Even when you do not use &knode; for generating your
Message-IDs there may be collisions when you are using a local
newsserver; for example, <application>leafnode</application> generates
a Message-ID which it derives from the local hostname.</para>

</caution>

<tip>
<para>You can get more information about this and how to own a free domain at
<ulink
url="http://www.qad.org/faq/faq-messageid.html">http://www.qad.org/faq/faq-
messageid.html</ulink>.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Hostname</guilabel></title>

<para>Here you enter the Hostname of your computer; this is used to
generate the Message-ID. If you do not have your own domain you
should not activate this option &mdash; let the newsserver generate a
Message-ID for you. Using the example above this would be:
<userinput>kde.org</userinput>.</para>

</sect3>

<sect3>
<title><guilabel>X-Headers</guilabel></title>

<para>Here you can enter X-Headers which are not provided by &knode;;
for example, <userinput>X-No-Archive: yes</userinput>, which can be
used to prevent your articles from being archived by archive services
such as Google.</para>

<para>X-Headers are experimental headers, which are not included in the
standard for Internet-Messages; they are, for example, used for
extended information transfer. To prevent collisions with later
standard headers, they have a <quote>X-</quote> prefix.</para>

</sect3>

<sect3>
<title><guilabel>Don't add the "User-Agent" identification
header</guilabel></title>

<para>When this option is checked &knode; does not include the
corresponding line in the Header before posting.</para>

<para>This header is used for identification of the newsreader the
article was written in; apart from statistical reasons, this allows
non-standard newsreaders to be identified. You should not activate this
option &mdash; &knode; has no need to hide.</para>
</sect3>
</sect2>

<sect2 id="knode-composer-settings">
<title>The Composer Settings</title>

<screenshot>
<screeninfo>The Composer Settings dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-composer-settings.png" format="PNG"/></imageobject>
<textobject>
<phrase>The Composer Settings dialog</phrase>
</textobject>
<caption>
<para>The Composer Settings dialog</para>
</caption>
</mediaobject>
</screenshot>

<sect3>
<title><guilabel>Word-wrap at column</guilabel></title>

<para>Here you can set the column number at which &knode; wraps the
line; also, you can deactivate the automatic word-wrapping
completely.</para>

<tip>
<para>It is recommended to use no more than 76 characters even if
you are able to display more: many Usenet users use text-based
newsreaders which can not display more than 80 characters and it is
difficult to read your articles in such a newsreader if you increase
this value &mdash; this would reduce the probability of your articles
being read at all.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Append signature automatically</guilabel></title>

<para>When you write a new <glossterm>article</glossterm> or a
<glossterm>followup</glossterm>, your <glossterm>signature</glossterm>
is appended automatically if you have configured one in
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
KNode...</guimenuitem><guilabel>Identity</guilabel></menuchoice>.</para>

</sect3>

<sect3>
<title><guilabel>Introduction Phrase:</guilabel></title>

<para>When you write a followup, &knode; inserts an introduction
phrase before the quoted original text. You can put arbitrary text
here; you can also use the variables which &knode; extracts from the original
article, &eg; the name of the author or the date the article was
written.</para>

<para>The following variable are available:</para>

<variablelist>
<varlistentry>
<term><varname>%NAME</varname></term>
<listitem>
<para>The name of the original author;</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>%DATE</varname></term>
<listitem>
<para>The date on which the original article was written;</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>%EMAIL</varname></term>
<listitem>
<para>The original author's email address;</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>%MSID</varname></term>
<listitem>
<para>The Message-ID of the original article;</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>%GROUP</varname></term>
<listitem>
<para>The name of the <glossterm>newsgroup</glossterm>the article
comes from.</para>
</listitem>
</varlistentry>
</variablelist>

<tip>
<para>Keep this short, because this introductory line appears in
every followup: a long introductory line can be as repelling as
a long signature.</para>
</tip>

<example>
<title>An example introductory line</title>

<screen><userinput>On <varname>%DATE</varname> <varname>%NAME</varname> wrote in
<varname>%MSID</varname></userinput></screen>

<para>Let us assume the original article was written by Konqui on
Saturday the 17th of June at 17:42:32 - 0500. The article has the
Message-ID &lt;8igdg5.3vvijgt.3@lizard.physos.com&gt;. &knode; will
then insert the following introductionary line.</para>

<screen><computeroutput>On Sat, 17 Jun 2000 17:42:32 +0200 Konqui wrote in
&lt;8igdg5.3vvijgt.3@lizard.physos.com&gt;:</computeroutput></screen>

</example>
</sect3>

<sect3>
<title><guilabel>Rewrap quoted text automatically</guilabel></title>

<para>When this is checked, the quoted text is wrapped at the correct
border value; hence, every new line will be at the correct quoting
level.</para>

</sect3>

<sect3>
<title><guilabel>Include the author's signature</guilabel></title>

<para>When this is activated not only the text of the original
message, but also the signature of the author, is quoted in a
reply.</para>

<tip>
<para>Quoting a signature is unnecessary and is often considered
impolite.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Put the cursor below the introduction
phrase</guilabel></title>

<para>Normally the cursor will appear below the whole message when
answering; with this option turned on the cursor appears below the
introduction phrase.</para>

<tip>
<para>This is especially helpful if you quote an article and wish to
write between the quoted lines from top to bottom.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Define external editor</guilabel></title>

<para>You can define an external editor here which is opened by
selecting <menuchoice><guimenu>Tools</guimenu><guimenuitem>Start
external editor</guimenuitem></menuchoice> in the Composer
window.</para>

<para>When <guilabel>Start external editor automatically</guilabel> is
checked the external editor is opened directly.</para>

<caution>
<para>Notice the <varname>%f</varname> after the name of the
editor: this is a variable for the filename of the article you want to
edit; do not delete this &mdash; you will get an error message when opening
the external editor if you do.</para>
</caution>

<tip>
<para>If you have problems with starting your external editor, the
reason may be that the editor starting in "the background"; this is called
forking: &knode; only notices the sub-process started and has finished, and
thinks you have quit the editor. The editor
<application>gvim</application> is an example for this; you can
disable the forking of <application>gvim</application> with the
commandline switch <option>-f</option>. It is recommended that you refer to
the documentation of your editor you are experiencing this problem.</para>

<para>If you want to use <application>gvim</application> in
<guilabel>Specify Editor</guilabel> enter the following:</para>

<para>
<userinput>
gvim -f %f</userinput>
</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Start external editor
automatically</guilabel></title>

<para>If this option is active the external editor will be used for
editing articles.</para>

</sect3>
</sect2>

<sect2>
<title><guilabel>Spelling</guilabel></title>

<para>Here you can configure the behavior of the spell
checker.</para>

<sect3>
<title><guilabel>Create root/affix not in
dictionary</guilabel></title>

<para>If this is checked a known word-root with an unknown affix will
be automatically accepted as a new word.</para>

</sect3>

<sect3>
<title><guilabel>Consider run-together words as spelling
errors</guilabel></title>

<para>Here you can toggle if two known words that run together to form an
unknown word should be treated as an error or
not.)</para>

</sect3>

<sect3>
<title><guilabel>Dictionary</guilabel></title>

<para>Here you chose the dictionary the spell-checker should
use.</para>

</sect3>

<sect3>
<title><guilabel>Encoding</guilabel></title>

<para>Here you can tell &knode; which encoding should be used for
spell checking; for English text this should normally be
<acronym>US-ASCII</acronym>.</para>

</sect3>

<sect3>
<title><guilabel>Client</guilabel></title>

<para>Here you can switch between the spell-checkers; you can use
<application>International Ispell</application> or
<application>Aspell</application>.</para>

</sect3>

</sect2>

<sect2>
<title><guilabel>Signing and verifying</guilabel></title>

<para>Here you can configure &knode; for signing articles with
<application>GnuPG</application> or
<application>PGP</application>. Your
<application>GnuPG</application>/<application>PGP</application>
<acronym>ID</acronym> will be built automatically from your configured
name and email address; it is identical to the from line in the
header of the <glossterm>article</glossterm>.</para>

<sect3>
<title><guilabel>Encryption tool</guilabel></title>

<para>Here you can choose your encryption tool.</para>

</sect3>

<sect3>
<title><guilabel>Keep passphrase in memory</guilabel></title>

<para>If this option is active you only need to type the passphrase
for your private key once; &knode; will remember your passphrase until
you close &knode; again.</para>

</sect3>

<sect3>
<title><guilabel>Show ciphered/signed text after
composing</guilabel></title>

<para>If this option is activated &knode; will show the signed message in
an extra window for confirmation before changing it in the
editor.</para>

</sect3>

<sect3>
<title>Always show the encryption keys for approval</title>

<para>If you are using public newsgroups (on Usenet) you can safely
ignore this option as it would not be useful to encrypt messages sent
to Usenet; this option may, however, be useful in private
newsgroups on private networks where encryption is desired.</para>
<!-- FIXME: LW - I can see use for -->
<!-- encryption, on private networks etc. This needs a rewrite -->
<!-- AndrewColes: is this revision any better? -->
</sect3>

<sect3>
<title><guilabel>Check signatures automatically</guilabel></title>

<para>If this is marked, the <application>PGP</application> signature
of the article is automatically checked when showing the article; if
there's no mark, you can check the signature for correctness manually
with the <menuchoice><guimenu>View</guimenu><guimenuitem>Verify
PGP-Signature</guimenuitem></menuchoice> menu entry.</para>

</sect3>

</sect2>


<sect2 id="knode-article-cleanup">
<title>The article-cleanup settings.</title>

<para>The dialog below shows the settings for the article
cleanup; these settings are used to keep the number of articles on
your local harddisk to a reasonable number. &knode; administrates the
articles in memory so there can be some decrease in speed if you
have to many articles lying around; most of the time it makes no sense
to keep articles for a very long time. Services like Google and
Altavista make archiving unnecessary.</para>

<caution>
<para>&knode; isn't an offline reader, so all of the
configuration refers to the headers which are managed by &knode;; if
you are running a local news server, such as
<application>leafnode</application>, you should refer to its
documentation to handle expiring the articles on the server &mdash;
&knode; cannot do this for you.</para>
</caution>

<screenshot>
<screeninfo>The cleanup settings</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-cleanup.png" format="PNG"/></imageobject>
<textobject>
<phrase>The cleanup settings</phrase>
</textobject>
<caption>
<para>The cleanup settings</para>
</caption>
</mediaobject>
</screenshot>

<sect3>
<title><guilabel>Expire old articles automatically</guilabel></title>

<para>When this option is active all subscribed groups are checked for
old articles in the time interval set here; the old articles will
then be deleted.</para>


<tip>
<para>You can force this check by selecting
<menuchoice><guimenu>Group</guimenu><guimenuitem>Expire
group</guimenuitem></menuchoice></para>
</tip>
</sect3>

<sect3>
<title><guilabel>Purge groups every</guilabel></title>

<para>Here you can configure how often subscribed groups should be
checked for old <glossterm>article</glossterm>s and how often those
articles should be deleted; this option only has an effect when 
<guilabel>Expire old articles automatically</guilabel> is
selected.</para>

</sect3>

<sect3>
<title><guilabel>Keep read articles</guilabel></title>

<para>Read articles are deleted by the next cleanup if they are older
than this value; &knode; uses the creation date for this.</para>

</sect3>

<sect3>
<title><guilabel>Keep unread articles</guilabel></title>

<para>Unread articles are deleted by the next cleanup if they are
older than this value; &knode; uses the creation date for this.</para>

</sect3>

<sect3>
<title><guilabel>Remove articles that are not available on the
server</guilabel></title>

<para>It may happen that you'll see a <glossterm>header</glossterm> in
&knode; but the article is not available on the server; if this option
is set, those articles will automatically deleted in &knode;.</para>

</sect3>

<sect3>
<title><guilabel>Preserve threads</guilabel></title>

<para>This selection forces a thread to be deleted only if all
articles contained in it fulfil the delete conditions; this means that a thread
will not be deleted until the last article in the thread should be
deleted.</para>

<para>This prevents old articles in a long thread from vanishing before
the discussion has ended.</para>

<caution>
<para>&knode; can not predict whether there will be a reply after the set
conditions are fulfilled; you will have to find your own settings for
this. Some newsgroups have days between replies; others only hours. Use
your own judgement.</para>
</caution>
</sect3>

<sect3>
<title><guilabel>Compact folders automatically</guilabel></title>

<para>This option refers to the memory behavior of &knode;. If an
<glossterm>article</glossterm> in a folder is deleted it will be
marked as deleted but still take up space on your hard disk; with
this option you can tell &knode; to actually delete the articles and
free the hard-disk space regularly.</para>

<tip>
<para>You can force this check by selecting
<menuchoice><guimenu>Folder</guimenu><guimenuitem>Compact
folder</guimenuitem></menuchoice> or for all folders together with
<menuchoice><guimenu>Folder</guimenu><guimenuitem>Compact all
folders</guimenuitem></menuchoice>.</para>
</tip>
</sect3>

<sect3>
<title><guilabel>Purge folders every</guilabel></title>

<para>Here you can configure how often the folder is checked for
deleted articles; this option only has an effect if the
<guilabel>Compact folders automatically</guilabel> is set.</para>
</sect3>
</sect2>

</sect1>