summaryrefslogtreecommitdiffstats
path: root/doc/knode
diff options
context:
space:
mode:
Diffstat (limited to 'doc/knode')
-rw-r--r--doc/knode/Makefile.am9
-rw-r--r--doc/knode/commands.docbook1890
-rw-r--r--doc/knode/credits.docbook55
-rw-r--r--doc/knode/eyes.pngbin0 -> 140 bytes
-rw-r--r--doc/knode/faq.docbook189
-rw-r--r--doc/knode/gloss.docbook257
-rw-r--r--doc/knode/greyball.pngbin0 -> 181 bytes
-rw-r--r--doc/knode/greyballchk.pngbin0 -> 219 bytes
-rw-r--r--doc/knode/index.docbook130
-rw-r--r--doc/knode/install.docbook54
-rw-r--r--doc/knode/introduction.docbook56
-rw-r--r--doc/knode/journey.docbook530
-rw-r--r--doc/knode/knode-cleanup.pngbin0 -> 19537 bytes
-rw-r--r--doc/knode/knode-colors-fonts.pngbin0 -> 23760 bytes
-rw-r--r--doc/knode/knode-composer-attachments.pngbin0 -> 27665 bytes
-rw-r--r--doc/knode/knode-composer-settings.pngbin0 -> 23566 bytes
-rw-r--r--doc/knode/knode-edit-filter.pngbin0 -> 16449 bytes
-rw-r--r--doc/knode/knode-edit-header1.pngbin0 -> 9364 bytes
-rw-r--r--doc/knode/knode-edit-header2.pngbin0 -> 9490 bytes
-rw-r--r--doc/knode/knode-filters.pngbin0 -> 34596 bytes
-rw-r--r--doc/knode/knode-followup.pngbin0 -> 21113 bytes
-rw-r--r--doc/knode/knode-header-settings.pngbin0 -> 24015 bytes
-rw-r--r--doc/knode/knode-identity.pngbin0 -> 24099 bytes
-rw-r--r--doc/knode/knode-mail-account.pngbin0 -> 17420 bytes
-rw-r--r--doc/knode/knode-new-article.pngbin0 -> 20641 bytes
-rw-r--r--doc/knode/knode-news-account.pngbin0 -> 11104 bytes
-rw-r--r--doc/knode/knode-post-settings.pngbin0 -> 25790 bytes
-rw-r--r--doc/knode/knode-read-news-appearance-dialog.pngbin0 -> 29498 bytes
-rw-r--r--doc/knode/knode-read-news-settings.pngbin0 -> 25953 bytes
-rw-r--r--doc/knode/knode-reply.pngbin0 -> 19592 bytes
-rw-r--r--doc/knode/knode-rule-editor.pngbin0 -> 16638 bytes
-rw-r--r--doc/knode/knode-search.pngbin0 -> 16101 bytes
-rw-r--r--doc/knode/knode-start.pngbin0 -> 24388 bytes
-rw-r--r--doc/knode/knode-subscribe.pngbin0 -> 15885 bytes
-rw-r--r--doc/knode/knode-views.pngbin0 -> 38641 bytes
-rw-r--r--doc/knode/more.docbook134
-rw-r--r--doc/knode/newsubs.pngbin0 -> 193 bytes
-rw-r--r--doc/knode/redball.pngbin0 -> 191 bytes
-rw-r--r--doc/knode/redballchk.pngbin0 -> 211 bytes
-rw-r--r--doc/knode/using-firststart.docbook1859
-rw-r--r--doc/knode/using-morefeatures.docbook855
-rw-r--r--doc/knode/using-subscribing.docbook1367
42 files changed, 7385 insertions, 0 deletions
diff --git a/doc/knode/Makefile.am b/doc/knode/Makefile.am
new file mode 100644
index 000000000..692f3ff3a
--- /dev/null
+++ b/doc/knode/Makefile.am
@@ -0,0 +1,9 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
+# $(srcdir)/translation.po: $(srcdir)/german_original.docbook
+# xml2pot $(srcdir)/german_original.docbook > german.pot
+# msgmerge -o $(srcdir)/translation.po $(srcdir)/translation.po german.pot
+# rm german.pot
+
diff --git a/doc/knode/commands.docbook b/doc/knode/commands.docbook
new file mode 100644
index 000000000..47a96ffe1
--- /dev/null
+++ b/doc/knode/commands.docbook
@@ -0,0 +1,1890 @@
+<!-- <?xml version="1.0" ?>
+<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> -->
+
+<chapter id="commands">
+<title>Command reference</title>
+
+<para>The following keybindings assume you did not change the default
+settings.</para>
+
+<sect1 id="knode-mainwindow">
+<title>The main &knode; window</title>
+
+<sect2>
+<title>The <guimenu>File</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Save As...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Saves the selected article in a file.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>P</keycap>
+</keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Print...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Prints the selected article.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>
+File</guimenu>
+<guimenuitem>Send Pending Messages</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+The messages in the <guilabel>Outbox</guilabel> folder are sent.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>
+File</guimenu>
+<guimenuitem>Stop Network</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Disconnects the current connection to a newsserver.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Quit</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Quits &knode;.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Edit</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>C</keycap>
+</keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Copy the selected text to the clipboard.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Select All</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Selects the whole article.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycap>F4</keycap></shortcut><guimenu>Edit</guimenu>
+<guimenuitem>Search Articles...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens the <guilabel>Search for Articles</guilabel> dialog box for searching in the active group.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>F</keycap>
+</keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Find in Article...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+To be written
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Fetch Article with ID...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Enables the download of an article with a specified article-ID.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>View</guimenu> menu</title>
+
+<!--Headers and Attachments missing-->
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Show/Hide Threads</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+When this is activated, &knode; shows discussions as a tree view in the article view.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Expand All Threads</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+When this is activated, &knode; shows the complete threads; this is
+only functional when <guilabel>Show threads</guilabel>
+is active.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Collapse All Threads</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+When this is activated, &knode; shows no threads; this is only
+functional when <guilabel>Show threads</guilabel> is active.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>T</keycap></shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Toggle Subthread</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Toggles between showing and collapsing the selected thread.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Filter</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Allows you to choose a filter for the article view.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Sort</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>View</guimenu>
+<guimenuitem>Refresh List</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Refreshes the article view</action>
+</para>
+</listitem>
+</varlistentry>
+<!--varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Show all headers</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+When this setting is activated, &knode; shows the complete article header in the article window.</action>
+</para>
+</listitem>
+</varlistentry-->
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Unscramble (ROT 13)</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+When this setting is activated, &knode; shows all characters of the complete article rotated by 13 characters.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Verify PGP signature</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Checks the PGP signature in the article.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>V</keycap></shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>View Source</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+The source code of the active article is opened in a new window.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>X</keycap></shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Use Fixed Font</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Activates the configured fixed-width font for the viewer.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<!--Fancy Formatting Y is missing-->
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Charset</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Here you can configure the charset which is used for the articles.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Go</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>P</keycap></shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Previous Article</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Jumps to previous article in the article view.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>N</keycap></shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Next Article</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Jumps to next article in the article view.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Alt;&Shift;<keycap>Space</keycap></keycombo>
+</shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Next Unread Article</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Jumps to the next unread article, and to the first unread article of the next newsgroup if necessary.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Shift;<keycap>Space</keycap></keycombo></shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Next Unread Thread</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Jumps to the next unread thread, and to the next unread thread in the next newsgroup if necessary.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>-</keycap></shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Previous Group</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Jumps to the previous news group in the folder view</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>+</keycap></shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Next Group</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Jumps to the next newsgroup in the folder view</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>The <guimenu>Account</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Account</guimenu>
+<guimenuitem>Get New Articles in All Groups</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Connects with the active account and fetches any new messages.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Account</guimenu>
+<guimenuitem>Get New Articles in All Accounts</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Connects with all account and fetches any new messages.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Account</guimenu>
+<guimenuitem>Subscribe 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>Account</guimenu>
+<guimenuitem>Expire All Groups</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Here you can expire all groups of an account manually.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Account</guimenu>
+<guimenuitem>Account Properties</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens the properties dialog for the active account.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Account</guimenu>
+<guimenuitem>Delete Account</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Deletes the active account and all subscribed newsgroups therein.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Group</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Group</guimenu>
+<guimenuitem>Get New Articles</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Connects with the active account and fetches any new messages.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Group</guimenu>
+<guimenuitem>Expire Group</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Checks if there are any old articles and, if so, deletes them.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Group</guimenu>
+<guimenuitem>Reorganize Group</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Rebuilds the article view by using the configured sortings.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Group</guimenu>
+<guimenuitem>Mark All as Read</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Sets the status of all articles in the active newsgroup to read.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Group</guimenu>
+<guimenuitem>Mark All as Unread</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Sets the status of all articles in the active newsgroup to unread.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Group</guimenu>
+<guimenuitem>Mark Last as Unread</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+To be written.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Group</guimenu>
+<guimenuitem>Group Properties</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens the dialog for the group properties.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Group</guimenu>
+<guimenuitem>Unsubscribe From Group</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Unsubscribes from the active newsgroup</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+
+<sect2>
+<title>
+The <guimenu>Folder</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>New Folder</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Creates a new main folder.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>New Subfolder</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Creates a new subfolder.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>Rename Folder</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Here you can rename the active folder.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>Import MBox Folder...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+With this function it is possible to import an MBox folder into the active folder.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>Export as MBox Folder...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+With this function you can export the active folder as an MBox folder.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>Compact Folder</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Removes all deleted articles from the active folder.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>Compact All Folders</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Removes all deleted articles from the every folder.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>Empty Folder</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Deletes all articles from the active folder.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Folder</guimenu>
+<guimenuitem>Delete Folder</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Deletes the active folder.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Article</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>Article</guimenu>
+<guimenuitem>Post to Newsgroup...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens the Composer, with the settings for writing new articles set to those of the active newsgroup.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>R</keycap></shortcut>
+<guimenu>Article</guimenu>
+<guimenuitem>Followup 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>Article</guimenu>
+<guimenuitem>Reply by Email...</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>Article</guimenu>
+<guimenuitem>Forward by Email...</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>Article</guimenu>
+<guisubmenu>Mark as Read</guisubmenu>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Set the status of the active article to<quote>
+read</quote>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>U</keycap></shortcut>
+<guimenu>Article</guimenu>
+<guisubmenu>Mark as Unread</guisubmenu>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Set the status of the active article to<quote>
+unread</quote>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></shortcut>
+<guimenu>Article</guimenu>
+<guisubmenu>Mark Thread as Read</guisubmenu>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Set the status of the active thread to<quote>
+read</quote>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></shortcut>
+<guimenu>Article</guimenu>
+<guisubmenu>Mark Thread as Unread</guisubmenu>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Set the status of the active thread to<quote>
+unread</quote>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Article</guimenu>
+<guimenuitem>Cancel Article</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>Article</guimenu>
+<guimenuitem>Supersede Article</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>Article</guimenu>
+<guimenuitem>Open in Own Window</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+The active article is opened in a new window.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>E</keycap></shortcut>
+<guimenu>Article</guimenu>
+<guimenuitem>Edit Article...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens the Composer for editing the active article;</action>
+you can only use this in the <guilabel>
+Outbox</guilabel>
+and <guilabel>
+Drafts</guilabel>
+folders.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>Delete</keycap></shortcut>
+<guimenu>Article</guimenu>
+<guimenuitem>Delete Article</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Deletes the active article.</action>
+You can only use this in the <guilabel>
+Outbox</guilabel>
+and <guilabel>
+Drafts</guilabel>
+ folders.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Article</guimenu>
+<guimenuitem>Send Now</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Sends the active article.</action>
+You can only use this in the <guilabel>
+Outbox</guilabel>
+and <guilabel>
+Drafts</guilabel>
+folders.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Scoring</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo></shortcut>
+<guimenu>Scoring</guimenu>
+<guimenuitem>Edit Scoring Rules...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+The dialog to edit the scoring rules will be opened.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Scoring</guimenu>
+<guimenuitem>Recalculate Scores</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+The scores will be reset and recalculated.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></shortcut>
+<guimenu>Scoring</guimenu>
+<guimenuitem>Lower Score for Author...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Creates a rule for lowering the score of all articles posted by the author of the active article.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></shortcut>
+<guimenu>Scoring</guimenu>
+<guimenuitem>Raise Score for Author...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Creates a rule for raising the score of all articles posted by the author of the active article.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>W</keycap></shortcut><guimenu>Scoring</guimenu>
+<guimenuitem>Watch Thread</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Sets the score for this thread to the configured score of watched threads (standard = 100).</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycap>I</keycap></shortcut>
+<guimenu>Scoring</guimenu>
+<guimenuitem>Ignore Thread</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Sets the score for this thread to the configured score of ignored threads (standard = -100).</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Settings</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Toolbar</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+This option toggles whether the toolbar is shown or not.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Statusbar</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+This option toggles whether the statusbar is shown or not.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Group View</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+This option toggles whether the group list is shown or not.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Header View</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+This option toggles whether the header view is shown or not.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Article Viewer</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+This option toggles whether the article is shown or not.</action>
+</para>
+</listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Shortcuts...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens a dialog for configuring the key bindings.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Toolbars...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens a dialog for configuring the toolbars.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure &knode;...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens a dialog for configuring &knode;.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Help</guimenu> menu</title>
+
+&help.menu.documentation;
+
+</sect2>
+</sect1>
+
+<sect1 id="knode-editorwindow">
+<title>The composer menus.</title>
+
+<sect2>
+<title>
+The <guimenu>File</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>Return</keycap></keycombo></shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Send Now</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Sends the current article immediately.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Send Later</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Stores the current article in the <guilabel>
+Outbox</guilabel>
+to be sent later.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Save as Draft</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Saves the current article in the <guilabel>
+Drafts</guilabel>
+folder, so you can finish editing it another time.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Delete</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Deletes the current article, closing the editor.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Close</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Closes 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">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Undo</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Undo the last edit.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>Shift</keycap><keycap>Z</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Redo</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Redo the last action undone with the <guimenuitem>
+Undo</guimenuitem>
+menu entry.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Cut</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Cuts the currently-selected text to the clipboard, deleting it from the editor window.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Copies the selected text to the clipboard.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Paste</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Pastes the current contents of the clipboard into the editor window.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Paste as Quotation</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Pastes the current contents of the clipboard into the editor window with
+a quote character </action> (<quote>&gt;</quote>) at the beginning of each
+line.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Select All</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Selects all the text in the editor window.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Find</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens the Find dialog.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Replace...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens the Replace dialog.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Attach</guimenu> menu</title>
+<para>
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Attach</guimenu>
+<guimenuitem>Append Signature</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Inserts your signature at the end of the article you are editing.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Attach</guimenu>
+<guimenuitem>Insert File...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Inserts the contents of a file into the editor window.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Attach</guimenu>
+<guimenuitem>Insert File (in a box)...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Inserts the contents of a file into the editor window and puts a box around of it.</action>
+</para>
+</listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Attach</guimenu>
+<guimenuitem>Attach File...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Inserts a file as an attachment.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</para>
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Options</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Options</guimenu>
+<guimenuitem>Send News-Article</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Toggles whether the message is to be sent as an article or not.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Options</guimenu>
+<guimenuitem>Send Email</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Toggles whether the message is to be sent as an email or not; if it's configured, an external editor will be activated.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Options</guimenu>
+<guimenuitem>Set Charset</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Here you can configure the charset used for this article; normally you use us-ascii for English-speaking areas.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Options</guimenu>
+<guimenuitem>Word Wrap</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Toggles the word wrapping in the editor on or off.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>
+The <guimenu>Tools</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Add Quote Characters</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+
+Puts <quote>&gt;</quote> in front of the marked lines.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Remove Quote Characters</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Removes the quote characters at the beginning of the marked lines.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Add Box</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Puts the marked lines in an ASCII box.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Remove Box</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Removes the ASCII box around the marked area.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Sign Article with PGP</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Signs the article with PGP.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Get Original Text (not rewrapped)</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Rebuilds the original posting when answering to an article.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Scramble (Rot-13)</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Encrypts the marked text by rotating every character 13 characters of the alphabet.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</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">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
+<guimenu>Tools</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>Settings</guimenu> menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Toolbar</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Toggles whether the toolbar should be shown or not.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Statusbar</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Toggles whether the statusbar should be shown or not.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Shortcuts...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens a dialog for configuring the key bindings.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Toolbars...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Opens a dialog for configuring the toolbars.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure KNode...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>
+Open the &knode; Preferences dialog.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2>
+<title>The <guimenu>Help</guimenu> menu</title>
+
+&help.menu.documentation;
+
+</sect2>
+
+</sect1>
+</chapter>
diff --git a/doc/knode/credits.docbook b/doc/knode/credits.docbook
new file mode 100644
index 000000000..093c16851
--- /dev/null
+++ b/doc/knode/credits.docbook
@@ -0,0 +1,55 @@
+<chapter id="credits">
+<title>Credits and License</title>
+
+<para>&knode;</para>
+
+<para>Program Copyright 1999, 2000, 2001, 2002 KNode developers</para>
+
+<itemizedlist>
+<title>Developers</title>
+<listitem>
+<para>Christian Gebauer <email>gebauer@kde.org</email></para>
+</listitem>
+<listitem>
+<para>Christian Thurner <email>cthurner@web.de</email></para>
+</listitem>
+<listitem>
+<para>Dirk Mueller <email>mueller@kde.org</email></para>
+</listitem>
+<listitem>
+<para>Mark Mutz <email>mutz@kde.org</email></para>
+</listitem>
+<listitem>
+<para>Roberto Teixeira <email>roberto@kde.org</email></para>
+</listitem>
+<listitem>
+<para>Mathias Waack <email>mathias@atoll-net.de</email></para>
+</listitem>
+</itemizedlist>
+
+<itemizedlist>
+<title>Documentation</title>
+<listitem>
+<para>Copyright 2000, 2001 Stephan
+Johach<email>lucardus@onlinehome.de</email></para>
+</listitem>
+<listitem>
+<para>Copyright 2001, 2002 Thomas Schütz <email>
+Thomas.Schuetz@gmx.li</email></para>
+</listitem>
+</itemizedlist>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+<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. Many Thanks to
+Malcolm Hunter who checked this english 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>
+
+&underFDL; <!-- FDL license for the documentation -->
+&underGPL; <!-- GPL License for the application -->
+
+</chapter>
diff --git a/doc/knode/eyes.png b/doc/knode/eyes.png
new file mode 100644
index 000000000..f2eefe3a8
--- /dev/null
+++ b/doc/knode/eyes.png
Binary files differ
diff --git a/doc/knode/faq.docbook b/doc/knode/faq.docbook
new file mode 100644
index 000000000..6f37d8765
--- /dev/null
+++ b/doc/knode/faq.docbook
@@ -0,0 +1,189 @@
+<!-- <?xml version="1.0" ?>
+<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd">
+-->
+<chapter id="faq">
+<title>Questions and Answers</title>
+
+<qandaset>
+<qandaentry>
+<question>
+<para>I have installed &kde; 3, but &knode; does not exist in the
+<guimenu>K</guimenu> Menu.</para>
+ </question>
+<answer>
+<para>Does the <guisubmenu>Internet</guisubmenu>entry exist? If not,
+maybe the kdenetwork package isn't installed (perhaps because your
+distribution possibly doesn't do this for you); if the entry is there,
+but you do not have a <guimenuitem>KNode</guimenuitem> item
+in it, you should try to open a &konsole; and run &knode; from
+there. Type</para>
+
+<screen>
+<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">$<envar>KDEDIR</envar>/bin</filename> and that 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 &konsole; (see previous question)
+and keep attention for the messages displayed there: if they do not
+make sense to you mark them with your mouse and copy it to the
+clipboard; then, ask for help on one of the &kde; mailing lists or
+&kde; news groups.</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>I need an important article, but &knode; doesn't have it any
+more; where can I find this article?</para>
+</question>
+<answer>
+<para>You can find some extensive usenet archives at
+<ulink
+url="http://groups.google.com/usenet/">groups.google.com</ulink> or
+<ulink url="http://av.com">AltaVista</ulink>; they even contain
+articles that are several years old.</para>
+</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 do not appear in the newsgroup.</para>
+</question>
+<answer>
+<para>When you publish an article it may be 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 an article; how do I archive it?</para>
+</question>
+<answer>
+<para>Choose the article in the article
+view and then use
+<menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice>
+to open a file dialog; you can then save the article to a file. Another
+possibility is to copy the article to a folder.</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>Some set headers do not 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; does not 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 is that?</para>
+</question>
+<answer>
+<para>This happens when somebody posted an article in another news
+group and checked the option <guilabel>Followup To</guilabel>; the
+article in question is then 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 want, for example, to
+use &kedit; enter <userinput><command>kedit</command><token>
+%f</token></userinput></para>
+<para>If the <token>%f</token> is absent, your editor cannot be
+run.</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question>
+<para>Why can I not receive data from my local news server?</para>
+</question>
+<answer>
+<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 <command>telnet</command> program: open a console and type:</para>
+
+<screen>
+<prompt>%</prompt> <userinput><command>telnet</command> <parameter>localhost nntp</parameter></userinput>
+</screen>
+
+<para>Followed by that, the news server should respond with:</para>
+
+<screen>
+<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 can quit the <command>telnet</command> session with:</para>
+
+<screen>
+<prompt>%</prompt> <userinput>quit</userinput>
+</screen>
+
+<para>If that does 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>If you are trying to connect to a news server on the Internet
+you need, of course, an open (dial-in) connection and to have set
+up &knode; to use your <acronym>ISP</acronym>'s news server; your
+<acronym>ISP</acronym> should be able to give you information about
+which news servers you can use.</para>
+</answer>
+</qandaentry>
+
+</qandaset>
+
+
+</chapter>
diff --git a/doc/knode/gloss.docbook b/doc/knode/gloss.docbook
new file mode 100644
index 000000000..5e04fd0d3
--- /dev/null
+++ b/doc/knode/gloss.docbook
@@ -0,0 +1,257 @@
+<glossary id="glossary">
+<title>Glossary</title>
+
+<glossdiv>
+<title>A</title>
+<glossentry id="gloss-article">
+<glossterm>Article</glossterm>
+<glossdef>
+<para>An <glossterm>article</glossterm> in the sense of
+newspapers: special <glossterm>articles</glossterm> are, for example,
+followups; replies are not <glossterm>articles</glossterm> but
+Email.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>C</title>
+
+<glossentry id="gloss-cancel">
+<glossterm>Canceling</glossterm>
+<glossdef>
+<para>To delete one of your articles from the newsserver: the newsreader
+generates a special control message to tell the server to delete this
+article.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-crossposting">
+<glossterm>Crossposting</glossterm>
+<glossdef>
+<para>The posting of an article in several newsgroups; this is very
+often disliked, because it disturbs the topic-oriented association of
+the newsgroups.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>E</title>
+
+<glossentry id="gloss-expire">
+<glossterm>Expire</glossterm>
+<glossdef>
+<para><glossterm>Articles</glossterm> can not be held for eternity
+because of harddisk limits. Because of this there is usually a program
+called <application>expire</application> on most computer
+systems; this program deletes all articles which are older than a
+configured number of days. &knode; includes this functionality on its
+own.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>F</title>
+<glossentry id="gloss-faq">
+<glossterm><acronym>FAQ</acronym></glossterm>
+<glossdef>
+<para><acronym>FAQ</acronym> is the acronym for <quote>Frequently
+Asked Questions</quote>.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-follow-up">
+<glossterm>Followup</glossterm>
+<glossdef>
+<para>An <glossterm>article</glossterm> which is written as an answer
+to another <glossterm>article</glossterm>.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>G</title>
+<glossentry id="gloss-gknsa">
+<glossterm><acronym>GNKSA</acronym></glossterm>
+<glossdef>
+<para><acronym>GNKSA</acronym> is a kind of seal-of-approval for
+newsreaders; you can get more information at <ulink
+url="http://www.gnksa.org">http://www.gnksa.org</ulink>.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>H</title>
+<glossentry id="gloss-header">
+<glossterm>Header</glossterm>
+<glossdef>
+<para>The Header of an <glossterm>article</glossterm> contains
+information about the sender, the subject, and the newsgroup of the
+article.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>
+K</title>
+<glossentry id="gloss-killfile">
+<glossterm>Killfile</glossterm>
+<glossdef>
+<para>This is a functionality of a newsreader to hide
+<glossterm>articles</glossterm> of a determined sender or
+with certain contents.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>M</title>
+<glossentry id="gloss-message-id">
+<glossterm>Message-ID</glossterm>
+<glossdef>
+
+<para>The <glossterm>Message-ID</glossterm> of an article is a clear
+mark for the newsserver to identify the article. A
+<glossterm>Message-ID</glossterm> should not be used twice in the
+whole usenet for about 2 years; wrong or double
+<glossterm>Message-IDs</glossterm> could cause problems when
+forwarding them and could overwrite other articles.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>N</title>
+<glossentry id="gloss-newbie">
+<glossterm>Newbie</glossterm>
+<glossdef>
+<para>Somebody who is new somewhere, in relationship to usenet:
+somebody who is new to the newsgroup, or new to usenet in
+general.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-newsgroup">
+<glossterm>Newsgroup</glossterm>
+<glossdef>
+<para>A kind-of bulletin board in the usenet about a special topic or
+a group of topics. This is where you post your
+<glossterm>articles</glossterm>.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-newsreader">
+<glossterm>Newsreader</glossterm>
+<glossdef>
+<para>A program for reading and writing <glossterm>news</glossterm>.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-nntp"> <glossterm>
+<acronym><acronym>NNTP</acronym></acronym>
+</glossterm>
+<glossdef>
+<para>Network News Transport Protocol; this is the protocol which
+defines how the articles in the usenet are spread.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>P</title>
+
+<glossentry id="gloss-port">
+<glossterm>Port</glossterm>
+<glossdef>
+<para>A kind-of address for the application to listen for data on and
+for connecting to another computer; the standard-port for the
+connection between the newsreader and the newsserver is 119.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-pgp-signature">
+<glossterm>PGP-Signature</glossterm>
+<glossdef>
+<para>A digital signature; you can use it to determine whether the document
+has been changed since it was signed or if it is the original text from
+the author.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-posting">
+<glossterm>Posting</glossterm>
+<glossdef>
+<para>Either an <glossterm>article</glossterm> which is sent to usenet or the
+act of sending itself; you are <quote>posting</quote> an
+<glossterm>article</glossterm> into a newsgroup.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>Q</title>
+
+<glossentry id="gloss-quoting">
+<glossterm>Quoting</glossterm>
+<glossdef>
+<para>This is the act of citing of an article to which you are answering:
+you quote the original <glossterm>article</glossterm> to make clear
+which passages of text your answer refers to.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>R</title>
+<glossentry id="gloss-reply">
+
+<glossterm>Reply</glossterm>
+<glossdef>
+<para>A <glossterm>reply</glossterm> is an answer to the author of an
+article by e-mail.</para>
+</glossdef>
+</glossentry>
+</glossdiv>
+
+<glossdiv>
+<title>S</title>
+
+<glossentry id="gloss-scoring">
+<glossterm>Scoring</glossterm>
+<glossdef>
+
+<para>This is the valuation of an article or a thread.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-signature">
+<glossterm>Signature</glossterm>
+<glossdef>
+<para>A <glossterm>signature</glossterm> is a personal sign of the
+author which is attached at the end of the normal contents of the article;
+it is like a visiting card &mdash; very often there are e-mail addresses, a
+homepage <acronym>URL</acronym> or other personal data. The
+<glossterm>signature</glossterm> should not be longer than 4 lines. Note that
+the <glossterm>signature</glossterm> should not be mixed up with the
+<glossterm>PGP-signature</glossterm>.</para>
+</glossdef>
+</glossentry>
+
+<glossentry id="gloss-supersede">
+<glossterm>Supersede</glossterm>
+<glossdef>
+
+<para>This is the overwriting of an existing article: the newsreader
+generates a special article with a control message in the header which
+tells the newsserver to overwrite the existing article with this
+one.</para>
+
+</glossdef>
+</glossentry>
+</glossdiv>
+
+</glossary>
diff --git a/doc/knode/greyball.png b/doc/knode/greyball.png
new file mode 100644
index 000000000..65335f182
--- /dev/null
+++ b/doc/knode/greyball.png
Binary files differ
diff --git a/doc/knode/greyballchk.png b/doc/knode/greyballchk.png
new file mode 100644
index 000000000..f5c86586d
--- /dev/null
+++ b/doc/knode/greyballchk.png
Binary files differ
diff --git a/doc/knode/index.docbook b/doc/knode/index.docbook
new file mode 100644
index 000000000..29eeb14ba
--- /dev/null
+++ b/doc/knode/index.docbook
@@ -0,0 +1,130 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+ <!ENTITY kappname "&knode;">
+ <!ENTITY package "kdepim">
+ <!ENTITY introduction SYSTEM "introduction.docbook">
+ <!ENTITY commands SYSTEM "commands.docbook">
+ <!ENTITY faq SYSTEM "faq.docbook">
+ <!ENTITY credits SYSTEM "credits.docbook">
+ <!ENTITY install SYSTEM "install.docbook">
+ <!ENTITY journey SYSTEM "journey.docbook">
+ <!ENTITY using-firststart SYSTEM "using-firststart.docbook">
+ <!ENTITY using-subscribing SYSTEM "using-subscribing.docbook">
+ <!ENTITY using-morefeatures SYSTEM "using-morefeatures.docbook">
+ <!ENTITY more SYSTEM "more.docbook">
+ <!ENTITY glossary SYSTEM "gloss.docbook">
+ <!ENTITY % addindex "IGNORE">
+ <!ENTITY % English "INCLUDE">
+]>
+
+<!--TODO: PGP-Option for encoding?
+ Exchange german links (find "(german" )
+ Maybe complete the <accels> of the menus
+ After that set version to 0.7.1 -->
+<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>
+
+<author>
+<firstname> Thomas</firstname> <surname>Schütz</surname>
+<affiliation> <address> <email>Thomas.Schuetz@gmx.li</email> </address>
+</affiliation>
+</author>
+
+<othercredit role="developer" >
+<firstname> Christian</firstname> <surname> Gebauer</surname>
+<contrib> Developer and maintainer</contrib>
+<affiliation> <address> <email>gebauer@kde.org</email> </address> </affiliation>
+</othercredit>
+
+<othercredit role="developer">
+<firstname> Christian</firstname> <surname> Thurner</surname>
+<contrib> Developer</contrib>
+<affiliation> <address> <email>cthurner@web.de</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> Mark</firstname> <surname> Mutz</surname>
+<contrib> Developer</contrib>
+<affiliation> <address> <email>mutz@kde.org</email> </address> </affiliation>
+</othercredit>
+
+<othercredit role="developer">
+<firstname> Roberto</firstname> <surname> Teixeira</surname>
+<contrib> Developer</contrib>
+<affiliation> <address> <email>roberto@kde.org</email> </address> </affiliation>
+</othercredit>
+
+<othercredit role="developer">
+<firstname> Mathias</firstname> <surname> Waack</surname>
+<contrib> Developer</contrib>
+<affiliation> <address> <email>mathias@atoll-net.de</email> </address> </affiliation>
+</othercredit>
+
+</authorgroup>
+
+<copyright>
+<year> 2000</year> <year>2001</year> <year>2002</year>
+<holder>Stephan Johach</holder>
+<holder>Thomas Schütz</holder>
+</copyright>
+
+<date>2002-04-13</date>
+<releaseinfo>0.07.00</releaseinfo>
+
+<!-- Abstract about this handbook -->
+
+<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>
+
+&introduction;
+
+<!-- Using chapter is too big to put in one of it's own, so breaking down to sect1 level -->
+
+<chapter id="using-knode">
+<title>Working with &knode;</title>
+
+&using-firststart;
+&using-subscribing;
+&using-morefeatures;
+</chapter>
+
+&commands;
+
+&faq;
+
+&journey;
+
+&more;
+
+&credits;
+
+&install;
+
+&glossary;
+
+&documentation.index;
+</book> \ No newline at end of file
diff --git a/doc/knode/install.docbook b/doc/knode/install.docbook
new file mode 100644
index 000000000..6a5f11499
--- /dev/null
+++ b/doc/knode/install.docbook
@@ -0,0 +1,54 @@
+<appendix id="installation">
+<title>Installation</title>
+
+<sect1 id="getting-knode">
+<title>Where do I get &knode;?</title>
+
+&install.intro.documentation;
+
+</sect1>
+
+<sect1 id="requirements">
+<title>
+Requirements</title>
+<anchor id="anc-requirements"/>
+
+<para>If you want to successfully install &knode;, you need &kde;
+3.x; if, in addition, you want to use &knode; as an offline
+newsreader, you need a local news server, &eg; <ulink
+url="http://www.leafnode.org"><application>leafnode</application></ulink>.</para>
+</sect1>
+
+<sect1 id="compilation">
+<title>Compile and install</title>
+
+<para>&knode; is part of the kdenetwork package of &kde; 3.x and is
+installed together with it, provided you have chosen to install the
+kdenetwork package; so, in general, there is no need for a user
+to compile the sources of &knode;.</para>
+
+&install.compile.documentation;
+
+</sect1>
+
+<sect1 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>
+
+<sect2 id="update-file-changes">
+<title>Changes in configuration files and folders</title>
+
+<para>Since version 0.2 the format of the configuration files and the
+saved articles has changed, so unfortunately, your old configuration
+files cannot be imported.</para>
+
+<para>If you update from a version >= 0.4 the local folders will
+automatically be converted into the new format; you will then be
+unable to use the data with an older version of &knode; any more.</para>
+</sect2>
+
+</sect1>
+</appendix> \ No newline at end of file
diff --git a/doc/knode/introduction.docbook b/doc/knode/introduction.docbook
new file mode 100644
index 000000000..a86de4663
--- /dev/null
+++ b/doc/knode/introduction.docbook
@@ -0,0 +1,56 @@
+<!-- <?xml version="1.0" ?>
+<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> -->
+<chapter id="introduction">
+<title> Introduction</title>
+<anchor id="anc-introduction"/>
+
+<para>&knode; is an easy-to-use, convenient newsreader; it is intended
+to allow even newbies to use a newsreader under &kde;, but it also
+offers advanced features appealing to experienced users. &knode; is a
+online-reader but could work together with a newsserver like
+<application>leafnode</application> as an offline-reader.</para>
+
+<para>As of version 0.4 &knode; complies with all the requirements of
+the <glossterm>GNKSA</glossterm>.</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>
+<member>de.comp.os.unix.apps.kde (german)</member>
+</simplelist>
+
+<para>If you have found a bug or have suggestions regarding the
+functionality of &knode; please report them via the
+<menuchoice><guimenu>Help</guimenu><guimenuitem>Report
+bug...</guimenuitem></menuchoice> menu.</para>
+
+<para>Please make sure when asking questions in the newsgroups and
+mailing lists mentioned above that the question you are asking
+is not answered in this manual.</para>
+
+<para>For those new to reading news and posting articles, the
+<link linkend="knode-journey">A journey through
+Usenet</link> chapter is recommended; it is not so much about &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 <quote>traffic rules</quote> 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>
+
+<para>Please address suggestions and criticisms at the author or at the
+responsible translator for your language.</para>
+
+</chapter>
+
diff --git a/doc/knode/journey.docbook b/doc/knode/journey.docbook
new file mode 100644
index 000000000..30448513f
--- /dev/null
+++ b/doc/knode/journey.docbook
@@ -0,0 +1,530 @@
+<!-- <?xml version="1.0" ?>
+<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> -->
+
+<chapter id="knode-journey">
+<title>A journey in the World of Newsgroups</title>
+
+<anchor id="anc-knode-journey"/>
+
+<para>This chapter is supposed to be glance over the World of Newsgroups
+and their <quote>inhabitants</quote>; someone who has never dared to go
+there before will encounter some strange customs, which 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>
+<anchor id="anc-about-news"/>
+
+<sect2>
+<title>... online-readers?</title>
+
+<para>An online-reader connects to a newsserver and gives you access 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
+mark (offline) the articles you are really interested in. When you
+connect next time the offline-reader fetches the articles you
+marked and sends the articles you have written whilst 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 everybody 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 their articles
+in a newsgroup.</para>
+
+</sect2>
+
+<sect2>
+<title>... news?</title>
+
+<para>News is the collective term for articles published in a newsgroup.</para>
+
+</sect2>
+
+<sect2>
+<title>... threads?</title>
+
+<para>A thread is a topic of discussion in a
+newsgroup.</para>
+
+</sect2>
+</sect1>
+
+<sect1 id="nettiquette">
+<title>Online Manners</title>
+
+<anchor id="anc-nettiquette"/>
+
+<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, the basics of which are listed here.</para>
+
+<orderedlist>
+<listitem>
+<para>Before you ask questions be sure you have read the newsgroup's
+<acronym>FAQ</acronym> (Frequently Asked Questions) and didn't find
+the answer.</para>
+</listitem>
+<listitem>
+<para>If you take part in a discussion be aware of the fact that everybody
+can read the answer: do not say anything that you would not say to the others
+if you were facing them; avoid insults.</para>
+</listitem>
+<listitem>
+<para>Try to avoid crossposting: do not ask a question in more than
+one newsgroup when you do not know which is the right one. Ask in one
+newsgroup; if it is wrong, you will be 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 ironic
+sentence: it may be funny for you, but it can be very serious for the
+person 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
+answering or publishing an article.</para>
+</listitem>
+</orderedlist>
+
+</sect1>
+
+<sect1 id="usenet-slang">
+<title>The Usenet language</title>
+<anchor id="anc-usenet-slang"/>
+
+<para>You will not be surprised about English being the main language on
+the Usenet; however, there are special trees for 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 listening
+or a possible explanation in the description of the group in the
+grouplist.</para>
+
+<para>In addition, over the time the Usenet has developed its own language
+but 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>
+
+<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 to write the same sentence over and over
+again.</para>
+
+<para>But what is the meaning of <acronym>RTFM</acronym>? The writer
+is asking you to read the manual, documentation or
+<acronym>FAQ</acronym> before asking questions in the
+newsgroup. It stands for: (R)ead (T)he (F)...ing
+(M)anual; <acronym>BTW</acronym> this is 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; to avoid you having to continuously speculate over the meaning of
+acronyms there is table at he end of this section containing the
+most-often-used acronyms.</para>
+
+<para>This table does not try to be complete and is based on a list by
+Martin Imlau.</para>
+
+<table>
+<title>
+Acronyms on Usenet</title>
+<tgroup cols="2">
+<thead>
+<row>
+<entry>
+Acronym</entry>
+<entry>
+Meaning</entry>
+</row>
+</thead>
+<!--TRANSLATORS: Write the translation in the second column in brackets! -->
+<tbody>
+<row>
+<entry>
+&lt;g&gt;</entry>
+<entry>
+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>
+BTW</acronym>
+</entry>
+<entry>
+By the way</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>
+DAU</acronym>
+</entry>
+<entry>
+German abbreviation for the silliest user you can imagine (Dümmster
+anzunehmender User)</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 loudly</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 f...ing 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 f...ing 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>
+
+<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? It's
+a smile with a wink? This is a so-called emoticon; emoticons are an
+often-used possibility to express emotions, one thing missing in
+conversation on the Usenet (but there is a substitute, remember?
+;-)</para>
+
+<para>It is very difficult to express emotions in email or news; your
+joking comment appear to be very serious to 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; 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, does it not? 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! annoyed the sender. The PLONK! is meant to
+play back the sound of the recipients name hitting the ground in the
+<glossterm>killfile</glossterm>.</para>
+</sect2>
+</sect1>
+
+</chapter>
diff --git a/doc/knode/knode-cleanup.png b/doc/knode/knode-cleanup.png
new file mode 100644
index 000000000..9b4a1b051
--- /dev/null
+++ b/doc/knode/knode-cleanup.png
Binary files differ
diff --git a/doc/knode/knode-colors-fonts.png b/doc/knode/knode-colors-fonts.png
new file mode 100644
index 000000000..37934238e
--- /dev/null
+++ b/doc/knode/knode-colors-fonts.png
Binary files differ
diff --git a/doc/knode/knode-composer-attachments.png b/doc/knode/knode-composer-attachments.png
new file mode 100644
index 000000000..dad84a292
--- /dev/null
+++ b/doc/knode/knode-composer-attachments.png
Binary files differ
diff --git a/doc/knode/knode-composer-settings.png b/doc/knode/knode-composer-settings.png
new file mode 100644
index 000000000..b4b27a030
--- /dev/null
+++ b/doc/knode/knode-composer-settings.png
Binary files differ
diff --git a/doc/knode/knode-edit-filter.png b/doc/knode/knode-edit-filter.png
new file mode 100644
index 000000000..4c0916892
--- /dev/null
+++ b/doc/knode/knode-edit-filter.png
Binary files differ
diff --git a/doc/knode/knode-edit-header1.png b/doc/knode/knode-edit-header1.png
new file mode 100644
index 000000000..6b7115050
--- /dev/null
+++ b/doc/knode/knode-edit-header1.png
Binary files differ
diff --git a/doc/knode/knode-edit-header2.png b/doc/knode/knode-edit-header2.png
new file mode 100644
index 000000000..b59a665a6
--- /dev/null
+++ b/doc/knode/knode-edit-header2.png
Binary files differ
diff --git a/doc/knode/knode-filters.png b/doc/knode/knode-filters.png
new file mode 100644
index 000000000..de4a20bbe
--- /dev/null
+++ b/doc/knode/knode-filters.png
Binary files differ
diff --git a/doc/knode/knode-followup.png b/doc/knode/knode-followup.png
new file mode 100644
index 000000000..02edf3313
--- /dev/null
+++ b/doc/knode/knode-followup.png
Binary files differ
diff --git a/doc/knode/knode-header-settings.png b/doc/knode/knode-header-settings.png
new file mode 100644
index 000000000..35ba241bd
--- /dev/null
+++ b/doc/knode/knode-header-settings.png
Binary files differ
diff --git a/doc/knode/knode-identity.png b/doc/knode/knode-identity.png
new file mode 100644
index 000000000..e732f264f
--- /dev/null
+++ b/doc/knode/knode-identity.png
Binary files differ
diff --git a/doc/knode/knode-mail-account.png b/doc/knode/knode-mail-account.png
new file mode 100644
index 000000000..de4458d06
--- /dev/null
+++ b/doc/knode/knode-mail-account.png
Binary files differ
diff --git a/doc/knode/knode-new-article.png b/doc/knode/knode-new-article.png
new file mode 100644
index 000000000..3fcc44830
--- /dev/null
+++ b/doc/knode/knode-new-article.png
Binary files differ
diff --git a/doc/knode/knode-news-account.png b/doc/knode/knode-news-account.png
new file mode 100644
index 000000000..e2aa1f66c
--- /dev/null
+++ b/doc/knode/knode-news-account.png
Binary files differ
diff --git a/doc/knode/knode-post-settings.png b/doc/knode/knode-post-settings.png
new file mode 100644
index 000000000..b7301a23d
--- /dev/null
+++ b/doc/knode/knode-post-settings.png
Binary files differ
diff --git a/doc/knode/knode-read-news-appearance-dialog.png b/doc/knode/knode-read-news-appearance-dialog.png
new file mode 100644
index 000000000..8c98f2622
--- /dev/null
+++ b/doc/knode/knode-read-news-appearance-dialog.png
Binary files differ
diff --git a/doc/knode/knode-read-news-settings.png b/doc/knode/knode-read-news-settings.png
new file mode 100644
index 000000000..610b4bd07
--- /dev/null
+++ b/doc/knode/knode-read-news-settings.png
Binary files differ
diff --git a/doc/knode/knode-reply.png b/doc/knode/knode-reply.png
new file mode 100644
index 000000000..497007d11
--- /dev/null
+++ b/doc/knode/knode-reply.png
Binary files differ
diff --git a/doc/knode/knode-rule-editor.png b/doc/knode/knode-rule-editor.png
new file mode 100644
index 000000000..224e4be3c
--- /dev/null
+++ b/doc/knode/knode-rule-editor.png
Binary files differ
diff --git a/doc/knode/knode-search.png b/doc/knode/knode-search.png
new file mode 100644
index 000000000..68b28af16
--- /dev/null
+++ b/doc/knode/knode-search.png
Binary files differ
diff --git a/doc/knode/knode-start.png b/doc/knode/knode-start.png
new file mode 100644
index 000000000..8d4307fcf
--- /dev/null
+++ b/doc/knode/knode-start.png
Binary files differ
diff --git a/doc/knode/knode-subscribe.png b/doc/knode/knode-subscribe.png
new file mode 100644
index 000000000..4357ae54a
--- /dev/null
+++ b/doc/knode/knode-subscribe.png
Binary files differ
diff --git a/doc/knode/knode-views.png b/doc/knode/knode-views.png
new file mode 100644
index 000000000..5fbae986d
--- /dev/null
+++ b/doc/knode/knode-views.png
Binary files differ
diff --git a/doc/knode/more.docbook b/doc/knode/more.docbook
new file mode 100644
index 000000000..79bab8261
--- /dev/null
+++ b/doc/knode/more.docbook
@@ -0,0 +1,134 @@
+<!-- <?xml version="1.0" ?>
+<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> -->
+
+<chapter id="knode-more-info">
+<title>
+Further Information</title>
+<anchor id="anc-knode-more-info"/>
+<!-- TRANSLATORS! Please modify this chapter for your language specific needs -->
+
+<para>In this section we will detail some additional information
+resources which could be useful to you. Many of the articles listed
+below (for which <acronym>URL</acronym>s 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>
+
+<anchor id="anc-infos-newsgroups"/>
+<simplelist>
+<member>news.answers</member>
+<member>news.newusers.questions</member>
+<member>de.newsusers.infos (German)</member>
+<member>de.answers (German)</member>
+<member>de.comp.os.unix.linux.infos (German)</member>
+<member>de.newusers.answers (German)</member>
+<member>de.newusers.questions (German)</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
+<acronym>FAQ</acronym>s and introductory
+<glossterm>articles</glossterm> are posted frequently, &eg; the
+<glossterm>newsgroup</glossterm> de.comp.os.unix.linux.infos (German),
+which contains a lot of useful articles about the &Linux; operating system.
+Just have a look on the group list of your newsserver for
+it.</para>
+
+</sect1>
+
+<sect1 id="infos-testgroups">
+<title>Test Groups</title>
+
+<anchor id="anc-infos-testgroups"/>
+
+<para>The following groups were created especially for testing,
+&ie; after successfully configuring &knode; you should post some
+articles to those groups to test your settings.</para>
+
+<para>Some groups support automatic replies through email to enable you to
+test whether your entered identity is correct and mail-replies actually
+arrive in your mailbox.</para>
+
+<para>In addition, some scripts are offered which check your articles
+for erroneous settings and generate a followup with useful
+hints.</para>
+
+<simplelist>
+<member>de.test (German test newsgroup)</member>
+<member>misc.test</member>
+<member>alt.test</member>
+<member>alt.test.ignore</member>
+</simplelist>
+</sect1>
+
+<sect1 id="infos-urls">
+<title>Informative technical articles in the world wide web</title>
+
+<anchor id="anc-infos-urls"/>
+
+<para>These <acronym>URL</acronym>s are from the corresponding article
+in the <glossterm>newsgroup</glossterm>
+<emphasis>de.newusers.infos</emphasis> and have the same contents as
+the articles posted there.</para>
+
+<simplelist>
+<member>Introduction for de.newusers.infos: <ulink url="http://www.kirchwitz.de/~amk/dni/einleitung">http://www.kirchwitz.de/~amk/dni/einleitung</ulink>
+(German)</member>
+<member>The newsgroups of the de.alt hierarchy: <ulink url="http://www.kirchwitz.de/~amk/dni/de-alt-newsgruppen">
+http://www.kirchwitz.de/~amk/dni/de-alt-newsgruppen</ulink>
+(German)</member>
+<member>The newsgroups of the de-hierarchy: <ulink
+url="http://www.kirchwitz.de/~amk/dni/de-newsgruppen">http://www.kirchwitz.de/~amk/dni/de-newsgruppen</ulink>
+(German)</member>
+<member>First read, then post: <ulink
+url="http://www.kirchwitz.de/~amk/dni/erst-lesen-dann-schreiben">http://www.kirchwitz.de/~amk/dni/erst-lesen-dann-schreiben</ulink> (German)</member>
+<member>First steps in the usenet: <ulink
+url="http://www.kirchwitz.de/~amk/dni/erste-schritte">http://www.kirchwitz.de/~amk/dni/erste-schritte</ulink>
+(German)</member>
+<member>Questions and answers from de.newusers.questions: <ulink
+url="http://www.kirchwitz.de/~amk/dni/faq">http://www.kirchwitz.de/~amk/dni/faq</ulink>
+(German)</member>
+<member>Seven theses about behavior in the internet: <ulink
+url="http://www.kirchwitz.de/~amk/dni/hoeflichkeit">http://www.kirchwitz.de/~amk/dni/hoeflichkeit</ulink>
+(German)</member>
+<member>Introduction to the usenet: <ulink
+url="http://www.kirchwitz.de/~amk/dni/usenet-einfuehrung">http://www.kirchwitz.de/~amk/dni/usenet-einfuehrung</ulink>
+(German)</member>
+<member>Why should I take the rules seriously? <ulink
+url="http://www.kirchwitz.de/~amk/dni/warum-regel">http://www.kirchwitz.de/~amk/dni/warum-regel</ulink>
+(German)</member>
+<member>The newsreader <acronym>FAQ</acronym>: <ulink
+url="http://www.crosswinds.net/~cgarbers/faq/newsreaderFAQ.htm">http://www.crosswinds.net/~cgarbers/faq/newsreaderFAQ.htm</ulink></member>
+<member>The correct quoting: <ulink
+url="http://www.afaik.de/usenet/faq/zitieren">http://www.afaik.de/usenet/faq/zitieren</ulink>
+(German)</member>
+<member>The German umlauts <acronym>FAQ</acronym>: <ulink
+url="http://www.westfalen.de/paefken/de.newusers/umlaute-faq.txt">
+http://www.westfalen.de/paefken/de.newusers/umlaute-faq.txt</ulink> (German)</member>
+</simplelist>
+</sect1>
+
+<sect1 id="infos-technical">
+<title>Informative technical articles</title>
+<anchor id="anc-infos-technical"/>
+
+<para>If you are interested in further technical information in
+connection to news, you should not miss the following
+<acronym>URL</acronym>s.</para>
+
+<simplelist>
+<member>Header entries: <ulink url="http://www.kirchwitz.de/~amk/dni/headerzeilen">
+http://www.kirchwitz.de/~amk/dni/headerzeilen</ulink> (German)</member>
+<member>A very useful message-ID <acronym>FAQ</acronym>: <ulink url="http://www.qad.org/faq/faq-messageid.html">
+http://www.qad.org/faq/faq-messageid.html</ulink></member>
+<member>A lot of links about newsreaders and related topics: <ulink
+url="http://www.leafnode.org/links">http://www.leafnode.org/links</ulink></member>
+<member><acronym>RFC</acronym>s, Drafts and documents for the technical
+interested: <ulink url="http://www.landfield.com/usefor/">
+http://www.landfield.com/usefor/</ulink></member>
+</simplelist>
+</sect1>
+</chapter>
diff --git a/doc/knode/newsubs.png b/doc/knode/newsubs.png
new file mode 100644
index 000000000..ca443d01e
--- /dev/null
+++ b/doc/knode/newsubs.png
Binary files differ
diff --git a/doc/knode/redball.png b/doc/knode/redball.png
new file mode 100644
index 000000000..506343729
--- /dev/null
+++ b/doc/knode/redball.png
Binary files differ
diff --git a/doc/knode/redballchk.png b/doc/knode/redballchk.png
new file mode 100644
index 000000000..d84cec9ac
--- /dev/null
+++ b/doc/knode/redballchk.png
Binary files differ
diff --git a/doc/knode/using-firststart.docbook b/doc/knode/using-firststart.docbook
new file mode 100644
index 000000000..945b26fd2
--- /dev/null
+++ b/doc/knode/using-firststart.docbook
@@ -0,0 +1,1859 @@
+<!-- <?xml version="1.0" ?>
+<!DOCTYPE sect1 PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN"
+"dtd/kdex.dtd"> -->
+<sect1 id="first-start">
+<title>The first start</title>
+
+<para>You can find &knode; in the <guimenu>K</guimenu> Menu under the
+<guisubmenu>Internet</guisubmenu> entry: the menu entry
+<guimenuitem>KNode</guimenuitem> launches the program.</para>
+
+<tip>
+<para>If the entry for &knode; can not be found or if &knode; does
+not appear after clicking on the menu entry, read <link
+linkend="faq">Questions and Answers</link>.</para>
+</tip>
+
+<para>The main window of &knode; should now be displayed on your
+desktop as shown; on the first start, the settings dialog will be
+invoked.</para>
+
+<screenshot>
+<screeninfo>Setting up &knode;</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-start.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>&knode; after first start</phrase>
+</textobject>
+<caption>
+<para>&knode; after first start</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>The windows shows the menu bar, the toolbar below and the status
+pane at the buttom. The area between the toolbar and the status pane
+is occupied by a three-part window.</para>
+
+<para>There is a folder view, which currently contains only three
+entries:</para>
+
+<simplelist>
+<member>The folder <guilabel>Outbox</guilabel></member>
+<member>The folder <guilabel>Drafts</guilabel></member>
+<member>The folder <guilabel>Sent</guilabel></member>
+</simplelist>
+
+<para>When &knode; is completely and correctly configured, the news
+servers and the subscribed news groups will appear there.</para>
+
+<para>In the upper section is the article view; it is currently empty
+and does not show any articles. Directly below the article view is the
+article window; the body of the currently-selected article
+appears there. These windows are also blank at the moment, as there
+are no articles, of course. You should not be concerned, though, as before
+reading and publishing news some things have to be configured; this
+will be covered by the following section.</para>
+
+<para>We are now beginning the setting up of &knode;. Most settings
+are not important for daily use, but you should know what settings are
+possible and what they are for. Some may skip the
+<quote>Quickstart</quote> chapter but those who prefer a quick start
+will just glance over the manual anyway. For others, especially those
+who have not any or much experience with a news reader, this chapter
+offers the chance to fully perform the configuration, although some
+things may become clear only later on.</para>
+
+<sect2 id="setting-your-identity">
+<title>Personal settings</title>
+
+<anchor id="anc-setting-your-identity"/>
+
+<para>Via
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem></menuchoice> you will enter the preferences
+dialog of &knode;. The figure shows the dialog.</para>
+
+<screenshot>
+<screeninfo>Dialog for entering personal information</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-identity.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>Entering personal information</phrase>
+</textobject>
+<caption>
+<para>Entering personal information</para></caption>
+</mediaobject>
+</screenshot>
+
+<para>The dialog is divided into two parts: in one part there is a treeview, in
+which the top entry <guilabel>Identity</guilabel> is already
+highlighted; in the other part is the corresponding input
+dialog -- these settings relate to the identity with which you navigate
+through the newsgroups.</para>
+
+<tip>
+<para>If you have already configured your personal settings in the
+&kcontrolcenter; before the first start of &knode;, they will be
+adopted.</para>
+</tip>
+
+<sect3>
+<title><guilabel>Name</guilabel></title>
+
+<para>In the field <guilabel>Name</guilabel> you enter your name, &eg;
+<replaceable>Joe Miller</replaceable> or <replaceable>Mary
+Gordon</replaceable>. This name will later appear in the newsgroups as
+sender, and can be seen by anyone.</para>
+
+<para>Filling out the field <guilabel>Name</guilabel> is
+mandatory.</para>
+
+<caution>
+<para>
+In most newsgroups, it is considered polite and appropriate to appear
+with one's real name; other newsgroups are less strict about this. But,
+there are also cases when one would not want to appear with one's real
+name, &eg; in newsgroups where one would like to (and can) talk about
+very personal matters without being exposed; these groups mostly do
+tell you in their Charter that the anonymity of their members is
+explicitly approved.</para>
+</caution>
+
+<tip>
+<para>For those special cases, &knode; offers settings that can be
+adjusted to each newsgroup individually; further information can be
+found under <link linkend="group-identity">Group local
+Identities</link>.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Organization</guilabel></title>
+
+<para>The input field <guilabel>Organization</guilabel> is optional
+and does not have to be filled out. You can enter, &eg;, the name of
+your company or your university if you use &knode;
+there; if you leave this field blank, it will often be filled out
+later by your Internet service provider.</para>
+</sect3>
+
+<sect3>
+<title><guilabel>Email address</guilabel></title>
+
+<para>The email address you enter here will be used as sender in news
+articles, &ie; as actual address of the author, in conjunction with
+the real name (set in the field <guilabel>Name</guilabel>).</para>
+
+<para>The field <guilabel>Email Address</guilabel> shows up when
+someone wants to reply to you by email: the email will be sent to
+the address entered here. Many newsreaders display the sender address
+together with the name in the Header of the article.</para>
+
+<para>Filling out the <guilabel>Email Address</guilabel> field is
+mandatory.</para>
+<tip>
+<para>Note that the e-mail address will only be used for replies to you if
+the field <guilabel>Reply-to Address</guilabel> is not filled out; in
+this case, the field <guilabel>Email</guilabel> will be ignored for
+replies and the address given under <guilabel>Reply-to
+Address</guilabel> will be used.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Reply-to Address</guilabel></title>
+
+<para><guilabel>Reply-to Address</guilabel> offers you the possibility
+to enter a different address than your sender e-mail address: if
+someone replies to you by email this address will be displayed as
+target address in the reply. An example for using <guilabel>Reply-to
+Address</guilabel> would be that you write the article at the office
+during the day but want to receive the answer in your home inbox,
+because your boss co-reads your mail.</para>
+
+<para>Only enter an e-mail address in that field if it actually
+differs from the field <guilabel>Email Address</guilabel>.</para>
+
+<warning>
+<para>Some news readers deliberately set this to an invalid e-mail
+address in order to prevent spam mails from being received; what could
+happen, though, is that a reader sends an e-mail to this invalid address
+which you will therefore never receive. You should drop a note about
+this in the signature.</para>
+</warning>
+</sect3>
+
+<sect3>
+<title><guilabel>Mail-Copies-To</guilabel></title>
+
+<para>If you enter an email address here every article will be sent
+to the usenet and to this email address.</para>
+</sect3>
+
+<sect3>
+<title><guilabel>Signing Key</guilabel></title>
+
+<para>If you have configured the use of <acronym>PGP</acronym> or
+GnuPG you can chose your signing key with
+<guibutton>Change...</guibutton>. </para>
+</sect3>
+
+<sect3>
+<title><guilabel>Use a signature from file</guilabel></title>
+
+<para>If this option is selected, the file specified under
+<guilabel>Signature File</guilabel> will be used as Signature.</para>
+</sect3>
+
+<sect3>
+<title><guilabel>Signature File</guilabel></title>
+
+<para>The field <guilabel>Signature File</guilabel> determines the
+file, the content of which is appended to each of your articles. The
+field is only enabled if the option <guilabel>Use a signature from
+file</guilabel> is selected.</para>
+
+<para>The signature file is a simple text file, which should not
+contain more than four lines; it can, for example, contain a reference
+to your homepage with the corresponding link, your postal address with
+your telephone number (which would then be of course visible to the
+whole world with every article) or just a cool quote. The signature is
+your brand, so to speak, which will mark all your articles; therefore,
+your signature should not be designed sloppily or in the long run annoying
+to others: an old joke that one would have to read over and over again
+does not foster sympathy or the interest of the other newsgroup
+subscribers.</para>
+
+<para>You can directly enter the file name of the signature file but
+it is more convenient to use the button
+<guibutton>Choose...</guibutton>. This opens a file open dialog and
+you can conveniently choose the signature file with the mouse. The
+button <guibutton>Edit File</guibutton> enables you, after choosing
+the file, to edit the signature.</para>
+
+<tip>
+<para>It is not necessary to include a separation line in the
+signature file as &knode; inserts it automatically.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>The file is a program</guilabel></title>
+
+<para>If this option is activated, the signature file is not handled
+as a text file, but as a program. The signature file will be started
+as a program and the output will be used as a signature. Through that
+you'll be able to chose a signature by accident or to use fortune to
+generate a cool slogan every time.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Specify signature below</guilabel></title>
+
+<para>If this option is selected you can enter the text of the
+signature directly in the input field below.</para>
+
+<tip>
+<para>Please make sure that in this case also your
+<glossterm>signature</glossterm> should not contain more than 4
+lines. A separation line is not necessary as &knode; inserts it
+automatically.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title>General notes</title>
+
+<para>You can later adapt the identity individually for each of the
+subscribed groups via the <guilabel>Preferences</guilabel> dialog,
+&eg; you can specify an English signature for English groups and a
+German one for German groups. Apart from the language it is also
+possible to have context-sensitive signatures, &eg; your favorite
+recipe in a cooking group or the names of your twelve cats in a cat
+owner group.</para>
+
+<para>You find more in the section <link
+linkend="group-identity">Group local identities</link>.</para>
+
+<para>The next step in the configuration covers the news
+account.</para>
+
+</sect3>
+</sect2>
+
+<sect2 id="setting-the-news-account">
+<title>Configuring the news account</title>
+<anchor id="anc-setting-the-news-account"/>
+
+<para>Now we must tell &knode; about where we get the news from or
+where to send the articles to later on. In the tree view on the
+right, there is an <guilabel>Accounts</guilabel> entry; click on it
+with the mouse; then, two sub entries will be opened out. Choose the
+<guilabel>News</guilabel> entry, because we first want to configure
+the news account: the list of accounts is still empty.</para>
+
+<para>To create a new account click on <guibutton>New...</guibutton>. The
+following dialog appears:</para>
+
+<screenshot>
+<screeninfo>The <guilabel>New Account</guilabel> dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-news-account.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The <guilabel>New Account</guilabel> dialog</phrase>
+</textobject>
+<caption>
+<para>The <guilabel>New Account</guilabel> dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<sect3>
+<title><guilabel>Name</guilabel></title>
+
+<para>The <guilabel>Name</guilabel> field can be filled in as you
+like; the text you enter will later be visible in the folder view. You
+could, for example, enter the name of your Internet Provider; for our example we
+enter the name <userinput>My News Account</userinput>.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Server</guilabel></title>
+
+<para>The next field is labelled <guilabel>Server</guilabel>. Unlike
+the field <guilabel>Name</guilabel>, what you enter here is
+important. The name of the news server is fixed and you should be able
+to get it from your Internet service provider; if you do not know the name
+of the news server, you should get it now: without this information you can
+not read any news. If your Internet service provider doesn't own a
+news server you can use a public one (universities often provide public news
+servers.)</para>
+
+<para>For our example configuration we enter the name
+<userinput><systemitem
+class="systemname">news.server.com</systemitem></userinput>; you will,
+of course, enter the real name of your news server.</para>
+
+<tip>
+<para>If you want to use &knode; with a local news server, enter the name
+<userinput><systemitem
+class="systemname">localhost</systemitem></userinput> here.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Port</guilabel></title>
+
+<para><guilabel>Port</guilabel>, the next field, has already a default
+value. The Port designates, roughly speaking, a data channel on which
+the server listens for whether someone wants to retrieve news: it
+defaults to the value 119, which is applicable in most
+cases; therefore, we do not change this default for our example.</para>
+</sect3>
+
+<sect3>
+<title><guilabel>Hold connection for</guilabel></title>
+
+<para>The time value you enter here is used if you have
+established a connection to the news server and if, for whatever
+reason, no data is received from or transmitted to the news
+server: after the specified time has elapsed &knode; will automatically
+disconnect. This, amongst other things, relieves the server of
+unnecessary connections which would otherwise reduce its availability
+for other subscribers; it also makes sure that an automatically-established
+Internet connection is not held unnecessarily even if no data is
+being sent or received.</para>
+
+<tip>
+<para>This settings mainly makes sense if one receives and reads
+news online; for local news servers it is of almost no importance. If
+this waiting time is set too low, there can be waiting periods if you
+read a longer article and do not do <quote>anything</quote> for some
+time: &knode; will have canceled the connection to the server by then (after
+the time period has elapsed) and has to reestablish it, causing a delay.</para>
+<para> If the waiting time is set too high you might waste online
+time whilst doing nothing (perhaps increasing your phone bill).</para></tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Timeout</guilabel></title>
+
+<para>If &knode; connects to the news server it waits no longer than the
+time specified here for an answer; if the period is exceeded &knode; cancels
+the connection attempt and you will get an error message stating that the
+server is not responding.</para>
+
+<tip>
+<para>Depending on the quality of your Internet account and the
+news server's current load there can be busy periods where
+&knode; cancels the connection; if this happens frequently, you should
+set this setting to a higher value.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title>
+<guilabel>Fetch group descriptions</guilabel></title>
+
+<para>If this setting is selected, &knode; additionally requests the
+available group descriptions; they will be displayed in the
+<guilabel>Subscribe to Newsgroups</guilabel> dialog.</para>
+
+<tip>
+<para>There is not a group description for every group, so it is not
+an error if no group description is shown when subscribing to a group
+later on.</para>
+</tip>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Server requires authentication</guilabel></title>
+
+<para>The option <guilabel>Server requires authentication</guilabel>
+needs only to be selected if your news server requires a user name and
+a password when retrieving articles; you can find out if this is the case
+from your Internet service provider or the server's
+maintainer.</para>
+
+<tip>
+<para>If you do not know if this setting is necessary forget
+about selecting it for now: if you encounter an error later on, you can
+try selecting it then. Otherwise, select this option and enter your user name
+under <guilabel>User</guilabel> and the associated password
+under <guilabel>Password</guilabel>.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title>General notes</title>
+
+<para>By now you have completed the setup of your news account. You can
+confirm and save your settings by clicking on the
+<guibutton>OK</guibutton> button: as soon as you have done that,
+the account will appear in the list by the name that you entered in
+<guilabel>Name</guilabel> earlier; and, if you have a close look, you
+will see that the account also appears in the folder view.</para>
+
+<para>Using the <guibutton>Subscribe</guibutton> button you could
+get directly to the dialog for subscribing to news groups; but, we
+still have more to do so we'll ignore it for now: there are several ways
+that lead to the goal.</para>
+
+<para>In the <link linkend="multiple-news-accounts"> Managing
+multiple news accounts</link> chapter you can learn how to work with multiple
+news accounts, but first we will stay with this one; in most cases,
+one account is sufficient.</para>
+
+<caution>
+<para>Please note that some Internet providers only allow retrieving
+news from their news server if you are connected to the Internet
+through them.</para>
+</caution>
+
+<para>We will now move on to configuring the email account; in order
+to do that, click on the <guilabel>Mail</guilabel> entry in the tree
+view on the left.</para>
+
+</sect3>
+</sect2>
+
+<sect2 id="setting-the-mail-account">
+<title>Setting up the mail account</title>
+
+<para>After selecting <guilabel>Mail</guilabel> in the tree view, the
+following dialog box appears.</para>
+
+<screenshot>
+<screeninfo>Dialog box for setting up the mail account</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-mail-account.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>Setting up the mail account</phrase>
+</textobject>
+<caption>
+<para>Setting up the mail account</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>You will notice this dialog box is very similar to the news
+account settings dialog box; but why do we need an email account in a
+newsreader?</para>
+
+<para>Sometimes you need to answer to the author of an article
+directly, without posting to the newsgroup; for example, when you want
+to make a very personal comment or want to correct an error. Sometimes
+an email is more appropriate than a public remark.</para>
+
+<para>That's why &knode; provides the possibility to reply by
+email; if you want to use this feature you must tell &knode; how to
+send emails: you just need to insert the mail server's address. If you have
+already configured an email account, &eg; with &kmail;, you can reuse
+the settings used there.</para>
+
+<sect3>
+<title><guilabel>Use external mail program</guilabel></title>
+
+<para>If this option is active &knode; will use the mail program
+which is configured in the control center; the other options in this
+dialog will then be disabled.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Server</guilabel></title>
+
+<para>The name (address) of your mail server as provided by your Internet
+service
+provider or system administrator; all you have to do here is enter the mail
+server's
+name in the <guilabel>Server</guilabel> field.</para>
+
+<para>In our example we enter<userinput><systemitem
+class="systemname">mail.server.de</systemitem></userinput></para>
+
+<tip>
+<para>If you have one you can send your mail via a local mail
+server; if this is the case local mail server enter <systemitem
+class="systemname">localhost</systemitem> in the
+<guilabel>Server</guilabel> field.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Port</guilabel></title>
+
+<para>Again, the <guilabel>Port</guilabel> field has a default
+value; in this case it's port 25. You should not need to change this,
+unless your <acronym>ISP</acronym> has a very exotic configuration
+and tells you to do so. We do not change this for the example.</para>
+
+</sect3>
+
+<sect3>
+<title>Hold connection for</title>
+
+<para>This value is important: if you have established a connection
+with your mail server and there is no data transfer occurring &knode;
+cancels the connection to your mailserver after the specified amount
+of time has elapsed.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Timeout</guilabel></title>
+
+<para>When &knode; tries to connect to the mail server it will wait this
+long for a reply from the server; if this time is exceeded, you will get a
+error message.</para>
+
+<tip>
+<para>Depending on the quality of your connection and the actual load
+of your mail server you might get long reply times; if &knode; cancels
+the connection due to this, you should increase the timeout.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title>General notes</title>
+
+<caution>
+<para>Some <acronym>ISP</acronym>s only allow you to send email using
+their mail server after you have checked your mailbox for new mail: this
+reduces spamming.</para>
+
+<para>For the same reasons, some <acronym>ISP</acronym>s will only allow you
+to send mail using their mailservers if you are online with them
+or if you are logged in at the mailserver; for example, this is the normal
+configuration at GMX and isn't supported by &knode; or &kmail; yet.</para>
+</caution>
+
+</sect3>
+</sect2>
+
+<sect2 id="knode-appearance">
+<title>Defining the appearance</title>
+
+<para>With the <guilabel>Appearance</guilabel> dialog you are given
+the ability to set the colors, the character code and the font size of
+the text in the article window; the picture below shows the
+dialog.</para>
+
+<screenshot>
+<screeninfo>Setting up the Appearance dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-colors-fonts.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>Setting up the Appearance dialog</phrase>
+</textobject>
+<caption>
+<para>Setting up the Appearance dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<sect3>
+<title><guilabel>Use custom colors</guilabel></title>
+
+<para>If you select this option you can adjust the color settings of
+&knode; in the list field below; to change a color setting do a
+double-click with the &LMB; on the list entry to open the &kde;
+color-selection dialog.</para>
+
+<para>The color selection can only be configured after the checkbox
+has been checked; otherwise, a double-click on the list entries
+won't do anything.</para>
+
+<caution>
+<para>If the <guilabel>Use custom colors</guilabel> setting is
+selected &knode; won't use colors which have been changed later
+globally for &kde; but will only use the colors defined here
+instead.</para>
+</caution>
+</sect3>
+
+<sect3>
+<title><guilabel>Use custom fonts</guilabel></title>
+
+<para>If you select this setting you can adjust the fonts which
+&knode; uses for the display in the list field below; to choose a
+font do a double-click with the &LMB; on the list entry to open the
+&kde; font-selection dialog.</para>
+
+<para>The font can only be configured after the checkbox has been
+checked; otherwise, a double click on the list entries won't do
+anything.</para>
+
+<caution>
+<para>If the setting <guilabel>Use custom fonts</guilabel> is
+selected &knode; won't use later changes to the global font settings
+for &kde; but will use the fonts defined here instead.</para>
+</caution>
+</sect3>
+
+</sect2>
+
+<sect2 id="setting-news-general">
+<title>General News Settings</title>
+
+<para>Now click on <guibutton>Reading news</guibutton> and then on the
+<guibutton>General</guibutton> sub-entry; the figure below shows the dialog
+containing the preferences you can configure there.</para>
+
+<screenshot>
+<screeninfo><guilabel>General Preferences</guilabel> dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-read-news-settings.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The <guilabel>General Preferences</guilabel> dialog</phrase>
+</textobject>
+<caption>
+<para>The <guilabel>General Preferences</guilabel> dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>You don't need to change most of these settings, but we will
+discuss them step-by-step to give you an overview of the
+possibilities of &knode;.</para>
+
+<sect3>
+<title><guilabel>Check for new articles
+automatically</guilabel></title>
+
+<para>If this box is checked &knode; tries to request new articles
+from the server when selecting a newsgroup. These settings especially
+make sense when you use &knode; together with a local news
+server: downloading the messages obviously only works when the server
+is reachable; for a server which is only reachable via an Internet
+connection, this setting rarely makes sense and should stay
+deactivated.</para>
+
+<para>If your system isn't set up to establish an Internet connection
+if necessary, you will get an error message each time you select a
+newsgroup.</para>
+
+<para>If you want to keep control over when a connection to the server
+is established, the
+<menuchoice><guimenu>Group</guimenu><guimenuitem>Get new
+articles</guimenuitem></menuchoice> menu option is appropriate.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Maximal number of articles to fetch</guilabel></title>
+
+<para>This sets a restriction on the number articles which are requested
+from the server while downloading. The value configured here is for
+each newsgroup separately. If this is set, for instance, to 300 only
+the 300 newest articles of the newsgroup are requested; other articles will
+be discarded.</para>
+
+<warning>
+<para>For newsgroups with relatively high traffic you might lose
+articles if this value is too low; this especially occurs when you've
+just subscribed to a newsgroup or only occasionally download articles
+and the traffic for this reason rises above the value specified
+here.</para>
+</warning>
+</sect3>
+
+<sect3>
+<title><guilabel>Mark article as read after</guilabel></title>
+
+<para>Articles you have opened in the article window are marked as
+read after the number of seconds specified here. If you set this value
+to be relatively high you avoid articles you have just glanced at
+being marked as read; on the other hand, it can be annoying for
+relatively short articles, for which you need less time to read than
+specified: if you browsed too quickly through the articles
+they would stay unread even though you have read them. Therefore, you
+should adjust this value to your personal preferences.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Mark crossposted articles as read</guilabel></title>
+
+<para>Sometimes an <glossterm>article</glossterm> will be posted to
+more than one group; this is known as crossposting. If you activate this
+option, those crossposted articles will be marked as read in all the
+newsgroups to which they were posted if you read it in one newsgroup.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Smart scrolling</guilabel></title>
+
+<para>If this option is selected the lines in the article list are
+scrolled smoothly instead of jerkily.
+</para> <!-- LW: FIXME could be explained a tiny bit better -->
+
+</sect3>
+
+<sect3>
+<title><guilabel>Show whole thread on expanding</guilabel></title>
+
+<para>This setting lets a discussion be displayed completely (over
+multiple answer levels) if you click on the plus in front of the
+discussion; if this setting isn't checked, only the immediate answers
+to the current article are displayed.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Default to expanded threads</guilabel></title>
+
+<para>Here you can toggle whether the threads are expanded by default or
+not.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Show article score</guilabel></title>
+
+<para>Here you can toggle whether the scoring column should be shown
+in the article view.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Show line count</guilabel></title>
+
+<para>Here you can toggle whether the column with the number of lines
+should be shown in the article view.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Cache size for headers</guilabel></title>
+
+<para>Here you can configure how much memory &knode; should use for
+the caching of the headers.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Cache size for articles</guilabel></title>
+
+<para>Here you can configure, how much memory &knode; should use for
+the caching of the articles.</para>
+
+</sect3>
+</sect2>
+
+<sect2>
+<title><guilabel>Navigation</guilabel></title>
+
+<para>Here you can change some navigation properties of &knode;.
+Normally everything here is switched off, but if you don't like this
+kind of navigation you can change it.</para>
+
+<sect3>
+<title><guilabel>General</guilabel></title>
+
+<para>The keyboard behavior between &knode; and &kmail; is a bit
+different; with the <guilabel>Emulate the keyboard behavior of
+KMail</guilabel> switch you can activate the same keyboard behavior
+as in &kmail; for &knode;.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Mark All as Read</guilabel></title>
+
+<para>If the box <guilabel>Switch to next group</guilabel> is checked,
+&knode; automatically switches to the next group if you mark all
+articles as read.</para>
+</sect3>
+
+<sect3>
+<title><guilabel>Mark Thread as Read</guilabel></title>
+
+<para>If <guilabel>Close the current thread</guilabel> is
+checked, &knode; automatically closes a thread if you mark
+it as read.</para>
+
+<para>If <guilabel>Go to next unread thread</guilabel> is
+checked, &knode; automatically shows the next thread if you mark the
+the previous thread as read.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Ignore Thread</guilabel></title>
+
+<para>If <guilabel>Close the current thread</guilabel>is
+checked, &knode; automatically closes a thread if you choose to
+ignore it.</para>
+
+<para>If <guilabel>Go to next unread thread</guilabel> is
+checked, &knode; automatically shows the next thread if you choose
+to ignore the previous one.</para>
+
+</sect3>
+</sect2>
+
+<sect2 id="knode-scoring-settings">
+<title>Scoring rules</title>
+
+<para>To sort the articles you have the possibility to score them. The
+standard score is 0: a higher score means that the
+<glossterm>article</glossterm> is interesting; a lower score means
+it is less interesting.</para>
+
+<para>In the middle of the window you see a big, white area; here you
+can see your scoring rules. Scoring rules are used by &knode; to score
+the incoming articles automatically; if, for example, a person always
+posts nonsense you can automatically score the articles of that person
+down and hide them.</para>
+
+<para>With the buttons below the list of scoring-rules you can
+<guibutton>edit</guibutton>, <guibutton>add</guibutton>,
+<guibutton>remove</guibutton> and <guibutton>copy</guibutton> a
+rule. We will skip this feature for now, because it is not essential
+for the setup of &knode;.</para>
+
+<para>You can learn more about scoring; in the chapter <link
+linkend="anc-score-watch-ignore">Scoring, watching and
+ignoring</link>.</para>
+
+<sect3>
+<title><guilabel>Default score for ignored threads</guilabel></title>
+
+<para>Normally you only need the functions ignore and watch; this
+simply shows if a thread is interesting or not. Here you can configure
+a default score for the ignored threads; choosing the
+<menuchoice><guimenu>Scoring</guimenu><guimenuitem>Ignore
+Thread</guimenuitem></menuchoice> menu item will give this score to all the
+posts in that thread, and will apply that score also to future posts
+that follow up the thread.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Default score for watched threads</guilabel></title>
+
+<para>If an article is interesting, it will get a score above 0. Here
+you can enter the default score for those articles; choosing the
+<menuchoice><guimenu>Scoring</guimenu><guimenuitem>Watch
+Thread</guimenuitem></menuchoice> menu item will give this score to all the
+posts in that thread, and will apply that score also to future posts
+that follow up the thread.</para>
+
+<tip>
+<para>You can use the <keycap>W</keycap> key to watch a thread or the
+<keycap>I</keycap> key to ignore it.</para>
+</tip>
+</sect3>
+</sect2>
+
+<sect2 id="knode-filter-settings">
+<title>Filter settings</title>
+
+<para>This screenshot shows the filter settings.</para>
+
+<screenshot>
+<screeninfo>The filter settings</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-filters.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The filter settings</phrase>
+</textobject>
+<caption>
+<para>The filter settings</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>This dialog shows two lists. The upper list, labeled <guilabel>
+Filters</guilabel>, shows all defined filters; when you use &knode;
+for the first time, you will only see the predefined filters.</para>
+
+<para>With the buttons <guibutton>Add</guibutton>,
+<guibutton>Delete</guibutton>, <guibutton>Edit</guibutton> and
+<guibutton>Copy</guibutton> you can add new filters or delete filters
+which are no longer needed; we will skip this feature for now, because
+it is not essential for the setup of &knode;.</para>
+
+<para>You can find more-detailed information about filters in <link
+linkend="using-filters">Defining and using filters</link>.</para>
+
+<para>The lower list, labeled <guilabel>Menu</guilabel>, shows the
+appearance of the <menuchoice><guimenu>View</guimenu>
+<guisubmenu>Filter</guisubmenu></menuchoice> menu, which you can reach from
+the menu bar; the order of the filters in the this menu can be
+configured in this list.</para>
+
+<para>The <guibutton>Up</guibutton> button shifts the selected filter
+one position up. Try it: select the second filter and press
+<guibutton>Up</guibutton>; this entry will then go up one position.</para>
+
+<para>The <guibutton>Down</guibutton> button does the opposite
+action: select the filter you just shifted one up and
+press<guibutton>Down</guibutton> until it reaches its old
+position.</para>
+
+<para>With the two buttons <guibutton>Add Separator</guibutton> and
+<guibutton>Remove Separator</guibutton> you can visually group
+the filters on the menu. The separators are shown as <literal>====</literal>
+in the list; in the Menu they show up as some more-appealing
+horizontal lines. Try adding separator; then, select the
+separator and remove it by pressing <guibutton>Remove
+separator</guibutton>.</para>
+
+<para>Any changes you make here, you can see in
+<menuchoice><guimenu>View</guimenu><guisubmenu>Filter</guisubmenu></menuchoice>
+after closing this dialog.</para>
+
+</sect2>
+
+<sect2 id="knode-headers">
+<title><guilabel>Customize displayed article headers</guilabel></title>
+
+<anchor id="anc-knode-headers"/>
+
+<para>In this dialog you can set how the single header lines are
+displayed in the article window.</para>
+
+<screenshot>
+<screeninfo>The <guilabel>Customize displayed article
+headers</guilabel> dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-header-settings.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The <guilabel>Customize displayed article
+headers</guilabel> dialog</phrase>
+</textobject>
+<caption>
+<para>The <guilabel>Customize displayed article
+headers</guilabel> dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>This list shows all the header lines which are to be
+display in the article window. The identifiers at the left will be
+displayed alongside the header lines in &lt; &gt; to their right;
+the header lines are taken from each message, &eg; for
+<guilabel>From</guilabel> the From header line will be used (indicating
+who send the message).</para>
+
+<para>Using <guibutton>Edit</guibutton> you can alter the shown
+identifiers, alter the header line shown by each identifier and
+change the font settings of the text used. To make things clearer,
+we'll now simply select the
+<guilabel>From:&lt;From&gt;</guilabel> entry in the list and open the dialog
+for editing the header display by clicking on
+<guibutton>Edit</guibutton>.</para>
+
+<screenshot>
+<screeninfo>The Header Properties dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-edit-header1.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The Header Properties dialog</phrase>
+</textobject>
+<caption>
+<para>The Header Properties dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<sect3>
+<title><guilabel>Header</guilabel></title>
+
+<para>The <guilabel>Header</guilabel> selection box shows the entry
+<guilabel>From</guilabel>: that is the name of the header line for the
+sender, as present in the article and evaluated by the
+newsreader. If you drop down the selection box &knode; shows a range
+of other identifiers, which stand all for a certain header lines in the
+article: for now, we'll leave the <guilabel>From</guilabel> identifier
+configured; we'll work with this list later, when we add a header line
+to the display.</para>
+</sect3>
+
+<sect3>
+<title><guilabel>Displayed Name</guilabel></title>
+
+<para>This field holds the name you'd like to be later shown in the article
+window as a label alongside the actual header
+line text; for example, for the <guilabel>From</guilabel> header line the
+label <guilabel>From</guilabel> is used. If you leave this field blank, only the
+content of the header line appears in the article window; this is, for
+example, the default setting for the <guilabel>Subject</guilabel>
+header line. We won't change anything here either, for now.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Name</guilabel></title>
+
+<para>Here you can influence the way the 'Displayed Name'
+text is displayed; in our case, the <guilabel>Bold</guilabel> attribute
+is selected for the name <guilabel>From</guilabel>, &ie; the text will
+be shown in bold letters in the article window. Of course, you can
+combine different attributes, for example <guilabel>Bold</guilabel>
+and <guilabel>Underlined</guilabel>.</para>
+
+</sect3>
+
+<sect3>
+<title>Value</title>
+
+<para>Here you can influence the way the header text is displayed
+in the article window; for example, if the
+<guilabel>Italic</guilabel> entry is selected the sender, &eg; <quote>John Doe
+&lt;johndoe@doubleguns.com&gt;</quote> will appears in an italic
+font.</para>
+
+</sect3>
+
+<sect3>
+<title>Add and remove header lines to the display</title>
+
+<para>To explain the possibilities of this dialog to you we're going
+to add a new header line to the display.</para>
+
+<example>
+<title>Show the newsreader used for a post in the article window</title>
+
+<para>This pictures shows the dialog with the header line
+<literal>X-Newsreader</literal>.</para>
+<screenshot>
+<screeninfo>The Header Properties dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-edit-header2.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The Header Properties dialog</phrase>
+</textobject>
+<caption>
+<para>The Header Properties dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>It would be nice if one could see which newsreader another
+subscriber uses in the article window; it is actually quite easy
+to do this because there is a (optional) header line which contains
+the necessary information.</para>
+
+<para>Drop down the <guilabel>Header</guilabel> selection field and
+select the <guilabel>X-Newsreader</guilabel> entry from the
+list.</para>
+
+<para>In the <guilabel>Displayed name</guilabel> field, enter
+<userinput>Newsreader</userinput>.</para>
+
+<para>Now you can select any attribute for the display of the field
+and its content; next, acknowledge your input with the
+<guibutton>OK</guibutton>: the new header line appears now in the list
+and will later be shown in the article window.</para>
+
+</example>
+
+<para>Use the <guibutton>up</guibutton> and
+<guibutton>Down</guibutton> buttons to arrange the order of the
+headers in the article window.</para>
+
+<tip>
+<para>The statement that the new header line will be shown in the
+article window is actually pretty optimistic, because the entry
+X-Newsreader isn't required for Usenet articles; therefore, not all
+articles will contain that header line: if the line doesn't exist, the
+according entry simply won't be shown. You can get more information
+about headers at <ulink
+url="http://www.kirchwitz.de/~amk/dni/headerzeilen">http://www.kirchwitz.de/~amk
+/dni/headerzeilen</ulink>
+(german)</para>
+</tip>
+</sect3>
+</sect2>
+
+<sect2>
+<title><guilabel>Viewer</guilabel></title>
+
+<sect3>
+<title><guilabel>Show fancy header decorations</guilabel></title>
+
+<para>If this is active, the headers will be 'beautified' a
+bit; otherwise, only the plain text is shown.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Rewrap text when necessary</guilabel></title>
+
+<para>If this option is active, the text wrapping in the viewer will
+be automatically corrected.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Remove trailing empty lines</guilabel></title>
+
+<para>If this is active empty lines at the end of the article will
+be automatically hidden.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Show signature</guilabel></title>
+
+<para>If this setting is activated, the
+<glossterm>signature</glossterm> of the sender is displayed in the
+article window; if it isn't, the signature is surpressed.</para>
+
+<caution>
+<para>Please notice that &knode; can display the signature
+correctly only if it can be separated correctly from the article
+content in the current article: there are newsreaders which do this
+separation incorrectly. Two <quote>-</quote> characters followed by a
+<quote>&nbsp;</quote> (space) is correct.</para>
+</caution>
+
+<tip>
+<para>Many participants in the newsgroups give hints on their homepage
+or say that they have intentionally erroneously specified their Email addresses
+in the header fields: if you disable displaying the signature, you might
+lose this information; on the other hand, you might save yourself
+from reading strange quotes.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Interpret text-format tags</guilabel></title>
+
+<para>If this is active, all text format tags in the message like
+<literal>*bold*</literal>, <literal>/italic/</literal> and
+<literal>_underline_</literal> are shown directly in the viewer. These
+text-format tags are an unofficial standard.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Recognize quote characters</guilabel></title>
+
+<para>To display the quoted text in another size or color, &knode;
+needs to recognize that it's quoted text. Quoted text is normally
+marked with a <quote>&gt;</quote> at the beginning of the line, but
+sometimes there are other characters. In this field you can enter all
+characters that should mark quoted text.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Show attachments inline if
+possible</guilabel></title>
+
+<para>If this setting is marked, &knode; tries to display the contents
+of possible attachment directly in the window when opening an
+article; for instance, a picture would be displayed directly below the
+article text.</para>
+
+<para>Additionally, you have the possibility to save the attachment or
+open it with the application you have associated with the
+<acronym>MIME</acronym> type of the attachment by using the context
+menu.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Open attachments on click</guilabel></title>
+
+<para>If this box is checked, attachments are opened with the external
+program which is configured for the <acronym>MIME</acronym> type; if
+there is no such association, a dialog for saving a file is opened and
+you can save the attachment to a separate file.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Show alternative contents as
+attachments</guilabel></title>
+
+<para>Articles which are sent as Multipart <acronym>MIME</acronym>
+contain the text of the message in multiple formats, for example as
+raw text and <acronym>HTML</acronym>; the newsreader decides which
+part of the article is displayed. This setting makes it possible for
+the other formats to be opened as if they were attachments with a
+mouse click.</para>
+
+<para>If this setting is disabled, alternative contents are not
+displayed.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Open links with</guilabel></title>
+
+<para>Here you can select which browser is used for displaying links
+you clicked on in a message. Currently, you can either select the
+<application>Netscape Navigator</application> or the default,
+&konqueror;; the selected browser has to be installed, of
+course.</para>
+
+</sect3>
+</sect2>
+
+<sect2 id="knode-post-news-settings">
+<title>Settings for publishing articles</title>
+
+<para>When you post articles with &knode; the settings in the
+following dialog box are used.</para>
+
+<screenshot>
+<screeninfo>The Technical Settings dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-post-settings.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The Technical Settings dialog</phrase>
+</textobject>
+<caption>
+<para>The Technical Settings dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<caution>
+<para>If you choose the wrong settings here your articles could be
+unreadable or not sendable at all, so please be careful with these
+settings.</para>
+</caution>
+
+<sect3>
+<title><guilabel>Charset</guilabel></title>
+
+<para>Here you can choose the charset used for encoding your
+articles. Normally this is <acronym>US-ASCII</acronym> for English
+speaking countries, but your charset may differ. The default is the
+charset used in your global &kde; settings, so you should not have to
+change this.</para>
+
+<para>When you want to post articles in newsgroups with other charsets
+(&eg; eastern European or Asian) you can set the required charset
+here.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Encoding</guilabel></title>
+
+<para>Here you set the encoding of the characters for the message
+transfer; you can choose between 8-bit and 7-bit
+(quoted-printable).</para>
+
+<para>If you choose 8-bit encoding most special characters are
+transfered correctly; this is, for example, the normal option for the
+German groups (de.*).</para>
+
+<para>If you choose quoted-printable 8-bit characters (&eg; German
+umlauts or special characters) are send as encoded 7-bit
+characters.</para>
+
+<tip>
+<para>In the English newsgroups 7-bit encoding is quite
+normal.</para>
+</tip>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Use own default charset when
+replying</guilabel></title>
+
+<para>If this option is active, &knode; uses your default charset for
+replying instead of the charset of the article you're answering
+on.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Generate Message-ID</guilabel></title>
+
+<para>When this is active, &knode; generates its own Message-IDs for
+all articles you post.</para>
+
+<caution>
+<para>The Message-ID must be unique worldwide: there would
+otherwise be collisions between messages with the same Message-ID and the
+news server would reject the second article because it thinks
+this article has already been received.</para>
+
+<para>A Message-ID consists of a valid <acronym>FQDN</acronym> (Full
+Qualified Domain Name); this means it looks similar to an email
+address with an identification before the <literal>@</literal> and the
+domain.</para>
+
+<para>The identification is generated by &knode; automatically, but
+you must provide a valid domain name in <guilabel>Hostname</guilabel>;
+if you do not have your own domain, you should not activate this
+option &mdash; let the newsserver generate a Message-ID for you.</para>
+
+<example>
+<title>Message-ID</title>
+
+<para>An example for a valid domain would be:
+<literal>kde.org</literal>; a Message-ID generated with this domain
+would look like:</para>
+
+<screen>934lek9934@kde.org</screen>
+</example>
+
+<para>An unique identification is only guaranteed if you have your
+own domain. Even when you do not use &knode; for generating your
+Message-IDs there may be collisions when you are using a local
+newsserver; for example, <application>leafnode</application> generates
+a Message-ID which it derives from the local hostname.</para>
+
+</caution>
+
+<tip>
+<para>You can get more information about this and how to own a free domain at
+<ulink
+url="http://www.qad.org/faq/faq-messageid.html">http://www.qad.org/faq/faq-
+messageid.html</ulink>.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Hostname</guilabel></title>
+
+<para>Here you enter the Hostname of your computer; this is used to
+generate the Message-ID. If you do not have your own domain you
+should not activate this option &mdash; let the newsserver generate a
+Message-ID for you. Using the example above this would be:
+<userinput>kde.org</userinput>.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>X-Headers</guilabel></title>
+
+<para>Here you can enter X-Headers which are not provided by &knode;;
+for example, <userinput>X-No-Archive: yes</userinput>, which can be
+used to prevent your articles from being archived by archive services
+such as Google.</para>
+
+<para>X-Headers are experimental headers, which are not included in the
+standard for Internet-Messages; they are, for example, used for
+extended information transfer. To prevent collisions with later
+standard headers, they have a <quote>X-</quote> prefix.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Don't add the "User-Agent" identification
+header</guilabel></title>
+
+<para>When this option is checked &knode; does not include the
+corresponding line in the Header before posting.</para>
+
+<para>This header is used for identification of the newsreader the
+article was written in; apart from statistical reasons, this allows
+non-standard newsreaders to be identified. You should not activate this
+option &mdash; &knode; has no need to hide.</para>
+</sect3>
+</sect2>
+
+<sect2 id="knode-composer-settings">
+<title>The Composer Settings</title>
+
+<screenshot>
+<screeninfo>The Composer Settings dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-composer-settings.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The Composer Settings dialog</phrase>
+</textobject>
+<caption>
+<para>The Composer Settings dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<sect3>
+<title><guilabel>Word-wrap at column</guilabel></title>
+
+<para>Here you can set the column number at which &knode; wraps the
+line; also, you can deactivate the automatic word-wrapping
+completely.</para>
+
+<tip>
+<para>It is recommended to use no more than 76 characters even if
+you are able to display more: many Usenet users use text-based
+newsreaders which can not display more than 80 characters and it is
+difficult to read your articles in such a newsreader if you increase
+this value &mdash; this would reduce the probability of your articles
+being read at all.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Append signature automatically</guilabel></title>
+
+<para>When you write a new <glossterm>article</glossterm> or a
+<glossterm>followup</glossterm>, your <glossterm>signature</glossterm>
+is appended automatically if you have configured one in
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guilabel>Identity</guilabel></menuchoice>.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Introduction Phrase:</guilabel></title>
+
+<para>When you write a followup, &knode; inserts an introduction
+phrase before the quoted original text. You can put arbitrary text
+here; you can also use the variables which &knode; extracts from the original
+article, &eg; the name of the author or the date the article was
+written.</para>
+
+<para>The following variable are available:</para>
+
+<variablelist>
+<varlistentry>
+<term><varname>%NAME</varname></term>
+<listitem>
+<para>The name of the original author;</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><varname>%DATE</varname></term>
+<listitem>
+<para>The date on which the original article was written;</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><varname>%EMAIL</varname></term>
+<listitem>
+<para>The original author's email address;</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><varname>%MSID</varname></term>
+<listitem>
+<para>The Message-ID of the original article;</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><varname>%GROUP</varname></term>
+<listitem>
+<para>The name of the <glossterm>newsgroup</glossterm>the article
+comes from.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<tip>
+<para>Keep this short, because this introductory line appears in
+every followup: a long introductory line can be as repelling as
+a long signature.</para>
+</tip>
+
+<example>
+<title>An example introductory line</title>
+
+<screen><userinput>On <varname>%DATE</varname> <varname>%NAME</varname> wrote in
+<varname>%MSID</varname></userinput></screen>
+
+<para>Let us assume the original article was written by Konqui on
+Saturday the 17th of June at 17:42:32 - 0500. The article has the
+Message-ID &lt;8igdg5.3vvijgt.3@lizard.physos.com&gt;. &knode; will
+then insert the following introductionary line.</para>
+
+<screen><computeroutput>On Sat, 17 Jun 2000 17:42:32 +0200 Konqui wrote in
+&lt;8igdg5.3vvijgt.3@lizard.physos.com&gt;:</computeroutput></screen>
+
+</example>
+</sect3>
+
+<sect3>
+<title><guilabel>Rewrap quoted text automatically</guilabel></title>
+
+<para>When this is checked, the quoted text is wrapped at the correct
+border value; hence, every new line will be at the correct quoting
+level.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Include the author's signature</guilabel></title>
+
+<para>When this is activated not only the text of the original
+message, but also the signature of the author, is quoted in a
+reply.</para>
+
+<tip>
+<para>Quoting a signature is unnecessary and is often considered
+impolite.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Put the cursor below the introduction
+phrase</guilabel></title>
+
+<para>Normally the cursor will appear below the whole message when
+answering; with this option turned on the cursor appears below the
+introduction phrase.</para>
+
+<tip>
+<para>This is especially helpful if you quote an article and wish to
+write between the quoted lines from top to bottom.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Define external editor</guilabel></title>
+
+<para>You can define an external editor here which is opened by
+selecting <menuchoice><guimenu>Tools</guimenu><guimenuitem>Start
+external editor</guimenuitem></menuchoice> in the Composer
+window.</para>
+
+<para>When <guilabel>Start external editor automatically</guilabel> is
+checked the external editor is opened directly.</para>
+
+<caution>
+<para>Notice the <varname>%f</varname> after the name of the
+editor: this is a variable for the filename of the article you want to
+edit; do not delete this &mdash; you will get an error message when opening
+the external editor if you do.</para>
+</caution>
+
+<tip>
+<para>If you have problems with starting your external editor, the
+reason may be that the editor starting in "the background"; this is called
+forking: &knode; only notices the sub-process started and has finished, and
+thinks you have quit the editor. The editor
+<application>gvim</application> is an example for this; you can
+disable the forking of <application>gvim</application> with the
+commandline switch <option>-f</option>. It is recommended that you refer to
+the documentation of your editor you are experiencing this problem.</para>
+
+<para>If you want to use <application>gvim</application> in
+<guilabel>Specify Editor</guilabel> enter the following:</para>
+
+<para>
+<userinput>
+gvim -f %f</userinput>
+</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Start external editor
+automatically</guilabel></title>
+
+<para>If this option is active the external editor will be used for
+editing articles.</para>
+
+</sect3>
+</sect2>
+
+<sect2>
+<title><guilabel>Spelling</guilabel></title>
+
+<para>Here you can configure the behavior of the spell
+checker.</para>
+
+<sect3>
+<title><guilabel>Create root/affix not in
+dictionary</guilabel></title>
+
+<para>If this is checked a known word-root with an unknown affix will
+be automatically accepted as a new word.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Consider run-together words as spelling
+errors</guilabel></title>
+
+<para>Here you can toggle if two known words that run together to form an
+unknown word should be treated as an error or
+not.)</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Dictionary</guilabel></title>
+
+<para>Here you chose the dictionary the spell-checker should
+use.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Encoding</guilabel></title>
+
+<para>Here you can tell &knode; which encoding should be used for
+spell checking; for English text this should normally be
+<acronym>US-ASCII</acronym>.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Client</guilabel></title>
+
+<para>Here you can switch between the spell-checkers; you can use
+<application>International Ispell</application> or
+<application>Aspell</application>.</para>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+<title><guilabel>Signing and verifying</guilabel></title>
+
+<para>Here you can configure &knode; for signing articles with
+<application>GnuPG</application> or
+<application>PGP</application>. Your
+<application>GnuPG</application>/<application>PGP</application>
+<acronym>ID</acronym> will be built automatically from your configured
+name and email address; it is identical to the from line in the
+header of the <glossterm>article</glossterm>.</para>
+
+<sect3>
+<title><guilabel>Encryption tool</guilabel></title>
+
+<para>Here you can choose your encryption tool.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Keep passphrase in memory</guilabel></title>
+
+<para>If this option is active you only need to type the passphrase
+for your private key once; &knode; will remember your passphrase until
+you close &knode; again.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Show ciphered/signed text after
+composing</guilabel></title>
+
+<para>If this option is activated &knode; will show the signed message in
+an extra window for confirmation before changing it in the
+editor.</para>
+
+</sect3>
+
+<sect3>
+<title>Always show the encryption keys for approval</title>
+
+<para>If you are using public newsgroups (on Usenet) you can safely
+ignore this option as it would not be useful to encrypt messages sent
+to Usenet; this option may, however, be useful in private
+newsgroups on private networks where encryption is desired.</para>
+<!-- FIXME: LW - I can see use for -->
+<!-- encryption, on private networks etc. This needs a rewrite -->
+<!-- AndrewColes: is this revision any better? -->
+</sect3>
+
+<sect3>
+<title><guilabel>Check signatures automatically</guilabel></title>
+
+<para>If this is marked, the <application>PGP</application> signature
+of the article is automatically checked when showing the article; if
+there's no mark, you can check the signature for correctness manually
+with the <menuchoice><guimenu>View</guimenu><guimenuitem>Verify
+PGP-Signature</guimenuitem></menuchoice> menu entry.</para>
+
+</sect3>
+
+</sect2>
+
+
+<sect2 id="knode-article-cleanup">
+<title>The article-cleanup settings.</title>
+
+<para>The dialog below shows the settings for the article
+cleanup; these settings are used to keep the number of articles on
+your local harddisk to a reasonable number. &knode; administrates the
+articles in memory so there can be some decrease in speed if you
+have to many articles lying around; most of the time it makes no sense
+to keep articles for a very long time. Services like Google and
+Altavista make archiving unnecessary.</para>
+
+<caution>
+<para>&knode; isn't an offline reader, so all of the
+configuration refers to the headers which are managed by &knode;; if
+you are running a local news server, such as
+<application>leafnode</application>, you should refer to its
+documentation to handle expiring the articles on the server &mdash;
+&knode; cannot do this for you.</para>
+</caution>
+
+<screenshot>
+<screeninfo>The cleanup settings</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-cleanup.png" format="PNG"/></imageobject>
+<textobject>
+<phrase>The cleanup settings</phrase>
+</textobject>
+<caption>
+<para>The cleanup settings</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<sect3>
+<title><guilabel>Expire old articles automatically</guilabel></title>
+
+<para>When this option is active all subscribed groups are checked for
+old articles in the time interval set here; the old articles will
+then be deleted.</para>
+
+
+<tip>
+<para>You can force this check by selecting
+<menuchoice><guimenu>Group</guimenu><guimenuitem>Expire
+group</guimenuitem></menuchoice></para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Purge groups every</guilabel></title>
+
+<para>Here you can configure how often subscribed groups should be
+checked for old <glossterm>article</glossterm>s and how often those
+articles should be deleted; this option only has an effect when
+<guilabel>Expire old articles automatically</guilabel> is
+selected.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Keep read articles</guilabel></title>
+
+<para>Read articles are deleted by the next cleanup if they are older
+than this value; &knode; uses the creation date for this.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Keep unread articles</guilabel></title>
+
+<para>Unread articles are deleted by the next cleanup if they are
+older than this value; &knode; uses the creation date for this.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Remove articles that are not available on the
+server</guilabel></title>
+
+<para>It may happen that you'll see a <glossterm>header</glossterm> in
+&knode; but the article is not available on the server; if this option
+is set, those articles will automatically deleted in &knode;.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>Preserve threads</guilabel></title>
+
+<para>This selection forces a thread to be deleted only if all
+articles contained in it fulfil the delete conditions; this means that a thread
+will not be deleted until the last article in the thread should be
+deleted.</para>
+
+<para>This prevents old articles in a long thread from vanishing before
+the discussion has ended.</para>
+
+<caution>
+<para>&knode; can not predict whether there will be a reply after the set
+conditions are fulfilled; you will have to find your own settings for
+this. Some newsgroups have days between replies; others only hours. Use
+your own judgement.</para>
+</caution>
+</sect3>
+
+<sect3>
+<title><guilabel>Compact folders automatically</guilabel></title>
+
+<para>This option refers to the memory behavior of &knode;. If an
+<glossterm>article</glossterm> in a folder is deleted it will be
+marked as deleted but still take up space on your hard disk; with
+this option you can tell &knode; to actually delete the articles and
+free the hard-disk space regularly.</para>
+
+<tip>
+<para>You can force this check by selecting
+<menuchoice><guimenu>Folder</guimenu><guimenuitem>Compact
+folder</guimenuitem></menuchoice> or for all folders together with
+<menuchoice><guimenu>Folder</guimenu><guimenuitem>Compact all
+folders</guimenuitem></menuchoice>.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title><guilabel>Purge folders every</guilabel></title>
+
+<para>Here you can configure how often the folder is checked for
+deleted articles; this option only has an effect if the
+<guilabel>Compact folders automatically</guilabel> is set.</para>
+</sect3>
+</sect2>
+
+</sect1>
diff --git a/doc/knode/using-morefeatures.docbook b/doc/knode/using-morefeatures.docbook
new file mode 100644
index 000000000..39892bf60
--- /dev/null
+++ b/doc/knode/using-morefeatures.docbook
@@ -0,0 +1,855 @@
+<sect1 id="more-knode-features">
+<title>The Advanced &knode; Features</title>
+
+<sect2 id="using-filters">
+<title>Defining and Using Filters</title>
+
+<para>You may already have read about using filters in the chapter explaining
+the configuration of &knode;; there, we were talking about the built-in
+filters provided by &knode; there. You can configure the built-in
+filters like all the others. The screenshot below shows the dialog box for
+configuring the filters.</para>
+
+<tip><para>While filters and scoring are very powerful and have many
+uses, one of the most common requirements is simply to add all posts
+written by someone you don't wish to read to a
+<quote>killfile</quote>. At the <link linkend="killfiles">end of this
+section</link> is a quick guide to using filters and scores to create
+such a killfile.</para></tip>
+
+<screenshot>
+<screeninfo>The <guilabel>New Filter</guilabel> dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-edit-filter.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>The <guilabel>New Filter</guilabel> dialog</phrase>
+</textobject>
+<caption>
+<para>The <guilabel>New Filter</guilabel> dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>First we will create a new filter. You may, at some point, want
+to find your own articles amongst all the others; or, you may not
+want to see the articles posted by 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>Configure
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>Filters</guilabel></menuchoice></para>
+</step>
+<step performance="required">
+<para>Select <guibutton>New...</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>To make the filter appear on the menu, check <guilabel>Show
+in menu</guilabel>.</para>
+</step>
+<step performance="required">
+<para>Go to the <guilabel>From</guilabel> area.</para>
+</step>
+<step performance="required">
+<para>Choose <guilabel>Does NOT contain</guilabel> from the drop-down
+box.</para>
+</step>
+<step performance="required">
+<para>Insert the name of the person 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 'Subject + From' tab
+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>Configure
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>Filters</guilabel></menuchoice></para>
+</step>
+<step>
+<para>Select the predefined filter <guilabel>threads with own
+articles</guilabel></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 <guilabel>Status</guilabel> tab</para>
+</step>
+<step>
+<para>Select <guilabel>has new 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 the threads your are participating in which
+have unread messages; also, you have seen the possibility of using
+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>Configure
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>Filters</guilabel></menuchoice></para>
+</step>
+<step>
+<para>Select <guibutton>Add</guibutton></para>
+</step>
+<step>
+<para>Insert <userinput>Latest KNode threads</userinput> in the
+<guilabel>Name</guilabel> field.</para>
+</step>
+<step>
+<para>To make the filter appear in the menu, check <guilabel>show
+in menu</guilabel>.</para>
+</step>
+<step>
+<para>From the <guilabel>apply on</guilabel> drop-down box select
+<guilabel>single articles</guilabel></para>
+</step>
+<step>
+<para>Go to the <guilabel>Subject</guilabel> area and select
+<guilabel>does contain</guilabel> in the drop-down box.</para>
+</step>
+<step>
+<para>Insert <userinput>knode</userinput> in the text box.</para>
+</step>
+<step>
+<para>Change to the <guilabel>Additional</guilabel> tab</para>
+</step>
+<step>
+<para>Select the <guilabel>Age</guilabel> check box</para>
+</step>
+<step>
+<para>Enter the following settings: <guilabel>0 &lt; days &lt;=
+3</guilabel></para>
+</step>
+<step>
+<para>Confirm the filter settings 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>
+
+<sect3 id="killfiles">
+<title>Creating a Killfile</title>
+
+<para>&knode; offers viewing filters (<guilabel>all</guilabel>,
+<guilabel>unread only</guilabel>, <guilabel>my posts</guilabel>,
+&etc;) and scoring filters (threads and articles start with a score of
+zero and can be adjusted according to author, thread, &etc;).</para>
+
+<para>Using viewing filters you could hide articles according to
+poster, but this is not really suitable when you want to kill several
+posters universally.</para>
+
+<para>Using the scoring gives lots of control but filters
+only at the thread level, i.e. you can watch and ignore threads; the
+disadvantage of this, however, is that you may lose otherwise-useful
+threads just because of one poster.</para>
+
+<para>The solution is to use these in combination.</para>
+
+<procedure>
+<title>Creating a Killfile</title>
+<step>
+<para>Go to
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>Filters</guilabel></menuchoice>.</para>
+</step>
+
+<step>
+<para>Create a new filter below <guilabel>unread</guilabel>, called
+<userinput>killfile on</userinput>. Be sure that <guilabel>Apply to single
+articles</guilabel> is set and then click on the
+<guilabel>Additional</guilabel> tab. Set score <quote>equal to or less than
+zero</quote> (<guilabel>&lt;=</guilabel>); then click the
+<guibutton>OK</guibutton> until you have exited the dialog.</para>
+</step>
+
+<step>
+<para>Open an article whose author should be killed and just type
+<keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>(or
+select, from the <guimenu>Scoring</guimenu> menu, <guimenuitem>Lower Score
+for Author</guimenuitem>). This opens the Rule Editor (a part of
+scoring). You can optionally give the rule a name that matches the
+author (<userinput>Kook</userinput>, for example.) and then, if this is
+to be permanent, uncheck the <guilabel>expire automatically</guilabel>
+box; you'll see that this rule will change the author's score to minus
+ten (or the score you entered); finally, click <guibutton>OK</guibutton>.</para>
+</step>
+
+<step>
+<para>Go to the menu item
+<menuchoice><guimenu>View</guimenu><guisubmenu>Filter</guisubmenu><guimenuitem>killfile on.</guimenuitem>
+</menuchoice></para>
+</step>
+</procedure>
+
+<para>This will cause any articles with scores less than zero will
+disappear; to kill additional authors you only need repeat the
+<keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo> part of
+these instructions.</para>
+
+</sect3>
+
+</sect2>
+
+<sect2 id="knode-editor-advanced">
+<title>The Composer</title>
+<anchor id="anc-knode-editor-advanced"/>
+
+<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 generally undesirable to post articles in multiple
+newsgroups: please think twice about it; if you are not sure where to
+post your article ask in one of the possible groups &mdash; somebody will
+tell you were to post.</para>
+</caution>
+</sect3>
+
+<sect3>
+<title>Redirect Followups</title>
+
+<para>The main use of this feature is when a thread has gone
+off topic for the newsgroup in which it is posted; for example, a thread may
+start in a &kde; newsgroup discussing how to redirect a followup in &knode;,
+but may leads to a dicussion about graphical and text based
+newsreaders.</para>
+
+<para>Sometimes it happens that usenet users post an article into the
+wrong newsgroup; very often those articles are just ignored. If it
+looks like the author did this unintentionally, you might like to tell
+them politely and make the followup articles go into the right
+group.</para>
+
+<para>Another reason for using <guilabel>Followup-To:</guilabel> is a
+when dealing with articles cross-posted across in multiple newsgroups:
+you should take care that the replies are only posted in one single newsgroup.</para>
+
+<para>You can activate this by filling the text box
+<guilabel>Followups - To:</guilabel>; here you can enter the suitable
+group. If there are multiple newsgroups in the
+<guilabel>Groups:</guilabel> field, they are shown in the drop-down
+list.</para>
+
+<tip>
+<para>If you enter <userinput>poster</userinput> here, instead of a
+newsgroup, the replies will go directly to the author, not to the
+newsgroup.</para>
+
+<para>Some people put an email address here, but this is not a valid
+entry: use <userinput>poster</userinput> and correctly set your
+Reply-To address in the normal &knode; settings.</para>
+
+</tip>
+
+</sect3>
+
+<sect3>
+<title>Working With an External Editor</title>
+
+<para>Using <menuchoice><guimenu>Tools</guimenu><guimenuitem>Start
+External Editor</guimenuitem></menuchoice> you can start an editor of
+your choice for editing the reply; this way you can use your preferred
+Editor for writing articles and e-mails.</para>
+
+</sect3>
+
+<sect3>
+<title>Spelling</title>
+
+<para>By selecting
+<menuchoice><guimenu>Tools</guimenu><guimenuitem>Spelling</guimenuitem></menuchoice>,
+you can check the article in the composer for spelling errors.</para>
+
+</sect3>
+
+<sect3>
+<title>Sending Attachments</title>
+
+<para>By selecting
+<menuchoice><guimenu>Attach</guimenu><guimenuitem>Attach
+File</guimenuitem></menuchoice> you can 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; detects
+it incorrectly, you can correct the <acronym>MIME</acronym> type manually.</para>
+
+<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>
+
+<caution>
+<para>Only do this if you know what you're doing! An incorrect
+<acronym>MIME</acronym> type could cause the attachment to be sent
+incorrectly, or mean that the attachment will not be able to be
+rebuilt after sending.</para>
+</caution>
+
+<tip>
+<para>The English word attachment is used all over the world; you can
+use it in your language, too.</para>
+</tip>
+
+<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 them &mdash; normally, the person will want you to send them by
+email.</para>
+
+<para>The news server will probably reject articles with attachments
+for most groups anyway; those that do accept attachments
+normally have the word <quote>binaries</quote> in their name. Some
+news servers even stop carrying non-binaries newsgroups that
+continuously receive attachments.</para>
+</important>
+</sect3>
+</sect2>
+
+<sect2>
+<title>Searching for Articles</title>
+
+<para>Sooner or later, you will want to search for one specific
+article; the &knode; search feature is an easy way to do this.</para>
+
+<para>You can reach the search function by selecting
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Search
+Articles...</guimenuitem></menuchoice> or the by pressing
+<keycap>F4</keycap>. 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 four tabs which allow several search
+criteria: the first tab contains the settings for the
+<guilabel>Subject</guilabel> and <guilabel>From</guilabel> criteria; the second
+tab contains the settings for the <guilabel>message-IDs</guilabel> of
+an article and its references; the third tab contains the settings for
+the <guilabel>Status</guilabel> of an
+article; the fourth tab, <guilabel>Additional</guilabel>, contains the remaining
+criteria.</para>
+
+<para>You have probably 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 have 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 has finished the articles found appear in the article view; when
+you close the Search Dialog Box using <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 selected newsgroup, fulfiling these
+criteria, 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 these two features very often, but they do exist should
+you, one day, need them.</para>
+
+<caution>
+<para>Both functions need a news server prepared to handle
+them; you should also remember 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? Perhaps you
+flamed 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, doesn't look good, especially when you regret
+it; so, there is only one thing you can do &mdash; cancel the article.</para>
+
+<para>Select the article you want to cancel and choose
+<guimenuitem>Cancel article</guimenuitem> from its context menu. If
+you are sure it is the right article, confirm &knode;s question with
+<guibutton>Yes</guibutton>. Now you will be 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>
+
+<screen>
+<computeroutput>cancel of &lt;n177m8.1m.ln@konqui.org&gt;</computeroutput>
+</screen>
+
+<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: if 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> &mdash; this line tells the server that
+this message is a control message and, in our case, tells the server to
+cancel your article.</para>
+
+<para>You can still delete the control message from the
+<guilabel>Outbox</guilabel> should you change your mind.</para>
+
+<caution>
+<para>Keep in mind that articles can only be identified by their
+Message-IDs; you need this Message-ID if you want to cancel an
+article. Normally, your article gets a Message-ID when it arrives at
+the newsserver &mdash; that's why you can only cancel an article once
+it has been published. The articles in the
+<guilabel>Sent</guilabel> folder have no Message-ID, so you cannot 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>
+
+<warning>
+<para>Since the cancel feature is so easily fooled, by newsreaders
+that let you cancel any post, many news servers do not acknowledge
+cancel messages from posters; even if your own <acronym>ISP</acronym>
+accepts the cancel and passes it on, many other servers will ignore it
+<emphasis>and will not pass it on</emphasis>.</para>
+
+<para>You should consider any previously-sent article, canceled or
+not, to be published and publicly available.</para>
+</warning>
+
+</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 have already posted it; now, you
+have found an error in this article: you could cancel this article, and post a
+new, corrected, article; or, you can use Supersede.</para>
+
+<para>Select the article in the article view. From its context menu
+select <guimenuitem>Supersede article...</guimenuitem>. &knode; will
+ask you if you really want to overwrite this article; if you confirm with
+<guibutton>Yes</guibutton> the Composer appears.</para>
+
+<para>In the Composer you can now make the desired corrections and
+changes. You can then publish this article in the same way as you post
+every other article; when the newsserver receives 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 article's 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
+headers the newsserver receives. 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, &eg;
+ an <acronym>FAQ</acronym>. The new article supersedes the old one and
+ the newsgroups 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 Message-ID from the
+newsserver: this means that you can only supersede articles which have
+already been published.</para>
+
+<para>You can configure &knode; to generate this Message-ID, then you can
+supersede your articles in the folder <guilabel>Sent</guilabel>,
+too.</para>
+
+<para>&knode; allows you to only supersede your own articles.</para>
+
+</caution>
+
+<warning>
+<para>As with cancels, supersede messages have been abused in the
+past, with, for example, certain parties sending hundreds or even
+thousands of them to overwrite legitimate posts with random computer
+generated junk; again, as with cancels, many news servers do not
+honor supersede messages, nor do they pass them on.</para>
+</warning>
+
+</sect3>
+</sect2>
+
+<sect2 id="score-watch-ignore">
+<title>Score, watch, ignore</title>
+
+<anchor id="anc-score-watch-ignore"/>
+<para>Score, Watch and Ignore are different names for the same
+feature.</para>
+
+<para>By scoring a thread, you determine its importance. &knode;
+allows scores between -100000 and 100000. A normal article will get a
+score of 0 if you do not change this; threads with a score below 0
+are less important than average; threads with a score above 0 are more
+important than 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 to show only
+articles with a score &gt; 0, i.e. all articles in which you are
+specifically interested.</para>
+
+<para>The function <guilabel>Watch</guilabel> sets the score of
+all article in a thread to 100; this way they get a high score and &knode;
+labels them with a special icon.</para>
+
+<para>The function <guilabel>Ignore</guilabel> does the
+opposite: it scores all articles in a thread with -100 so &knode;
+does not show these articles anymore.</para>
+
+<tip>
+<para>The English word <quote>scoring</quote> is used in many other
+countries, too.</para>
+</tip>
+
+<para>You can score an article or a thread manually with the right
+mouse button or with the <guimenu>Scoring</guimenu> menu &mdash; here you can
+score with <guilabel>Watch Thread</guilabel> and <guilabel>Ignore
+Thread</guilabel> directly. Apart from scoring manually you can let &knode;
+score the articles with scoring rules automatically; you can configure these
+rules at <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guimenuitem>Reading
+News</guimenuitem><guimenuitem>Scoring</guimenuitem></menuchoice> or
+at <menuchoice><guimenu>Scoring</guimenu><guimenuitem>Edit scoring
+rules...</guimenuitem></menuchoice> &mdash; the only difference between these
+dialogs is that the last one has the rule-list next to the rule
+configuration. In the following guide I'm using the editor that appears
+if <menuchoice><guimenu>Scoring</guimenu><guimenuitem>Edit scoring
+rules...</guimenuitem></menuchoice> is chosen.</para>
+
+<screenshot>
+<screeninfo>The Rule Editor</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-rule-editor.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>The Rule Editor</phrase>
+</textobject>
+<caption>
+<para>The Rule Editor</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>The composer consists of 4 areas: on the left side is the list
+of the rules; with the buttons below the list you can add, delete or
+copy an existing rule; below that you have the possibility to limit
+the rules which are shown &mdash; you have the choice whether to show all
+rules or only the rules for a specific <glossterm>newsgroup</glossterm>.</para>
+
+<para>If you chose a rule-name in the list you the rule will be displayed
+on the right-hand side; now you can edit the rule. At the top you can change
+the name of the rule and set the newsgroups to which this rule applies.
+You can choose one or
+more than one group, note that group names must be separated by a
+semicolon. You can choose from the subscribed groups with
+the drop-down list and the <guibutton>Add group</guibutton> button; or
+you can use regular expressions and wild cards, &eg; <quote>.*</quote> for all
+groups. The <guilabel>Expire rule automatically</guilabel> option
+makes it possible to delete the rule automatically after the
+configured number of days; this is useful if a specific person
+behaves badly and you do not want to read anything from this person for a
+few days.</para>
+
+<para>In the <guilabel>Condition</guilabel> field you enter the
+condition on which this rule is activated. Normally, you can enter only
+one condition, but you can change this by pressing the
+<guibutton>More</guibutton> and <guibutton>Fewer</guibutton> buttons. If you
+have more than one condition, you must tell knode whether all conditions
+need to be fulfilled or only one of them; this can be done by choosing
+<guilabel>Match all conditions</guilabel> or
+<guilabel>Match any condition</guilabel> respectively.
+</para>
+
+<para>Each condition consists of 2 drop-down lists and a text
+field. In the first list you chose the part of the message which should
+be used for the condition &mdash; this part will be compared with the text
+field; the second drop-down list tells &knode; how it is to be
+compared, for example, whether the chosen header should be identical
+to the text entered in the text field, or if it just needs to match part of it.
+Regular expressions are allowed, too.
+If you check <guilabel>Not</guilabel> then the conditions under which
+the condition is satisfied are reversed, and the condition will be satisfied
+if the opposite of its shown conditions is true.</para>
+
+<para>Now, let's have a look at some
+examples.</para>
+
+<itemizedlist>
+<listitem>
+<para>Maybe you want to filter away all the postings by Theodor
+Test; to do this choose the
+<guilabel>From</guilabel> header line from the first drop-down
+list, choose <guilabel>is exactly the same as</guilabel> from the second
+drop-down list, and enter his name in the text field.
+But, before doing this you should have a
+look at the <glossterm>header</glossterm> of one of Theodor's
+articles and see what is in the <quote>From</quote> line.</para>
+</listitem>
+<listitem>
+<para>If you do not want to read articles with more than 100 lines, choose
+the header entry <guilabel>Lines</guilabel> from the first drop-down
+list, choose <guilabel>greater than</guilabel> from the second, and enter
+<userinput>100</userinput> in the text field. You probably, then, want to
+score down the message.</para>
+</listitem>
+<listitem>
+<para>Last example: of course, you're very interested in every article
+that refers to &knode;. Choose the header entry
+<guilabel>Subject</guilabel>, then <guilabel>contains substring</guilabel>
+and enter <userinput>knode</userinput> in the text field. But what do
+you do if &knode; is not mentioned in the
+<guilabel>Subject</guilabel>? I suggest using a regular
+expression: change <guilabel>contains substring</guilabel> to
+<guilabel>matches regular expression</guilabel> and type
+<userinput>knode|newsreader|usenet</userinput> into the text
+field to match either knode, newsreader or usenet &mdash; the <userinput>|</userinput> symbol
+means OR. Alternatively, you can make 3 conditions &mdash; one that matches knode,
+one that matches newsreader and so on &mdash; and choose
+<guilabel>Match any condition</guilabel>; but, this needs a lot of
+space and it is not very elegant, is it?</para>
+</listitem>
+
+</itemizedlist>
+
+<para>Once your condition is ready you should set an action down in the
+<guilabel>Actions</guilabel> section. The most important action is
+<guilabel>adjust score</guilabel>; if this action is chosen you can
+raise or lower the score, by the configured value, for articles to which
+this rule applies. &knode; can also show you a little message when finding
+such an article or colorize the header in the article list; for example, you could make
+interesting articles scraeming pink so you would notice them very
+quickly.</para>
+
+<para>When leaving the editor, or when the
+<menuchoice><guimenu>Scoring</guimenu><guimenuitem>Recalculate
+scores</guimenuitem></menuchoice> menu item is chosen, the rules are executed; furthermore,
+the rules are automatically used for new
+<glossterm>articles</glossterm>. Scoring makes the most sense when
+used with filters: by scoring some articles down and filtering them away
+they won't appear in the article list.</para>
+
+</sect2>
+
+<sect2 id="group-identity">
+<title>Group identities</title>
+
+<para>With &knode; you can use a different identity with every
+newsgroup to which you are subscribed; i.e. you can set a name, email address,
+reply-to address and signature to use with that group.</para>
+
+<para>It is easy to set group identities. First, with the right mouse button,
+click on the name of the newsgroup in which to have a different identity in; then,
+select <guimenuitem>Group Properties</guimenuitem> from the context menu
+that appears. In the dialog that appears the second tab contains
+fields identical to the global identity settings; enter your settings here and
+click <guibutton>OK</guibutton> to confirm the changes: then, your articles in
+this group will always posted with this newly-entered identity.</para>
+
+<caution>
+<para>When you unsubscribe from a group you lose its identity
+settings for this group: if you re-subscribe to the group, you will need to
+re-enter its identity 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 an 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 useful to if your main newsserver does not provide
+all groups you want to read. Typical cases of this are when support groups for
+commercial software are hosted on a special, private, server or binary
+newsgroups, which are only available from some servers.</para>
+
+<para>Another example of why you sometimes need more than one newsserver
+is that sometimes not all interesting newsgroups are on one
+server; in fact, there is very often only a selection of
+newsgroups. For example, many servers do not support binary
+groups with pictures or programs; if you want such a newsgroup and
+your newsserver provider does not want to serve it you can configure
+&knode; to get it from another server.</para>
+
+<para>Or, perhaps you find you are just subscribed to too many
+newsgroups, and would like to organize them a little better; you
+could set up several accounts for the same server, perhaps one for
+groups you read every day, and one for groups you read less often, so
+that you do not have to search for your <quote>everyday</quote> groups
+in a long list of subscribed groups.</para>
+
+<para>In order to add an new account, open the preferences
+dialog via
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guilabel>Accounts</guilabel><guilabel>News</guilabel>
+</menuchoice>. The <guibutton>New</guibutton> button 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 a user name
+and password 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>
+
+<tip>
+<para>In the <guimenu>Account properties</guimenu> dialog (available
+from the context menu of the newsserver) you can setup an identity for use
+only on this newsserver.</para>
+</tip>
+</sect2>
+
+<sect2 id="PGP-support">
+<title>Sign and Verify Articles with <acronym>PGP</acronym></title>
+<anchor id="anc-PGP-support"/>
+
+<para><acronym>PGP</acronym> is the most-widespread method used to encrypt or
+sign data. Using the <glossterm>PGP-signature</glossterm> you can
+verify if an article is really from the original author or if it has been
+changed by others. You can find PGP-programs and guides at <ulink
+url="http://www.pgpi.org">http://www.pgpi.org</ulink>.</para>
+
+<para>With &knode; you can sign an article with
+<acronym>PGP</acronym> and to verify <acronym>PGP</acronym>-signed
+article. After you have configured the <acronym>PGP</acronym> support,
+at <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+Knode...</guimenuitem><guilabel>Signing/Verifying</guilabel></menuchoice>,
+you can sign articles in the editor with the
+<menuchoice><guimenu>Tools</guimenu><guimenuitem>Sign article with
+PGP</guimenuitem></menuchoice> menu item &mdash; you will be asked for your passphrase
+and after that the article will be signed.</para>
+
+<caution>
+<para>Your <application>GnuPG</application>/<acronym>PGP</acronym>
+<acronym>ID</acronym> is automatically built from your name and your
+email address and is identical to the sender of the message
+(<quote>From</quote>-header).</para>
+</caution>
+
+<para> To verify
+a <glossterm>PGP-signature</glossterm> you have to choose the menu
+item <menuchoice><guimenu>View</guimenu><guimenuitem>Verify
+PGP-signature</guimenuitem></menuchoice>.</para>
+</sect2>
+
+</sect1>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "chapter" "sect1")
+End:
+-->
diff --git a/doc/knode/using-subscribing.docbook b/doc/knode/using-subscribing.docbook
new file mode 100644
index 000000000..618ab292a
--- /dev/null
+++ b/doc/knode/using-subscribing.docbook
@@ -0,0 +1,1367 @@
+<!-- <?xml version="1.0" ?>
+<!DOCTYPE sect1 PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd">
+
+-->
+<sect1 id="subscribing">
+<title>Working with newsgroups</title>
+
+<para>After the configuration of &knode; we will now try to get your
+first news; to achieve this, you need to do some more steps of
+configuration, but you will not have to do this very often.</para>
+
+<sect2 id="fetch-group-list">
+<title>Fetching the group-list from the news server</title>
+
+<anchor id="anc-fetch-group-list"/>
+
+<para>If you want to read a newsgroup you first have to subscribe to
+it. &RMB;-click with your mouse on the entry of your newsserver in the
+folder-list; from the context menu that appears select the
+<guimenuitem>Subscribe to Newsgroups</guimenuitem> entry. &knode;, at
+this moment, does not know which newsgroups are available from this
+server and will ask you if it should fetch a list of available
+newsgroups: confirm with <guibutton>Yes</guibutton>. Now you should
+see the following dialog.</para>
+
+<screenshot>
+<screeninfo>The <guilabel>Subscribe to
+Newsgroups</guilabel> Dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-subscribe.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>The <guilabel>Subscribe to
+Newsgroups</guilabel> dialog</phrase>
+</textobject>
+<caption>
+<para>The <guilabel>Subscribe to
+Newsgroups</guilabel> dialog</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<para>After some time &knode; will has fetched the list of available
+newsgroups and will show them in the left window, <guilabel>Groups
+on</guilabel>, in a tree; this tree view shows the
+newsgroup hierarchy.</para>
+
+<tip>
+<para>You can find a short description about the structure of the usenet
+and the hierarchy of the single newsgroups at <ulink
+url="http://www.kirchwitz.de/~amk/dni/usenet-einfuehrung">http://www.kirchwitz.de/~amk/dni/usenet-einfuehrung</ulink>
+(German).</para>
+</tip>
+
+<sect3>
+<title><guilabel>Search</guilabel></title>
+
+<para>The simplest method to navigate in the tree is to use
+the <guilabel>Search</guilabel> input field: &knode; will filter the groups
+displayed according to your input. If you are searching for
+a group about &kde;, but you do not know its exact position in the
+hierarchy, just type <userinput>kde</userinput> in the
+<guilabel>Search</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. You will most likely end with just one group:</para>
+
+<simplelist>
+<member>comp.windows.x.kde</member>
+</simplelist>
+
+<para>If your server carries the international groups, you might find
+your list is:</para>
+
+<simplelist>
+<member>comp.windows.x.kde</member>
+<member>de.comp.os.unix.apps.kde</member>
+</simplelist>
+
+<para>This incremental search gives you the possibility to search for
+newsgroups without knowing their exact paths.</para>
+
+<tip>
+<para>On a closer 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><guilabel>disable tree view</guilabel></title>
+
+<para>Normally &knode; shows all the groups in a tree; if this option
+is activated, all newsgroups are listed amongst one another.</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 then won'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 which 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 <guibutton>New Groups</guibutton> button give the
+possibility to show all the new groups since a specific date.</para>
+
+</sect3>
+
+<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 <guilabel>Current changes</guilabel> window shows all
+changes you have made since you opened the dialog.</para>
+
+<para>The <guilabel>subscribe to</guilabel> list shows the newsgroups
+you have chosen to subscribe to.</para>
+
+<para>Below you can see the <guilabel>unsubscribe
+from</guilabel> list, which shows all newsgroups from which you have chosen to
+unsubscribe. You cannot unsubscribe from groups you are not
+subscribed to.</para>
+
+</sect3>
+
+<sect3>
+<title><guilabel>New Groups</guilabel></title>
+
+<para>This button opens a dialog which 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 possibility to check for new
+groups; you can even check for new groups since before the last refresh of
+the group list.</para>
+
+</sect3>
+
+<sect3>
+<title><guibutton>New List</guibutton></title>
+
+<para>The <guibutton>New List</guibutton> button tells &knode; to
+fetch a new group list from the news server.</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 you have seen every new group, it is
+more effective to use <guibutton>New Groups</guibutton>; fetching the
+complete list is much more time consuming, but you do make sure that any
+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 access alternative servers providing
+these groups; you can read more about this in <xref
+linkend="multiple-news-accounts"/> .</para>
+
+</sect3>
+
+<sect3>
+<title>Working with the dialog</title>
+
+<para>We now want to subscribe to the &kde; group: mark the the box
+beside the name; you can now see the group in the list labelled
+<guilabel>subscribe to</guilabel>. Another possibility 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 group's name in the
+<guilabel>Groups on</guilabel> window; again, you could use the
+arrow (you probably noticed the arrow changing direction.)</para>
+
+<para>If you want to unsubscribe from a newsgroup it is as easy as
+subscribing to it: you just uncheck the box next to its name. The groups
+you wish to unsubscribe from are shown in the <guilabel>unsubscribe
+from</guilabel> list. Again, the arrow is another way of doing things: to
+correct 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 chosen 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. If you have, in
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode</guimenuitem><guimenuitem>Reading
+news</guimenuitem><guimenuitem>General</guimenuitem></menuchoice>, the
+check box <guilabel>Check for new article automatically</guilabel>
+checked &knode; tries 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 a
+server, there will be a single article in the
+group: <application>leafnode</application> generates an article in
+every new subscribed group; this indicates that
+<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
+can be found in the documentation of your local newsserver.</para>
+</important>
+
+<para>When everything works the articles of the subscribed newsgroup
+appear in the upper right window &mdash; the article view.</para>
+
+</sect3>
+</sect2>
+
+<sect2 id="fetch-and-read-news">
+<title>Fetching and reading Articles</title>
+
+<para>&knode; always shows three views: the folder view, the article view and
+the 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
+column 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>
+
+<para>It is possible to select more than one group or article. You can
+select an area by clicking on the first entry with the &LMB;, holding
+the &Shift; key and clicking on the last entry with the &LMB;
+again.</para>
+
+<para>If you want to select more than one single entry, but they are
+not next to each other in the list, you have to select the first by
+clicking on it with the &LMB; and then select the other entries by
+holding down the &Ctrl; key and clicking on them with the &LMB;.</para>
+
+<para>In either case you can clear your selection by clicking on
+another entry with the &LMB;.</para>
+
+<caution>
+<para>
+If you have selected more than one entry you have to activate the
+context menu with the &Shift; key pressed, otherwise you'll clear the
+selection.</para>
+</caution>
+
+<sect3>
+<title>The Folder View</title>
+
+<para>The folder views contains not only the accounts you configured
+&mdash; in our example this is <emphasis>My News Account</emphasis>
+&mdash; but also three other folders. When you are subscribed to some
+newsgroups there will be plus next to the name of the
+account: clicking on the plus or the name of the account opens the
+tree to show the names of the newsgroups you have chosen to subscribe
+to using that account.</para>
+
+<tip>
+<para>Using the &RMB; you can get a context menu for the selected item
+(folders or newsgroups): if you select a newsgroup and choose
+Properties you can, amongst other things, specify your identity for
+this particular group; you can find more about this in the
+<link linkend="group-identity">Local Identities</link> chapter.</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-right window there are two possibilities &mdash;
+either 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 in
+all groups</guimenuitem></menuchoice>: if there are still no articles
+appearing you either 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 will probably have to work through the
+first chapters, about the configuration of &knode;, again; the
+<link linkend="faq">Frequently Asked Questions</link> chapter may help you,
+too.</para>
+
+<caution>
+<para>If you are using a local newsserver the articles only appear if
+the newsserver has already got them from the internet; if you are using
+<application>leafnode</application> this is done by the
+<command>fetchnews</command> program.</para>
+</caution>
+
+<sect4>
+<title>The Newsgroup Folders</title>
+
+<para>The newsgroup folders appear with the name they are given by the
+hierarchy on the newsserver; in our example this is
+<guilabel>comp.windows.x.kde</guilabel>. You can change the name shown
+in this view: in the context menu (click with the &RMB; on the
+newsgroup's name) choose <menuchoice><guimenuitem>Rename
+group</guimenuitem></menuchoice>, then you can change the name in the
+input field. A good name for <guilabel>comp.windows.x.kde</guilabel>
+would be, for example, <guilabel>The KDE Newsgroup</guilabel>.</para>
+
+<para>If you don't change this, the hierarchical name will still be shown.</para>
+
+<para>Besides the name of newsgroups the folder view shows more
+information by altering its appearance: if a newsgroup contains
+new articles its name is shown bold; the columns
+<guilabel>Total</guilabel> and <guilabel>Unread</guilabel> also tell you
+how many articles are in the corresponding group or folder and how many
+are marked as unread.</para>
+
+</sect4>
+
+<sect4>
+<title>The <guilabel>Outbox</guilabel> folder</title>
+
+<para>The <guilabel>Outbox</guilabel> folder contains all articles
+which are 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 will not lose these articles.</para>
+</tip>
+</sect4>
+
+<sect4>
+<title>The <guilabel>Drafts</guilabel> folder</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. To store 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>
+
+<sect4>
+<title>The <guilabel>Sent</guilabel> Folder</title>
+
+<para>This folder contains copies of the articles that you have successfully
+sent, including your e-mail replies; you can delete the messages in
+this folder, but it will not un-send 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 received the article; it is possible this article will never
+appears in any newsgroup if the local newsserver was not able to
+send it for some reason. If you notice some articles 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> then articles
+leafnode was unable to send are normally found in
+<filename>/var/spool/failed.postings</filename>.</para>
+</tip>
+</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 appearance of this
+view using the <guimenu>View</guimenu> menu. The uppermost row of the
+view contains the column headers.</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Subject</guilabel></term>
+<listitem>
+<para>The <guilabel>Subject</guilabel> column shows the subjects of
+an articles which, most of the time, give you a clue about the content
+of 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 <guilabel>From</guilabel> column shows the author, or their
+e-mail address if the author didn't give a name. You can configure
+your settings in
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode</guimenuitem><guilabel>Identity</guilabel></menuchoice>; when
+you publish an article &knode; will show these settings in the
+<guilabel>From</guilabel> column.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Score</guilabel></term>
+<listitem>
+<para>The <guilabel>Score</guilabel> column shows the scoring of an
+article as a number; the default is 0. Articles which are important to
+you can be scored up; articles you want to ignore can be scored
+down: the range is -100000 to +100000. You can read more about this in
+the <link linkend="score-watch-ignore">Scoring, Watching and
+Ignoring</link> chapter.</para>
+<para>The <guilabel>Score</guilabel> column is only shown if
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>General</guilabel><guilabel>Show article
+score</guilabel></menuchoice> is activated.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Date</guilabel></term>
+<listitem>
+<para>The <guilabel>Date</guilabel> column shows the date and time
+when the article was written.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Lines</guilabel></term>
+<listitem>
+<para>The <guilabel>Lines</guilabel> column shows the number of lines
+of the <glossterm>article</glossterm>; this column is only shown if
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>General</guilabel><guilabel>Show line
+count</guilabel></menuchoice> is activated.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<sect4>
+<title>The Symbols and Highlighting Used</title>
+
+<para>This is a short 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 labeled 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/or
+unread articles in it.</para>
+</listitem>
+<listitem>
+<para>
+<inlinemediaobject>
+<imageobject>
+<imagedata fileref="eyes.png" format="PNG"/> </imageobject>
+</inlinemediaobject>
+Articles labeled 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>Bold article subjects.</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>Article subjects printed in gray.</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
+another article you can use the mouse to select it, or you can use
+the cursor keys. If you use the cursor keys you can move the
+dashed frame to the article you want to read and then press
+<keycap>Enter</keycap> to mark and display the article.</para>
+
+<para>There are many key commands to provide comfortable navigation
+within a news group and to switching between newsgroups. Here the most
+common key commands of the standard key configuration are listed; you
+can configure the key bindings in
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+Shortcuts</guimenuitem></menuchoice>.</para>
+
+<variablelist>
+<varlistentry>
+<term>Toggle Subthreads <keycap>T</keycap>
+</term>
+<listitem>
+<para>The replies to an article are either shown or hidden by
+multiply pressing this key; another way to open threads is
+to use the <keycap>Right Arrow</keycap> key.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Filter <keycap>F6</keycap></term>
+<listitem>
+<para>A dialog is shown where you can choose the filter for the
+articles.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Sort <keycap>F7</keycap>
+</term>
+<listitem>
+<para>A dialog is shown where you can change the sorting of the
+articles; if you choose a column for a second time it will change the
+sorting direction.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Browsing articles <keycap>Space</keycap></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 <keycap>Space</keycap>, it takes you to the next
+article; when you have read all articles in one newsgroup,
+<keycap>Space</keycap> takes you to the first article of the next
+newsgroup. By repeatedly pressing <keycap>Space</keycap> you can
+browse through all subscribed newsgroups like this.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Next unread article <keycombo
+action="simul">&Alt;<keycap>Space</keycap></keycombo>
+</term>
+<listitem>
+<para>This key binding jumps to the next unread article. The sequence
+follows the order of articles in the article view; threads are opened
+if necessary.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Next unread thread <keycombo
+action="simul">&Ctrl;<keycap>Space</keycap></keycombo>
+</term>
+<listitem>
+<para>This command jumps to the next thread containing unread
+articles: the first unread article is then 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 newsgroups in the folder 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 newsgroups in the folder 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 of the news you are interested in is
+to sort your articles with a certain criterion.</para>
+
+<para>Sorting your articles, and choosing sorting criteria, is
+done with the column titles in the article view: clicking on a column
+title makes it the current sorting criterion; another click on the same
+column title changes the order of sorting.</para>
+
+<tip>
+<para>The current sorting criterion is indicated with an arrow next to
+the title; this gives you an easy sign which column is used for
+sorting, too. You have to make the column wide enough, though, so you
+can actually see the arrow; you can change the column width by moving
+the mouse pointer on the small area between two column titles: the
+pointer changes its appearance to two horizontal arrows; clicking
+and holding the &LMB; mouse button now allows you to change the width
+of the column to the left of the mouse pointer.</para>
+</tip>
+
+<para>&knode; gives you the possibility to reduce the flood of
+articles: you can show only articles fitting specific
+criteria; &knode; uses filters for this task. In the following paragraphs we
+are just dealing with the predefined filters; for defining and using
+your own filters please refer to the <link
+linkend="using-filters">Defining and using Filters</link> chapter.</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
+next to 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 in all, which 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; you
+may be watching a thread because, for example, you are participating in it,
+or because you are particularly interested in the answers.
+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 have you selected one or more
+threads to watch; you can achieve this by selecting
+<menuchoice><guimenu>Article</guimenu><guisubmenu>Thread</guisubmenu><guimenuitem>Watch</guimenuitem></menuchoice>:
+next to the subject a symbol will appear, showing a pair of eyes.</para>
+
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Threads With Unread</term>
+<listitem>
+<para>This filter shows only threads 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 newly-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 only articles you have 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 only shows threads containing articles you
+have 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 task-specific and are 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
+that you cannot change the article &mdash; it is for reading only.</para>
+
+<para>By pressing the &RMB; in the article viewer you can access the
+important functions in the context menu very quickly.</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 information here from the article view; for
+example, the subject and the address or name where the article
+originated. When you click on the <guilabel>From:</guilabel> address,
+&knode; opens an editor window where the email address of the author and
+the subject of the referring article are already filled in for
+you; this enables you to reply to the author directly from their
+article.</para>
+
+<para>The appearance and content of the header shown by default
+can be configured by choosing <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configuring
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>Headers</guilabel></menuchoice>; you can
+find a more-detailed view on this in <link
+linkend="anc-knode-headers">Configuring the Shown
+Headers</link>.</para>
+
+<para>By selecting
+<menuchoice><guimenu>View</guimenu><guimenuitem>Show all
+headers</guimenuitem></menuchoice> you force &knode; to show the whole
+header as is produced by the newsreader and newsservers; normally
+you do not need this view: 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 the articles to which the current article refers:
+the article labeled with 1 is the oldest article to which this article
+refers; the article with the highest number is the most-recent article
+to which the current article refers.</para>
+
+<para>When you click on a reference the corresponding article is loaded
+and shown in the article view; if the article is no longer available
+you will be informed by &knode;. This will happen if
+the article has been deleted by the article management of &knode; due to
+its age, or your news server decided to delete it from the newsgroup;
+for details on how to get such an article, please refer to the
+<link linkend="faq">Frequently Asked Questions</link>.</para>
+
+<tip>
+<para>The first lines in an article, with the subject and author
+information and so on, are called
+<glossterm>headers</glossterm>.</para>
+</tip>
+</sect4>
+
+<sect4>
+<title>The Body of the Article</title>
+
+<para>The body of the article follows straight after the header; it
+is the actual message the author published in the newsgroup. Be aware
+that some articles may contain quotes from other articles which are
+not recognizable as quotes; this depends on the news editor the author
+used and their article-formatting habits.</para>
+
+<para>&knode; provides some formatting which can be used by articles;
+at the moment the available options are:</para>
+
+<simplelist>
+<member>/italic/</member>
+<member>*bold*</member>
+<member>_underlined_</member>
+</simplelist>
+
+<para>Do not use the highlighting too often; the impact decreases
+the more it is used.</para>
+
+<tip>
+<para>The main part of the message (the contents) is called the
+<glossterm>body</glossterm>.</para>
+</tip>
+
+<para>Most of the time a quote is indicated by a prefixed &gt; on
+every line; however, 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>Also, it is usual to start an answer with a
+introductionary line, something like:</para>
+
+<informalexample>
+<para>On 12/25/2000 Santa Claus wrote:</para>
+</informalexample>
+
+<tip>
+<para>Normally you do not have to concern yourself with these introductionary
+lines: &knode; does this automatically when you reply to an
+article; to find out how to customize this line see
+<link linkend="knode-composer-settings">The Composer Settings</link>
+documentation.
+</para>
+</tip>
+
+<para>In <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>Appearance</guilabel></menuchoice> you can
+choose how the articles are shown. In particular, &knode; provides the
+smart coloring of different reply levels; you can read more about this
+in the chapter <link linkend="knode-appearance">Configuring the
+appearance</link>.</para>
+
+<caution>
+<para>&knode; only supports the coloring of quotes if the quoting
+lines starts with special characters; you can configure these
+characters at
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>Viewer</guilabel></menuchoice>.</para>
+</caution>
+
+<para>When the body of an article contains links to internet addresses
+you can invoke an internet browser to display the web page it links to
+by clicking on the link; details about configuring this feature can be
+found in <link linkend="setting-news-general">General news
+settings</link>.</para>
+
+</sect4>
+
+<sect4>
+<title>The Signature</title>
+
+<para>Below the main text of an article you can find the signature of the
+author, provided you did not disable signatures in
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</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 <acronym>MIME</acronym>
+messages</title>
+
+<para>If an article contains attachments they are shown below the
+signature in a table.</para>
+
+<para>The multipart <acronym>MIME</acronym> format allows the body of
+an article to be sent in more than one format; for example, in plain-text
+and in <acronym>HTML</acronym>. It depends on the newsreader which format
+is used for reading the article.</para>
+
+<para>&knode; allows the different formats to be shown by selecting
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guilabel>Reading
+News</guilabel><guilabel>Viewer</guilabel><guilabel>Show alternative
+contents as attachments</guilabel></menuchoice>; when this option is
+checked all alternative formats are shown as attachments and can be
+opened and viewed.</para>
+
+<para>If this option is unchecked you will not be shown the different text
+formats and &knode; decides which one should be shown.</para>
+
+</sect4>
+</sect3>
+</sect2>
+
+<sect2 id="post-and-mail-news">
+<title>Writing and Replying to Articles</title>
+
+<para>Before you start writing articles or replying to other Usenet
+users be sure you understand the habits of the current
+newsgroup; again, reading <link linkend="knode-journey">A Journey
+Through Usenet</link> 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 only contain the word
+<quote>test</quote>? It is like somebody calling you just to
+testing their phone.</para>
+
+<para>This is the reason for the special groups having
+<quote>test</quote> in their name; for example,
+<emphasis>alt.test</emphasis>. In these groups you can test everything
+you want without bothering anybody; some groups even send you error
+messages back.</para>
+
+<para>Here you can easily identify obvious mistakes, like a missing or
+a wrong e-mail address or a wrongly-configured charset which doesn't
+show all special characters.</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 news servers 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; this may take some time if there are many articles
+in the group. The only
+important articles are yours and the answers by the check handler; if
+you want to reduce the number of articles fetched during the test you
+can configure this in
+<menuchoice><guimenu>Settings</guimenu><guilabel>Configure
+KNode...</guilabel><guilabel>Reading
+News</guilabel><guilabel>General</guilabel><guilabel>Maximal number of
+articles to fetch</guilabel></menuchoice>: if you reduce this
+dramatically, you should not wait too long to fetch the new
+articles after sending your test article; however, if it set too low
+your article might not be fetched. A tolerably-fast news server should
+provide your article right after you sent it; you might, however, have to
+wait a while, at worst 1 or 2 days. Feel free to send another article
+if cannot see your initial one; this is what the test groups are
+for.</para>
+</tip>
+
+<caution>
+<para>When you are using a local news server the configuration of
+<guilabel>Maximal number of articles to fetch</guilabel> in &knode; is
+probably unnecessary; you should consult the documentation of your
+news server instead.</para>
+</caution>
+
+<para>If you did not encounter any errors unsubscribe from the
+test groups and set <guilabel>Maximum number of articles to
+fetch</guilabel> back to normal (1000).</para>
+
+<sect3>
+<title>Publishing Articles</title>
+
+<para>You have seen most of &knode; now, but have only used it
+passively so far, so let's publish a test
+article now. Select the new subscribed test group in the folder
+view; then, with <menuchoice><guimenu>Article</guimenu><guimenuitem>Post to
+newsgroup...</guimenuitem></menuchoice>or the key <keycap>P</keycap>,
+the Editor will be opened.</para>
+
+<para>You can use the &knode; Editor like a normal Texteditor; there
+are some additional features for writing news articles though.</para>
+
+<para>In the editor window there are 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>Normally, 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 before; do not change this.</para>
+
+<para>Below the input field for the <glossterm>newsgroup</glossterm>
+there is another inactive option field: this function is explained
+later in the chapter <link linkend="knode-editor-advanced">The
+editor</link>; for now it is irrelevant.</para>
+
+<para>For simplicity reasons we will only use a simple
+sentence; type:</para>
+
+<screen>
+<userinput>This is the body of my test article. @ $ %</userinput>
+</screen>
+
+<para>Then, enter an empty line, followed by:</para>
+
+<screen>
+<userinput>Did it work?</userinput>
+</screen>
+
+<para>This may look funny to you, but it does what it is supposed to
+do &mdash; test your configuration..</para>
+
+<para>Your article should now look like the screenshot below:</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 &mdash; you can achieve this by using
+<menuchoice><guimenu>File</guimenu><guimenuitem>Send
+Later</guimenuitem></menuchoice> &mdash; &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; stores a copy
+in the <guilabel>Sent</guilabel> folder.</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, though, it <emphasis>may</emphasis> take the article some
+hours before reaching the newsgroup. If the article does not arrive
+after a number of hours it is likely that something went wrong: try again; then,
+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 news server, you have to check
+for new articles: the local news server just sends the article, it does
+not store it in the local newsgroup, so you have to synchronize with
+an external news server if you want to see if your test article
+has arrived.</para>
+</important>
+
+<para>If the <glossterm>article</glossterm> appears in the newsgroup
+you are successful; now you should check if there is the correct
+sender and if the article is readable. Have a look on your
+language-specific characters like the German umlauts; if they are not
+readable you have to change the coding at
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</guimenuitem><guilabel>Posting
+News</guilabel><guilabel>Technical</guilabel></menuchoice>to
+<guilabel>Allow 8-bit</guilabel>. Change this and repeat your
+test.</para>
+
+<para>If everything is right you have successfully published your first
+article in usenet with &knode;.</para>
+
+</sect3>
+
+<sect3>
+<title>Post Reply</title>
+
+<para>After successfully publishing an article we will now answer to
+your own article. You want to answer the question you asked, don't
+you?</para>
+
+<para>Select your article in the article view and press the &RMB;: a
+context menu will appear; choose <guimenuitem>Followup to
+newsgroup</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>
+
+<screen>
+<computeroutput>Re: This is a test</computeroutput>
+</screen>
+
+<para><emphasis>Re:</emphasis> is a shortcut for the Latin <quote>In
+re</quote>, which translates to something along the lines of <quote>relating
+to</quote>. 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, for example,
+when a new topic occurs in the original discussion or the original
+subject has changed for some reason.</para>
+
+<para>If you answer to an article with such a subject, delete the
+parenthesized part of the subject; the first part with a prefixed
+<emphasis>Re:</emphasis> remains.</para>
+
+<informalexample>
+<para>Re: A new subject!</para>
+</informalexample>
+</tip>
+
+<para>Let us have look at the Editor now. The contents of the article
+to which we want to reply 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 an 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>Configure
+KNode...</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 answer this question now.</para>
+
+<para>Place the cursor below the quoted question and write in the next
+line:</para>
+
+<screen>
+<userinput>Yes it worked, congratulations!</userinput>
+</screen>
+
+<para>We are not finished yet: it is considered polite to begin with
+a greeting like <quote>Hello</quote> in the first line; whether you call the
+author by their name or not depends on your habits, watch the
+newsgroup to get used to the habits there.</para>
+
+<para>Next we delete all non-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 an <citation>I agree</citation> at the end you will
+understand.... Aside from this, it makes articles smaller so they use
+less space on the server.</para>
+
+<para>At the end we say good bye.</para>
+
+<para>This screenshot shows our answer before sending it.</para>
+
+<screenshot>
+<screeninfo>Your answer to your article</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="knode-followup.png" format="PNG"/> </imageobject>
+<textobject>
+<phrase>Your answer to your article</phrase>
+</textobject>
+<caption>
+<para>Your answer to your article</para>
+</caption>
+</mediaobject>
+</screenshot>
+
+<tip>
+<para>You can find a good guide for correct quoting at <ulink
+url="http://www.afaik.de/usenet/faq/zitieren">http://www.afaik.de/usenet/faq/zitieren</ulink>
+(German).</para>
+</tip>
+
+<para>Now we still need to post our reply; like posting the original message
+choose <menuchoice><guimenu>File</guimenu><guimenuitem>Send
+now</guimenuitem></menuchoice> or the alternative
+<menuchoice><guimenu>File</guimenu><guimenuitem>Send
+later</guimenuitem></menuchoice>, if you're not online at the moment
+and you're not using a local newsserver. If everything works
+you will see your article in the newsgroup after a while; easy, isn't
+it?</para>
+
+<tip>
+<para>Using the <guimenu>Options</guimenu> menu you can configure whether
+you want to send an email, a news article or both.</para>
+</tip>
+</sect3>
+
+<sect3>
+<title>Mail Reply</title>
+
+<para>The Mail Reply follows the same lines as posting a reply in a
+newsgroup; the only difference is that a mail reply is sent directly
+to the author and does not appear in any newsgroup.</para>
+
+<para>Sometimes it is better to use an emailed reply instead of
+posting a reply to newsgroup; they are used primarily for when you
+want to correct an error or misconduct by the author, without hurting
+their feelings by doing so publicly on the newsgroup.</para>
+
+<para>To answer with an e-mail select your article; again,
+open the context menu with the right mouse button; and choose
+<guimenuitem>Reply by Email</guimenuitem>: &knode; opens the Composer
+with the quoted article.</para>
+
+<para>Subject and body are identical as when posting an article but
+the <guilabel>Groups:</guilabel> field is replaced by a
+<guilabel>To:</guilabel> field; here the author's email address
+appears. In our example this should be your own email address, if
+&knode; is set up correctly.</para>
+
+<para>For emails the same rules for quoting and politeness apply
+as for posting an article in a newsgroup.</para>
+
+<para>After finishing your Reply, you can send it.</para>
+
+<para>The screenshot below 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 if you have used the correct settings in
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KNode...</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; you might have to connect to your
+<acronym>ISP</acronym> and fetch your new mail first though.</para>
+</important>
+
+<tip>
+<para>On the <guimenu>Options</guimenu> menu you can configure whether
+you want to send an email, a news article or both.</para>
+</tip>
+</sect3>
+</sect2>
+</sect1>
+