See manual.txt or index.html if you haven't installed newsstar yet. These files
need to be built first by the make process.

Read:
    /usr/local/etc/newsstar/main.cf.sample
If you need to change any of the options, rename it to:
    /usr/local/etc/newsstar/main.cf
and apply the changes.

For each remote server, eg news.isp.com, you want to connect to:
Execute:
    touch /var/spool/newsstar/lib/newsrc.news.isp.com
    (Make sure the the user newsstar will be running as has write access too.)
Read:
    /usr/local/etc/newsstar/cf.server.sample
If any of the options need changing for news.isp.com, copy it to:
    /usr/local/etc/newsstar/cf.news.isp.com
and apply the changes.
If not all groups known to the local server should be downloaded from this
server, create:
    /usr/local/etc/newsstar/ignore.news.isp.com
containing perl regexps matching the groups you don't want to download.

If your local server is INN, ensure INN's newsfeeds file is configured to
create a suitable feed file for each remote server you want to upload articles
to, in the directory named by outgoing_dir in /usr/local/etc/newsstar/main.cf.

If you need to filter outgoing articles, read:
    /usr/local/etc/newsstar/filter.pl.sample
If it needs altering, first rename it to:
    /usr/local/etc/newsstar/filter.pl

To fetch and upload news, make sure you are running as user news (or root if
you must), and if your local server is INN, execute:
    newsstar -A-50 -m
or, for sn:
    newsstar -A-50 -m -sn
or, for s-news:
    newsstar -A-50 -m -snews
where 50 is the maximum number of articles to be downloaded from each group on
the first run; this figure only applies to groups from which newsstar hasn't
previously downloaded or attempted to download articles.

See the man page (man newsstar(1)) and README.html or README for more details.
