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