fix segfault in prefs_matcher.c
[claws.git] / doc / manual / en / sylpheed-15.html
index edfd8528cfe199d4c700656e96331cbb21b784f9..fb42e8d8f9415a4ff0ea182d6ddf5f52fc1c9226 100644 (file)
 <HTML>
 <HEAD>
  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>: Reference</TITLE>
-<link HREF="sylpheed-16.html" REL=next>
-<link HREF="sylpheed-14.html" REL=previous>
-<link HREF="sylpheed.html#toc15" REL=contents>
+ <TITLE>Sylpheed User's Manual: NetNews</TITLE>
+ <LINK HREF="sylpheed-16.html" REL=next>
+ <LINK HREF="sylpheed-14.html" REL=previous>
+ <LINK HREF="sylpheed.html#toc15" REL=contents>
 </HEAD>
 <BODY>
-<a HREF="sylpheed-16.html">Next</a>
-<a HREF="sylpheed-14.html">Previous</a>
-<a HREF="sylpheed.html#toc15">Contents</a>
+<A HREF="sylpheed-16.html">Next</A>
+<A HREF="sylpheed-14.html">Previous</A>
+<A HREF="sylpheed.html#toc15">Contents</A>
 <HR>
-<H2><A NAME="s15">1.5 Reference</A></H2>
+<H2><A NAME="s15">15. NetNews</A></H2>
 
-<P>In this section you will find a few pieces of information that might be handy in making Sylpheed more clear for you in respect to the used shortcut keys, and a layout of the format of the address book.
-<H2><A NAME="ss15.1">15.1 Short-Cut Key List</A>
+<P>What is netnews?
+<P>Netnews, also called Usenet, is a collection of "news servers" that contain a great deal of information. News, as it is called in short, can be about anything. About making your own wine, about old cars or radios. You name it, and there probably is a newsgroup about it.
+<P>This is what we will set up here. Accessing newsgroups. Note that this is different from e-mails. You can almost compare it to a mailing list, but yet the concept is a bit different.
+<H2><A NAME="ss15.1">15.1 Adding and Deleting Servers</A>
 </H2>
 
 <P>
-<H3>One-key shortcuts:</H3>
+<H3>Adding a news server</H3>
 
-<P>
+<P>To add a news server, go to the configuration menu and select the "create new account" option.
+There you can name the news-account to anything of your liking. This is important, so you can identify the account later.
+<P>In the BASIC tab, in the block 'personal information' you also can enter your own name, your e-mail address (so you can reply to news message by e-mail), optionally your organization (if you are organized at all).
+<P>In the block 'Server information' you select the "News (NNTP)" protocol. Forget about "Inbox", that does not matter in this setup. Next you enter the name of the newsserver you want to connect to. You can get that name from your ISP, if you don't already have that.
+<P>If you need to log into the news server, check the box next to "This server requires authentication", and then fill the fields for User ID and Password.
+<P>Next step is to go to the Send tab. Since Receive is only there for e-mail, there is no need to do anything there. You can't even do anything in the Receive tab, for that matter. So, in Send you can select a few options:
 <UL>
-<LI>a: create a new message</LI>
-<LI>d: delete the selected message</LI>
-<LI>f: forward the selected message#</LI>
-<LI>g: go to a specific folder through a browsing dialog</LI>
-<LI>n: jump to the next message/next part of a multipart message</LI>
-<LI>p: jump to the previous message/previous part of a multipart message</LI>
-<LI>v: switch on/off the message view</LI>
-<LI>w: same as a</LI>
-<LI>y: Opens save as... dialog</LI>
+<LI>If you want a date header field added to posts</LI>
+<LI>If Sylpheed should generate a Message-ID</LI>
+<LI>If you want to add user-defined headers</LI>
 </UL>
-<H3>Shortcuts to the File menu:</H3>
 
+The next items only apply to when you reply to a news message through e-mail. You can set an automatic CC, BCC or Reply-To address here. In case your ISP requires SMTP authentication, you can select the checkbox here below.
+<P>The next tab, Compose, allows you to select a default signature file. This will be added to each post to the newsgroups you do.
+<P>Finally, in the "Advanced" tab, you can specify the port on which Sylpheed has to connect to the news server. The default is 119, and only in rare cases you should have to do something about that.
+<P>Now you click "OK" and the account is created! You can verify this by checking the folder pane in Sylpheed. There you will see a new folder created with the name of the account you entered, and (news) behind it.
 <P>
-<UL>
-<LI>Alt-F: open FILE menu</LI>
-<LI>Alt-P: print</LI>
-<LI>Alt-W: close</LI>
-<LI>Alt-Q: exit</LI>
-</UL>
-<H3>Shortcuts to the Edit menu</H3>
-
-<P>
-<UL>
-<LI>Alt-E: open EDIT menu</LI>
-<LI>Ctrl-C: copy</LI>
-<LI>Ctrl-A: select all</LI>
-<LI>Ctrl-S: search</LI>
-</UL>
-<H3>Shortcuts to the View menu</H3>
+<H3>Deleting a news-server.</H3>
 
