home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD2.img / d4xx / d473 / cnewssrc / cnews_src.lzh / README.amiga < prev    next >
Text File  |  1990-06-06  |  4KB  |  85 lines
  1. This README is for the Amiga port of Henry Spencer's and Geoff Collyer's
  2. CNews news distribution package.
  3.  
  4. Do not expect this file to tell you how CNews works.  There is documentation
  5. which comes with CNews that will describe that for you (see doc/install.doc
  6. for general information, other files in doc/ for more info).
  7.  
  8. Instead, this file contains installation instructions for the Amiga.  This
  9. begins by understanding (at a very high level) what CNews does.
  10.  
  11.     1.    News comes into our machine from the feeder site.  Normally such
  12.         news will be compressed using the Unix compress(1) program, although
  13.         uncompressed news will be handled correctly also.
  14.  
  15.     2.    When the news arrives, UUX will execute RNEWS and provide the given
  16.         batch of news as stdin.  RNEWS will simply move the file to another
  17.         location, NEWSARTS:In.coming (which is a directory).
  18.  
  19.         NB:  whatever transport mechanism you're using should file the
  20.         article in that directory.
  21.  
  22.     3.    At periodic intervals, each file in NEWSARTS/In.coming (hereafter
  23.         referred to as "in.coming") will be uncompressed and unbatched.
  24.         Uncompression *may* use the "acomp" program provided with this
  25.         distribution, or any other compress(1) compatible program.  Acomp
  26.         has been optimized for 68020/68030 operation, and will take
  27.         advantage of the bit-field instructions that those processors have.
  28.         Otherwise, the bit-fields are handled in 68000/68010 code.  Also,
  29.         this code dynamically allocates its buffers, meaning that two large
  30.         hunks are allocated instead of one, reducing the requirement
  31.         (somewhat) for contiguous memory.  Only memory required is
  32.         allocated.
  33.  
  34.         NB:  the periodic intervals can be via AmiCron or manually.
  35.  
  36.     4.    After uncompression, the articles are ready to be dispersed for
  37.         filed prior to reading.  This is the job of RELAYNEWS.  It reads
  38.         the incoming news and creates directories and files as needed
  39.         based on the "Newsgroups:" header of the article.  Full handling
  40.         of the "active" file is implemented, i.e. "junk" articles, "to."
  41.         newsgroups, "control" newsgroup, moderated newsgroups, etc.
  42.  
  43.         Local news also goes into RELAYNEWS, which files the article, just
  44.         like normal, and then puts it into a queue file for transmission
  45.         to your feeder site.  See the section below, "Non-Leaf Sites".
  46.  
  47.     5.    Read your news.  I have provided AmiRN for this.  Since I don't have
  48.         and have never used `rn', I have no idea how close this program
  49.         comes to the "Real Thing (tm)".
  50.  
  51.     6.    Run the EXPIRE program, which removes old articles in order to
  52.         make room for more.  I typically run EXPIRE on a daily basis, but
  53.         I am able to read the news at least that often also.  Occasionally,
  54.         when I'm out-of-town, the news gets to my machine, but I don't let
  55.         it unbatch until I get home.  Initially this was done out of
  56.         paranoia; now its that way because I just haven't changed it! ;-)
  57.  
  58.         NB:  EXPIRE contains code to perform an archive operation instead
  59.         of a removal.  This hasn't (yet) been tested on an Amiga.  However,
  60.         I felt that what *is* provided by this CNews release would more than
  61.         make up for it.
  62.  
  63.     7.    That's All Folks!!!
  64.  
  65.  
  66. Non-Leaf Sites.
  67.  
  68.     If you are going to be sending news to another site, i.e. you are not
  69.     a "leaf" or "terminating" site, or you plan on posting your own news
  70.     articles, there's a little more work involved.
  71.  
  72.     1.    As news comes in your "sys" file will be checked to see if that
  73.         news should be propagated to other sites.  If so, a file will be
  74.         appended to which is a list of full pathnames to the articles
  75.         that need to be sent.  There will be one such file per destination
  76.         machine.
  77.  
  78.         It is also possible that instead of "batch"ing news, each article
  79.         is transmitted as a mail message to your feeder site.  Which one
  80.         you choose will be reflected by option flags in the "sys" file.
  81.  
  82.     2.    Periodically you must run the BATCHER program to read those files,
  83.         concatenate the articles together (before they are EXPIRE'd! :-),
  84.         compress them, and send them on their way to the next site.
  85.