README
1This is relaynews, the heart of C News: article filing.
2
3If you're starting here, you are in the wrong place: go to ../conf and
4run "build".
5
6Subdirectories are:
7
8anews stuff for conversion to and from the old A News format
9aux auxiliary programs of various kinds
10ctl control-message shell files
11regress regression-test facilities for relaynews
12
13ihave.not.c is an alternate version of ihave.c for sites that specifically
14wish to disable ihave/sendme (typically because of foolishness like
15proprietary newsgroups).
16
17To run a regression test, "make r".
18
README.relay
1``yer about to be boarded, ye scurvy network news dogs! har har ...''
2 -- Oliver Wendell Jones, Bloom County Hacker & Cracker
3
4``No news is good news.''
5``When bigger machines are built, netnews will saturate them.''
6``USENET -- All the news that's fit to `N'.''
7 -- /usr/games/fortune
8
9``Net news is the television of computing.''
10 -- Geoff Collyer
11
12You can test relaynews by supplying NEWSCTL, NEWSBIN or NEWSARTS
13environment variables to change the library, binary or spool directories,
14and I encourage this.
15
16If you plan to run rn, you'll need an rn which honours Xref: in the
17absence of Relay-Version:, which has been banished. patchlevel 40 or
18greater should be fine; patchlevel 40 works fine.
19
20You will need to put your site name in /usr/lib/news/mailname
21(../conf/build looks after all this). No upper case letters in your name
22please, there is no call for it and it just looks uGLy.
23
24You must only permit relaynews to run on file servers since newsboot
25clears all locks in /usr/lib/news.
26
27You'll need compress for compressing or uncompressing batches of news.
28See the contact person of your news feed or the moderator of the
29newsgroup comp.sources.unix (try uunet!sources).
30
31See the anews directory for conversion filters from A to B and back.
32
33Good Luck.
34
35 Geoff Collyer
36