<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&knode;">
  <!ENTITY % English "INCLUDE">
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">

<bookinfo>

<title>The &knode; manual</title>

<authorgroup>
<author>
<firstname>Stephan</firstname><surname>Johach</surname>
<affiliation><address><email>lucardus@onlinehome.de</email></address>
</affiliation>
</author>

<othercredit role="developer">
<firstname>Christian</firstname><surname>Thurner</surname>
<contrib>Developer and maintainer</contrib>
<affiliation><address><email>cthurner@freepage.de</email></address>
</affiliation>
</othercredit>

<othercredit role="developer">
<firstname>Christian</firstname><surname>Gebauer</surname>
<contrib>Developer</contrib>
<affiliation><address><email>gebauer@bigfoot.com</email></address></affiliation>
</othercredit>

<othercredit role="developer">
<firstname>Dirk</firstname><surname>Mueller</surname>
<contrib>Developer</contrib>
<affiliation><address><email>mueller@kde.org</email></address></affiliation>
</othercredit>

<othercredit role="developer">
<firstname>Matthias Kalle</firstname><surname>Dalheimer</surname>
<contrib>Developer</contrib>
<affiliation><address><email>kalle@kde.org</email></address></affiliation>
</othercredit>

<othercredit role="translator">
<firstname>Rainer</firstname><surname>Endres</surname>
<contrib> Documentation translator and maintainer of the English documentation</contrib>
<affiliation><address><email>endres@physos.com</email></address></affiliation>
</othercredit>

<othercredit role="translator">
<firstname>Frerich</firstname><surname>Raabe</surname>
<contrib>Documentation translator</contrib>
<affiliation><address><email>frerichraabe@gmx.de</email></address></affiliation>
</othercredit>

<othercredit role="translator">
<firstname>Oliver</firstname><surname>Henning</surname>
<contrib>Documentation translator</contrib>
<affiliation><address><email>oliver@henning.com</email></address></affiliation>
</othercredit>

<othercredit role="translator">
<firstname>Martin</firstname><surname>Piskernig</surname>
<contrib>Documentation translator</contrib>
<affiliation><address><email>martin.piskernig@stuwo.at</email></address></affiliation>
</othercredit>

<othercredit role="reviewer">
<firstname>Lauri</firstname><surname>Watts</surname>
<contrib>Reviewer</contrib>
<affiliation><address><email>vampyr@atconnex.net</email></address></affiliation>
</othercredit>

<!-- TRANS:ROLES_OF_TRANSLATORS -->

</authorgroup>

<copyright>
<year>2000</year>
<holder>Stephan Johach</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2000-12-16</date>
<releaseinfo>0.03.02</releaseinfo>

<abstract>
<para>&knode; is an easy-to-use newsreader.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>KNode</keyword>
<keyword>kdenetwork</keyword>
<keyword>newsreader</keyword>
</keywordset>
</bookinfo>

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

<para>&knode; is an easy-to-use, convenient newsreader. It is intended to allow
even newbies to use a newsreader under &kde;. &knode; also offers advanced
features appealing to experienced users.</para>

<para>&knode; is an online-reader, but can also, in conjunction with a local
news server, be used as an offline-reader.</para>

<para>If you have problems or questions about this program, please contact the
mailing list for &kde; users (for subscription, see <ulink
url="http://www.kde.org/contact.html">Homepage of the KDE mailing lists</ulink>
) or one of the &kde; newsgroups: </para>

<simplelist>
<member>comp.windows.x.kde</member>
</simplelist>

<para>If you found a bug or have suggestions regarding the functionality of
&knode; please report them via the menu
<menuchoice><guimenu>Help</guimenu><guimenuitem>Report a
bug...</guimenuitem></menuchoice>.</para>

<para>Please make sure when asking questions in the above mentioned newsgroups
and mailing lists to only ask questions that are not answered in this
manual.</para>

<para>For those new to reading news and posting articles, I want to recommend
the chapter <link linkend="knode-journey">A journey through Usenet</link>. It is
not so much about the program &knode; as how to move about in the Usenet with
its help. In general, it is not sufficient to just master a news reader for
writing news articles. Imagine a car driver who masters his car perfectly but
does not know about the traffic rules or signs. Do you want to encounter such a
driver when out in traffic? So please take your time to learn at least a little
about the "traffic rules" of the Usenet. The other participants will thank
you.</para>

<tip><para>&knode; supports you in many cases with hints and warnings. If you do
not simply ignore them, you will avoid many beginners' mistakes.  But do not
exclusively depend on them either.</para> </tip>

<!-- Revisions here should be about the *application* not the documentation, -->
<!-- that's handled in the prologue.  I removed this section. -->

</chapter>

<chapter id="using-knode">
<title>Working with &knode;</title>

<sect1 id="first-start">
<title>The first start</title>

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

<tip><para>If the entry for &knode; can not be found or if &knode; should not
appear on the desktop 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 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 windows. </para>

<para>On the left there is a folder view.It currently contains only three
entries.</para>

<simplelist>
<member>Outbox</member>
<member>Drafts</member>
<member>Sent</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-right section, is the article view. It is
currently empty and does not show any articles.  Directly
below the article view, the article window is located. There appears the body of
the currently selected article. These windows are also blank at the moment, as
there are no articles, of course. You should not be
confused because before reading and publishing news, some things have to be
configured first. 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 miss a "Quickstart" 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>

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

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

<para>The dialog is divided into two parts: On the left, there is a treeview, in
which the top entry <guilabel>Identity</guilabel> is already highlighted. On the
right, you see the corresponding input dialog. These settings relate to your
identity with which you navigate through the newsgroups.</para>

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


<sect3 id="identity-name">
<title><guilabel>Name</guilabel></title>

<para>In the field <guilabel>Name</guilabel> you enter your name,
<abbrev>e.g.</abbrev> <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,
<abbrev>e.g.</abbrev> 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 id="identity-email">
<title><guilabel>Email address</guilabel></title>

<para>The email adress you enter here will be used as sender in news articles,
<abbrev>i.e.</abbrev> 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</guilabel> shows up when someone wants to reply
to you by e-mail. The e-mail 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 field <guilabel>Email</guilabel>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 id="identity-reply-to">
<title>Reply-to Address</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 e-mail, 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</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.</para> </warning> </sect3>

<sect3 id="identity-organization">
<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 <abbrev>e.g.</abbrev> the name of your
company or your university institute, if you use &knode; there. If you leave
this field blank, it will often be filled out later by your Internet
provider.</para> </sect3>

<sect3 id="identity-signature">
<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 id="identity-sig-file">
<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 <abbrev>e.g.</abbrev> 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 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 interes
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 neccessary to include a separation line in the signature
file as &knode; inserts it automatically.</para> </tip>

</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
signature should not contain more than 4 lines. A
separation line is not neccesary 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, <abbrev>e.g.</abbrev>
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, <abbrev>e.g.</abbrev> 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>

<para>Now we must tell &knode; about where we get the news from or where to send
the articless to later on. In the tree view on the right,
there is an entry <guilabel>Account</guilabel>.  Click on that with the
mouse. Then two sub entries will be opened out. We choose the entry
<guilabel>News</guilabel>, because we first want to configure the news
account. The list of accounts is empty yet.</para>

<para>Therefore we create a new account with <guibutton>Add</guibutton>. The
following dialog appears: </para>

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

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

<para>The field <guilabel>Name</guilabel> can be filled out as you like. The
text you enter will later be visible in the folder view. You can
<abbrev>e.g.</abbrev> 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>, it is not unimportant what you enter here.  The name
of the news server is fixed and should be made public by your Internet
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.</para>

<para>For our example configuration we enter the name
<userinput>news.server.de</userinput>. You will of course enter the real name of
your news server.</para>

<tip><para>If you deploy &knode; with a local news server, enter the name
<userinput>localhost</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, 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.</para> </sect3>

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

<para>The time value you enter here is effective 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 expired,
&knode; automatically disconnects. This, among other things, relieves the server
of unneccessay connections which reduce its availibilty for other subscribers.
It also makes sure that an automatically established Internet connection is not
held unnecessarily although 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 "anything" for some time. &knode;
has cancelled the connection to the server by then after the period has expired
and has to reestablish it. </para>

<para>If this waiting time is set too high, you perhaps waste online time when
doing nothing. </para></tip>

</sect3>

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

<para>If &knode; connects to the news server, it waits no longer for an answer
of the news server than the time that is set here. If this period is exceeded,
you will get a corresponding error message, because the server does not respond
and &knode; cancels the connection attempt.</para>

<tip><para>Depending on the quality of your Internet account and the news
server's current load. there can be waiting periods, so that &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 dialog <guilabel>Subscribe to
Newsgroups</guilabel>.</para>

<tip><para>There is not a group description for every group, so there is no
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. If this is the case, you will find out from your Internet
provider or the server's maintainer. </para>

<tip><para>If you do not know exactly if this setting is necessary, forget about
selecting it. If you encounter an error later on, you still can select 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. Via the button
<guibutton>Subscribe</guibutton> you can perhaps directly get to the dialog for
subscribing to news groups. But we still have more to do and ignore it for
now. There are several ways that lead to the goal. </para>

<para>You confirm and save your settings by clicking on the button
<guibutton>OK</guibutton>. As soon as you have done that, the account will
appear in the list by the name that you have entered in
<guilabel>Name</guilabel> before. And if you have a close look, you will see
that the account is also appearing in the folder view. </para>

<para>In the chapter <link linkend="multiple-news-accounts">Managing
multiple news accounts </link> you will 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 if you are logged on via this provider. </para></caution>

<para>We will now move on to configuring the e-mail account. In order to do
that, click on the entry <guilabel>E-Mail</guilabel> in the tree view on the
left. </para></sect3>

</sect2>

<!-- Oliver End -->

<!-- Rainer 2:45-->
<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 on the right.</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>Dialog Box for setting up the mail-account</phrase>
	  </textobject>
	  <caption><para>Dialog Box for setting up the mail-account</para></caption>
	</mediaobject>
</screenshot>

<para>You will notice this Dialog Box to be very simmilar to the news account
settings Dialog Box. But why do we need an e-mail account in a
newsreader?</para>

<para>Sometimes you need to anwser 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 a dialog is more appropriate than
a public remark.</para>

<para>Thats why &knode; provides the posssibility to reply by e-mail.  If you
want to use this feature, you must tell &knode; how to send e-mails. You just
need to insert the mailserver. When you have already configured an e-mail
account, <abbrev>i.e</abbrev> with <application>KMail</application>, you can
reuse the settings used there.  </para>

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

<para>The name of your mailserver is not arbitrary. Your <abbrev>ISP</abbrev>,
should provide you the informations, which mailserver to use. All you have to do
here is to enter the mailserver in the <guilabel>Server</guilabel> field.</para>

<para>In our example we enter <userinput>mail.server.de</userinput></para>

<tip><para>You can send your mail by a local mailserver. When you use a local
mailserver, use <emphasis>localhost</emphasis> 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 Port 25. You should not need to change this, despite your ISP has a very
exotic configuration nad 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, after you established a connection with your
mailserver. If there is no data transfer, &knode; cancels the connection to your
mailserver after this amount of time.</para>

</sect3>

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

<para>When &knode; tries to connect to the mailserver, it waits this long for a
reply by the the server. Is this time execceded, you get a error message.</para>

<tip><para>Depending on the quality of your connnection and the actual load of
your mailserver, you can get long reply times. If &knode; cancels the connection
due to this, you should increase the timeout.</para></tip>

</sect3>

<sect3>
<title>General remarks</title>

<caution><para>Some ISP only allow you to send e-mail over their mailserver 
after you checked your mailbox on new mails. This reduces spamming.</para>

<para>For same reasons, some ISP only allow you to send mail by their
mailservers, when you are onine with this ISP.</para>

</caution>

<para>In the next step we look at the general settings for reading news.</para>

</sect3>
</sect2>

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

<para>Now click on <guibutton>Read news</guibutton> and then on the subentry
<guibutton>General</guibutton>. The picture shows the dialog and the preferences
you can configure there.</para>

<screenshot>
<screeninfo>Dialog General Preferences</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="knode-read-news-settings.png" format="PNG"/>
	  </imageobject>
	<textobject>
	<phrase>The dialog General Preferences</phrase>
	</textobject>
	  <caption><para>The dialog General Preferences</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 over 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
neccessary, 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 menu option <guimenu>Group</guimenu> <guimenuitem>Get new
articles</guimenuitem> is appropriate.</para>

</sect3>

<sect3>
<title><guilabel>max to fetch</guilabel></title>

<para>This sets the restriction of the articles, which are requested from the
server while downloading. The value configured here is for each
Newsgroup seperately. Set this for instance to 300, so
that only the 300 newest articles of the newsgroup are
requested. Other articles are discarded!</para>

<warning><para>Please notice: 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 download
articles only occasionally 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 relatively high, you
avoid that an articles you just glanced at is directly 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 browse in this case too fast through
the articles they stay, although you've read them
already, unread. Therefore, you should adjust this value to your personal
preferences.</para>

</sect3>

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

<para>This setting lets discussion be displayed completely (over multiple answer
levels, that is). If this setting isn't checked, only the immediate answers to
the current article are displayed.</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 seperated correctly from the article content in the current
article. There are newsreaders which do this seperation incorrectly. Two "-"
with a following "&nbsp;" (space) are correct. </para>

</caution>

<tip><para>Many participants in the newsgroups give hints on their homepage or
intentionally erroneous specified E-Mail adresses in the header in the
signature. If you disable displaying the signature, you might loose those
information. On the other hand you might save yourself from reading stupid
texts.</para></tip>

</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 an external program
with 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 in 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
<abbrev>HTML</abbrev>. The newsreader decides which part of the article is
displayed. This setting makes it possible that the other formats can be opened
as if they were attachments with a mouse click.</para>

<para>If this setting is disable, 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,
<application>Konqueror</application>. The selected browser has to be installed,
of course.</para>

</sect3>
</sect2>

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

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

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

<para>This list shows all the header lines which are intended for display in the
article window. The identifier at the left will be displayed, the name in &lt;
&gt; stand for the name of the according header line how it is transmitted in
the Usenet, <abbrev>i.e.</abbrev> for <guilabel>From</guilabel> the name
<guilabel>From</guilabel></para>

<para>Via <guibutton>Edit</guibutton> you can influence the shown identifier as
well as the attributes of the shown identifier and the text. To make things
clearer, we'll now simply select the entry <guilabel>Sender</guilabel> in the
list and open the dialog for editing the header display by clicking on
<guibutton>Edit</guibutton>.</para>

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


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

