home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / forth / compiler / fpc / utils.doc < prev    next >
Text File  |  1990-04-25  |  4KB  |  100 lines
  1. \ UTILS.DOC             Utilities provided for TCOM     by Tom Zimmer
  2.  
  3.   Most of the library functions available in TCOM are precompiled into
  4. the TCOM.EXE file provided on disk, but some functions are specialized
  5. enough that I have decided to include them in source form only. This
  6. means you will need to "FLOAD" or "NEEDS" them at the beginning of your
  7. program source file to make these functions available.
  8.  
  9.   Two classes of files are included in this ZIP file. The first group
  10. are utilities that are additional library functions. These are true
  11. library functions, in that only those portions of a library file used
  12. in the applicaiton will be included in the application:
  13.  
  14.         FLOAT4TH.SEQ    needed by TFLOAT for compile time operations,
  15.                         and for use with F-PC to provide identical
  16.                         floating point functionality to the TCOMed
  17.                         TFLOAT.SEQ.
  18.  
  19.         TFLOAT.SEQ      Floating point support for TCOM, needs
  20.                         FLOAT4TH.SEQ to perform the compile time
  21.                         operations. Slower than SFLOAT, but target
  22.                         compilable.
  23.  
  24.         TGRAPH.SEQ      Color graphics support for TCOM. Identical
  25.                         functionality to GRAPH.SEQ which can be used in
  26.                         F-PC. Includes LINE drawing support. THERC.SEQ
  27.                         must be loaded before TGRAPH is loaded.
  28.  
  29.         THERC.SEQ       Hercules monochrome support for TCOM. Identical
  30.                         functionality to HERC.SEQ which can be used
  31.                         with F-PC. Includeds only POINT and PLOT
  32.                         support, TGRAPH must be loaded for LINE
  33.                         drawing.
  34.  
  35.         THERCTXT.SEQ    Hercules monochrome text support for TCOM. This
  36.                         file along with THERC.SEQ are equivelant to
  37.                        HERC.SEQ for F-PC.
  38.  
  39.         TSHAPES.SEQ     CIRCLE and ARC graphics additions for TCOM.
  40.  
  41.         GRAPH.SEQ
  42.         HERC.SEQ        Provides F-PC with identical graphics support
  43.                         to the TCOM "T" functions discribed above.
  44.  
  45.  
  46.   The second group of files in UTILS.ZIP are debugging support files
  47. that allow TCOM to add an interpretive Forth environment to an
  48. application program for debugging purposes. Three command line options
  49. add varying levels of debug support to an application the options are
  50. as follows:
  51.  
  52.         /FORTH          Adds a Forth interpretive shell to any program.
  53.                         Adds about 6k to an application program.
  54.  
  55.         /DIS            Includes a Forth shell, an also includes a CODE
  56.                         disassembler in the application. (SEE) Adds
  57.                         about 17k total to an application program.
  58.  
  59.         /DEBUG          Includes a Forth shell, the disassembler, and a
  60.                         CODE debugger to the application. (DEBUG) and
  61.                         (DBG). Adds about 24k total to an application
  62.                         program.
  63.  
  64.   The files used to support these commands are:
  65.  
  66.         TFORTH.SEQ      The source for the Forth interpretive
  67.                         environemnt.
  68.  
  69.         DIS.SEQ         The source for the CODE disassembler.
  70.  
  71.         TDEBUG.SEQ      The source for the CODE debugger.
  72.  
  73.   These files must be available to load either in the current directory
  74. with the application, or in the FPATH directory as specified in the
  75. environment SET statement "TPATH" for the command line options
  76. described above to work.
  77.  
  78. DIS the Disassembler
  79.  
  80.   The DIS.SEQ file is also an example program that can be compiled by
  81. TCOM to build DIS.COM a symbolic disassembler that can take any TCOM
  82. application apart and produce a listing file containing symbolic
  83. source, with intermixed source lines. Compile DIS as follows:
  84.  
  85.         TCOM DIS /OPT /NOINIT enter
  86.  
  87.   This will produce DIS.COM which is used as follows:
  88.  
  89.                 DIS filename enter
  90.         or      DIS filename hexaddress enter
  91.         or      DIS filename symbol enter
  92.  
  93.   The file being disassembled should have been compiled with the /SYM
  94. command line option, so that a .SYM and a .LIN file will be available
  95. for the disassembler. The disassembler also needs the .SEQ file in the
  96. same directory if it si to include intermixed source in the
  97. disassembly.
  98.  
  99.  
  100.