
                MicroWalt W-NEWS News Package  4.50
                =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

How To Install W-NEWS:

1.  Type "make". You will be shown a list of system to choose from.
    Choose your system, and type "make systemtype". One of the system
    specific Makefiles from the config/ subdirectory will be copied
    to the master Makefile. If you really want, then check the header
    file for your system, also in the config/ subdirectory. Now just
    type "make" to compile all programs.

2.  Look into the "samples" subdirectory. The configuration files there
    will be installed on your system _if_ you don't already have them.
    Change the files to suit your system configuration.

3.  Check the 'active' file for customization of the newsgroups. Remove
    unwanted newsgroups or add additional ones. Do *not* remove the lines
    with 'junk' and 'control', these groups are mandatory!

4.  Now substitute "my_feed" in the 'sys' file by the real name of your
    news feed. If you haven't added other newsgroups in the 'active' file
    before, there isn't anything else to do. If you added newsgroups
    others than from the 'comp' hierarchy you have to add them also.
    As an example, if you added the newsgroup alt.sources you have to
    change the 'sys' file to the following:
    
	ME:world,comp,alt:F:
	my_feed/my_feed.domain.org:world,comp,alt:F:

    If you are using the 'newsfeeds' file, this will do:

	ME::F:
	my_feed/my_feed.domain.org:*:F:

5.  The following installation *must* be done as user root! Type:

	make install

    All programs will now be compiled.  Note, that you need one of the new
    Stdio(3) packages for the 'inews' program, since it uses the 'r+' (read
    and update) flag with fopen(3).  Define HAVE_STDIO in "wnews.h" to 1 if
    your library cannot handle the 'r+' operator; otherwise set it to 0.
    (Only worry about this if you have a Minix system).

6.  All W-NEWS files will have been installed in LIBDIR, CONFDIR, BINDIR and
    MANDIR, and some control directories will have been created in SPOOLDIR.

7.  Fetch, compile and install one or more newsreaders.
    Available newsreaders are vn, tass, tin, nn and trn.

8.  Add a line to /usr/lib/crontab, or wherever your crontab file is located,
    which automatically executes the "rnews -U' program at certain time
    intervals.  I have an entry like:

	10 * * * *	news	/usr/bin/rnews -U

    That automatically unbatches news every hour.

9.  Set up a news feed with a site nearby, and try to exchange some
    articles.  It should work OK.

10. After some days of collecting news you should read the manual for
    expire and also add it to the crontab file. I have entries like:

	0 6 * * *	LIBDIR/expire -v 1 -e 7
	15 6 * * *	LIBDIR/expire -n junk -v 1 -e 1

11. Don't forget to trim the files "log", "errlog" and "news.adm" regulary
    or you'll be out of disk space very soon. The history file(s) will be
    trimmed by expire, but can grow pretty big too.

Enjoy,
	Miquel van Smoorenburg.

	Other people who helped with Wnews:

	Fred van Kempen	(original author)
	Edvard Tuinder  (lots of ideas)
