Mercurial > noffle

view README @ 45:32ba1198c6fa noffle

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[svn] * Makefile.in, configure, configure.in, docs/Makefile.in, src/Makefile.in: Added checks for the mail and sort programs. ./configure will abort if they're not found. * README: Removed the paragraph about news client software, as it's the same as the one in docs/NOTES. * TODO: Removed 'expiring by groups' and 'move some text from noffle.1 to noffle.conf.5'. * docs/NOTES: Changed the text about -DDEBUG to explain one should use './configure --enable-debug'. * docs/noffle.1, docs/noffle.conf.5: Minor fixes. Added myself and Jim Hague to the AUTHORS section :-) * src/client.h, src/common.h, src/configfile.h, src/content.c, src/content.h, src/control.c, src/control.h, src/database.h, src/dynamicstring.c, src/dynamicstring.h, src/fetch.h, src/fetchlist.h, src/group.h, src/itemlist.c, src/itemlist.h, src/lock.h, src/log.c, src/log.h, src/noffle.c, src/online.h, src/outgoing.h, src/over.c, src/over.h, src/post.h, src/protocol.h, src/pseudo.h, src/request.h, src/server.h, src/util.c, src/util.h: Added the <config.h> include. * src/content.c: Added missing include "content.h". Added a missing 'void' in the declaration of clearCont(). * src/fetchlist.c: Casted fetchlist.size to (size_t) in a call to qsort(), as qsort() expects a size_t. This removes a warning. * src/noffle.c: Made doRequested() static. Added missing void to enableCorefiles(). * src/log.c, src/protocol.c, src/online.c, src/pseudo.c: Added missing includes. * src/pseudo.c: Made genOv() and genPseudo() static. * src/server.c: Added missing void to postArts(). Made touchArticle() static. * src/util.c: Casted arguments of malloc() and memcpy() to size_t. * src/dynamicstring.c, src/itemlist.c, src/over.c, src/request.c, src/util.c: Removed casting of the result of malloc(). This is not necessary and can hide a missing include of <stdlib.h>.
author uh1763
date Sat, 06 May 2000 00:49:38 +0100
parents 2467ff423c15
children 8c6dbce3b178
line wrap: on
line source

-------------------------------------------------------------------------------
The NOFFLE News Server
-------------------------------------------------------------------------------

Features
--------

NOFFLE is a Usenet news server optimized for few users and low speed dial-up
connections to the Internet. It acts as a server to news clients running on
the local host, but gets its news feed by acting as a client to a remote
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.

 * Groups can be retrieved in overview, full or thread mode.
    * In overview mode, opened articles that have not been completely
      downloaded yet are marked for download. NOFFLE generates a pseudo
      article body telling the human about this.
    * In full mode, complete articles are fetched at once.
    * Thread mode is like overview mode, but opening an article marks the whole
      thread for download (all later articles for some time that are
      referencing the original article).

 * The news feed is invoked automatically next online time by calling NOFFLE
   in the ip-up script.

 * Groups can be put on the fetch list via the 'noffle' command or
   automatically when someone tries to read them. Groups can be automatically
   removed from the fetch list, when nobody accesses them for some time.

 * NOFFLE also offers limited support for local groups. Articles posted in
   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
-------------------------------

See docs/NOTES for information about news client software.


Getting NOFFLE
--------------

NOFFLE can be downloaded from the following location:

 http://home.t-online.de/home/markus.enzenberger/noffle-1.0pre5.tar.gz
 (18 Apr 2000)

 http://home.t-online.de/home/markus.enzenberger/noffle-1.0pre4.tar.gz
 (13 Nov 1999)

You can always get the latest version from CVS. For instructions see

 http://sourceforge.net/cvs/?group_id=1044


RPM packages have been created by Mario Moder <moderm@gmx.net>. They are
available at 

 ftp://ftp.fbam.de/pub/linux/ 


I moved Noffle to SourceForge recently (http://sourceforge.net/).

You can download files from the Noffle project page at
 http://sourceforge.net/project/?group_id=1044

There is also a mailing list and a discussion forum.


Installation
------------

Read INSTALL for information about compiling and installing Noffle.


Documentation
-------------

Read the files in the subdirectory docs/ for more info on NOFFLE.
Read INSTALL for information about compiling and installing NOFFLE on your
system.

Some German documentation is provided by
Klaus Mödinger <klaus.moedinger@t-online.de>:

 http://home.t-online.de/home/klaus.moedinger/noffle_install_de.html


The current version is still beta. Please send bug reports, comments and
patches to Markus Enzenberger <markus.enzenberger@t-online.de>.


Links
-----

 * http://www.tin.org/docs.html
   NNTP information

 * http://www.privat.kkf.net/~mark.bulmahn/ncontr.html
   ncontr -- a graphical front-end for NOFFLE by
   Mark Bulmahn <mbu@privat.kkf.net>

 * http://www.leafnode.org/
   Leafnode -- a news server similar to NOFFLE

 * http://space.mit.edu/~davis/slrn.html
   slrn -- a powerful news reader for Windows and Unix

 * http://www.gedanken.demon.co.uk/wwwoffle/index.html
   WWWOFFLE - http proxy


Acknowledgements
----------------

The wildmat newsgroup pattern matching software used by NOFFLE was developed
by Rich Salz, and is distributed with INN v2.2. 


-- 
Markus Enzenberger <markus.enzenberger@t-online.de>