home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / boo / ckiboohlp.txt < prev    next >
Text File  |  2020-01-01  |  2KB  |  51 lines
  1.                      HOW TO USE CKIKER.BOO
  2.                      -=-=-=-=-=-=-=-=-=-=-
  3.  
  4.                  Stephen Walton, 15 January 1992
  5.  
  6. A bit of background first:  a BOO file, or a .BOO file, is a way of
  7. translating an arbitrary binary file into a series of characters.
  8. Unlike a Unix uuencode file, a BOO file is carefully designed to survive
  9. intact translations between different character sets, in particular from
  10. EBCDIC (IBM mainframes) to ASCII (everyone else) and back.
  11.  
  12. The file CKIKER.BOO in this directory is the BOO'd version of the
  13. executable of C Kermit for the Amiga.  You need an "un-boo'er" program
  14. to translate CKIKER.BOO into the Kermit executable.  Once this is done,
  15. you simply type Kermit at a CLI prompt to run the program.
  16.  
  17. There are three techniques to convert CKIKER.BOO into the executable program
  18. Kermit, depending on what you have available:
  19.  
  20. 1.  If you have a C compiler (any one will do), get the file CKIPCT.C
  21. Compile and link it with the AMIGA symbol defined;  either edit the
  22. source or use the -DAMIGA symbol from the command line.  Now, assuming
  23. you call the executable ckipct, the command
  24.  
  25. 1>ckipct ckiker.boo
  26.  
  27. will, in a few minutes, produce a working Kermit executable.
  28.  
  29. 2.  If you don't have a C compiler, but can drop back to AmigaDOS 1.3
  30. and run AmigaBasic, the Basic version of the MS/DOS un-boo'er, namely
  31. MSBPCT.BAS, will run with almost no change on the Amiga.  You must add a
  32. CLEAR, 50000 statement near the beginning of the program to get some
  33. work space, and you'll also need to change the name of the default input
  34. file from MSIIBM.BOO to CKIKER.BOO.  Unfortunately, AmigaBasic will not
  35. run on the Amiga 3000, so find a friend with a 500, 1000, or 2000.
  36.  
  37. 3.  By far the slowest technique is to use the Amiga REXX version of the
  38. un-BOO program, CKIPCT.REXX. This is so slow, even on an Amiga 3000,
  39. that I have also provided a BOO file of the CKIPCT.C program as CKIPCT.BOO.
  40. Thus, the recommended technique in this case is as follows:
  41.  
  42. 1>rx ckipct.rexx ckipct.boo
  43. 1>rename ckipct.rexx ckipct.save
  44. 1>ckipct ckiker.boo
  45.  
  46. The first command will run ckipct.rexx as a Rexx program over the BOO file
  47. of ckipct.  This will take several minutes.  The second step renames the
  48. REXX file as a saved file;  this prevents the REXX script from being run
  49. instead of the executable.  Finally, the third step runs the ckipct executable
  50. to produce a Kermit executable.
  51.