annotate docs/FAQ @ 480:5d32ceec7f25 noffle

[svn] * docs/FAQ: Improve X-NOFFLE-Status entry.
author bears
date Wed, 13 Oct 2004 22:49:53 +0100
parents 0dca2ed29197
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
42
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
1 -------------------------------------------------------------------------------
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
2 NOFFLE FAQ
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
3 -------------------------------------------------------------------------------
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
4
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
5 Q: What is the difference between NOFFLE and leafnode?
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
6
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
7 A: NOFFLE uses less resources (disk space and bandwidth). Downloading groups
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
8 in overview mode is several times faster, because it uses the XOVER command
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
9 instead of HEAD. In addition, there is the quasi-transparent mode, when
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
10 online, which allows to browse through groups and cache everything without
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
11 subscribing. NOFFLE is GPLed, leafnode isn't.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
12
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
13 -------------------------------------------------------------------------------
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
14
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
15 Q: I subscribe to groups, but get a "Retreiving failed" message for every
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
16 requested article.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
17
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
18 A: Some news server do not allow retrieving articles by message-ID. You cannot
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
19 use NOFFLE together with these servers presently.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
20
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
21 -------------------------------------------------------------------------------
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
22
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
23 Q: I changed the server in the config files, but the new groups do not appear.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
24
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
25 A: You should run 'noffle --query groups' again. If you want all old group
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
26 information deleted, you should remove the file data/groupinfo.gdbm in the
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
27 spool directory before.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
28
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
29 -------------------------------------------------------------------------------
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
30
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
31 Q: The Emacs news reader GNUS hangs while getting active list from server.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
32
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
33 A: This is a known phenomena and I believe that it is a bug with GNUS, because
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
34 the log files show correct handling of client commands by noffle.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff changeset
35
266
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
36 -------------------------------------------------------------------------------
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
37
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
38 Q: What is the NOFFLE 'online' mode?
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
39
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
40 A: NOFFLE can be optionally switched into 'online' mode. When in
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
41 online mode any newsgroup can be read and the selected articles are
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
42 fetched immediately from the remote server if not present
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
43 locally. Regardless of the settings in noffle.conf, NOFFLE will not
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
44 automatically subscribe to any newsgroup when in online mode. Online
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
45 mode is therefore useful for quickly sampling the content of
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
46 potentially interesting newsgroups.
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
47
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
48 To enter online mode, run 'noffle --online'. To return the regular
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
49 offline mode, run 'noffle --offline'. If you net connection is via
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
50 dial-up, you may find it convenient to do this in your ip-up and
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
51 ip-down scripts, though if you do you'll have to remember that NOFFLE's
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
52 behaviour will be subtly different when you are dialled out.
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
53
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
54 -------------------------------------------------------------------------------
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
55
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
56 Q: Can I read any article in 'online' mode?
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
57
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
58 A: No. You cannot read groups that are not known to NOFFLE, or articles
505a88ee6782 [svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
bears
parents: 42
diff changeset
59 that NOFFLE has already expired. NOFFLE will not refetch expired articles.
479
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
60
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
61 -------------------------------------------------------------------------------
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
62
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
63 Q: What are the possible values of the X-NOFFLE-Status: header that
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
64 Noffle adds to messages?
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
65
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
66 A: The X-NOFFLE-Status: header can contain one, two or all of the
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
67 following, separated by spaces:
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
68
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
69 INTERESTING
480
5d32ceec7f25 [svn] * docs/FAQ: Improve X-NOFFLE-Status entry.
bears
parents: 479
diff changeset
70 - This message has been read, or a message referencing it has been
5d32ceec7f25 [svn] * docs/FAQ: Improve X-NOFFLE-Status entry.
bears
parents: 479
diff changeset
71 read and the group is in 'thread' more. The full message body should
5d32ceec7f25 [svn] * docs/FAQ: Improve X-NOFFLE-Status entry.
bears
parents: 479
diff changeset
72 be downloaded on the next fetch, if it has not been downloaded already.
479
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
73
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
74 NOT_DOWNLOADED
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
75 - The article has not yet been downloaded.
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
76
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
77 RETRIEVING_FAILED
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
78 - An attempt was made to retrieve the article from upstream, but
0dca2ed29197 [svn] * docs/FAQ: Add entry about X-NOFFLE-Status: header and its possible
bears
parents: 266
diff changeset
79 the attempt failed.