<!-- <?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 dialogue 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 dialogue of &knode;. The figure shows the dialogue.</para>

<screenshot
> 
<screeninfo
>Dialogue 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 dialogue 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 dialogue -- 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
>Organisation</guilabel
></title
> 

<para
>The input field <guilabel
>Organisation</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 dialogue 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
> dialogue, &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 favourite 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 dialogue appears:</para>

<screenshot>
<screeninfo
>The <guilabel
>New Account</guilabel
> dialogue</screeninfo
> 
<mediaobject
> 
<imageobject
> 
<imagedata fileref="knode-news-account.png" format="PNG"/> </imageobject
> 
<textobject
> 
<phrase
>The <guilabel
>New Account</guilabel
> dialogue</phrase
> 
</textobject
> 
<caption>
<para
>The <guilabel
>New Account</guilabel
> dialogue</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 cancelled 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
> dialogue.</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 dialogue 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 Dialogue Box appears.</para
> 

<screenshot
> 
<screeninfo
>Dialogue 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 Dialogue Box is very similar to the news account settings Dialogue 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 centre; the other options in this dialogue 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
> dialogue you are given the ability to set the colours, the character code and the font size of the text in the article window; the picture below shows the dialogue.</para>

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

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

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

<para
>The colour 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 colours</guilabel
> setting is selected &knode; won't use colours which have been changed later globally for &kde; but will only use the colours 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 dialogue.</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 dialogue containing the preferences you can configure there.</para
> 

<screenshot
> 
<screeninfo
><guilabel
>General Preferences</guilabel
> Dialogue</screeninfo
> 
<mediaobject
> 
<imageobject
> 
<imagedata fileref="knode-read-news-settings.png" format="PNG"/> </imageobject
> 
<textobject
> 
<phrase
>The <guilabel
>General Preferences</guilabel
> dialogue</phrase
> 
</textobject
> 
<caption
> 
<para
>The <guilabel
>General Preferences</guilabel
> dialogue</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 behaviour between &knode; and &kmail; is a bit different; with the <guilabel
>Emulate the keyboard behaviour of KMail</guilabel
> switch you can activate the same keyboard behaviour 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 dialogue shows two lists. The upper list, labelled <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, labelled <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 dialogue.</para
> 

</sect2
> 

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

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

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

<screenshot
> 
<screeninfo
>The <guilabel
>Customise displayed article headers</guilabel
> Dialogue</screeninfo
> 
<mediaobject
> 
<imageobject
> 
<imagedata fileref="knode-header-settings.png" format="PNG"/> </imageobject
> 
<textobject
> 
<phrase
>The <guilabel
>Customise displayed article headers</guilabel
> dialogue</phrase
> 
</textobject
> 
<caption>
<para
>The <guilabel
>Customise displayed article headers</guilabel
> dialogue</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 dialogue for editing the header display by clicking on <guibutton
>Edit</guibutton
>.</para
> 

<screenshot>
<screeninfo
>The Header Properties Dialogue</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="knode-edit-header1.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>The Header Properties dialogue</phrase>
</textobject>
<caption>
<para
>The Header Properties dialogue</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 dialogue 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 dialogue with the header line <literal
>X-Newsreader</literal
>.</para
> 
<screenshot
> 
<screeninfo
>The Header Properties Dialogue</screeninfo
> 
<mediaobject
> 
<imageobject
> 
<imagedata fileref="knode-edit-header2.png" format="PNG"/> </imageobject
> 
<textobject
> 
<phrase
>The Header Properties dialogue</phrase
> 
</textobject
> 
<caption
> 
<para
>The Header Properties dialogue</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 suppressed.</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
>Recognise quote characters</guilabel
></title
> 

<para
>To display the quoted text in another size or colour, &knode; needs to recognise 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 dialogue 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 dialogue box are used.</para
> 

<screenshot
> 
<screeninfo
>The Technical Settings dialogue</screeninfo
> 
<mediaobject
> 
<imageobject
> 
<imagedata fileref="knode-post-settings.png" format="PNG"/> </imageobject
> 
<textobject
> 
<phrase
>The Technical Settings dialogue</phrase
> 
</textobject
> 
<caption
> 
<para
>The Technical Settings dialogue</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 dialogue</screeninfo
> 
<mediaobject
> 
<imageobject
> 
<imagedata fileref="knode-composer-settings.png" format="PNG"/> </imageobject
> 
<textobject
> 
<phrase
>The Composer Settings dialogue</phrase
> 
</textobject
> 
<caption
> 
<para
>The Composer Settings dialogue</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 behaviour 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 dialogue 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 behaviour 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>
