changeset 266:505a88ee6782 noffle

[svn] * INSTALL,README,docs/FAQ: Remove online mode from introductory documentation. It causes confusion. Add it to FAQ list.
author bears
date Mon, 05 Aug 2002 23:05:53 +0100
parents 1cafe0f3f0ec
children a53d3f2f2f38
files ChangeLog INSTALL README docs/FAQ
diffstat 4 files changed, 41 insertions(+), 21 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog	Mon Aug 05 23:05:32 2002 +0100
+++ b/ChangeLog	Mon Aug 05 23:05:53 2002 +0100
@@ -1,3 +1,13 @@
+Mon Aug 5 2002 Jim Hague <jim.hague@acm.org>
+
+* INSTALL,README,docs/FAQ: Remove online mode from introductory documentation.
+  It causes confusion. Add it to FAQ list.
+* configure, configure.in: Correct --enable-debug handling. Don't add
+  -DDEBUG flag to the build line on non-debug builds.
+* src/group.c: Explicitly disallow zero-length group names. Yes, I found one.
+* src/server.c: Correctly implement LISTGROUP when the optional group name
+  parameter is omitted.
+	
 Thu Jul 4 2002 Jim Hague <jim.hague@acm.org>
 
 * docs/NOTES: Add note on Slypheed.
--- a/INSTALL	Mon Aug 05 23:05:32 2002 +0100
+++ b/INSTALL	Mon Aug 05 23:05:53 2002 +0100
@@ -75,14 +75,9 @@
 
    (Change the path of noffle if necessary)
 
- * Add the following lines to your 'ip-up' script:
+ * Add the following line to your 'ip-up' script:
 
     /usr/local/bin/noffle --fetch
-    /usr/local/bin/noffle --online
-
-   Add the following line to your 'ip-down' script:
-
-    /usr/local/bin/noffle --offline
 
  * Add a line for running noffle to the crontab of news (by running
    'crontab -u news -e' as root):
@@ -99,8 +94,8 @@
 and/or create the file /etc/nntpserver containing "localhost".
 
 If something goes wrong, have a look at '/var/log/news' for error and
-logging messages.
-
+logging messages. Try setting 'log-debug all' in noffle.conf to enable
+every debug message.
 
 It can be helpful to recompile NOFFLE with 
 
@@ -108,10 +103,9 @@
  make
  make install
 
-to increase the level of logged details. Additionally, this will create
-a core file in the spool directory if NOFFLE should crash.
-This will allow those of you familiar with a debugger to send me a detailed
-bug report :-)
+This enable various internal consistency checks and ensures NOFFLE is
+built with full debugging symbol information. This will allow those of
+you familiar with a debugger to send me a detailed bug report :-)
 
 
 Read below for more (generic) information about ./configure.
--- a/README	Mon Aug 05 23:05:32 2002 +0100
+++ b/README	Mon Aug 05 23:05:53 2002 +0100
@@ -11,13 +11,6 @@
 server. Noffle is written for the GNU/Linux operating system and freely
 available under the terms of the GPL. See COPYING for details.
 
-While Online:
-
- * Any newsgroup can be read, selected articles are fetched immediately from
-   the remote server.
-
-While Offline:
-
  * Allows reading news offline with many news clients, even if they do not
    support offline reading by themselves.
 
@@ -41,7 +34,6 @@
    local groups appear in the news database for those groups immediately,
    and are expired in the same way as other articles.
 
-
 Compatibility with News Clients
 -------------------------------
 
@@ -53,7 +45,7 @@
 
 The current stable release is:      1.0.1
 
-The current development release is: none
+The current development release is: 1.1.2
 
 The Noffle homepage is at:
 
--- a/docs/FAQ	Mon Aug 05 23:05:32 2002 +0100
+++ b/docs/FAQ	Mon Aug 05 23:05:53 2002 +0100
@@ -33,3 +33,27 @@
 A: This is a known phenomena and I believe that it is a bug with GNUS, because
    the log files show correct handling of client commands by noffle.
 
+-------------------------------------------------------------------------------
+
+Q: What is the NOFFLE 'online' mode?
+
+A: NOFFLE can be optionally switched into 'online' mode. When in
+   online mode any newsgroup can be read and the selected articles are
+   fetched immediately from the remote server if not present
+   locally. Regardless of the settings in noffle.conf, NOFFLE will not
+   automatically subscribe to any newsgroup when in online mode. Online
+   mode is therefore useful for quickly sampling the content of
+   potentially interesting newsgroups.
+
+  To enter online mode, run 'noffle --online'. To return the regular
+  offline mode, run 'noffle --offline'. If you net connection is via
+  dial-up, you may find it convenient to do this in your ip-up and
+  ip-down scripts, though if you do you'll have to remember that NOFFLE's
+  behaviour will be subtly different when you are dialled out.
+
+-------------------------------------------------------------------------------
+
+Q: Can I read any article in 'online' mode?
+
+A: No. You cannot read groups that are not known to NOFFLE, or articles
+   that NOFFLE has already expired. NOFFLE will not refetch expired articles.