
                            NOFFLE Installation
     _________________________________________________________________
   
   For compiling NOFFLE there are the following requirements:
   
     * The gdbm library must be installed on your system (standard with
       most distributions).
       Please use the same compiler for compiling NOFFLE that was used
       for compiling the gdbm library!
       The reason for this warning is that there is an incompatibility
       between egcs and gcc that causes programs to crash on some
       distributions, depending on the optimisation level.
     * The program "mail" must be available, because failed postings are
       returned to the sender by calling it (with option -s and by piping
       message text into it).
     * The program "sort" must be available (standard with most
       distributions).
       
   For installing NOFFLE on your system, the following steps are
   necessary:
   
     * Edit the Makefile. Change SPOOLDIR and PREFIX, if you do not like
       the defaults.
     * Type 'make'.
     * Log in as root and type 'make install'.
     * Copy '<PREFIX>/doc/noffle/noffle.conf.example' to
       '/etc/noffle.conf' and edit it. Write in the name of the remote
       news server.
       Change the owner to 'news':
         chown news.news /etc/noffle.conf
       Make it unreadable by others, if it contains a username and a
       password:
         chmod o-r /etc/noffle.conf
       Now you can leave the root account.
     * Go online and run
         noffle --query groups # required
         noffle --query desc   # optional group descriptions
       to retrieve newsgroup information.
       This may take a while depending on the number of active newsgroups
       at the remote news server.
       Subscribe to some groups by running
         noffle --subscribe-over 
       or
         noffle --subscribe-thread 
       or
         noffle --subscribe-full 
       Then run
         noffle --fetch
       for testing the retrieving of overviews/articles of the groups
       subscribed.
     * Add a line for 'noffle' to '/etc/inetd.conf':
         nntp stream tcp nowait news /usr/sbin/tcpd /usr/local/bin/noffle -r
       (Change the path of noffle if necessary)
     * Add the following lines 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):
         0 19 * * 1 /usr/local/bin/noffle --expire 14
       (if you want to run 'noffle' on Monday (1st day of week) at 19.00
       and delete all articles not accessed within the last 14 days).
       
   Now you are ready, configure the client readers to use "localhost"
   port 119 as news server and/or set the environment variable NNTPSERVER
   to "localhost" 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.
   
   It can be helpful to recompile NOFFLE with the -DDEBUG option to
   increase the level of logged details. Additionally, the -DDEBUG option
   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 :-)
