home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / prog1 / 4th_86.lzh / READTHIS.1ST < prev    next >
Text File  |  1989-02-19  |  7KB  |  199 lines
  1. $    4th_86 version 3.0           README.1ST                   page  1
  2.     
  3.     
  4.                  ( 1st. February 1989 - 4th_86 version 3.0 - MFB )
  5.  
  6.     There are four descriptions of the system
  7.  
  8.     a) WHY.486 (the concept behind 4th_86)
  9.     b) MANUAL.486 (main manual/tutorial)
  10.     c) GLOSSARY.486  (glossary)
  11.     d) UPDATE.486 (changes from version 2.0 to version 3.0)
  12.  
  13.     and the main run file is UCC23.COM which contains floating point, EGA
  14.     graphics, transcendental, DOS extensions, etc.
  15.  
  16.     There are various demonstrations (COM files other than UCC03 UCC13
  17.     and UCC23) and the source for most of them ( Sorry -- Nearly all
  18.     require an EGA card to really function adequately.)
  19.  
  20.     ====
  21.     / For those who don't own EGA cards, you can not run the standalone
  22.     / COM demonstrations, as they attempt to set 640x350 mode on entry
  23.     / by executing the word EGAM (set EGA Mode)
  24.     / You can however type LINK EGAM CGAM as soon as you fire up UCC,
  25.     / and thereafter all calls to EGAM will be diverted to CGAM which
  26.     / sets up 640x200 two colour graphics.
  27.     / after this you can try FLOADing and running the graphics source.
  28.     / SMITH and SQ work, also SIERP and HILBERT in the file HILSIER. The
  29.     / results however are not as good as with an EGA card in 640x350
  30.     ===
  31.  
  32.     There is lots and lots of source code -- and after the manual this is where
  33.     you should look for further guidance.
  34.  
  35.     All source is standard text, and can be typed out, printed, or edited with
  36.     your standard text editor. There is no such thing as a "screen file".
  37.  
  38.     / *** All source from the earlier version 2.0 should be scrapped. It
  39.     / *** has undergone extensive changes, and the earlier versions
  40.     / *** are unlikely to be compatible. Much "utilities" (eg OMIT, 7STINIT, and
  41.     / *** ATTACH ) are now an intrinsic part of the system.
  42.     / **    Even demos like HILBERT.COM, MAND.COM and 4DEMO.COM have
  43.     / **    been updated and improved.
  44.     / *** --- nothing in Version 2.0 is omitted from version 3.0. Much
  45.     / ***     is added.
  46.  
  47.     A more ordered naming convention for files has been adopted.
  48.  
  49.     o All system files start with 7 (they may be .ASM or .4TH )
  50.  
  51.     o All version 3.0 system files are of form xxxx3.yyy
  52.         o UCC23.COM => Main run file with debug, floating point etc.
  53.         o UCC13.COM => as UCC23 but without Fpoint, Double, and Transcendental
  54.         o UCC03.COM => minimal system - no debug, graphics, or DOS extensions
  55.  
  56.     o Directory ( Forth WORD ) listings for the above files are named
  57.         o EXTRN03
  58.         o EXTRN13
  59.         o EXTRN23
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.     4th_86 version 3.0           README.1ST                   page  2
  68.     
  69.     
  70.     o All meta-compiled binary files saved with ISAVE end in .IMG
  71.  
  72.     o Image files can only be ILOADed within the SAME system they were
  73.         ISAVEd from. They are named
  74.         o KERNEL03.IMG
  75.         o KERNEL13.IMG
  76.         o KERNEL23.IMG
  77.  
  78.     o All MASM source has extension .ASM
  79.  
  80.     o All compiled ASM binary source (for GLOADing) has extension .BIN
  81.  
  82.     o FORTH source generaly has extension .4TH -- but
  83.        o Forth (batch style) files used for building the system end in .BLD
  84.        o Forth (batch style) files for building demonstrations end in .DEM
  85.  
  86.     o All run files end in .COM
  87.  
  88.     o DOS batch files used for building the system end in .BAT
  89.  
  90.     o Most .BAT files take their input by redirection from a DIN file.
  91.       All DIN files (Data INput) need to be present when BAT files are
  92.       being used to build the system. This is fully automated - no user
  93.       input is needed -- BUT -- the build will crash (blame DOS redirection
  94.       - not 4th_86 !!) if any of the required input files are missing
  95.       or abort early. Ctrl-Brk will exit.
  96.  
  97.     Run Files   Demonstrations                  System Source Files
  98.     =========   ==============   ==============================================
  99.     UCC03.COM    SQUARE.COM     7BASIC3.ASM      7ATTACH3.4TH     7NXTRA3.4TH
  100.     UCC13.COM    HILBERT.COM    7DOUBLE3.BIN     7BOOT3.4TH       7OMIT3.4TH
  101.     UCC23.COM    4DEMO.COM      7EGAM3.ASM       7CCP3.4TH        7OSIB3.4TH
  102.     NORM.COM     MAND.COM       7FPOINT3.BIN     7DEBUG3.4TH      7STINIT3.4TH
  103.                  SMITH.COM      7OSIA3.ASM       7DISP3.4TH       7TM3.4TH
  104.                  WORM.COM       7QUOTE3.ASM      7DOSX3.4TH       7TRANSC3.4TH
  105.                                 7SHELL3.ASM      7DOUBLE3.4TH     OMITFILE
  106.                                 7TR3.ASM         7FPOINT3.4TH     KERNEL03.IMG
  107.                                                                   KERNEL13.IMG
  108.                                 ----------------------------------------------
  109.                                 SHARPS.4TH       MAKECOM.4TH      DEMO#S.4TH
  110.                                 EVAL.4TH         ARRAY.4TH        TRAP.4TH
  111.                                 TEST.ASM
  112.  
  113.     Editor        BAT (and BIN)  DIN files  BLD files   Documentation
  114.                     FILES
  115.     ======        ===========    =========  =========   =============
  116.     EDHELP        7BASIC3.BAT    1CR.DIN     UCC1.BLD    README.1ST
  117.     OMNI.TXT      BUILD4.BAT     2CR.DIN     UCC2.BLD    MANUAL.DOC
  118.     OMNI.COM      7EGAM3.BAT     HILCOM.DIN              WHY.UCC
  119.                   TEST.BAT       K2CR.DIN                FP.DOC
  120.                   7OSIA3.BAT     MAND.DIN                TRANSCEN.DOC
  121.                   7QUOTE3.BAT    SINCOM.DIN              EXTRN03
  122.                   7SHELL3.BAT    SMITH.DIN               EXTRN13
  123.                   7TR3.BAT       SQUARE.DIN              EXTRN23
  124.                   BUILD.BAT                              MAKESYS.DOC
  125.                   
  126.                   
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.     4th_86 version 3.0           README.1ST                   page  3
  134.     
  135.     
  136.     Demo Source
  137.     ===========
  138.     SQ.4TH
  139.     SQUARE.DEM   => SQUARE.COM
  140.     HILCOM.DEM   => HILBERT.COM
  141.     HILSIER2.4TH
  142.     SIN.4TH
  143.     SINCOM.DEM   => SINE.COM
  144.     SMITH.4TH
  145.     SMITH.DEM    => SMITH.COM
  146.     MAND.4TH
  147.     MAND.DEM     => MAND.COM
  148.     WORM.4TH     => WORM.COM
  149.     ( xxx  )     => 4DEMO.COM ( source not included - still buggy
  150.                             and undergoing development)
  151.  
  152.  
  153.  
  154.     An excellent comprehensive manual is available for $25 from
  155.  
  156.  
  157.     United Controls Corporation,
  158.     P.O. Box 4620
  159.     Huntsville, Alabama 35802
  160.  
  161.     205-837-6144
  162.  
  163.  
  164.                                             Larry Buchan
  165.  
  166.     1st. February 1989
  167.     
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. $