home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / TELECOM / rn_4_3_blars.lzh / README < prev    next >
Text File  |  1992-03-09  |  4KB  |  90 lines
  1. This is a port of Rn to os9/68k by blarson@usc.edu.  Some features
  2. (such as the mailbox saver) do not work, but everything I normally
  3. use does.  Note that this port is not based on the most recent
  4. version.
  5.  
  6. Blarslib and C news are required.
  7.  
  8.  
  9.  
  10.  
  11.  
  12.             Rn Kit, Version 4.3
  13.  
  14.             Copyright (c) 1985, Larry Wall
  15.  
  16. You may copy the rn kit in whole or in part as long as you don't try to
  17. make money off it, or pretend that you wrote it.
  18. --------------------------------------------------------------------------
  19.  
  20. Please read all the directions below before you proceed any further, and
  21. then follow them carefully.  Failure to do so may void your warranty. :-)
  22.  
  23. After you have unpacked your kit, you should have all the files listed
  24. in MANIFEST.
  25.  
  26. Installation
  27.  
  28. 1)  Run Configure.  This will figure out various things about your system.
  29.     Some things Configure will figure out for itself, other things it will
  30.     ask you about.  It will then proceed to make config.h, config.sh, Makefile,
  31.     and a bunch of shell scripts.  It will also do a make depend for you.
  32.     You might possibly have to trim # comments from the front of Configure
  33.     if your sh doesn't handle them, but all other # comments will be taken
  34.     care of.
  35.  
  36. 2)  Glance through config.h and common.h to make sure system dependencies
  37.     are correct.  Most of them should have been taken care of by running
  38.     the Configure script.
  39.  
  40.     If you have any additional changes to make to the C definitions, they
  41.     can be done in the Makefile, in config.h, or in common.h.  If you have
  42.     strange mailboxes on your system you should modify mbox.saver to correctly
  43.     append an article to a mailbox or folder.
  44.  
  45.     If you are on a machine with limited address space, you may have to
  46.     remove some of the special functions of rn to make it fit.  This is
  47.     easily done by undefining symbols in the System Dependencies section
  48.     of common.h.  You should run "make depend" again to be safe.
  49.  
  50. 3)  make
  51.  
  52.     This will attempt to make rn in the current directory.
  53.  
  54. 4)  make install
  55.  
  56.     This will put rn, newsetup, newsgroups, Pnews, and Rnmail into a public
  57.     directory (normally /usr/local/bin), and put a number of files into the
  58.     private rn library (normally /usr/lib/news/rn).  It will also try to put
  59.     the man pages in a reasonable place.
  60.  
  61. 5)  Read the manual entry before running rn.  It's quite different from
  62.     readnews.
  63.  
  64. 6)  If you are trying to make it work with NNTP, be sure you have 
  65.     installed the NNTP inews and the file that contains the name of the
  66.     NNTP server. RRN expects that the NNTP is at least version 1.5.
  67.  
  68. 7)  Try rn, and play with some of the switches.  You may want to make -/
  69.     default on your system.  This is done in common.h.  You may want to modify
  70.     which header lines are displayed by default--this is done in head.h.
  71.  
  72.     To change default values of enviroment variables on a system-wide basis
  73.     without recompiling rn, put switches into file INIT in the rn library.
  74.  
  75. 8)  IMPORTANT!  Help save the world!  Communicate any problems and
  76.     suggested patches to my faithful servant, sob@bcm.tmc.edu, so we can
  77.     keep the world in sync.  If you have a problem, there's someone else
  78.     out there who either has had or will have the same problem.
  79.  
  80.     If possible, send in patches such that the patch program will apply them.
  81.     Context diffs are the best, then normal diffs.  Don't send ed scripts--
  82.     I've probably changed my copy since the version you have.
  83.  
  84.     Watch for rn patches in news.software.b.  Patches will generally be
  85.     applyable (is that a word?) by the patch program.  If you are just
  86.     now bringing up news and aren't sure how many patches there are, write
  87.     to sob@bcm.tmc.edu and he'll send any you don't have.
  88.  
  89. 9)  If you are going to hack on rn, please read the HACKERSGUIDE first.
  90.