home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / news / nn.tar / nn-6.5.1 / inews / README.NN < prev    next >
Internet Message Format  |  1995-04-29  |  3KB
  1. From: Steve Simmons <scs%itivax@relay.EU.net>
  2. To: storm@texas.dk (Kim F. Storm)
  3. Date: Thu, 21 Dec 89 18:02:03 EDT
  4. Subject: Inews Kit For NN
  5.  
  6. What Is This:
  7.  
  8. This is a mini-inews, suitable for building client-only versions of NN
  9. that use NNTP for remote reading.  Some unknown (to me) person patched
  10. it to be driven on NNs config.h file.  I have taken those changes, reversed
  11. most of them and upgraded to NNTP release version 1.5.7.  This inews was
  12. a co-operative venture when Stan released it, and it's kind of fitting
  13. that it continues to be worked on by many hands.
  14.  
  15. If you have a full installation of news where you're installing NN,
  16. you could care less about this.
  17.  
  18. Copyrights:
  19.  
  20. See individual files for authors.  I wrote conf.h and the
  21. Makefile, and explicitly put them in the public domain.  Other parts
  22. may have other copyrights, see the individual files.
  23.  
  24. Maintenance:
  25.  
  26. My less-than-humble opinion is that as Stan releases nntp patches, you will
  27. be able to apply them to this code with no changes whatsoever.  As Stan
  28. releases patches I will attempt to apply them and upgrade this source,
  29. but no guarantees.
  30.  
  31. Why A Separate Release From NNTP:
  32.  
  33. NN and NNTP both use configuration files to let you fit the software
  34. for your system.  Unfortunately, they used rather different methods.
  35. This release specificly reconciles NNs 'config.h' and NNTPs '../common/conf.h'
  36. by creating a local "conf.h" which maps 'config.h' to what NNTP inews needs.
  37. Result -- once you build the config.h for NN you're 98% done with NNTP inews.
  38.  
  39. INSTALLATION:
  40.  
  41. Ideally you went to your nn source directory and created a subdir
  42. named inews.  Then you unpacked this in that directory (I have already
  43. done that, ++Kim).
  44.  
  45. All you should need to do is read conf.h, make any changes you feel
  46. like, and then type 'make'.  If things work, type 'make install'.  For
  47. more data on the inews itself, read the file README.  It's slightly
  48. edited from the NNTP version to reflect its separation from the rest
  49. of NNTP.
  50.  
  51. For more data on the inews itself, read the file README.  It's
  52. slightly edited from the NNTP version to reflect its separation from
  53. the rest of NNTP.
  54.  
  55. Steve Simmons
  56. scs@lokkur.dexter.mi.us
  57. December 21, 1989
  58.  
  59.  
  60. --- Changes by Kim Storm, storm@texas.dk
  61.  
  62. I have edited what Steve sent me a bit further to simplify the
  63. configuration and installation even more: It now uses nn's code to get
  64. the hostname, so this is now got for free, and it gets the location of
  65. the inews program from config.h as well.
  66.  
  67. Makefile:
  68.     Added -I../conf to CFLAGS
  69.     nn's hostname.o is used instead of uname.o to get the hostname.
  70.     Installation uses nn's inst script (which will use the possible
  71.     definition of INEWS or NEWS_LIB_DIRECTORY in config.h).
  72.  
  73. conf.h:
  74.     #defines to set the proper hostname removed.
  75.     #include "../config.h" line moved to start of file.
  76.     Documents optional #define USG to get bcopy function.
  77.  
  78. clientlib.c, inews.c
  79.     Added tweaks using a FOR_NN #define to include/exclude
  80.     code to co-exist with nn's config.h file.
  81.  
  82. uname.c:
  83.     Not used (so it is omitted from this distribution).
  84.