<para>The selection box <guilabel>Header line</guilabel> shows the entry
<guilabel>From</guilabel>. That is the name of the header line for the sender,
as it's actually 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 line in the
article. For now, we'll leave the identifier
<guilabel>From</guilabel> configured. We'll work with this list later, when we
add a header line to the display.</para>

</sect3>

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

<para>This field holds the name, which is later shown in the article window as a
replacement for the actual identifier of the header line. For the header line
<guilabel>From</guilabel>, it's the <guilabel>sender</guilabel>.  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 header line
<guilabel>Subject</guilabel>. We won't change anything here either.</para>

</sect3>

<sect3>
<title>Name</title>

<para>Here you can influence the attributes of the shown name with the
checkboxes. In our case, the attribute <guilabel>Bold</guilabel> is selected for
the name <guilabel>Sender</guilabel>, <abbrev>i.e.</abbrev> 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>The information given for <guilabel>Name</guilabel> is true for these
checkboxes as well, but these attributes are associated to the content of the
shown header line, in course case to the actual sender. You can later see the
effects of these settings in the displayed articles. For example, select here
the entry <guilabel>Italic</guilabel>, and the sender, <abbrev>i.e.</abbrev>
"John Doe &lt;johndoe@doubleguns.com&gt;" appears in a 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 X-Newsreader.</para>

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

<para>It would be nice if one could see which newsreader another subscriber uses
in the article window. Well, that's pretty easy because there's actually a
(optional) header line which contains that information.</para>

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

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

<para>Now you can select any attribute for the display of the field and it's
content. Next, acknowledge your input with the <guibutton>OK</guibutton>.  The
new header line appers 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 artciles. Therefore, not all articles will contain that
header line. If the line doesn't exist, the according entry simply won't be
shown.</para></tip>

</sect3>
</sect2>

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

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

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

<sect3>
<title><guilabel>Show long group list</guilabel></title>

<para>If this setting is activated, &knode; enlarges the folder view over the
whole heigth of the main window. That way, the width of the article window is
restricted to the area below the article view.</para>

<para>If this setting is deactivated, the article window can use the whole width
of the main window.</para>

</sect3>

<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
<mousebutton>left</mousebutton> mouse button 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 setting <guilabel>Use custom colors </guilabel> 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 left mouse button 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 userdefined 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="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 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 no longer
needed.  We skip this feature for now, because it is not essential for the setup
of &knode;</para>

<para>More detailed informations about filters you can find in <link
linkend="using-filters">Definig and using filters</link></para>

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

<para>The button <guibutton>Up</guibutton> shifts the selected
article one position up. Try it, select the second filter and press
<guibutton>Up</guibutton>. This entry goes up on position.</para>

<para>The button <guibutton>Down</guibutton> does the opposite action.  Select
the article, 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 group the filters optical. The
separators are shown as <quote>====</quote> in the list.  In the Menu they show
up as some more appealing horizontal lines.  Try to add a separator. Then you
select the seperator and remove it by pressing <guibutton>Remove
seperator</guibutton> wider.</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-post-news-settings">
<title>Settings for publishing articles</title>

<para>When you post articles with &knode; the settings in the following Dialog
Box is used.</para>

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

<caution><para>When you choose the wrong settings here, your articles can 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 iso 8859-1 in Western Europe and 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
(<abbrev>i.e.</abbrev> eastern-european or asian) you can set the needed 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 7-bit, 8-bit and quoted-printable.</para>

<para>When you choose 7-bit encoding, special characters are not correctly
send. 7-bit is kind of restricted to the us-ascii charset.  </para>

<para>When you choose 8-bit encoding, most special characters are transfered.
</para>

<para>When you choose quoted-printable, 8-bit charcters are send as encoded
7-bit charcaters.  </para>
</sect3>

<sect3>
<title><guilabel>don't encode 8-bit characters in the
header</guilabel></title>

<para>This setting allows 8-bit characters in the header, if checked,
<abbrev>i.e.</abbrev> in the subject. This is explicitly not allowed by the
standard.</para>

<para>This setting is made for a special case, because in scandinavian
newsgroups, standard encoded 8-bit characters in the headers are reasonably
common.</para>

<warning><para>You should normally never use this option, unless you know for
certain this is normal in the newsgroup you are posting to.</para></warning>

</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 will be collisions
between messages with the same Message-ID, otherwise.  The newsserver will
reject the second article, because it thinks, this article was already
recieved.</para>

<para>A Message-ID consists of a valid FQDN (Full Qualified Domain Name).  This
means it looks similary to an e-mail adress with a indentification befor the @
and the domain.  </para>

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

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

<para>An example for a valid domain would be:
<emphasis>kde.org</emphasis>. A Message-ID gernerated with this
domain will look like:
</para>
<para>934lek9934@kde.org</para>
</example>
</para>

<para>An uniqe identification is only guarenteed, when 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>

</sect3>

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

<para>Here you enter the Hostname of your computer. This is used to generate the
Message-ID. When you do not have your own domain, you should not activate this
option. 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, wich are not provided by &knode; For
example: <emphasis>X-No-Archive: yes</emphasis>. This should prevent your
articles to be archived by <abbrev>i.e.</abbrev> dejanews.  </para>

<para>X-Headers are experimental headers, wich 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 "X-"
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 according line
in the Header before posting.  </para>

<para>This header is used for identification of the newsreader the article was
written in. Besides statistical reasons, this allows to identify non-standard
newsreaders. You should not activate this option, &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 Box</screeninfo>
         <mediaobject>
          <imageobject>
            <imagedata fileref="knode-composer-settings.png" format="PNG"/>
          </imageobject>
         <textobject>
         <phrase>The Composer settings Dialog Box</phrase>
         </textobject>
          <caption><para>The Composer settings Dialog Box</para></caption>
         </mediaobject>
</screenshot>

<sect3>
<title><guilabel>word wrap at coloumn</guilabel></title>

<para>Here you can set the value at which &knode; wraps the line.</para>

<tip><para>It is recomended to use no more than 76 characters. Even when you are
able to diable more. Many Usenet users will use a text-based newsreader which
can not display more than 80 characters. It is difficult to read your articles
in such a newsreader, if you increase this value. This reduces the probatility
of your articles to be read at all.  </para> </tip>

</sect3>

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

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

</sect3>

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

<para>When you write a followup, &knode; inserts an introdutionary phrase befor
the quoted orginal Text.  You can put an aribrary text here. You can use
variables, which &knode; extracts from the original article, i.e. the name of
the author or the date the article was written.  </para>

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

<variablelist>
<varlistentry>
<term>%NAME</term>
<listitem>
<para>The name of the original author.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>%DATE</term>
<listitem>
<para>The date the original article was written.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>%EMAIL</term>
<listitem>
<para>The original authors e-mail adress.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>%MSID</term>
<listitem>
<para>The Message-ID of the original article.</para>
</listitem>
</varlistentry>
</variablelist>

<tip><para>Keep this short, because this introdutionary line appears in every
followup. A too long introducionary line can be as repelling as a too long
signature.</para></tip>

<example>
<title>An example</title>
<para>On %DATE %NAME wrote in %MSID</para>

<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>

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

<sect3>
<title>rewrap quoted text automatically</title>

<para>When this is checked, the quoted text is wraped at the correct
border value. So, every new line is in the correct quoting level.
</para>
</sect3>

<sect3>
<title><guilabel>include the authors 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>Define external editor</guilabel></title>

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

<para>When <guilabel>start external editor auotmatically</guilabel> is checked,
the external editor is opened directly.  </para>

<caution><para>Notice the <option>%f</option> behind the name of the
editor. This is a variable for the filename of the article you want to edit. Do
not delete this.  You will get an error message when opening the external
editor.  </para> </caution>

<tip> <para>When you have problems with starting your external Editor, the
reason may be the editor starting in "the background". This is called forking.
&knode; only notices the process started, is 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> by the
commandline switch <option>-f</option>. It is recommended to refer to the
documentation of the used editor for this.  </para>

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

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

</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 amount of articles on your local harddisk in a
reasonable value. &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
Dejanews and Altavista make archiving needless.</para>

<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>purge groups every</guilabel></title>

<para>When this option is active, all subcribed groups are checked for old
articles in the time intervall set here. The old articles are deleted,
then.</para>

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

</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 make 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 make date for this.</para>

</sect3>

<sect3>
<title><guilabel>preserve threads</guilabel></title>

<para>This selection forces a thread, only to be deleted, if all articles
contained, fulfill the delete conditions.</para>

<para>This prevents old articles in a long thread to vanish, before the
dicussion is ended.</para>

<caution><para>&knode; can not predict, if there is a reply, after the set
conditions are fulfilled. You have to find your own settings for this. Some
newgroups have days between replys, others only hours. Use your own
judgement.</para></caution>

</sect3>

<sect3>
<title><guilabel>compact folders</guilabel></title>

<para>After the time, set here, &knode; removes all deleted or moved articles
finally from the folders.</para>

</sect3>
</sect2>

</sect1>

<sect1 id="subscribing">
<title>Working with newsgroups</title>

<para>After the configuration of &knode; we will now try to read your first
news. To achieve this, you need to do some more steps of configuration, but you
don't have to do this very often.</para>

<sect2 id="fetch-group-list">
<title>Fetching the group-list from the newsserver</title>

<para>If you want to read a newsgroup, you first have to subscribe to it.  You
click with your mouse on the entry of your newsserver in the folder-list.  The
<mousebutton>right</mousebutton> mouse button opens the context menu. Here you
select the entry <guimenuitem>"Subscribe to Newsgroups"</guimenuitem>. &knode;,
at this moment, does not know which newsgroups are available from this
server. &knode; asks you if it should fetch a list of available
newsgroups. Confirm with <guibutton>yes</guibutton>. Now you see the
following dialog.</para>

<screenshot>
<screeninfo>The Dialog Box "Subscribe to Newsgroups"</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="knode-subscribe.png" format="PNG"/>
	  </imageobject>
	 <textobject>
	<phrase>The Dialog Box "Subscribe to Newsgroups"</phrase>
	 </textobject>
	  <caption><para>The Dialog Box "Subscribe to Newsgroups"</para></caption>
	</mediaobject>
</screenshot>

<para>After some time, &knode; has fetched the list of available newsgroups and
shows them in the left window <guilabel>Groups on</guilabel> in a tree view.
This tree view shows the newsgroup-hierarchy.</para>

<sect3>
<title><guilabel>Groups on</guilabel></title>

<para>This list shows all newsgroups on this server. If you check one of the
checkboxes <guilabel>subscribed only</guilabel> or <guilabel>new only</guilabel>
you get the corresponding selection.</para>

</sect3>

<sect3>
<title><guilabel>Current changes</guilabel></title>

<para>The window<guilabel>Current changes</guilabel> shows all changes you made,
since you opened the dialog.</para>

<para>The list <guilabel>subscribe to</guilabel> shows the newsgroups you have
choosen to subscribe.</para>

<para>Below you see the list <guilabel>unsubscribe from</guilabel>. This list
shows all newsgroups you have choosen to unsubscribe. You can not unsubscribe
from groups you didn't first subscribe to.</para>

</sect3>

<sect3>
<title><guilabel>subscribed only</guilabel></title>

<para>If <guilabel>subscribed only</guilabel> is checked, the tree-view
<guilabel>Groups on</guilabel> shows only the groups you are already subscribed
to. This is very convenient, if you want to unsubscribe from some groups.  You
don't have to search the whole tree for these groups.</para>

</sect3>

<sect3>
<title><guilabel>new only</guilabel></title>

<para>If <guilabel>new only</guilabel> is checked, the tree-view
<guilabel>Groups on</guilabel> shows only the groups, wich are new since you
last fetched the group-list. For this to be functional, you first have to fetch
a new group-list with <guibutton>New List</guibutton></para>

<para>The button <guibutton>New Groups</guibutton> give the possibility to show
show all new groups since a specific date.</para>

</sect3>

<sect3>
<title><guilabel>Filter</guilabel></title>

<para>The second and most likely used possibility to navigate in the tree is the
input field <guilabel>Filter</guilabel>.  &knode; filters the groups according
to your input with every keystroke. If you are searching for a group around KDE,
but you do not know the exact position in the hierarchy, just type
<userinput>kde</userinput> in the <guilabel>Filter</guilabel>-field.</para>

<para>When you enter the <userinput>k</userinput>, you will already see the list
changing. The second letter, <userinput>d</userinput>, give you a significantly
reduced list of shown groups, and the final <userinput>e</userinput> reduces the
list to the groups with kde in their name. In the US you will most likely end
with just one group.
<simplelist>
<member>comp.windows.x.kde</member>
</simplelist>
</para>

<para>This incremental search gives you the possibility to search for newsgroups
without knowing the exact path.</para>

<tip><para>On a close look, you will see &knode; showing the groups without a
tree if there are only a few groups left. This is not a bug, it is a
feature. </para></tip>

</sect3>

<sect3>
<title><guibutton>New List</guibutton></title>

<para>The button <guibutton>New List</guibutton> tells &knode; to fetch a new
group list from the newsserver.</para>

<para>The newsgroup-hierarchy is in a constant flux. All the time there are
groups introduced, renamed or moved. Some groups just disappear, they are no
longer available and get deleted. To reflect this, &knode; gives you the
possibility to refresh the the group list. This is, normally, only needed to see
if your server now provides a group which was not there before.</para>

<tip><para>If you simply want to make sure to see every new group, it is more
effective to use <guibutton>New Groups</guibutton>. Fetching the complete list
is much more time consuming, but you make sure the deleted groups vanish from
the grouplist.</para></tip>

<para> Unfortunately there is no guarantee that your newsserver is providing all
available newsgroups. Many newsserver refuse groups publishing binary
attachments. Other groups are only available from special servers.  &knode;
provides you the possibility to use more than one news-server, if you want to
acces alternative servers providing these groups. You can read more about this
in <xref linkend="multiple-news-accounts"/>.</para>

</sect3>

<sect3>
<title><guilabel>New Groups</guilabel></title>

<para>This button opens a dialog wich allows you to configure the list of new
groups. You can choose between showing all groups since the last refresh or all
groups since a given date. With the date option, &knode; provides a more
flexible posibility to check for new groups. You can even check for new groups
before the last refresh of the grouplist.</para>

</sect3>

<sect3>
<title>Working with the dialog</title>

<para>We now want to subscribe to the KDE-group. Mark the the box on the left of
the name. You can now see the group in the list <guilabel>subscribe
to</guilabel>. Another posibility is to use the arrows between the two
windows.</para>

<para>If you picked the wrong newsgroup by mistake, you can undo your selection
by unchecking the checkbox next to the groups name in the <guilabel>Groups
on</guilabel> window. Again you can use the arrow. You probably noticed the
arrow changing his direction.</para>