-<P>
-<UL>
-<LI>Alt-V: open VIEW menu</LI>
-</UL>
-<H3>Shortcuts to the Message menu</H3>
-
-<P>
-<UL>
-<LI>Alt-M: open MESSAGE menu</LI>
-<LI>Alt-I: check mail for current account</LI>
-<LI>Shift-Alt-I: Check mail for all accounts</LI>
-<LI>Alt-N: compose new message</LI>
-<LI>Alt-R: reply to message</LI>
-<LI>Ctrl-Alt-R: reply to sender (contrary to reply to e.g. mailing list)</LI>
-<LI>Shift-Alt-R: reply to all (includes all addresses in To: and Cc:)</LI>
-<LI>Ctrl-F: forward message</LI>
-<LI>Shift-Ctrl-F: forward message as attachment</LI>
-<LI>Alt-O: move message</LI>
-<LI>Alt-D: delete message</LI>
-<LI>Shift-Ctrl-N: open message in new window</LI>
-<LI>Ctrl-U: view message source</LI>
-<LI>Ctrl-H: show all message headers</LI>
-</UL>
-<H3>Shortcuts to the Summary menu</H3>
-
-<P>
-<UL>
-<LI>Alt-S: open SUMMARY menu<P>
-</LI>
-<LI>Alt-X: execute (pending commands, only useful when commands are not executed immediately)</LI>
-<LI>Alt-U: update view</LI>
-<LI>Alt-G: go to other folder</LI>
-<LI>Ctrl-T: thread view</LI>
-<LI>Shift-Ctrl-T: unthread view</LI>
-</UL>
-<H3>Shortcuts to the Tool menu</H3>
+<P>If you want to delete a news-account, right-click the news-folder and select "Remove news account". After confirming that you want this to be done, the account and all files related will be removed.
+<H2><A NAME="ss15.2">15.2 Subscribing and Unsubscribing to NewsGroups</A>
+</H2>
 
+<P>Okay. Here the real stuff begins. First you have to let Sylpheed load the list of news groups that is on the news system. Right-click the new NEWS folder and select "Subscribe to newsgroups". Sylpheed will tell you that the groups need to be downloaded, so sit back and wait a while. Of course, during time, new groups are added, and dead groups are removed. For this you can click the "refresh" button in the newsgroup dialog, so a new list is downloaded and you are up to date
+<P>After a while the groups are loaded and displayed in a window. Now you can look up a group that is interesting, for example comp.os.linux.networking. Click the name once and then select OK. The group will be added to the news folder as a subfolder. When you now click the name of the new subfolder, Sylpheed will connect to the news server and download the headers (subject lines, in e-mail talk), to your computer. Some groups have -large- amounts of articles, so this may take a while!!
 <P>
-<UL>
-<LI>Alt-T: open tool menu</LI>
-<LI>Alt-A: open addressbook</LI>
-<LI>Alt-L: open logfile</LI>
-</UL>
-<H2><A NAME="ss15.2">15.2 Data Format of Address Book</A>
+<H2><A NAME="ss15.3">15.3 Reading News</A>
 </H2>
 
-<P>The addressbook is located in &nbsp;/.sylpheed. It is named addressbook.xml.
-The general format of the addressbook is:
-<P>
-<P>
-<PRE>
-&lt; addressbook &gt;&lt;p>
- &lt; common_address &gt;&lt;p>
-    &lt; group name="Common addresses" &gt;&lt;p>
-    &lt; item &gt;&lt;p>
-     &lt; name &gt; Paul &lt; /name &gt;&lt;p>
-     &lt; address &gt; paul@nlpagan.net &lt; /address &gt;&lt;p>
-     &lt; remarks &gt; Writes Sylph. manual &lt; /remarks &gt;&lt;p>
-        &lt; /item &gt;&lt;p>
-    &lt; /group &gt;&lt;p>
- &lt; /common_address &gt;&lt;p>
-&lt; /addressbook &gt;
-</PRE>
-<P>
+<P>When the articles are displayed, in the summary view, you can click one of them to be downloaded so you can read it. This will usually go very quickly on discussion groups.
+<P>If you want to respond to a message, press Alt-R (or press "Reply") and a message window will pop up, with the name of the newsgroup already in the "To" field. Depending on whether or not you selected quoting of the message, the original message will be in the body of the message already. Write away, then send, and soon the entire world will be able to read what you wrote on the subject.
+<P>Starting a new message in a newsgroup is equally simple: press Alt-N (or click "New"), the name of the newsgroup is in the "To" field, and you can write your question or reply.
+<H3>A note about binary files</H3>
+
+<P>In newsgroups you can download binary files. These are programs, images etc. Often these are posted as so called UUencoded files. Sylpheed will as upto version 0.5.1 not decode UUencoded files. You need to save these articles to disk as separate files, and use a separate decoder program, like juju, to decode the garble of text. A UUencoded file usually looks something like this:
+<P>begin 666 sundown.jpg
+<P>after which you will find nicely formatted blocks of characters that don't seem to mean anything.
 <HR>
-<a HREF="sylpheed-16.html">Next</a>
-<a HREF="sylpheed-14.html">Previous</a>
-<a HREF="sylpheed.html#toc15">Contents</a>
+<A HREF="sylpheed-16.html">Next</A>
+<A HREF="sylpheed-14.html">Previous</A>
+<A HREF="sylpheed.html#toc15">Contents</A>
 </BODY>
 </HTML>