home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / mnews.t.Z / mnews.t / inst.prf < prev    next >
Text File  |  1990-04-17  |  5KB  |  157 lines
  1. .m1 0
  2. .m2 0
  3. .nopaging
  4. .offset 5
  5. .rightmargin 70
  6. .ec X.ce
  7. MNews - PreRelease
  8.  
  9. .ul
  10. 1. Copyright
  11.  
  12. .in +3
  13.   This package is copyrighted by Ulrich Dessauer, Germering, W.Germany.
  14. You may copy and redistribute this package in whole but only in source
  15. and this notice have to be included. If you made changes then you have
  16. to redistribute the original source as well.
  17.  
  18.   The programs
  19. .bold
  20. encode
  21. and
  22. .bold
  23. decode
  24. aren't copyright by me, they are normally part of the BNews 2.11
  25. distribution and are only included to be compatible with this news
  26. system.
  27. .in -3
  28.  
  29. .ul
  30. 2. Installing
  31.  
  32. .in +3
  33.   Before installing the software itself you have to edit your sysinfo
  34. database and add some entry for the package:
  35. .ce 3
  36. rnews.seq,l
  37. rnews.batch,l
  38. lck.inews,l
  39.  
  40.   The news package needs an own account to run under this uid. I advice
  41. to use an user `news' with a group `news'. Remember the uid and gid of
  42. this account; All binaries and configuration files have to be owned by
  43. this account (the file and on modules also the module).
  44.  
  45.   You should have unshared the package and find some subdirectories. The
  46. directory where this paper can be found is now called the root directory
  47. of the package. You can find a file `config.h' there; please edit it and
  48. adapt it to your local system. This will be everywhere included where it
  49. will be useful.
  50.  
  51.   Then go through all subdirectories and glance through the makefiles to
  52. place the binaries to proper places. Now compile the whole stuff and
  53. create the necessary directories. On default these are
  54. .ce 6
  55. /h0/USR/LIB/NEWS
  56. /h0/USR/LIB/NEWS/HISTORY
  57. /h0/SPOOL/NEWS
  58. /h0/SPOOL/BATCH
  59. and
  60. /h0/SPOOL/RNEWS
  61.  
  62.   Copy the files found in the `LIB' directory to /h0/USR/LIB/NEWS and
  63. edit them to reflect your system. The format of the files are explained
  64. in the file `INEWS/inews.h'. (Don't forget to change the owner of all
  65. these directories and files!)
  66.  
  67.   Now log in as `news' (or just make `su news') and execute the
  68. following commands:
  69. .ce 2
  70. inews -c=newgroup:control -v </nil
  71. inews -c=newgroup:junk -v </nil
  72.  
  73.   You should then create (or get) a file called newsgroups where all
  74. newsgroups are listen (one per line) which you like to have on your
  75. system. Execute the following command:
  76. .ce
  77. inews -c=checkgroups -v <newsgroups
  78.  
  79.   Now you can find a mail in the mailbox of the news account. The body
  80. of the mail can be fed to `shell' to create all desired newsgroups.
  81. Everything of the package should now be installed correct. If you have
  82. had some problems have a short look in the logfile in `/h0/USR/LIB/NEWS'
  83. where some hints may be found.
  84.  
  85.   Or try the shellscript
  86. .bold
  87. install.sh
  88. to do the whole thing for you. I am not sure if it really does everthing
  89. okay, but it is a handy way to do all theses steps by a program. To run
  90. this script, use `sh', not `shell' or `csh'!
  91. .in -3
  92.  
  93. .ul
  94. 3. Setting up the System
  95.  
  96. .in +3
  97.   For a regular use you need to install some entries for cron. First
  98. allow the user `news' to use cron (vcron users have to add news as a
  99. member of the group `cron' in /h0/SYS/groups). For UUCP you have to
  100. allow the command `rnews' to be executed by a remote machine. For every
  101. system you feed news to you have to start the `sbatch' program before
  102. this system calls you (or you call it). This will collect all new
  103. articles and batch them for the remote system. If you like to use
  104. compressed sending you need the `compress' program (not the OS-9 one, a
  105. good working version can be found on TOP disks).
  106.  
  107.   The more news you receive the faster the available free space on your
  108. harddisk will be eaten. So you need to delete old articles from time to
  109. time. This can be done by running `inews' with proper options (refer to
  110. the manual for the exact syntax).
  111.  
  112.   If you like, you can run the shell-script
  113. .bold
  114. check.sh
  115. to glance over your installation and see if everything will be okay.
  116. .in -3
  117.  
  118. .ul
  119. 4. Reading and Writing News
  120.  
  121. .in +3
  122.   I started to make the newsreader `NN' to run on OS-9. But it is a lot
  123. of work of keep it up to date so Frank Kaefer (fkk@stasys.sta.sub.org)
  124. will support the version for OS-9. In the patches for `NN' you can see
  125. how to adapt a newsreader to the MNews file formats.
  126.  
  127.   If you like to write your own newsreader you can use the predefined
  128. user interface. For details refer to the source.
  129. .in -3
  130.  
  131. .ul
  132. 5. Internal
  133.  
  134. .in +3
  135.   First of all, the programs `rnews' and `sbatch' had orginally be
  136. written for receiving compressed news to forward them to the notes
  137. system. So the source style may differ from the inews program, but I
  138. hope it is still understandable.
  139.  
  140.   MNews stores the articles as single files in a directory tree matching
  141. the newsgroup of the article. All articles are found under
  142. /h0/SPOOL/NEWS. Some examples for filenames for some newsgroups (I asume
  143. as the current number for each group a one; this will be increased on
  144. every new article in this group):
  145. .ce 3
  146. sub.sources.os9 --> sub/sources/os9/1
  147. junk --> junk/1
  148. comp.lang.c++ --> comp/lang/c__/1
  149.  
  150.   The filename converting takes only on creating the filenames
  151. themselves place; the name of the newsgroup aren't changed. A feature of
  152. news are so called `crosspostings'. On UNIX(tm) systems the article in
  153. theses groups are linked together. OS-9 doesn't (officially) supports
  154. links so MNews writes the article itself in the first newsgroup and in
  155. all other newsgroup there is only the filename of the original article,
  156. prefixed by some (hopefully) unique characters.
  157.