<para>If you want to unsubscribe from a newsgroup it is as easy as to subscribe
to it. You just uncheck the box next to its name. The groups you unsubscribed
from are shown in the list <guilabel>unsubscribe from</guilabel>. Again the
arrow is another way for doing things.  For correcting your actions you can use
the arrow again.  This works as long as the dialog is not closed by clicking
<guibutton>OK</guibutton>.</para>

<para>As a KDE and &knode; user you will probably want to subscribe to the
group.  So make sure you checked the box and press <guibutton>OK</guibutton>.
This group now appears in the tree-view under the server entry it was choosen
from. In our example this is <emphasis>My News Account</emphasis>. If you can
not see the group, click on the cross next to the server entry or on the server
entry itself. The list of subscribed newsgroups should appear.</para>

<para>Click on the newsgroup. Now you see on the right in the article view an
empty folder. &knode; has to fetch the articles for the new newsgroup.  When you
have in <menuchoice><guimenu> Settings</guimenu><guimenuitem> Preferences
</guimenuitem><guimenuitem>Reading news </guimenuitem><guimenuitem>
General</guimenuitem></menuchoice>, the check box <guilabel>checking for new
article automatically</guilabel> checked, &knode; trys to fetch the articles
from the server, when the newsgroup is first selected. If this is unchecked, you
have to use <menuchoice> <guimenu>Account</guimenu> <guimenuitem> Get new
articles</guimenuitem> </menuchoice></para>

<important><para>When you are using <application>leafnode</application> as an
server, there will be a single article in the
group. <application>leafnode</application> generates an article in every new
subcribed group.  This indicates <application>leafnode</application> will
consider this group the next time it fetches articles. You can ignore an error
message saying the article can not be found. If you select this article you tell
<application>leafnode</application> you are really interested in this
group.</para>

<para>You get the real articles, when your local newsserver fetches them from
the Internet and provides them to you. Details about this you can find in the
documentation of your local newsserver.  </para> </important>

<para>When everything worked, the articles of the subscribed newsgroup appear in
the upper right window, the article view.</para>

</sect3>
</sect2>

<sect2 id="fetch-and-read-news">
<title>Fetching and reading Articles</title>

<para>&knode; always shows three views (folder view, article view and article
window). You can change height and width of these views with the mouse.  If you
click in a window it gets the focus. This is important, if you want to use
&knode; with the keyboard. The <keycap>Tab</keycap> key changes the focus
between the views. The currently active view is indicated by a small colored
bar over the coloum headers.</para>

<para>This picture shows &knode; with the subscribed KDE-newsgroup. </para>

<screenshot>
<screeninfo>The three views of &knode;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="knode-views.png" format="PNG"/>
	  </imageobject>
	<textobject>
	<phrase>The three views of &knode;</phrase>
	</textobject>
	  <caption><para>The three views of &knode;</para></caption>
	</mediaobject>
</screenshot>

<sect3>
<title>The folder view</title>

<para>The folder views contains not only the accounts you configured - in our
example this is <emphasis>My News Account</emphasis> - but also three other
folders. When you already subscribed to some newsgroups ther will be cross next
to the accounts name. Clicking on the cross or the name of the account opens the
tree.</para>

<tip><para> Using the right mouse button you get a context menu for the selected
item (folders or newsgroups). If you select a newsgroup and choose Properties,
you can, among other things, specify your identity for this particular
group. You can find more about this in <xref
linkend="group-identity"/></para></tip>

<para>When you select a newsgroup with your mouse, a list of articles of this
group appears in the upper right window. If there are no articles in the upper
left window, there are two posibilities. There are no articles for this
newsgroup on the newsserver or the newsserver did not fetch them yet.  Select
<menuchoice> <guimenu>Account</guimenu> <guimenuitem> Get new
articles</guimenuitem> </menuchoice>.  If there are still no articles appearing,
you have some problems with your settings or there really are no articles for
this group. Try another group.  If there are no articles for this group, you
most likely have to work through the first chapters, about the configuration of
&knode;, again.  The chapter <link linkend="faq">Frequently Asked
Questions</link> may help you, too.</para>

<caution><para>If you are using a local newsserver, the articles only appear if
the newsserver already got them from the internet. When you are using
<application>leafnode</application> this is done by the the program
<application>fetchnews</application>.</para> </caution>

<sect4>
<title>The newsgroup folders</title>

<para>The newsgroup folders appear with the name the are given by the hierarchy
on the newsserver. In our exapmle this is
<guilabel>comp.windows.x.kde</guilabel>. You can change the name shown in this
view. In the context menu (<mousebutton>right</mousebutton> mouse button on the
newsgroups name) choose <menuchoice> <guimenu>Properties</guimenu> </menuchoice>
then you can change the name in the inputfield <guilabel>Nickname:</guilabel>. A
good name for <guilabel>comp.windows.x.kde</guilabel> would be for eample
<guilabel>The KDE-Newsgroup</guilabel>.</para>

<para>If you leave the input field empty, the hierarchical name is
shown.</para>

<para>Besides the name of newsgroups the folder view shows much more
informations by the appearance. When there are new articles in a group or
folder, the name is shown bold. The columns <guilabel>Total</guilabel> and
<guilabel>Unread</guilabel> tell you how many articles are in the according
group or folder and how many are marked as unread.  </para> 

</sect4>

<sect4>
<title>The folder <guilabel>Sent</guilabel></title>

<para>Selecting this folder shows you the articles you succesfully sent,
including your e-mail replies. You can delete the messages in this folder, but
this has no influence on the messages already sent. </para>

<caution><para>If your are using a local newsserver, an article appearing in the
folder <guilabel>Sent</guilabel> only indicates the local newsserver receiving
the article. It is possible this article never appears in any newsgroup, because
the local newsserver was not able to send it for some reason.  If you notice
some article not appearing in the according newsgroup, first make sure it was
sent by the local newsserver.</para></caution>

<tip><para> If you are using <application>leafnode</application> articles,
leafnode was unable to send, are found in
<filename>/var/spool/failed.postings</filename>, normally.</para></tip>

</sect4>

<sect4>
<title>The folder <guilabel>Outbox</guilabel></title>

<para>The folder <guilabel>Outbox</guilabel> contains all articles, wich are
supposed to be sent later or which could not be sent because of an error. If you
want to sent an article later, choose <menuchoice> <guimenu>File</guimenu>
<guimenuitem> Send Later</guimenuitem> </menuchoice> in the editor. The article
is then filed in the <guilabel>Outbox</guilabel> folder. It is possible to edit,
delete, or send these articles later.</para>

<tip><para>If an article was not sent because of an error, it is stored in this
folder. You are not losing these articles! </para></tip>

</sect4>

<sect4>
<title>The folder <guilabel>Drafts</guilabel></title>

<para>This folder is used for storing drafts of your articles. For example if
you want to do some further work on them, but you have no time for it right
now. For storing an article in this folder choose <menuchoice>
<guimenu>File</guimenu> <guimenuitem>Save as Draft</guimenuitem> </menuchoice>
in the editor.</para>

<para>You can edit, delete and send the articles in this folder.</para> 

</sect4>
</sect3>

<sect3>
<title>The article view</title>

<para>The article view gives you a list of all articles in the selected
newsgroup or folder. You can change the appearence of this view with the menu
entry <guimenu>View</guimenu>. The uppermost row of the view contains the
coloumn headers.</para>

<variablelist>
<varlistentry>
<term><guilabel>Subject</guilabel></term>
<listitem><para>The <guilabel>Subject</guilabel> coloumn shows the subjects of
an articles, which, most of the time give you a clue about the content ot this
article. The subject is chosen by the article author.  You can find more about
this in <link linkend="post-and-mail-news">How to post and reply to
news</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>From</guilabel></term>
<listitem><para>The column <guilabel>From</guilabel> shows the author or her
e-mail adress, if the author did not give a name. You can configure your
settings in <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem> <guilabel>Identity</guilabel>
</menuchoice> When you publish an article &knode; will show these settings in
the <guilabel>From</guilabel> coloumn. </para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Score</guilabel></term>

<listitem><para>The column <guilabel>Score</guilabel> shows the scoring of an
article as a number. The default is 50. Articles which are important to you can
be scored up, articles you want to ignore, can be scored down. The range is zero
to one hundred. Read more about this in chapter <link
linkend="score-watch-ignore">Scoring, Watching and
Ignoring</link></para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Date (Time)</guilabel></term>
<listitem><para>The <guilabel>Date (Time)</guilabel> column shows the date and time
when the article was written.</para></listitem>
</varlistentry>
</variablelist>

<sect4>
<title>The symbols and highlighting used</title>

<para>This is a shot explanation of the different symbols for labeling
articles.</para>

<itemizedlist>

<listitem><para> <inlinemediaobject><imageobject> <imagedata
fileref="greyball.png" format="PNG"/></imageobject> </inlinemediaobject> Already
read articles are labeled with this symbol.</para></listitem>

<listitem><para><inlinemediaobject><imageobject><imagedata
fileref="greyballchk.png" format="PNG"/> </imageobject> </inlinemediaobject>
Articles labeled with this symbol are read and the body was fetched from the
server.</para></listitem> 

<listitem><para><inlinemediaobject><imageobject><imagedata fileref="redball.png"
format="PNG"/> </imageobject></inlinemediaobject> Articles labeled with
this symbol are unread and the body has not yet been fetched.</para></listitem>

<listitem><para><inlinemediaobject><imageobject><imagedata
fileref="redballchk.png" format="PNG"/></imageobject></inlinemediaobject>
Articles labled with this symbol are unread but the body has already been
already fetched.</para></listitem>

<listitem><para><inlinemediaobject><imageobject><imagedata fileref="newsubs.png"
format="PNG"/></imageobject></inlinemediaobject> Articles labeled with this
symbol are part of a thread with new and unread articles in
it.</para></listitem>

<listitem><para><inlinemediaobject><imageobject><imagedata fileref="eyes.png"
format="PNG"/></imageobject></inlinemediaobject> Articles labled with
this symbol are parts of a guarded thread. This corresponds to a score of
100.</para></listitem>

</itemizedlist>

<para>Besides different symbols, &knode; is using the following highlighting:
</para>

<variablelist>
<varlistentry>
<term>The article subject is printed bold.</term>
<listitem>
<para>The article is new in this group. It was fetched during the last
connection with the server.</para> </listitem>
</varlistentry>

<varlistentry>
<term>The article subject is printed in grey.</term>
<listitem><para>There are no unread follow-up articles.</para></listitem>
</varlistentry>
</variablelist>
</sect4>

<sect4>
<title>Navigation in the article view. </title>

<para>You can navigate in articles, display an article and open or close threads
with your mouse or keyboard. </para>

<para>When you select an article with your mouse, its entry in the the article
view gets colored. At the same time the header and body of this article appear
in in the article window. If you want to read an other article, you can use the
mouse for selecting it or you can use  the cursor keys. When you use the coursor
keys, you can move the dashed frame to the article you want and then press Enter
for marking and diplaying the article. </para>

<para>There are many key commands, wich allow a comfortable navigation in a news
group and for switching between newsgroups. Here the most common key commandos
of the standard key configuration are listed.  You can configure this key
bindings in <menuchoice><guimenu>Settings </guimenu> <guimenuitem>Configure Key
bindings</guimenuitem></menuchoice></para>

<variablelist>
<varlistentry>
<term>Open and close threads <keycap>T</keycap></term>
<listitem><para>The replies on an article are either shown or hiddden by
multiply pressing this key. Another possibility for opening threads is using the
<keycap>right arrow key</keycap> </para></listitem>
</varlistentry>

<varlistentry>
<term>Browsing articles <keysym>Space</keysym></term>
<listitem><para>This key gives you a convenient possibility for browsing through
the article view. By pressing this key the article in the article window is
scrolled. When you reach the end of the article by repeatedly pressing
<keysym>Space</keysym>, it takes you to the next article. When you have read all
articles in one newsgroup, <keysym>Space</keysym> takes you to the first article
of the next newsgroup. By repeatedly pressing <keysym>Space</keysym> you can
browse through all subscribed newsgroups like this. </para></listitem> 
</varlistentry>

<varlistentry>
<term>Next unread article
<keycombo action="simul"><keycap>Alt</keycap><keysym>Space</keysym></keycombo></term>
<listitem><para>This key binding jumps to the next unread article. The sequence
follows the order of articles in the article view. A thread is opend if needed
to do so.</para></listitem>
</varlistentry>

<varlistentry>
<term>Next unread thread <keycombo action="simul"><keycap>Ctrl</keycap><keysym>Space</keysym>
</keycombo></term>
<listitem><para>This command jumps to the next thread containing unread
articles. The first unread article is selected and shown. The sequence follows
the order of articles in the article view.</para></listitem>
</varlistentry>

<varlistentry>
<term>Next article <keycap>N</keycap> </term>
<listitem><para>This command jumps to the next article. The sequence follows the
order of articles in the article view. Replies in closed threads are
ignored.</para></listitem>
</varlistentry>

<varlistentry>
<term>Previous article <keycap>B</keycap> </term>
<listitem><para>This command jumps to the previous article in the group. The
sequence follows the order of articles in the article view. Replies in closed
threads are ignored. </para></listitem>
</varlistentry>

<varlistentry>
<term>Next group <keycap>+</keycap> </term>
<listitem><para>This command jumps to the next newsgroup. The sequence follows
the order of articles in the article view. </para></listitem>
</varlistentry>

<varlistentry>
<term>Previous group <keycap>-</keycap> </term>
<listitem><para>This command jumps to the previous newsgroup. The sequence
follows the order of articles in the article view. </para></listitem>
</varlistentry>

</variablelist>
</sect4>

<sect4>
<title>Sorting and filtering of articles</title>

<para>Some newsgroups are very crowded and contain lots of articles.  Perhaps
only some of them are interesting to you. One possibility to keep track is
sorting your articles with certain criterias.</para>

<para>Sorting your articles and the choice of sorting criterias is done with the
column titles in the article view. Clicking on a cloumn title makes it the
current sorting criteria. Another click on the same coloumn title changes the
order of sorting.</para>

<tip><para>The current sorting criteria is indicated with an arrow next to the
titel.  This gives you an easy sign, wich column is used for sorting, too. You
have to make the coloumn wide enough, so that you can actually see the arrow.
You can change the coloumn width by moving the mouse pointer on the small area
between two column titles. The pointer changes it's appeareance in two horizontal
arrows. Click and hold <mousebutton>left</mousebutton> mouse button allows you
now to change the width of the column left to the mouse pointer.</para></tip>

<para>&knode; gives you the posibility to reduce the flood of articles. You can
show only the articles fitting in your specific criterias. &knode; uses filters
for this task. In this paragraphs we are just dealing with the predefined
filters. For defining and using your own filters, please refer to the chapter
<xref linkend="using-filters"/></para>

