
                MicroWalt W-NEWS News Package  4.02
                =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

How To Install W-NEWS:

1.  Select the correct Makefile for your operating system, and check
    its target compilation flag.  Then, check the 'wnews.h' file for
    customization of the defines.  This is not needed in most cases.

    NOTE: when using a custom configuration, copy the data from
          the section that fits you the most, and give it a unique
          target name, which can be used in the Makefile.

2.  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!

3.  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:world,comp,alt:F:

4.  The following installation *must* be done as user root!
    If this is your first news installation now 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.

    If you just want to update an existing W-NEWS installation use
    update instead of install, this only builds the new binaries
    and copies them to LIBDIR.    

    For the first installation answer all questions of the install-script
    with yes. If you run make install on an existing installation think
    twice before you answer a question! If you answer all questions
    with no, it only copies the binaries to LIBDIR, creates the
    appropriate links and sets the neccessary permissions. Also
    it does some sanity check on the system files, and copies only
    missing ones.

5.  All W-NEWS files will have been installed in LIBDIR, and some control
    directories will have been created in SPOOLDIR.

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

7.  Add a line to /usr/lib/crontab, which automatically executes the
    "rnews -U' program at certain time intervals.  I have an entry like:

    0 6,19 * * *	/bin/rnews -U

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

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

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