home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / forth / compiler / fpc / tcomread.me < prev    next >
Text File  |  1990-05-03  |  5KB  |  113 lines
  1. TCOMREAD.ME      Welcome to the F-PC Target Compiler   by Tom Zimmer
  2. °TCOM?
  3.  
  4.   TCOM is an optimizing Forth target compiler, that builds small ".COM"
  5. programs that contain only the functions in Forth that are needed to
  6. run your application.  TCOM is excellent for building those small
  7. little utilities to do things around the house, like text filters,
  8. user query programs, mode change utilities, etc. Programs can be as
  9. small as 400 bytes depending on the functions needed.
  10.  
  11.  
  12. Files in TCOM.ZIP
  13.  
  14.   TCOM consists of several .ZIPfiles files containing the compiler,
  15. documentation, compilable examples, utilities, and the source code for
  16. TCOM (The source will only be useful if you have F-PC 3.50). Since TCOM
  17. is provided in pre-compiled form, you will probably not need to unzip
  18. TCOMSRC.ZIP, or SMALTCOM.ZIP unless you want to study TCOM's internals,
  19. or want to re-compile or modify it.
  20.  
  21. Installing TCOM
  22.  
  23.   TCOM.ZIP contains the following files:
  24.  
  25.         TCOMREAD ME      2680   4-25-90   1:58p
  26.         TCOMINST COM    11393   4-26-90   2:54p
  27.         TCOMHELP DOC     7001   4-09-90   1:00p
  28.         TCOM     DOC    28582   4-25-90   2:00p
  29.         LIBRARY  DOC    41181   4-06-90   9:29a
  30.         HISTORY  DOC    56290   4-25-90   1:55p
  31.         TCOM     EXE   163840   4-25-90   1:40p
  32.         HYPER    NDX      262   4-25-90   2:02p
  33.         TCOMSAMP ZIP    67513   4-25-90   1:48p
  34.         TCOMUTIL ZIP    54084   4-25-90  10:14a
  35.         TCOMSRC  ZIP    75657   4-25-90   1:47p
  36.         SMALTCOM ZIP     4468   4-25-90   1:49p
  37.  
  38.  Some of the dates, times, or sizes may have been changed to protect
  39. the innocent (humor). You will need a couple of megabytes of disk space
  40. to unzip everything. To start the install process, type:
  41.  
  42.         A:TCOMINST enter
  43.  
  44.   This will create a directory on your hard drive called \TCOM, and
  45. allow you to specify what parts of TCOM to install.
  46.  
  47. TCOM Starting out
  48.  
  49.   If you are just starting to examine TCOM, you might want to just type
  50. TCOM <enter>. This will give you a single screen of helpful
  51. information. If you have the NEWZ editor available, you can then press
  52. F1, and TCOM will enter the Hypertext help system and let you examine
  53. additional online documentation. If NEWZ is not available, just print
  54. the .DOC files and read them through.
  55.  
  56.   The simplest example of using TCOM to compile a program, is as
  57. follows:
  58.  
  59.         TCOM SAMPLE enter
  60.  
  61.   If you have installed TCOM corrrectly, then TCOM will be able to open
  62. SAMPLE.SEQ, and compile it into a new file SAMPLE.COM. Various
  63. commandline options can modify the output of TCOM to optimize the .COM
  64. file created, and make symbol files for use while debugging.
  65.  
  66. Further Exploration
  67.  
  68.   As with F-PC, TCOM is NOT A SIMPLE PROGRAM. It is intended to be
  69. simple to use, and I hope it succeeds in this area, but you do need to
  70. know Forth to use it. If you are an experienced Forth programmer, and
  71. you use a lot of esoteric programming techniques that are
  72. implementation specific in your programs, then TCOM will probably not
  73. be able to compile them. TCOM compiles directly to machine code, and as
  74. such can make up for a lot of seemingly inefficient code automatically.
  75. Write your programs using simple straight forward methods, and you will
  76. minimize your problems in getting TCOM to compile properly.
  77.  
  78.   I (Tom Zimmer) am generally available for one (1) phone call when you
  79. have problems with TCOM. Since TCOM is in the public domain, I cannot
  80. provide indepth support, it is just too expensive, and I don't have the
  81. time. If you are a professional programmer, and have a project that
  82. will require continuing support from myself, then some financial
  83. arraingment will need to be made. If you can't figure out how to get
  84. TCOM to work for you, and can't afford consulting rates for help, then
  85. you should consider using another compiler.
  86.  
  87.  
  88. MONEY
  89.  
  90.   The F-PC Forth system and TCOM are Public Domain programs, you may
  91. do with them what you wish. If you find either or both programs
  92. Amazingly Useful, you may want to send 60.00 dollars to:
  93.  
  94.                 Tom Zimmer
  95.                 292 Falcato Drive
  96.                 Milpitas, Ca. 95035
  97.  
  98.                         Home (408) 263-8859
  99.                         Work (408) 432-4643
  100.  
  101.   You will receive the latest version of F-PC and the TCOM compiler. Be
  102. sure to specify the disk format, 1.2meg(5 1/4) is the prefered format.
  103. If you need 360k(5 1/4), 720k(3 1/2) or 1.4meg(3 1/2)m please add $5.00
  104. for additional handling. Please include a day and evening telephone
  105. number.
  106.  
  107. WARNING!!
  108. TCOM should only be compiled and run on F-PC version 3.50 or higher.
  109. Earlier versions of F-PC contain bugs that will prevent proper operation
  110. of TCOM.
  111.  
  112.  
  113.