<para>Normally you will read most articles only once, and then never again.
&knode; labels the articles which are unread, but when there are more articles
in a news group than can be shown by the article view, you often have to search
for unread articles. It would be much easier to see only the new fetched and
unread articles. &knode; gives you this feature by the predefined
filters.</para>

<para>In the status line at the bottom border of your main window behind the
word <guilabel>Filter</guilabel> the actually active filter is shown.  If you do
not change the filter configuration, this is the filter
<guilabel>all</guilabel>. This means all articles of a newsgroup are shown.
<guilabel>all</guilabel> is one of the predefined filters. There are eight of
them, wich are described in more detail here.</para>

<variablelist>
<varlistentry>
<term><guilabel>all</guilabel></term>
<listitem>
<para>
This filter is the default setting. It shows all articles in a newsgroup.
You can choose this filter by selecting
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu> Filter</guisubmenu>
<guimenuitem>all</guimenuitem>
</menuchoice>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>unread</term>
<listitem>
<para>
This filter shows only unread articles.
You can choose this filter by selecting
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu> Filter</guisubmenu>
<guimenuitem>unread</guimenuitem>
</menuchoice>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>new</term>
<listitem>
<para>
This filter shows only articles fetched during the last connection.
You can choose this filter by selecting
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu> Filter</guisubmenu>
<guimenuitem>new</guimenuitem>
</menuchoice>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>watched</term>
<listitem>
<para>
This shows only threads chosen as watched threads by you. For example,
because you are participating in this thread or you are particular
interested in the anwsers.  You can choose this filter by selecting
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu> Filter</guisubmenu>
<guimenuitem>watched</guimenuitem>
</menuchoice>
</para>

<para>
This filter only shows something, if you selected one or more threads to
watch. You can achieve by selecting
<menuchoice>
<guimenu>Article</guimenu>
<guisubmenu>Thread</guisubmenu>
<guimenuitem>Watch</guimenuitem>
</menuchoice>.
Next to the subject appears a symbol, showing a pair of eyes.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>threads with unread</term>
<listitem>
<para>
This filter shows only thread containing unread articles.
You can choose this filter by selecting
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu> Filter</guisubmenu>
<guimenuitem>threads with unread</guimenuitem>
</menuchoice>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Threads with new</term>
<listitem>
<para>
This filter shows only threads with new fetched articles.
You can choose this filter by selecting
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu> Filter</guisubmenu>
<guimenuitem>threads with new</guimenuitem>
</menuchoice>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Own articles</term>
<listitem>
<para>
This filter shows only articles you published.
You can choose this filter by selecting
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu> Filter</guisubmenu>
<guimenuitem>own articles</guimenuitem>
</menuchoice>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>threads with own articles</term>
<listitem>
<para>
This filter shows only threads containing articles you published.
This filter shows only articles you published.
You can choose this filter by selecting
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu> Filter</guisubmenu>
<guimenuitem>own articles</guimenuitem>
</menuchoice>
</para>
</listitem>
</varlistentry>
</variablelist>

<tip><para>For everyday use the <guilabel>unread</guilabel> filter is propably
the most useful. It shows all unread articles, including the old ones. The other
filters are very special and seldom used. In the end it is a matter of taste
which filter to select. </para></tip>
</sect4>

</sect3>

<sect3>
<title>The article window</title>
<para>The article window shows the currently selected article. You can scroll in
it like in a normal text editor window. The difference is, you can not change
the article. The article window ist for read only. </para>

<para>The window itself is divided in three areas. They are explained in more
detail now. </para>

<sect4>
<title>The header</title>

<para>This part shows the header lines or a part of the header. You will
recognize some informations here from the article view. For example the subject
and the adress or name where the article originated. When you click on the
<guilabel>From:</guilabel>-adress, &knode; opens an editor window. The e-mail
adress of the author and the subject of the refering article are already filled
in for you. This enables you to reply to the author directly from her
article. </para>

<para>The appeareance and content of the shown header shown by default can be
	  configured by choosing <menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem>
<guilabel>Reading News</guilabel>
<guilabel>Headers</guilabel>
</menuchoice>
You can find a more detailed view on this in <xref
linkend="knode-headers"/></para>

<para>
By selecting
<menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Show all headers</guimenuitem>
</menuchoice>
you force &knode; to show the whole header as it is produced by the
newsreader and newsservers. Normally you do not need this view, becaus it
needs a lot of space in the article window.
</para>

<para>The last lines of the header contain, if necessary, some references to
other articles, shown as numbers in the range from 1 to n. These References are
articles refering to the current article. The article labled with 1 is the
oldest article. This means it is the first one refering to the current
article. The article with the highest number is the one the current article is
refering to.</para>

<para>When you click on a reference, the according article is loaded and shown
in the article view. It can occure, &knode; is telling you, the refered article
is no longer reachable. This always happens when an article is older and the
article management of &knode; or your newsserver decided to delete it from the
newsgroup. How to get such an article, please refer to the <link
linkend="faq">Frequently Asked Questions</link>.</para>

</sect4>

<sect4>
<title>The body of the article</title>

<para>The body of the article follows straight after the header.  This is the
actual message, the author published in the newsgroup. Be aware of an article
possibly containing quotes from other articles, which are not always
recognizable as quotes. This depends on the newseditor and the habits of the
author.</para>

<para>&knode; provides some highlightings, wich are used in the article window.
At the moment these are:

<simplelist>
<member>/italic/</member>
<member>*bold*</member>
<member>_underlined_</member>
</simplelist>
</para>

<para>Do not use the highlighting too often. With increasing use of it, the
impact decreases.</para>

<para>Most of the time a quote is indicated by a prefixed &gt; on every
line. There are other possible signs. If you can not directly recognize a quote,
the author did not obey the rules of proper quoting.</para>

<para>Furthermore it is usual to start an anwser with a introductionary
line.</para>

<para>Something like:
</para>
<informalexample>
<para> On 12/25/2000 Santa Claus wrote:</para>
</informalexample>

<tip><para>Normally you do not have to bother with these introductionary lines.
&knode; does this automaticaly, when you reply to an article. How to configure
this line, you can read in chapter <xref
linkend="knode-composer-settings"/></para></tip>

<para>In <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem> <guilabel>Reading News </guilabel>
<guilabel>Appearance</guilabel></menuchoice> you can choose how the articles are
shown.  In particular &knode; provides the smat coloring of different reply
levels.  You can read more about this in th chapter <xref
linkend="knode-appearance"/>.</para>

<caution><para>&knode; provides smart colouring of quotes, but at the moment,
only quotes starting with &gt; are coloured.</para></caution>

<para>When the body of an article contains links to internet adresses, you can
invoke an internet browser, starting with this adress, by clicking on the
link.  Details about configuring this feature you can find in <xref
linkend="setting-news-general"/>.</para> 

</sect4>

<sect4>
<title>The signature</title>
<para>
Below the main text of an article, you find the signature of the author.
Provided you did not turn this behaviour off in
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem>
<guilabel>Reading News</guilabel>
<guilabel>General</guilabel></menuchoice>
The signature is divided from the text by thin, horizontal line.
</para>
</sect4>

<sect4>
<title>Attachments and multipart-mime messages</title>

<para>If an article contains attachment, they are shown below the signature in a
table.</para>

<para>The multipart-mime format allows to send the body of an article in more
than one format. For example in plain-text or <abbrev>HTML</abbrev>. It depends
on the newsreader which format to provide for reading the article. </para>

<para>&knode; allows showing the different formats by selecting
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem>
<guilabel>Reading News</guilabel>
<guilabel>General</guilabel>
<guilabel>show alternative contents as attachments</guilabel>
</menuchoice>.
When this option is checked, all alternative formats are sown as
attachments and can be opend and viewed like them.
</para>

<para>When this option is unchecked, you do not see the different text formats
and &knode; decides which one is best to be shown. </para>

</sect4>
</sect3>
</sect2>

<sect2 id="post-and-mail-news">
<title>Writing and replying to articles</title>

<para>Before you start writing article or replying to other Usenet users, be
sure you understand the habits in the current newsgroup. Again, reading <xref
linkend="knode-journey"/> would be a good idea.</para>

<para>For testing the Settings of &knode; please resist sending an article to a
random newsgroup. It is not very friendly to bother people with test
articles. What if you are subscribed to a newsgroup and half of its articles are
only containing the word <quote>test</quote>? This is like somebody calling you
just for testing her phone.</para>

<para>This is the reason for the special groups having <quote>test</quote> in
their name. An example is: <emphasis>alt.test</emphasis>. In these groups you
can test everything you want, without bothering somebody. Some groups even send
you error messages back. </para>

<para>You can find a selection of test groups in
<link linkend="infos-testgroups">Test Groups</link></para>

<para>Subscribe to one of the test groups now. Some newsservers have their own
test groups, which are probably less crowded. </para>

<tip><para>Remember, you have to download the articles of the new subscribed
group.  Perhaps there are many articles in these groups, so it will take some
time to fetch them the first time. The only important articles are yours and the
anwsers by the check handler. If you want to reduce the amount of fetched
articles during the test.  you can configure this in
<menuchoice>
 <guimenu>Settings</guimenu>
  <guilabel> Preferences</guilabel>
   <guilabel> Reading News</guilabel>
    <guilabel> General</guilabel>
     <guilabel> max to fetch</guilabel>
</menuchoice>
If you reduce this dramatically, you should not wait too long for fetching the
new articles after sending your test article. You article can be a vicitim of
your limitations.  A tolerably fast newsserver, should provide your article
right after you sent it.  Feel free to send another article, if can not see you
initial one. This is what the test groups are for. </para></tip>

<caution><para>When you are using a local newsserver, the configuration of
<guilabel>max to fetch</guilabel> in &knode; is useless. You should consult the
documentation of you newsserver instead.</para></caution>

<para>If you did not encounter any errors, unsubscribe from the testgroups and
set <guilabel>max to fetch</guilabel> back to normal (1000).</para>

<sect3>
<title>Publishing articles</title>

<para>You have seen a big part of &knode; now. You used &knode; passively so
far, so lets get to some action. We will publish a test article now.  Select the
new subscribed test group in the folder view.  With <menuchoice>
<guimenu>Article</guimenu> <guimenuitem>Post new article</guimenuitem>
</menuchoice> or the key <keycap>P</keycap>, the Editor is called.
</para>

<para>You can use the &knode;-Editor like a normal Texteditor.  There are some
additional features for writing news articles.</para>

<para>When you look at the editor window, you see two input lines.  One for the
subject, which is empty at the moment, and another for the newsgroups this
article is going to be posted to.</para>

<para>Enter the text <userinput> This is a test </userinput> in the subject
field.</para>

<tip><para>When you post an article, use a descriptive subject. Articles without
a descriptive subject are often ignored. Avoid subjects like <quote>Help, it
doesn't work !!!!!</quote> This subject gives no information about the content
of your article.</para></tip>

<para>The <guilabel>Groups:</guilabel> field already contains the test newsgroup
you selected befor. Do not change this.</para>

<para>The features provided by the Check Box and Combo Box below the input
fields mentioned above, are not used in this test. Please refer to <link
linkend="knode-editor-advanced">The Editor</link> for further
information.</para>

<para>For simplicity reasons we only use a simple sentence. Type:</para>

<para><userinput>This is the body of my test article. @ $ %</userinput></para>

<para>Enter an empty line, followed by.</para>

<para><userinput>Did it work?</userinput></para>

<para>This may look funny to you, but it does what it is supposed to do,
testing your configuration. Just write it.</para>

<para>Your article should look like the screenshot below now.</para>

<screenshot>
<screeninfo>Your first article</screeninfo>
 <mediaobject>
  <imageobject>
    <imagedata fileref="knode-new-article.png" format="PNG"/>
  </imageobject>
  <textobject>
   <phrase>Your first article</phrase>
  </textobject>
  <caption><para>Your first article</para></caption>
 </mediaobject>
</screenshot>

<para>If you are using &knode; with a local newsserver,  choose
<menuchoice>
 <guimenu>File</guimenu>
  <guimenuitem>Send Now</guimenuitem>
</menuchoice> in the Editor.
If you do not have a connection to a newsserver at this point,
you may want to send the article later. You can achieve this by using
<menuchoice>
 <guimenu>File</guimenu>
  <guimenuitem>Later</guimenuitem>
</menuchoice>.
&knode;, then, stores this article in the folder <guilabel>Outbox</guilabel>.
You can start sending the articles in the <guilabel>Outbox</guilabel> manually,
by selecting
<menuchoice>
 <guimenu> File</guimenu>
 <guimenuitem> Send pending messages</guimenuitem>
</menuchoice>.
</para>

<para>After sending the article you will notice &knode; stored a copy in
the folder  <guilabel>Sent</guilabel>.</para>

<para>Depending on how fast your article is published in the according
newsgroup, you can check the result after some time. Mostly it is sufficient to
check for new messages immediately after sending the article. Be patient it
<emphasis>may</emphasis> take the article some hours before reaching the
newsgroup. If the article does not arrive after some hours, most likely,
something went wrong. Try again. If it is still not working, have a look at the
<link linkend="faq">Frequently Asked Questions</link></para>

<important><para>Even when you are using a local newsserver, you have to check
for new articles. The local newsserver just sends the article, it does not store
it in the local newsgroup. So you have to synchronise with an external
newsserver, if you want to see if your test article arrived.</para></important>

<para>When the article shows up in the newsgroup, you were successful. Check the
<guilabel>From: </guilabel> line and the readability of the articles body.  If
everything is ok, you succesfully used &knode; to send your first
article.</para>

</sect3>

<sect3>
<title>Post Reply</title>

<para>After succesfully publishing an article, we will now anwser to your
own article. You want to anwser the question you asked, don't you?</para>

<para>Select your article in the article view and press the right mouse button.
You see a context menu, where you choose <guimenuitem>Post
reply</guimenuitem>.</para>

<para>&knode; opens the Editor again, but this time there is already a subject
filled in for you. The subject line reads:</para>

<para><emphasis>
Re: This is a test
</emphasis>
</para>

<para><emphasis>Re: </emphasis> is a shortcut for the latin <quote>In
re</quote>, which means something in the lines of "relating to". You should not
change the subject and above all the <emphasis>Re: </emphasis>. Most newsreaders
sort threads by the subject.</para>

<tip><para>If you want to change the subject for some reason, put the new subject
in front of the old and  replace the Re: with a parenthesized (Was: ... ). In our example
this would look like</para>

<informalexample>
<para>A new subject! (Was: This is a test)</para>
</informalexample>

<para>With this kind of subject you show the other readers, there is a branch in
the original discussion. This happens, when a new topic occurs in the original
discussion or the original subject changed for some reason.</para>

