home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / pfkerm.zip / PFAAAA.TXT < prev    next >
Text File  |  1997-11-12  |  3KB  |  92 lines
  1. file pfaaaa.txt (this is the "readme" file)
  2.  
  3. A Simple Implementation of the Kermit Protocol
  4.                in Pygmy Forth
  5.  
  6.               by Frank Sergeant
  7.               pygmy@pobox.com
  8.               http://www.eskimo.com/~pygmy
  9.  
  10. See the announcement file (pfaaaa.ann) or the source code
  11. files for terms of use and distribution (basically free).
  12.  
  13. The file names for the plain text files correspond to the
  14. file naming convention recommended by the Columbia
  15. University Kermit Project. The files begin with the prefix
  16. "pf" which stands for Pygmy Forth.  The files in plain
  17. text format should be available on the Kermit ftp site as
  18.  
  19.   ftp://kermit.columbia.edu/kermit/c/pf*
  20.  
  21. Those files, plus the non-plain-text files (which do not
  22. necessarily begin with the prefix "pf", are available in
  23. the pfkerm.zip file on the Kermit ftp site as
  24.  
  25.   ftp://kermit.columbia.edu/kermit/archives/pfkerm.zip
  26.  
  27. and also on my web site
  28.  
  29.   http://www.eskimo.com/~pygmy
  30.  
  31. Here is a description of the file contents:
  32.  
  33.     pfaaaa.ann
  34.          The announcement file.
  35.  
  36.     pfaaaa.txt
  37.          This file (the "readme" file).
  38.  
  39.     pfkerm.doc
  40.          a copy of the article "A Simple Implementation
  41.          of the Kermit Protocol in Pygmy Forth"
  42.          which appeared in the May/June and July/Aug
  43.          1997 issues (Volume XIX, Numbers 1 and 2) of
  44.          _Forth Dimensions_, published by the Forth
  45.          Interest Group.
  46.  
  47.     pfkerm.msg
  48.          Email correspondence between Frank da Cruz and
  49.          me correcting and commenting upon the article.
  50.  
  51.     pfkerm.src
  52.          The source code in plain text format.
  53.  
  54.     pfkerm.txt
  55.          The shadow comments in plain text format.
  56.  
  57.     kermit.scr
  58.          The source code as a Forth block file.
  59.          (This is not a plain text file.)
  60.  
  61.     kermit.dow
  62.          The associated "shadow" documentation file as
  63.          a Forth block file.
  64.          (This is not a plain text file.)
  65.  
  66.     listing.txt
  67.          A text file containing a side-by-side listing
  68.          of the source and shadow files.  This has more
  69.          than 80 columns, so it is included in pfkerm.zip
  70.          but not on the plain text ftp site, but is
  71.          readable as plain text if your viewer supports
  72.          132 columns.
  73.  
  74.  
  75. In order to run the code, you would need a copy of
  76. Pygmy Forth version 1.5 for DOS (pygmy15.zip),
  77. available on my web site.  You would also need serial
  78. port routines.  An article I wrote for _The Computer
  79. Journal_ might help you get started with the serial
  80. port routines.  Serial port routines are included in
  81. my Pygmy "bonus disk" (not free).  See pygmy15.zip
  82. for more details.
  83.  
  84. If you use a different Forth, the code would need some
  85. modifications, but still might get you off to a good
  86. start.
  87.  
  88.  
  89.   -- Frank Sergeant
  90.  
  91. (end of file pfaaa.txt)
  92.