home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol113 / abstract.113 < prev    next >
Encoding:
Text File  |  1984-04-29  |  4.5 KB  |  113 lines
  1. 00READMEFIRST.TXT                                            (4 February 1983)
  2.  
  3.  
  4.                  COLUMBIA UNIVERSITY KERMIT DISTRIBUTION TAPE
  5.  
  6.  
  7. This tape includes all the versions of Kermit which were in our possession as
  8. of the time this distribution tape was made, plus some miscellanous files.
  9. All files have been named to be unique in the first 6 characters, and contain
  10. only letters and digits in their names, so they should mesh with most file
  11. systems.  If you have received an IBM or TOPS-10 tape, some of the trailing
  12. characters of some of the filenames will have been truncated, but the
  13. filenames should still all be unique.  Most filetypes (extensions) are all 3
  14. characters or less, so no known operating system will truncate them.
  15.  
  16.  
  17. * Prefixed Files:
  18.  
  19. The file names for files associated with each implementation of KERMIT are
  20. prefixed by a few characters denoting the implementation.  The following are
  21. presently used:
  22.  
  23.     20    DEC-20, running TOPS-20, written in Macro
  24.     10    DEC-10, TOPS-10, Macro
  25.     CPM    8080 or Z80, CPM, Asm
  26.     PC    IBM PC, PC DOS, Assembler
  27.     UNIX    Berkeley Unix, C (Columbia Version)
  28.     CORN    Berkeley Unix, C (Cornell Version)
  29.     CMS    IBM 370 series, VM/CMS, Assembler
  30.     RT    PDP-11, RT-11, OMSI Pascal with Software Tools.
  31.  
  32. In some cases, binaries (.REL, .EXE, .COM, .HEX, etc) are not supplied.  For
  33. instance, no binaries come with the UNIX sources, since these can be compiled
  34. to run on many different machines, under different versions of UNIX.  The Z80
  35. version can be assembled for many different micros, so too much confusion
  36. would result from trying to maintain up-to-date hex files for each.  Binaries
  37. are provided when it makes sense, however: DEC-10 and DEC-20 .EXE files are
  38. provided on DEC-10 and -20 distribution tapes, MODULE files on the IBM VM/CMS
  39. tape.  All necessary files are included for building each version of Kermit
  40. from program source.
  41.  
  42. When working with one of these implementations, you would normally copy them
  43. to a separate area and strip the prefix from the file names, and install the
  44. programs on the appropriate systems without the prefix.  For instance, you
  45. would copy 20KERMIT.MAC to KERMIT.MAC, then assemble it, and store the result
  46. as KERMIT.EXE in SYS:.
  47.  
  48. The Kermit Users Guide contains instructions for installing or bootstrapping
  49. the various versions of Kermit.
  50.  
  51.  
  52. * Manuals:
  53.  
  54. There are two Kermit manuals: USER and PROTO, a user's guide and a protocol
  55. manual, respectively.  Three versions of these files are provided:
  56.  
  57.     .MSS    Scribe (UNILOGIC Ltd text formatter) source.
  58.     .LPT    Line Printer format (overstriking, underscore, etc).
  59.     .DOC    No special effects, suitable for reading on line.
  60.  
  61. If you have Scribe and the appropriate Scribe device drivers, you can run the
  62. .MSS files through it to produce output suitable for printing on any device
  63. supported at your site, including the Xerox-9700 or other multifont laser
  64. printers or photocomposers.  As of this writing, Scribe is not entirely
  65. bug-free; you will notice some problems with the footnotes in the .DOC and
  66. .LPT files.  Note that some parts of the user manual rely on underlining to
  67. clarify examples; the underlines are missing from the .DOC files, but will be
  68. found in the .LPT files.
  69.  
  70. The user's guide is intended for users of Kermit (including those who want to
  71. install it on a new system), the protocol manual is for those who would like
  72. to write a new implementation (i.e. a Kermit program for a new machine or
  73. operating system).
  74.  
  75. ASCII.MSS is the ASCII/EBCDIC character table, which is included as an
  76. appendix in both manuals.
  77.  
  78. MANUAL.HYP is a hyphenation dictionary for building the manual with Scribe.
  79.  
  80. OLD*.MSS is the (obsolete) 2nd edition of the Kermit manual.
  81.  
  82.  
  83. * Other Files:
  84.  
  85. 00READMEFIRST.TXT is this file, which should appear at the top of any
  86. directory listing.
  87.  
  88. The files SYMBOL.* comprise a cross assembler for the 8080 written in SAIL for
  89. the DEC-20 (and possibly with minor modifications) on the DEC-10.
  90.  
  91. TTLINK.* is a terminal linking program for the DEC-20, allowing you to log in
  92. to another system over a TTY line (e.g. over an autodialer).  KERMIT-20 runs
  93. TTLINK to execute the CONNECT command.
  94.  
  95. EZFIX.* is a utility for converting EasyWriter files sent to the DEC-20 from
  96. the IBM PC into ordinary text form.
  97.  
  98.  
  99. * Finally...
  100.  
  101. If you make any modifications to Kermit, fix any bugs, or write any new
  102. implementations or documentation, please send them back to us on magnetic tape
  103. so we can distribute them to other Kermit users:
  104.  
  105.     KERMIT Distribution
  106.     Columbia University
  107.     Center for Computing Activities
  108.     612 West 115th Street
  109.     7th Floor
  110.     New York NY 10025
  111.  
  112. We'll return your tape to you with the latest Kermit distribution.
  113.