<para>If you anwser to an article with such a subject, delete the parenthesized
part of the subject. The first part with a prefixed <emphasis>Re:</emphasis>
remains.

<informalexample>
<para>Re: A new subject!</para>
</informalexample>
</para>
</tip>

<para>Let us have look at the Editor now. The contents of the article, we want
to reply to has already been copied to the Editor by &knode; To indicate the
text is a quote, every line is prefixed with a <emphasis>
&gt;</emphasis>.</para>

<para>In front of the quoted text, &knode; has put a introduction line.
The content of this line refers to the original author.
You can change the standard text of this line in
<menuchoice>
 <guimenu>Settings </guimenu>
<guimenuitem>Preferences </guimenuitem>
<guilabel>Posting News </guilabel>
<guilabel>Composer </guilabel>
<guilabel>Introduction Phrase: </guilabel>
</menuchoice>.
</para>

<para>The original article contains the question:
<emphasis>Did it work?</emphasis>
We want to anwser this question now.
</para>

<para>Place the cursor below the quoted question and write in the next
line:</para>

<para><userinput>Yes it worked, congratulations!</userinput>
</para>

<para>We are not finished now. It is considered polite to begin with
greeting like <quote>Hello</quote> in the first line. If you call the atuthor by
his name or not, depends on your habits. Watch the newsgroup to get used to the
habits there.</para>

<para>Next we delete all not mandatory parts of the quoted article. In our case,
we delete all parts, except the question. </para>

<para>With such a short text this is unnecessary, but this just an example.  If
you have to read a message 100 lines long, again, just to find a <citation>"I
agree"</citation> at the end, you will understand.  Aside from this, articles
get smaller and use less space on the server.</para>

<para>In the end we say good bye.</para>

<para>This screenshot shows our answer before sending it.</para>

<screenshot>
<screeninfo>Your answer on your article</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="knode-followup.png" format="PNG"/>
	  </imageobject>
	<textobject>
	<phrase>Your answer on your article</phrase>
	</textobject>
	  <caption><para>Your answer on your article</para></caption>
	</mediaobject>
</screenshot>

<para>Sending the reply is equivalent to sending the original article.</para>

</sect3>

<sect3>
<title>Mail Reply</title>

<para>The Mail Reply follows the same lines as posting a reply in a newsgroup.
The Mail Reply is sent directly to the author and does not apear in any
newsgroup. This is the only difference.</para>

<para>Sometimes it is better to use an emailed reply instead of posting a reply
to newsgroup.  Primarily, when you want to correct an error or misconduct by the
author, without hurting his feelings by doing this publicly on the
newsgroup.</para>

<para>For answering with an e-mail, you select your article, again, open the
context menu with the right mouse button, and choose <guimenuitem>Mail
Reply</guimenuitem>.  &knode; opens the Composer with the quoted article.</para>

<para>Subject and body are identical with posting an article, but the
<guilabel>Groups:</guilabel> field is replaced by a <guilabel>To:</guilabel>
field. Here appears the authors e-mail adress.  In our example this should be
your own e-mail adress, if &knode; is set up correctly.</para>

<para>For e-mails apply the same rules for quoting and politness apply as for
posting an article in a newsgroup.</para>

<para>After finishing your Reply, you can send it.</para>

<para>The screenshot shows the reply we distributed by email.</para>

<screenshot>
<screeninfo>A Mail Reply</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="knode-reply.png" format="PNG"/>
	  </imageobject>
	<textobject>
	<phrase>A Mail Reply</phrase>
	</textobject>
	  <caption><para>A Mail Reply</para></caption>
	</mediaobject>
</screenshot>

<important><para>The Mail Reply only works, when you used the right settings in
<menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Preferences</guimenuitem>
<guilabel>Accounts</guilabel> <guilabel>Mail</guilabel> </menuchoice>.</para>

<para>Depending on the configuration of your computer, you will find the reply
in your mailbox. Perhaps you have to connect to your ISP first and fetch your
new mails.</para></important>

</sect3>
</sect2>
</sect1>

<sect1 id="more-knode-features">
<title>The advanced &knode; features</title>

<sect2 id="using-filters">
<title>Defining and using Filter</title>

<para>You alrady read about using Filters in the chapter explaining the
configuration of &knode;. We were talking about the build-in filters provided by
&knode; there.  You can configure the built-in filters like all the others. The
screenshot shows the Dialog Box for confguring the Filters.</para>

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

<para>First we will create a new filter. There will be the case, that you want
to find your own articles among all the others. Or you do not want to see the
articles of a particular person at all. Both cases can be solved by a simple
filter on the Sender.  Here are some examples:</para>


<procedure>
<title>Do not show the articles by a particular person</title>

<step performance="required" ><para>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem> Preferences</guimenuitem>
<guilabel> Reading News</guilabel>
<guilabel> Filters</guilabel>
</menuchoice></para>
</step>

<step performance="required">
<para>Select <guibutton>Add</guibutton>
</para>
</step>

<step performance="required">
<para>Insert <userinput>Do not show idiot</userinput>
in the Text Box <guilabel>Name</guilabel>
</para>
</step>

<step performance="required">
<para>For making the filter appear in the menu, check
<guilabel>show in menu</guilabel>.
</para>
</step>

<step performance="required">
<para>Check the Check Box
<guilabel>From</guilabel>.
</para>
</step>

<step performance="required">
<para>Chose <guilabel>does NOT contain</guilabel> from the
Drop Down Box.
</para>
</step>

<step performance="required">
<para>Insert the name of the moron you want to ignore in the now active
Text Box for example <userinput>Idiot</userinput>.
</para>
</step>

<step performance="required">
<para>Confirm the filter settings with
<guibutton>OK</guibutton>
</para>
</step>
</procedure>

<para>The filter now shows all articles, except the ones containing
<quote>Idiot</quote> in the From: line.
</para>

<para>You can combine the settings of the tab for Subject + From line
with the settings on the other tabs. For example:
</para>

<procedure>
<title>Show only discussion with unread follow-ups on own articles.</title>

<step>
<para><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem> Preferences</guimenuitem>
<guilabel> Reading News</guilabel>
<guilabel> Filter</guilabel></menuchoice>
</para>
</step>

<step>
<para>Select the predefined filter "threads with own articles"
</para>
</step>

<step>
<para>Select <guibutton>Copy</guibutton>
</para>
</step>

<step>
<para>Insert <userinput>My threads with unread</userinput>
in the <guilabel>Name</guilabel> field.
</para>
</step>

<step>
<para>Select the tab
<guilabel>Status</guilabel>
</para>
</step>

<step>
<para>Select <guilabel>has unread followups</guilabel>
</para>
</step>

<step>
<para>Select <guilabel>true</guilabel> in the Drop Down Box next to it.

</para>
</step>

<step>
<para>Confirm the filter settings with
<guibutton>OK</guibutton>
</para>

<para>This filter shows all threads your are participating in, wich have unread
messages. Also, you saw the possibility, to use already existing filters as a
base for new ones. This makes life easier for complex filters.</para>

</step>
</procedure>

<procedure>
<title>Show all articles, no older than 3 days, containing KNode in the subject.</title>

<step>
<para><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem> Preferences</guimenuitem>
<guilabel> Reading News</guilabel>
<guilabel> Filter</guilabel></menuchoice>
</para>
</step>

<step>
<para>Select <guibutton>Add</guibutton>
</para>
</step>

<step>
<para>Insert  <userinput>Last KNode threads</userinput>
in the <guilabel>Name</guilabel> field.
</para>
</step>

<step>
<para>If you want this filter to appear in the menu, check the check box
<guilabel>show in menu</guilabel>.
</para>
</step>

<step>
<para>In the Drop Down Box <guilabel>apply on</guilabel> select
<guilabel>single articles</guilabel>
</para>
</step>

<step>
<para>Select the Check Box
<guilabel>Subject</guilabel>.
</para>
</step>

<step>
<para>Select
<guilabel>does contain</guilabel> in the Drop Down Box.
</para>
</step>

<step>
<para>Insert <userinput>knode</userinput> in the now active Text Box.
</para>
</step>

<step>
<para>Change to Tab
<guilabel>Additional</guilabel>
</para>
</step>

<step>
<para>Select the Check Box <guilabel>Alter</guilabel>
</para>
</step>

<step>
<para>Place the following settings <guilabel> 0 &lt; days &lt;= 3
</guilabel>
</para>
</step>

<step>
<para>Confirm with
<guibutton>OK</guibutton>
</para>

<para>This filter, now, shows all articles, no older than 3 days, containing
<emphasis>knode</emphasis> in the subject.
</para>
</step>
</procedure>
</sect2>

<sect2 id="knode-editor-advanced">
<title>The Composer</title>

<para>The &knode;-composer provides many features, especially for posting and
replying to articles.</para>

<sect3>
<title>Publish articles in multiple newsgroups</title>

<para>By selecting the Button <guilabel>Browse</guilabel> you can choose
additional newsgroups, you want to publish your article in.</para>

<caution><para>It is undesirable to post articles in multiple newsgroups, most
of the time. Please think about it twice. If you are not sure, where to post
your article, ask in one of the possible groups. Sombody will tell you were to
post.</para></caution>

</sect3>

<sect3>
<title>Redirect Followups</title>

<para>The main use of this feature is the case, when a thread has gone off topic
for the newsgroup it is posted in. For example a thread in a kde newsgroup about
how to redirect a followup in &knode; which leads to a dicussion about graphical
and text based newsreaders.</para>

<para>Another reason for using <guilabel>Followup-To:</guilabel> is a possible
crossposting in multiple newsgroups. You should take care that the replys will
be posted in one single newsgroup.</para>

<para>You can activate this by checking the Check Box <guilabel>Followups -
To:</guilabel>.  When this is checked, you can enter the according newsgroup in
the Text Box next to it. If there are multiple newsgroups in the
<guilabel>Groups:</guilabel> field, they are shown in the Drop Down List.</para>

<tip><para>When you enter <userinput>poster</userinput> here, instead of a
newsgroup, the replies go directly to the author, not to the
newsgroup. </para></tip>

</sect3>

<sect3>
<title>Working with an external Editor</title>

<para>Using <menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem> Start External Editor</guimenuitem>
</menuchoice> you can start an editor of your choice,
for editing the reply. So you can use your prefered Editor
for writing articles and e-mails.</para>
</sect3>

<sect3>
<title>Spelling</title>

<para>By selecting
<menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Spelling</guimenuitem>
</menuchoice>, you can check the article in the composer
on spelling errors.
</para>
</sect3>

<sect3>
<title>Sending attachments</title>

<para>By selecting<menuchoice>
<guimenu>Attachments</guimenu>
<guimenuitem> Attach File</guimenuitem>
</menuchoice>
you open the File Selection Dialog Box. Here you can choose the
file you want to attach.
</para>

<para>Most of the time, &knode; determines the correct <acronym>MIME</acronym>
type for the attachment. If &knode; errs, you can correct the
<acronym>MIME</acronym> type manually.</para>

<caution><para>Please, only change the <acronym>MIME</acronym> type, if you know
what you are doing. A wrong <acronym>MIME</acronym> type can make your
attachment unreadable. </para> </caution>

<para>This screenshot shows the Composer with 2 attachments. A text
file and a PNG-picture.
</para>

<screenshot>
<screeninfo>Sending attachments</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="knode-composer-attachments.png" format="PNG"/>
	  </imageobject>
	<textobject>
	<phrase>Sending attachments</phrase>
	</textobject>
	  <caption><para>Sending attachments</para></caption>
	</mediaobject>
</screenshot>

<important><para>In most newsgroups, attachments are prohibited. Do not send
unsolicited attachments. If you are asked to send them, look who is asking
for. Mostly, this person wants you to send them by e-mail.</para>

<para>The newsserver probably rejects article with attachments for most
groups anyway.</para></important>

</sect3>
</sect2>

<sect2>
<title>Searching for articles</title>

<para>Sooner or later, you will start searching for one specific article.
The &knode; search feature is an easy way to do so.</para>

<para>You can reach the search function by selecting<menuchoice>
<guimenu>Article</guimenu>
<guimenuitem>Search</guimenuitem>
</menuchoice> or the <keycap>F4</keycap> key.
The screenshot below shows the Search Dialog Box.
</para>

<screenshot>
<screeninfo>The Search Dialog Box</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="knode-search.png" format="PNG"/>
	  </imageobject>
	 <textobject>
	<phrase>The Search Dialog Box</phrase>
	 </textobject>
	  <caption><para>The Search Dialog Box</para></caption>
	</mediaobject>
</screenshot>

<para>The Search Dialog Box has three tabs, which allow several
search criteria. The first tab contains the settings for the criterias
<guilabel>Subject</guilabel> and <guilabel>From</guilabel>. The second tab
contains the Settings for the <guilabel>Status</guilabel> of an article.
Additional contains the criteria, wich do not belong to the first or
second tab.
</para>

<para>You propably already noticed the similarities between the Filter Dialog Box
and the Search Dialog Box. The usage is the same and should not be too
complicated, if you already defined your own filters. </para>

<para>&knode; always searches in the currently active newsgroup.  A search in
all newsgroups is not possible at the moment.  After the Search finished, the
articles found appear in the article view.  When you close the Search Dialog
Box, When you close the Search Dialog Box with <guibutton>Close</guibutton> the
search results are deleted, and the old view of the newsgroup appears
again.</para>

<sect3>
<title><guilabel>Start Search</guilabel></title>
<para>With this button you start the Search with the search
criteria you defined. All articles in the selcted newsgroup,
fullfilling this criterias, appear in the article view.
</para>
</sect3>

<sect3>
<title><guilabel>New Search</guilabel></title>
<para>This button resets all search criteria.
</para>
</sect3>
</sect2>

<sect2 id="supersede-and-cancel">
<title>Supersede and cancel articles</title>

<para>This chapter deals with superseding and canceling articles.  You will not
use this two features very often, but they belong to the comfort features of a
newsreader.</para>

<caution><para>Both functions need a newsserver beeing able to handle them.  And
you should remeber that there is no guarantee, that no one has already read your
article, before it is superseded or canceled.</para>

<para>So first think, then post.</para>
</caution>

<sect3>
<title>Cancel</title>
<para>Canceling an article means deleting it from the newsgroup.
</para>

<para>Why should you want to cancel an article?  Well, perhaps you falmed
somebody in a rage and now you want to get this article out of the newsgroup,
because you regret what you wrote.  A personal insult, read by everybody, looks
not too good, especially when you regret it. So there is only one thing, cancel
the article.</para>

<para>Select the article you want to cancel and choose
<guimenuitem>Cancel</guimenuitem> in the context menu.  When you are sure it is
the right article, confirm &knode;s question with
<guibutton>Yes</guibutton>. Now you are asked if you want to send the Cancel
message now or later. For this example we decide to send it
<guibutton>Later</guibutton>. You will notice the new message in the folder
<guilabel>Outbox</guilabel>.</para>

