home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol154 / abstract.154 < prev    next >
Encoding:
Text File  |  1984-04-29  |  4.8 KB  |  128 lines
  1.                           ABSTRACT.154
  2.  
  3. This disk contains source and COM files for a public domain
  4. implementation of FORTH compatible with the FORTH 83 standard.
  5.  
  6. This version is for an 8080 CP/M system.
  7.  
  8. Here is what is on this disk:
  9.  
  10. ABSTRACT.154    This is the file that you are reading.
  11.  
  12. F83.COM         A compiled and ready to use FORTH system including an
  13.                 editor, assembler, and many FORTH utilities.
  14.  
  15. F83.DOC         A message from the primary implementors including instructions
  16.                 on how to use F83 to compile itself.
  17.  
  18. META80.BQK      The meta source and F83 screens in squeezed format.
  19.  
  20. EXTEND.BQK      The extension screens in squeezed format.
  21.  
  22. CPU8080.BQK     Assembler, debugging and multitasking source in squeezed format.
  23.  
  24. UTILITY.BQK     The CP/M interface, editor, and high level multitasking
  25.                 support in squeezed format.
  26.  
  27. DIRECT.BQK      Support screens for direct BIOS I/O in squeezed format.
  28.  
  29. KERNEL.HEX      A file that can be loaded to form a COM file of the F83
  30.                 kernel.
  31.  
  32. USQ.COM         The unsqueeze program that can be used to unsqueeze all of
  33.                 the files of type BQK.
  34.  
  35.  
  36.                           Unsqueezing the Sources
  37.  
  38. These instructions apply to people who have disk drives that only hold
  39. 240K bytes, such as single-density, 8-inch drives.
  40.  
  41. Format a blank disk and use SYSGEN to copy your system tracks to it.
  42. Put the new disk in drive A and this disk in drive B. After the "A>" type:
  43.  
  44.                 A>b:usq b:meta80.bqk
  45.  
  46. This will produce an unsqueezed META80.BLK on disk A that takes the
  47. whole 240K disk space.
  48.  
  49. Format a second blank disk and unsqueeze the other BQK files.  They will
  50. all fit on it.  Copy F83.COM to it also.
  51.  
  52. You can now use F83 to look at the source or print listings of the source
  53. if you have a printer.
  54.  
  55. Start FORTH by typing:
  56.  
  57.                  A>F83
  58.  
  59. You can type WORDS to see the words in the primary vocabulary. You can
  60. type SEE ORDER to use the SEE decompiler to decompile the word ORDER.
  61. You can type VIEW ORDER and F93 will open EXTEND.BLK and list the
  62. screen that contains the source code for the word ORDER.
  63. Now that this block is opened, you can print a listing of it, including
  64. shadow screens by typing the word LISTING.
  65.  
  66.  [The following is a fine point and can be ignored by first time users.
  67.  I have modified (PRINT) in screen 67 of META80.BLK to work with
  68.  all CP/M systems.  All CP/M systems have an entry LISTST in their BIOS.
  69.  Its purpose is to test the printer status and return 0 if it is busy and
  70.  0FFH if it is not. Digital Research's documentation says that if this test
  71.  is not implemented, it shoudld return 0.  This is probably wrong, because
  72.  a program that is using this entry will always loop waiting for the 0FFH
  73.  which never occurs.  If your BIOS implements the test, and you want to use
  74.  a multitasking background spooler, you should change the definition back to
  75.  
  76.  : (PRINT) BEGIN PAUSE 0 15 BIOS UNTIL 5 BIOS DROP 1 #OUT +! ;
  77.  
  78.  and recompile your system. Or you could just patch the address of BIOS
  79.  in place of the address of NIP.]
  80.  
  81.                         Metacompiling a New System
  82.  
  83. If you have a system that will hold 500KB on one disk you will have no problem
  84. recompiling the F83 system by following the directions in F83.DOC. If you
  85. have two single-density disks of 240K, you can follow this procedure.
  86.  
  87. Put F83.COM on a disk by itself and put it in drive A. Put the disk with
  88. META80.BLK in drive B. Start FORTH after the prompt by typing:
  89.  
  90.                         A>F83 b:meta80.blk
  91.  
  92. After FORTH starts, type "OK".  This is defined as a word to load the meta-
  93. compiler and start it generating a new kernel.  The kernel will automatically
  94. be saved on drive A as KERNEL.COM.  Type BYE to return to CP/M, then log
  95. in B as the default drive by typing "B:". Put the disk with the other *.BLK
  96. files on it in drive B.  Start the kernel by typing:
  97.  
  98.                         B>a:kernel extend80.blk
  99.  
  100. After the kernel is loaded, type the FORTH word "START".  The word is
  101. defined to load the first screen in extend80.blk which will in turn load
  102. all of the other extensions.
  103.  
  104. After this process is almost finished, you will see an error message
  105. "unable to open file".  This is because the META80.BLK file is not available.
  106. You can type the rest of the few lines by hand.  They are:
  107.  
  108.   1 ' META80.BLK   >BODY 40 + !
  109.   DEFINE EXTEND80.BLK
  110.   2 ' EXTEND80.BLK >BODY 40 + !
  111.   ' META80.BLK     VIEW-FILES 0 + !
  112.   ' EXTEND80.BLK   VIEW-FILES 2 + !
  113.   ' CPU8080.BLK    VIEW-FILES 4 + !
  114.   ' UTILTITY.BLK   VIEW-FILES 6 + !
  115.   2 LOAD
  116.  
  117. After this, you should receive a message telling you that the new system
  118. has been loaded, and what its size is. Type the word "BYE" and you will
  119. return to CP/M with a message of how many pages to save. Type
  120.  
  121.                         B>save 95 a:f83.com
  122.  
  123. for example, to save your new system on disk A.
  124.  
  125.  
  126. Ted Shapin, 10/28/83. 
  127.  
  128.