Mercurial > noffle
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.