<para>Now we want to look at the so called cancel message.  In the subject you
will find something like:</para>

<para><emphasis>cancel of &lt;n177m8.1m.ln@konqui.org&gt;</emphasis></para>

<para>This strange letters between the brackets are the
Message-ID of the article, you want to cancel.
This message tells the newsserver to delete your article.
When you look at complete header of this message by selecting
<menuchoice>
 <guimenu>View</guimenu>
 <guimenuitem>Show all headers</guimenuitem>
</menuchoice>
you will notice a line with the name <emphasis>control</emphasis> and the
content <emphasis>cancel &lt;xxxxx@ddddd.dd&gt;</emphasis> This line tells the
server, this message is a control message. In our case, this message cancels
your article.</para>

<para>You can still delete the control message from the
<guilabel>Outbox</guilabel>.</para>

<caution><para>Keep in mind, an article can only be identified by his
Message-ID.  You need this Message-ID if you want to cancel an article. Normaly
your article gets this Message-ID when it arrives at the newsserver.  Thats why
you can only cancel an article, when it is already published.  The articles in
the folder <guilabel>Sent</guilabel> have no Message-ID, so you can not cancel
them from there.</para>

<para>There is one exception. If you have configured &knode; to generate a
Message-ID, you can cancel you articles in folder <guilabel>Sent</guilabel> ,
too.</para>

<para>&knode; allows only to cancel your own articles. It refuses to cancel
articles from other authors.</para>
</caution>
</sect3>

<sect3>
<title>Supersede</title>

<para>Supersede overwrites your article with a new version.  One reason for
doing this could be:</para>

<para>You have written a long article and already posted it.  Now you find an
error in this article. You can cancel this article and post a new, corrected,
article. Or you can use Supersede.</para>

<para>Select this article in the article view. In the context menu, select
<guimenuitem>Supersede</guimenuitem>.&knode; will ask you, if you really want to
overwrite this article. Confirm with <guibutton> Yes</guibutton> and the
Composer appears.</para>

<para>In the Composer you can now make the wanted corrections and changes.  You
can publish this article in the same way as you post every other article.  When
the newsserver recives this article, it reads some special lines in the header
which tell the newsserver to supersede the older article.  Select
<menuchoice>
 <guimenu>File</guimenu>
<guimenuitem>Send Later</guimenuitem>
</menuchoice> for now, because we want to look at the articles header in
the <guilabel>Outbox</guilabel>.
</para>

<para>
Activate
<menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Show all headers</guimenuitem>
</menuchoice>, because we want to see all the header, the newsserver recives.
You will notice a line like:
</para>

<para>
Supersedes: &lt;oggcm8.4n5.ln@konqi.org&gt;
</para>

<para>This is the instruction for the newsserver for superseding the article
with the Message-ID &lt;oggcm8.4n5.ln@konqi.org&gt; with the new article.</para>

<para>Besides this Supersede is used for periodical posted
articles, <abbrev>i.e.</abbrev> <acronym>FAQ</acronym>s. The new article
supersedes the old one and the newsgoups do not end up with lots of different
versions. </para>

<caution><para>Again, using this function is only possible, if the article
already has a Message-ID. Normally articles get their by the newsserver.  This
means, you can only supersede articles, which are already published.</para>

<para>you can configure &knode; to generate this message, then you can supersede
your articles in the <guilabel>Outbox</guilabel>, too.</para>

<para>&knode; allows only to supersede your own articles.</para></caution>

</sect3>
</sect2>

<sect2 id="score-watch-ignore">
<title>Score, watch, ignore</title>

<para>Score, watch and ignore are only different names for the same
feature.</para>

<para>By scoring a thread, you determine its importance. &knode; allows scores
between 0 and 100. A normal article will get a score of 50 if you do not change
this. So threads with a score below 50 are less important and threads with a
score above 50 are more important than the average.</para>

<para>The score is an attribute of the thread and the articles in this thread.
So you can use the score for filtering and searching articles.  For example, you
can define a filter, which shows only articles with a score &gt; 50.</para>

<para>The function <guilabel>Watch</guilabel> only sets the score of all article
in a thread to 100. So they get the highest possible score and &knode; labels
them with a special icon.</para>

<para>The function <guilabel>Ignore</guilabel> does the opossite.  Ignore scores
all articles with 0 and does not show this articles anymore.</para>

<para>In this version &knode; only allows the scoring of threads.</para>

</sect2>

<sect2 id="group-identity">
<title>Group identities</title>

<para>With &knode; you can use a different identity with every newsgroup you are
subscribed to. This involves name, e-mail, reply-to adress and signature.</para>

<para>It is easy to set group identities. For setting up a group identity,
select the according newsgroup. In the context menu, select
<guimenuitem>Settings</guimenuitem>. The second tab is identical with the global
identity settings. Confirm your settings with <guibutton>OK</guibutton> and your
articles in this group are always posted with this identity.</para><caution>

<para>When you unsubscribe from a group, you lose the identity settings for this
group. If you resubscribe to this group, you have to repeat the settings. For
new newsgroups, the global identity is used.</para></caution>

</sect2>

<sect2 id="multiple-news-accounts">
<title>Managing multiple news accounts</title>

<para>&knode; can handle a unlimited number of news server accounts in addition
to your main news server. Most users don't need this feature, but it can be very
handy to if your main newsserver doesn't provide all groups you want to
read. Typical cases are support groups for commercial software that are hosted
on a special server or binary newsgroups.</para>

<para>In order to add an new account, you have to open the preferences dialog via
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Preferences</guimenuitem>
<guilabel>Accounts</guilabel>
<guilabel>News</guilabel>
</menuchoice>
The button <guibutton>New</guibutton> creates a new account, you then have
to enter the same data as for your first account, typically a name for the
account, the host name and user name / password combination if the server
requires authentication. When this is done the new server will appear both
in the configuration dialog and in the group view. You can now subscribe to
newsgroups.</para>

<para>You can delete the currently selected account by pressing the
<guibutton>Delete </guibutton> button.</para>

</sect2>
</sect1>
</chapter>

<chapter id="commands">
<title>Command reference</title>

<para>The following keybinding assume, you did not change the
default settings.</para>

<sect1 id="knode-mainwindow">
<title>The main &knode; window</title>

<sect2>
<title>The menu <guimenu>File</guimenu></title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>S</accel>ave</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the selected article in a file.</action>
</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>P</accel>rint</guimenuitem>
</menuchoice></term>
<listitem><para><action>Prints the selected article.</action>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Sen<accel>d</accel> pending messages</guimenuitem>
</menuchoice></term>
<listitem><para><action>The messages in the folder Outbox are
send.</action>
</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Stop <accel>N</accel>etwork</guimenuitem>
</menuchoice></term>
<listitem><para><action>Disconnects the current connection to a
newsserver.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>Q</accel>uit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quits</action> &knode;.</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title>The <guimenu>Edit</guimenu> menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>c</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>C</accel>opy</guimenuitem>
</menuchoice></term>
<listitem><para><action>Copy the selected text in the 
clipboard.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Select <accel>A</accel>ll</guimenuitem>
</menuchoice></term>
<listitem><para><action>Selects the whole 
article.</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title>The <guimenu>View</guimenu> menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Show <accel>T</accel>hreads</guimenuitem>
</menuchoice></term>
<listitem><para>When this is activated, &knode; <action>shows 
discussions as a tree view in the
article view. </action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>E<accel>x</accel>pand all threads</guimenuitem>
</menuchoice></term>
<listitem><para>
When this is activated, &knode; <action>shows the complete threads.</action>
This is only funtional when <guilabel>Show threads</guilabel> is
active.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem><accel>C</accel>ollapse all threads</guimenuitem>
</menuchoice></term>
<listitem><para>When this is activated, &knode; <action>shows no 
threads.</action> This is only funtional when <guilabel>Show threads</guilabel>
is active. </para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>T</keycap>
</shortcut>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem><accel>T</accel>oggle Subthread</guimenuitem>
</menuchoice></term> <listitem><para><action>
Toggles between showing and collapsing the selected thread.
</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem><accel>F</accel>ilter</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Allows you to choose a filter for the article 
view.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>S<accel>o</accel>rt</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Allows you to sort the article view.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>F5</keycap>
</shortcut>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem><accel>R</accel>efresh list</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Refeshes the article view</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Show <accel>a</accel>ll headers</guimenuitem>
</menuchoice></term>
<listitem><para>
When this setting is activated, &knode; <action>shows the complete article header
in the article window.</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Go</guimenu> menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>N</keycap>
</shortcut>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem><accel>N</accel>ext article</guimenuitem>
</menuchoice></term>
<listitem><para><action>Jumps to next article in the article 
view.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>B</keycap>
</shortcut>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem><accel>P</accel>revious article</guimenuitem>
</menuchoice></term>
<listitem><para><action>Jumps to previous article in the article 
view.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Alt</keycap><keycap>Space</keycap></keycombo>
</shortcut>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>Next unread <accel>a</accel>rticle</guimenuitem>
</menuchoice></term>
<listitem><para><action>Jumps to the next unread article and to the 
first unread
article of the next newsgroup if nessecarry.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>
</shortcut>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>Next unread <accel>t</accel>hread</guimenuitem>
</menuchoice></term>
<listitem><para><action>Jumps to the next unread thread and to the next
unread thread in the next newsgroup, if nessecary.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>+</keycap>
</shortcut>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>Ne<accel>x</accel>t group</guimenuitem>
</menuchoice></term>
<listitem><para><action>Jumps to the next news group in the folder 
view</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>-</keycap>
</shortcut>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>Pre<accel>v</accel>ious group</guimenuitem>
</menuchoice></term>
<listitem><para><action>Jumps to the previous news group in the folder 
view</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Account</guimenu> menu</title>

<variablelist>
<varlistentry>
<term><menuchoice> <guimenu>A<accel>c</accel>count</guimenu>
<guimenuitem><accel>G</accel>et new articles</guimenuitem>
</menuchoice></term>
<listitem><para><action>Connects with the active account and fetches the
new messages.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>A<accel>c</accel>count</guimenu>
<guimenuitem><accel>S</accel>ubscribe to Newsgroups</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Opens the Dialog Box for subscribing to newsgroups for the active 
account.
</action>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>A<accel>c</accel>count</guimenu>
<guimenuitem><accel>P</accel>roperties</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the properties dialog for the active 
account.</action>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <guimenu>A<accel>c</accel>count</guimenu>
<guimenuitem><accel>D</accel>elete</guimenuitem> </menuchoice></term>
<listitem><para><action>
Deletes the active account and all subscribed newsgroups within.
</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Group</guimenu> menu</title>
<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>G<accel>r</accel>oup</guimenu>
<guimenuitem>Mark all as unread</guimenuitem>
</menuchoice></term>
<listitem><para><action>Sets the status of all aticles in the active 
newsgroup to
"unread".</action>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>G<accel>r</accel>oup</guimenu>
<guimenuitem><accel>P</accel>roperties</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the dialog for the group 
properties.</action>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>G</accel>roup</guimenu>
<guimenuitem><accel>U</accel>nsubscribe</guimenuitem>
</menuchoice></term>
<listitem><para><action>Unsubscribes from the active newsgroup</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>G</accel>roup</guimenu>
<guimenuitem><accel>C</accel>ompact Folder</guimenuitem>
</menuchoice></term>
<listitem><para><action>removes all deleted or moved articles physically
out of the active folder.
</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>G</accel>roup</guimenu>
<guimenuitem><accel>E</accel>mpty Folder</guimenuitem>
</menuchoice></term>
<listitem><para><action>Deletes all articles from the active
folder.</action>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title>The menu <guimenu>Article</guimenu></title>
<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>P</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem><accel>P</accel>ost to newsgroup</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the Composer with the settings for 
writing new
articles of the active newsgroup.
</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>R</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem><accel>F</accel>ollow up to newsgroup</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the Composer for writing a followup
with the content of the active article.
</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>A</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem>Reply by E-<accel>M</accel>ail
</guimenuitem></menuchoice></term>
<listitem><para><action>Opens
the Composer for writing an e-mail to the author of the active article.
</action>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>F</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem>Forw<accel>a</accel>rd by E-Mail</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the Composer for forwarding the
active article as e-mail.
</action>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>D</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guisubmenu>Mar<accel>k</accel></guisubmenu>
<guimenuitem>Mark as <accel>r</accel>ead</guimenuitem>
</menuchoice></term>
<listitem><para><action>Set the status of the active article</action> to
<quote>read</quote>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>U</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guisubmenu>Mar<accel>k</accel></guisubmenu>
<guimenuitem>Mar<accel>k</accel> as unread
</guimenuitem>
</menuchoice></term>
<listitem><para><action>Set the status of the active article</action> to
<quote>unread</quote></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>D</keycap></keycombo>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guisubmenu><accel>T</accel>hread</guisubmenu>
<guimenuitem>Mark thread as r<accel>e</accel>ad
</guimenuitem>
</menuchoice></term>
<listitem><para><action>Set the status of the active thread</action> to
<quote>read</quote></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guisubmenu><accel>T</accel>hread</guisubmenu>
<guimenuitem>Mark thread as u<accel>n</accel>read
</guimenuitem>
</menuchoice></term>
<listitem><para><action>Set the status of the active thread</action> to
<quote>unread</quote></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>S</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guisubmenu><accel>T</accel>hread</guisubmenu>
<guimenuitem>Score ...</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Opens the dialog for scoring the active thread.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>W</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guisubmenu><accel>T</accel>hread</guisubmenu>
<guimenuitem><accel>W</accel>atch</guimenuitem> </menuchoice></term>
<listitem><para><action>Set the status of the active thread</action> to
<quote>watched</quote></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>I</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guisubmenu><accel>T</accel>hread</guisubmenu>
<guimenuitem><accel>I</accel>gnore</guimenuitem> </menuchoice></term>
<listitem><para><action>Set the status of the active thread</action> to
<quote>ignored</quote></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem><accel>C</accel>ancel
</guimenuitem>
</menuchoice></term>
<listitem><para><action>Generate a message which deletes the
active Article in Usenet. You can only use this with your own articles.
</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem>S<accel>u</accel>persede</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the Composer with the content of
the active article. When this article is posted, it overwrites
the original article. You can only use this with your own articles.
</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>O</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem>Open in own <accel>w</accel>indow</guimenuitem>
</menuchoice></term>
<listitem><para><action>The active article is opend in a new window.
</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>E</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem><accel>E</accel>dit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the Composer, for editing the active 
article.</action>
You can only use this in the folders <guilabel>Outbox</guilabel> and
<guilabel>Drafts</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>Delete</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem><accel>D</accel>elete</guimenuitem>
</menuchoice></term>
<listitem><para><action>Deletes the active article.</action>
You can only use this in the folders <guilabel>Outbox</guilabel> and
<guilabel>Drafts</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem>Send <accel>n</accel>ow</guimenuitem>
</menuchoice></term>
<listitem><para><action>Sends the active article.</action>
You can only use this in the folders <guilabel>Outbox</guilabel> and
<guilabel>Drafts</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem>Send Later</guimenuitem>
</menuchoice></term>
<listitem><para>Puts the active article in the folder
<guilabel>Outbox</guilabel>. You can only use this in the folder
<guilabel>Drafts</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>F4</keycap>
</shortcut>
<guimenu><accel>A</accel>rticle</guimenu>
<guimenuitem>Search</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Opens the Search Dialog Box for searching in the active group.
</action></para></listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title>The <guimenu>Settings</guimenu> menu</title>
<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show <accel>T</accel>oolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>This option toggles if the toolbar is shown or 
not.
</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show St<accel>a</accel>tusbar</guimenuitem>
</menuchoice></term> <listitem><para><action>
This option toggles if the statusbar is shown or not.
</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Configure <accel>K</accel>ey Bindings</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens a dialog for configuring the key bindings.
</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Configure Tool<accel>b</accel>ars</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens a dialog for configuring the toolbars.
</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice> <guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem><accel>C</accel>onfigure KNode</guimenuitem> </menuchoice></term>
<listitem><para><action>Opens a dialog for configuring</action>
&knode;.</para></listitem>
</varlistentry>


