home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / old / misc / prime / primek.hlp < prev    next >
Lisp/Scheme  |  2020-01-01  |  3KB  |  90 lines
  1. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  2. /*#READ_ME*/
  3. KERMIT-R19, KERMIT for the PRIME computer, written in PL/I
  4.  
  5.    Contributed by Leslie Spira, The SOURCE Telecomputing, McLean, Virginia,
  6.    February 1984.
  7.  
  8.    Modifications by C. Devine, SPSS Inc., Chicago, Illinois, July 1984.
  9.  
  10. Installation Instructions:
  11.  
  12. This program is built from many files (about a hundred, most of them small.)
  13. For distribution purposes, these files have all been concatenated together
  14. into one big file.  They are separated by a line of colons, like this:
  15.  
  16. ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  17.  
  18. Immediately below the line of colons comes the file name, as a PL/I comment,
  19. like this:
  20.  
  21. /*INCLUDE#KERCOM.REQ*/
  22.  
  23. You should pick this big file apart, discarding each line of colons, and
  24. storing each file under the name given in its heading comment. Be careful to
  25. delete the comment line itself from the PMA and FTN modules.
  26.  
  27. Then, follow these directions:
  28.  
  29. Three command files are supplied to assist in the creation of Kermit-R19
  30. from the source modules provided.
  31.  
  32. After all files have been placed in one ufd, the "home" ufd, they are to be
  33. run as follows:
  34.  
  35. First, KERMIT.TREE.CREATE.CPL or KERMIT.TREE.REV18.CPL
  36. This will transform the flat ufd into the correct structure for the next
  37. two programs. Use KERMIT.TREE.CREATE.CPL if you are at rev19; use
  38. KERMIT.TREE.REV18.CPL if you are at rev18.  Kermit-R19 runs at rev 18,
  39. but the load map will show routine AT$ missing.  This will not affect
  40. most users of Kermit, because the routine is only called by a server
  41. command many other Kermits will not recognize.
  42.  
  43. Second, KERMIT.COMP.COMI
  44. This will compile all Kermit source code, placing the binaries in a subufd.
  45.  
  46. Third, KERMIT.BUILD.COMI
  47. This will link the object code into a KERMIT.SEG program.
  48.  
  49. Each of these three are to be run from the home ufd.  For more information,
  50. see the comments inside each command file.
  51.  
  52. Here is a prime emacs macro to split PRIMEK.PLP into the individual files:
  53.  
  54. ; by Jack Heath
  55. ; modified by Robert A. Larson, USC-ECLB, 4/16/84
  56. (defcom splitk
  57.   (do_n_times (numeric_argument 1)
  58.     (next_line_command)
  59.     (forward_char 2)
  60.     (setq start (copy_cursor current_cursor))
  61.     (end_line)
  62.     (back_char 2)
  63.     (setq file (point_cursor_to_string start))
  64.     (begin_line)
  65.     (mark)
  66.     (forward_search_command "::::")
  67.     (begin_line)
  68.     (prepend_to_file 2 file)
  69. ))
  70.  
  71. There's also a Fortran-77 program provided in PRIMES.FTN that will split
  72. the big file into its component parts.
  73.  
  74. Beware:
  75.  
  76. When running Prime Kermit, you should have your PRIMOS line kill character
  77. set to some control character other than Control-A.  By default, the line
  78. kill character is "?", which will prevent file transfers from working, since
  79. packets often contain "?" characters.  To change your line kill character to
  80. Control-X, do
  81.  
  82. TERM -KILL ^X
  83.  
  84. (where "^X" is control-X, typed literally)
  85.  
  86. Also, the current version of Prime Kermit, when running as a server, will
  87. not respond correctly to GET or REMOTE commands issued by MS-DOS Kermit
  88. 2.27 or later, or Unix Kermit V4.  This is a problem with Prime Kermit that
  89. will be fixed in the next release.
  90.