</variablelist>
</para>
</sect2>

<sect2>
<title>The <guimenu>Help</guimenu> menu </title>
<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F1</keycap></shortcut>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>C</accel>ontents</guimenuitem>
</menuchoice></term>
<listitem><para>
Opens the &knode; online-help. The document you are
reading right now.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Shift</keycap><keycap>F1</keycap></keycombo></shortcut>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem>What's <accel>t</accel>his?</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens the quick help.</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>R</accel>eport Bug</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens the Bug Report Dialog.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>A</accel>bout KNode</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens the dialog with information</action> about &knode;.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem>About <accel>K</accel>DE</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens a dialog with information about the KDE-Project and the
current KDE version you use.
</action></para></listitem>
</varlistentry>

</variablelist>
</para>
</sect2>
</sect1>

<!-- Lauri -->

<sect1 id="knode-editorwindow">
<title>The composor menus.</title>

<sect2>
<title>The <guimenu><accel>F</accel>ile</guimenu> menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">
<keycap>Ctrl</keycap><keycap>Return</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>S</accel>end Now</guimenuitem>
</menuchoice></term> <listitem><para><action>Send the current article immediately.
</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <guimenu><accel>F</accel>ile</guimenu> <guimenuitem>Send
<accel>L</accel>ater</guimenuitem>
</menuchoice></term>
<listitem><para><action>Store the current article</action> in the
<guilabel>Outbox</guilabel> to be sent later.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <guimenu><accel>F</accel>ile</guimenu> <guimenuitem>Save as
<accel>D</accel>raft</guimenuitem> </menuchoice></term>
<listitem><para><action>Save the current article</action> in the
<guilabel>Drafts</guilabel> folder, so you can finish editing it another
time.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>D<accel>e</accel>lete</guimenuitem> </menuchoice></term>
<listitem><para><action>Delete the current article, closing the editor.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu> <guimenuitem><accel>C</accel>lose</guimenuitem>
</menuchoice></term> <listitem><para><action>Close the editor
window</action></para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>The <guimenu>Edit</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem>Und<accel>o</accel></guimenuitem>
</menuchoice></term> <listitem><para><action>Undo the last edit.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>Shift</keycap>
<keycap>Z</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem>Re<accel>d</accel>o</guimenuitem>
</menuchoice></term> <listitem><para><action>Redo the last action</action> undone with
the <guimenuitem>Undo</guimenuitem> menu entry.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>X</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem>C<accel>u</accel>t</guimenuitem>
</menuchoice></term> <listitem><para><action>Cut the currently selected text to
the clipboard, deleting it from the editor window.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem><accel>C</accel>opy</guimenuitem>
</menuchoice></term> <listitem><para><action>Copy the selected text to the
clipboard, without removing it from the editor window.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem><accel>P</accel>aste</guimenuitem>
</menuchoice></term> <listitem><para><action>Paste the current contents of the
clipboard to the editor window.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>A</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem>Select <accel>A</accel>ll</guimenuitem>
</menuchoice></term> <listitem><para><action>Select all the text in the editor window.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>F</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem><accel>F</accel>ind</guimenuitem>
</menuchoice></term> <listitem><para><action>Open the Find dialog.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F3</keycap></shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem>Find <accel>N</accel>ext</guimenuitem>
</menuchoice></term> <listitem><para><action>Repeat the last search.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>R</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem><accel>R</accel>eplace...</guimenuitem>
</menuchoice></term> <listitem><para><action>Open the replace dialog.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem>Start External Editor</guimenuitem>
</menuchoice></term> <listitem><para><action>Start the external editor (if one
is configured), with the current contents of the editor window.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu> <guimenuitem>Spelling...</guimenuitem>
</menuchoice></term> <listitem><para><action>Opens a dialog box to check your spelling.
</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Attach</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu><accel>A</accel>ttach</guimenu> <guimenuitem>Append <accel>S</accel>ignature</guimenuitem>
</menuchoice></term> <listitem><para><action>Insert your signature at the end of
the article you are editing.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>A</accel>ttach</guimenu> <guimenuitem><accel>I</accel>nsert File</guimenuitem>
</menuchoice></term> <listitem><para><action>Insert the contents of a file into
the editor window.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>A</accel>ttach</guimenu> <guimenuitem>Attach <accel>F</accel>ile</guimenuitem>
</menuchoice></term> <listitem><para><action>Insert a file as an attachment.
</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Settings</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu> <guimenuitem>Show <accel>T</accel>oolbar</guimenuitem>
</menuchoice></term> <listitem><para><action>Toggles on and off the
toolbar.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu> <guimenuitem>Configure <accel>K</accel>eybindings...</guimenuitem>
</menuchoice></term> <listitem><para><action>Open a dialog box where you can
configure the keyboard shortcuts.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Configure
Tool<accel>b</accel>ars...</guimenuitem></menuchoice></term>
<listitem><para><action>Open a dialog box where you can configure the toolbar
icons.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu> <guimenuitem><accel>C</accel>onfigure KNode</guimenuitem>
</menuchoice></term> <listitem><para>Open the &knode; <action>Preferences
dialog.</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>
<sect2>
<title>The <guimenu>Help</guimenu> menu </title>
<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F1</keycap></shortcut>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>C</accel>ontents</guimenuitem>
</menuchoice></term>
<listitem><para>
Opens the &knode; <action>online-help</action>. The document you are reading
right now.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Shift</keycap><keycap>F1</keycap></keycombo></shortcut>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem>What's <accel>t</accel>his?</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens the quick help.</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>R</accel>eport Bug</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens the Bug Report Dialog.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>A</accel>bout KNode</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens the dialog with information</action> about &knode;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem>About <accel>K</accel>DE</guimenuitem>
</menuchoice></term> <listitem><para><action>
Opens a dialog with information</action> about the &kde; Project and the
current &kde; version you use.
</para></listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

</sect1>
</chapter>

<chapter id="faq">
<title>Questions and Answers</title>

<qandaset id="faq-questions">

<qandaentry>
<question>
<para>I have installed KDE2, but &knode; does not exist in the
<guimenu>K</guimenu> Menu.</para></question>

<answer>
<para>Does the Entry <guisubmenu>Internet</guisubmenu> exist? If not, maybe you
didn't install the kdenetwork package because your distribution possibly doesn't
do this for you. If the entry is there, but you don't have an item
<guimenuitem>KNode</guimenuitem> in it, you should try to open a
<application>Konsole</application> and run &knode; from there. Type</para>

<screen width="40">
<prompt>%</prompt> <userinput><command>knode &amp;</command></userinput>
</screen>
<para>If an error message appears that tells you that &knode; could not be
started or found, please check whether the file <filename>knode</filename>
exists in <filename class="directory">$KDEDIR/bin</filename> and its permissions
are correctly set. </para>
</answer>
</qandaentry>

<qandaentry>
<question><para>When I start &knode;, a message appears in the task bar but
suddenly disappears without &knode; being started.</para></question>

<answer><para>Try to start &knode; from the <application>konsole</application>
(see previous question) and keep attention for the messages displayed there. If
those don't look obvious to you, mark them with your mouse and copy it to the
clipboard. Turn to a &kde; mailing list or use another news reader to ask for help
in a &kde; news group.</para></answer>

</qandaentry>

<qandaentry>
<question><para>I need an important article, but &knode; doesn't have it any
more. Where do I find this article?</para></question>

<answer><para>You can find some extensive usenet archives at
www.deja.com/usenet/ or AltaVista. They even contain several years old
articles.</para>
<!-- well, they do when they're not broken, like deja is now -->
</answer>
</qandaentry>

<qandaentry>
<question>
<para>How do I open and read several articles at the same
time?</para> </question>
<answer>
<para>Open the article with <guimenuitem>Open in own
window</guimenuitem>. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>My articles don't appear in the news group.
</para>
</question>
<answer>
<para>When you publish an article it may last some time
until your news server has it. Wait several hours before you send the
Article again. 
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>I want to keep some article. How do I archive
it?</para> </question>
<answer>
<para>
Choose the article in the article view. <menuchoice>
<guimenu>File
</guimenu>
<guimenuitem>Save
</guimenuitem>
</menuchoice> opens a file dialog. You can save the article to a file now.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>Some set headers don't appear for several articles in the article window.
Am I doing something wrong?
</para>
</question>
<answer>
<para>This is not unusual because many headers are optional and often not
contained in articles. In this case &knode; doesn't show those header
lines. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>Sometimes I see an article which refers to other articles but &knode; does
not show any references Why's that? </para>
</question>
<answer>
<para>
This happens when somebody posted an article in another news group and checked
the option <guilabel>Followup To</guilabel>. This article is sent to your news
group but the referring article is absent. In many cases the poster tells the
reason for his choice to set a followup.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>When I want to answer an article,
an error message appears telling me that the external editor could not be
started; but the editor is correctly set.
</para>
</question>
<answer>
<para>
Have a look whether you entered the place-holder for a filename
after the editor command. If not, enter it. If you &eg; want to use
<application>kedit</application>
enter
</para>
<para>
<userinput><command>kedit</command> <token>%f</token></userinput>
</para>
<para>If the <token>%f</token> is absent, your editor can not be run.
</para>
</answer>
</qandaentry>
</qandaset>

</chapter>
<!-- Martin End -->

<!-- START rainer -->
<chapter id="knode-journey">
<title>A journey in the World of Newsgroups</title>

<para>This chapter is supposed to glance over the World of Newsgroups and their
<quote>inhabitants</quote>. Someone who never dared to go there will encounter
some strange customs, wich may give you a feeling of being a lonely alien
without backup.  But stay calm, it is not like this. The Usenet is a meeting
place for all kinds of normal and not-so-normal folks. It is here where they are
distributing a lot of information but also gossip and other stuff.  </para>

<tip><para>References to more detailed and qualified essays on the Usenet can be found at
<link linkend="knode-more-info">More Resources</link>
</para>
</tip>

<sect1 id="about-news">
<title>What are ...</title>

<sect2>
<title>... online-readers?</title>
<para>An online-reader connects to a newsserver and gives you acces to its content.
 &knode; is an online-reader.  You are reading your News and publishing your own
 <glossterm>articles</glossterm>, while the online-reader stays connected.</para>
</sect2>

<sect2>
<title>... offline-readers?</title>
<para>An offline-reader connects to the Server and fetches only the headers of new 
articles. Then the connection is closed and you can
offline mark the articles, you are really interested in.
When you connent the next time, the offline-reader fetches the
articles you marked and sends the
articles you have written offline.
</para>

<para>There is no connection while you are reading or writing
articles.
</para>
</sect2>

<sect2>
<title>... newsgroups?</title>
<para>
You can look at newsgroups as public bulletin boards and forums, where evereybody
is allowed to participate. Articles you have published in a
newsgroup can be read by everybody subscribed to this newsgroup. And normally
everybody is allowed to publish her articles in a newsgroup.
</para>
</sect2>

<sect2>
<title>... news?</title>
<para>
News are articles published in a newsgroup.
</para>
</sect2>

<sect2>
<title>... threads?</title>
<para>A thread describes a discussion of one topic in a newsgroup.
</para>
</sect2>
</sect1>

<sect1 id="nettiquette">
<title>Online Manners</title>

<para>There are lot of different people meeting and talking in newsgroups.  It
is seen as some kind of courtesy to obey some rules of manner, Some basics are
listed here.</para>

<orderedlist>
<listitem> <para>Before you ask questions be sure you read the
newsgroups <acronym>FAQ</acronym> (Frequently Asked Questions) and didn't find
the anwser. </para> </listitem>

<listitem>
<para>If you take part in a discussion, be aware the fact, everybody can read the
anwser.  Say nothing you wouldn't say to the others when you were facing them.
Avoid insults.</para>
</listitem>

<listitem>
<para>Try to avoid crosspostings.  Do not ask a question in
more than one newsgroup when you don't know which is the right one.  Ask in one
newsgroup. If it is wrong, you are told which is right one.</para>
</listitem>

<listitem>
<para>
Formulate your articles accurately. Nobody likes to read
an article with lots of typos, even with content worth a Pulitzer. Think of your
articles as letters.  Your letter speaks for you, it represents you. Somebody
reading your article will draw conclusions about you from it, wrong or right.
</para>
</listitem>

<listitem>
<para>Remember, nobody sees your grin when you are writing an ironical
sentence. It may be funny for you, but it can be very serious for the one
reading it. It is very difficult to include emotions in an article. </para>
</listitem>

<listitem>
<para>The most important rule: Use your common sense when you are anwsering or
publishing an article. </para> </listitem>
</orderedlist>

</sect1>

<sect1 id="usenet-slang">
<title>The Usenet language</title>

<para> You won't be surprised about English beeing the main language on the
Usenet.  There are special trees with German (de.*), French (fr.*) and many
other languages.  If you are unable to determine the main language of a
newsgroup, the only possibility is careful listenening or a possible explanation
in the description of the group in the grouplist.  </para>

<para>In addition over the time the Usenet developed his own language,
but  happily it is easy to learn.</para>

<sect2>
<title><acronym>RTFM</acronym> and other typos</title>

<para>When you read news, after some time you will read some strange
combinations of letters. For example you can get a reply like:</para>

<!-- LW: This should be a variablelist, but I don't think there's time to change
before committing for Release.  We can fix for next version -->

<para>
RTFM
</para>

<para>
Nothing else. Strange but absolutely intended.  To solve the riddle: Those, most
of the time, are shortcuts, acronyms.  It is easier to drop some letters, than
writing the same sentence over and over again.
</para>

<para>
But what is the meaning of <acronym>RTFM</acronym>?  The writer demands you, to
read the manual, documentation or <acronym>FAQ</acronym> before asking questions
in the newsgroup. Clearer: (R)ead (T)he (F)ucking
(M)anual. <acronym>BTW</acronym> an advice you should adopt.
</para>

<para>
Wait, what is <acronym>BTW</acronym> now? Another often seen acronym which means
(B)y (T)he (W)ay. It is easy when you know it. Now, for you not to be
continously speculating over acronyms there is table at he end of this section,
containing the most often used aconyms. ;-)
</para>
</sect2>

<sect2>
<title>Smile!</title>
<para>
Again such a strange thing. What is this ;-) meant to be? Turn your
head so the left side of your Screen is on top. Got it?
You spot the smile with a wink?  This is a so called emoticon. Emoticons are
an often used possibility to express  mimic. One thing missing in conversation
on the Usenet. (But there is a susbstitute, remember? ;-)
</para>

<para>
It is very diffcult to express emotions in emails or news. Your joking comment
can be very serious for the recipient and can lead to unmeant reactions or conflicts
(flames). So use emoticons to express your intention.
</para>

<para>There are a lots of emoticons, which express a great variety of emotions.
You will see, the interpretation is easy  if you turn your head and think of a face.
</para>
</sect2>

<sect2>
<title>PLONK!</title>

<para>
This PLONK! looks like some comic-sound, doesn't it? And that is
exactly what it is used for. The one who reads it knows he was just added to the
killfile of a newsreader. Normally this means the recipient
of the PLONK! ticked off the sender. The PLONK!  plays back the sound of the
recipients name hitting the ground in the <glossterm>killfile</glossterm>. The
sender turned his back to the recipient.

</para>
</sect2>

<sect2 id="acronyms">
<title>Often used acronyms</title>

<para>When you are reading your news with &knode;, you will really soon see some
strange combinations of letters in the <glossterm>articles</glossterm>.
For a novice user it is difficult to guess the meaning of all the acronyms used.
That's why we provide you a list
of the most often used acronyms. This table is in no means complete. ;-) It is
based on a list originally provided by Martin Imlau.
</para>

<table>
<title>Acronyms on Usenet</title>
<tgroup cols="2">
<thead>
<row>
<entry>Acronym</entry>
<entry>Meaning</entry>
</row>
</thead>

<tbody>
<row>
<entry>&lt;g&gt;</entry>
<entry>(user) grins</entry>
</row>

<row>
<entry><acronym>AAMOF</acronym></entry>
<entry>As a matter of fact</entry>
</row>

<row>
<entry><acronym>ACK</acronym></entry>
<entry>Acknowledge</entry>
</row>

<row>
<entry><acronym>AFAIK</acronym></entry>
<entry>As far as I know</entry>
</row>

<row>
<entry><acronym>AFAIR</acronym></entry>
<entry>As far as I remember</entry>
</row>

<row>
<entry><acronym>AWGTHTGTTA</acronym></entry>
<entry>Are we going to have to go through this again?</entry>
</row>

<row>
<entry><acronym>ASAP</acronym></entry>
<entry>As soon as possible</entry>
</row>

<row>
<entry><acronym>BFN</acronym></entry>
<entry>Bye for now</entry>
</row>

<row>
<entry><acronym>BYKT</acronym></entry>
<entry>But you knew that</entry>
</row>

<row>
<entry><acronym>CMIIW</acronym></entry>
<entry>Correct me if I'm wrong</entry>
</row>

<row>
<entry><acronym>CU</acronym></entry>
<entry>See you</entry>
</row>

<row>
<entry><acronym>CU2</acronym></entry>
<entry>See you too</entry>
</row>

<row>
<entry><acronym>CYL</acronym></entry>
<entry>See you later</entry>
</row>

<row>
<entry><acronym>EOD</acronym></entry>
<entry>End of discussion</entry>
</row>

<row>
<entry><acronym>ESOSL</acronym></entry>
<entry>Endless snorts of stupid laughter</entry>
</row>

<row>
<entry><acronym>FYI</acronym></entry>
<entry>For your information</entry>
</row>

<row>
<entry><acronym>GOK</acronym></entry>
<entry>God only knows</entry>
</row>

<row>
<entry><acronym>HAND</acronym></entry>
<entry>Have a nice day</entry>
</row>

<row>
<entry><acronym>HTH</acronym></entry>
<entry>Hope that helps</entry>
</row>

<row>
<entry><acronym>HSIK</acronym></entry>
<entry>How should I know?</entry>
</row>

<row>
<entry><acronym>IAE</acronym></entry>
<entry>In any event</entry>
</row>

<row>
<entry><acronym>IANAL</acronym></entry>
<entry>I am not a lawyer</entry>
</row>

<row>
<entry><acronym>IIRC</acronym></entry>
<entry>If I remember correctly</entry>
</row>

<row>
<entry><acronym>IMCO</acronym></entry>
<entry>In my considered opinion</entry>
</row>

<row>
<entry><acronym>IMHO</acronym></entry>
<entry>In my humble opinion</entry>
</row>

<row>
<entry><acronym>IMNSHO</acronym></entry>
<entry>In my not so humble opinion</entry>
</row>

<row>
<entry><acronym>INPO</acronym></entry>
<entry>In no particular order</entry>
</row>

<row>
<entry><acronym>IOW</acronym></entry>
<entry>In other words</entry>
</row>

<row>
<entry><acronym>LMAO</acronym></entry>
<entry>Laughing my ass off</entry>
</row>

<row>
<entry><acronym>LOL</acronym></entry>
<entry>Laughing out loud</entry>
</row>

<row>
<entry><acronym>NAK</acronym></entry>
<entry>Not acknowledged</entry>
</row>

<row>
<entry><acronym>NBD</acronym></entry>
<entry>No big deal</entry>
</row>

<row>
<entry><acronym>NFW</acronym></entry>
<entry>No fucking way</entry>
</row>

<row>
<entry><acronym>ROTFL</acronym></entry>
<entry>Rolling on the floor, laughing</entry>
</row>

<row>
<entry><acronym>RTFM</acronym></entry>
<entry>Read the fucking manual</entry>
</row>

<row>
<entry><acronym>SCNR</acronym></entry>
<entry>Sorry, could not resist</entry>
</row>

<row>
<entry><acronym>TIA</acronym></entry>
<entry>Thanks in advance</entry>
</row>

</tbody>
</tgroup>
</table>
</sect2>
</sect1>

</chapter>
<!-- STOP rainer -->

<!-- martin start -->
<chapter id="knode-more-info">
<title>Further Information</title>


<para>In this paragraph we will offer you some more information resources which
could be useful to you. Many of the below listed articles (for which URLs are
given) are posted to news groups regularly. Some of those groups are also listed
here.
</para>

<sect1 id="infos-newsgroups">
<title>Informative Newsgroups</title>

<simplelist>

<member>news.answers</member>
<member>news.newusers.questions</member>

</simplelist>

<para>For beginners it is especially recommended to read these
articles at least partially. Informed
users have strong advantages in news groups. There are some more
specialized news groups where FAQs and introducing
articles are posted frequently.
</para>
</sect1>

<sect1 id="infos-testgroups">
<title>Test Groups</title>

<para>The following groups were created especially for testing, i.e.
after successfully configuring &knode; you should post some articles to
those groups to test your settings.
</para>

<para>
Some groups support automatic replys thru email to enable you to test
whether your entered identity is correct and mail-replys actually arrive
in your mailbox.
</para>

<para>
In addition, some scripts are offered which check your articles for
errorous settings and generate a followup with useful hints.
</para>


<simplelist>
<member>misc.test</member>
<member>alt.test</member>
<member>alt.test.ignore</member>
</simplelist>
</sect1>

<sect1 id="infos-technical">
<title>Informative technical articles</title>

<para>If you are interested in further technical information in connection to news,
you should not miss the following URLS.</para>

<simplelist>

<member><ulink url="http://www.qad.org/faq/faq-messageid.html">A very useful Message-ID FAQ</ulink></member>

<member><ulink url="http://www.leafnode.org/links">Many links regarding news readers and related issues.
</ulink>
</member>

<member><ulink url="http://www.landfield.com/usefor/">RFCs, drafts and documents for the technical interested
</ulink>
</member>
</simplelist>
</sect1>
</chapter>

<chapter id="credits">
<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

<title>Credits and License</title>

<para>
&knode;
</para>
<para>
Program Copyright 1999,2000 Christian Thurner <email>cthurner@freepage.de</email>
</para>
<para>
Developers:
<itemizedlist>
<listitem><para>Christian Thurner <email>cthurner@freepage.de</email></para>
</listitem>
<listitem><para>Christian Gebauer <email>gebauer@bigfoot.com</email></para>
</listitem>
<listitem><para>Dirk Mueller <email>mueller@kde.org</email></para>
</listitem>
<listitem><para>Matthias Kalle Dalheimer <email>kalle@kde.org</email></para>
</listitem>
</itemizedlist>
</para>
<para>
Documentation Copyright 2000 Stephan Johach
<email>lucardus@onlinehome.de</email></para>

<para>Thanks go to the &knode; developers who answered all my
stupid questions with patience. Then Thomas Diehl and
Matthias Kiefer who always were competent contacts regards to
translation. Not to forget Michael McBride, always there to
help me out with documentation-related and general stuff, and
everybody else in the &kde; Team who contributed to the creation
of this document.</para>

<para>
Documentation Translators:</para>
<para> German to English: </para>
<itemizedlist>
<listitem><para>Rainer Endres <email>endres@physos.com</email></para>
          <para>Maintainer</para>
</listitem>
<listitem><para>Frerich Raabe <email>frerichraabe@gmx.de</email></para>
</listitem>
<listitem><para>Oliver Henning <email>Oliver.Henning@gmx.net</email></para>
</listitem>
<listitem><para>Martin Piskernig <email>martin.piskernig@stuwo.at</email></para>
</listitem>
</itemizedlist>

<para>
Reviewer:</para>
<itemizedlist>
<listitem><para>Lauri Watts <email>vampyr@atconnex.net</email></para>
</listitem>
<listitem><para>Mike Mcbride <email>mmcbride@ematic.com</email></para>
</listitem>
</itemizedlist>

&underFDL;
&underGPL;

</chapter>

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

<sect1 id="getting-knode">
<title>Where do I get &knode; ?</title>

<para>&knode; is part of <ulink url="http://www.kde.org">KDE
Project</ulink>. You will find the current version of &knode; in the package
kdenetwork at <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, the
ftp-Server of the KDE Project or at the <ulink
url="http://knode.sourceforge.net">Homepage of &knode;</ulink>.</para>

</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>If you want to successfully install &knode;, you need a KDE
2.x.</para>

<para>If, in addition, you want to use &knode; as an offline newsreader, you
need a local news server, <abbrev>e.g.</abbrev> <ulink
url="http://www.leafnode.org"><application>leafnode</application></ulink>.</para>

<para>If you want to compile and install &knode;, you must make sure that the
following programs are present: </para>

<itemizedlist>
<listitem><para>g++2.8/egcs 1.0.3 (or compatible)</para></listitem>
<listitem><para>GNU make</para></listitem>
<listitem><para>autoconf 2.1</para></listitem>
<listitem><para>automake 1.4</para></listitem>
<listitem><para>QT 2.2</para></listitem>
<listitem><para>KDE 2.x</para></listitem>
</itemizedlist>

</sect1>

<sect1 id="compilation">
<title>Compile and install</title>

<para>&knode; is part of the package kdenetwork of KDE 2.x and is installed
together with it. so in general, there is no need for a user to compile the
sources of &knode;. If you nonetheless intend to or if you only have the sources
available, compilation and installation is done, as is custom on Linux, by
typing: </para>

<screen width="40">
<prompt>%</prompt> <userinput><command>./configure</command></userinput>
<prompt>%</prompt> <userinput><command>make</command></userinput>
<prompt>%</prompt> <userinput><command>su</command></userinput>
<prompt>%</prompt> <userinput><command>make</command> <option>install</option></userinput>
</screen>

<para>&knode; uses <application>autoconf</application> and
<application>automake</application>, so there should be no problems during
compilation. But if so, please contact the already mentioned mailing list or the
KDE newsgroups. </para>

</sect1>

<sect1 id="configuration">
<title>Configuration</title>

<para>If you use &knode; together with with a local news server, you must make
sure that this server is correctly set up and started. For further details,
please consult the documentation of your local news server. </para>

<tip><para>The availability of the local news server can easily be verified with
the program <application>telnet</application>. Open a console and type:</para>

<screen width="40">
<prompt>%</prompt> <command>telnet localhost nntp </command>
</screen>

<para>Followed by that, the news server should respond with:</para>

<screen width="40">
<prompt>%</prompt>
<computeroutput>
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
200 Leafnode NNTP Daemon, version 1.9.16 running at konqi.org
</computeroutput>
</screen>

<para>You quit the <application>telnet</application> session with:</para>

<screen width="20">
<prompt>%</prompt> <userinput>quit</userinput>
</screen>

<para>If that should not work, there is either no local news server set up or
the server was not started. In this case, please consult the documentation of
your local news server.</para> </tip>

<para>Further, you need of course a (dial-in) connection to a news server on the
Internet. From there, &knode; or the local news server retrieves the
articles. Your Internet provider should be able to give
you information about which news servers you can use. You need this information
in any case.</para>

<para>You will learn more about setting up &knode; in the chapter <link
linkend="using-knode">Working with &knode;</link></para>

</sect1>

</appendix>


<appendix id="update-installation">
<title>Notes about updating an older version of &knode;</title>

<para>This section contains notes about what to take care of when installing a
newer version of &knode; with an older version already installed.</para>

<sect1 id="update-from-0.1.x">
<title>Update from version 0.1.x</title>

<para>Since version 0.2 the format of the configuration files and the saved
articles has changed. An update is not readily possible. Unfortunately, your old
configuration files can not be imported. </para>

</sect1>
</appendix>


<!-- martin end -->
&documentation.index; 
</book>
<!--
Local Variables:
sgml-minimize-attributes:nil
sgml-general-insert-case: lower
sgml-omittag:t
sgml-shorttag:t
sgml-always-quote-attributes:t
sgml-indent-step:nil
sgml-indent-data:nil
sgml-parent-document:nil
sgml-default-dtd-file:"knode.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->

