home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / forth / compiler / fpc / doc / install.txt < prev    next >
Text File  |  1991-02-25  |  9KB  |  202 lines
  1. INSTALL.TXT             Installing F-PC                 by Tom Zimmer
  2.  
  3.   F-PC includes an installation program, but since installation
  4. programs are nebulous black boxes, this file will tell you where
  5. things go.
  6.  
  7. WHAT INSTALL DOES.
  8.  
  9.   The first thing INSTALL.EXE does is ask you whether you are
  10. installing F-PC on your hard disk, or configuring a copy of F-PC
  11. already present on your hard disk. To this question, you would answer
  12. "I" for Install, or "C" for configure. The default is "I".
  13.  
  14.   Question two is "Where you want F-PC placed on your hard disk?". You
  15. will need to answer that question for yorself now. The default is
  16. "C:\FPC".
  17.  
  18.   Question three is "Where are you installing F-PC from?", which is usually
  19. drive "A:", but can be "B:" or any drive and directory (like "C:\MASTER").
  20.  
  21.   At this point you are asked six (6) yes or no questions about what
  22. portions of F-PC to install. I will discuss those below.
  23.  
  24.   Lastly you are prompted to insert F-PC disk number one, and press
  25. Enter to start the installation.
  26.  
  27.   INSTALL.EXE proceeds to create directories and expand .ZIP files
  28. onto your hard disk. This process takes only a few minutes, and will
  29. consume about 2.5 megabytes if all portions are installed. After
  30. installation completes, the program proceeds into the configuration
  31. section. You are asked questions about your hardware. Then an
  32. installed copy of F-PC is created.
  33.  
  34.   If the above process makes you uncomfortable, or you just want to
  35. do it yourself, proceed to the next section. Otherwise just type:
  36. A:INSTALL <Enter>.
  37.  
  38.  
  39.  
  40. INSTALLING F-PC WITHOUT USING INSTALL.EXE
  41.  
  42.  
  43.       ┌────────────────────────────────────────────────────────┐
  44.       │   In this section I am assuming you are an experienced │
  45.       │ DOS user. If you are not, then please go ahead and use │
  46.       │ INSTALL.EXE. The process is pretty painless.           │
  47.       └────────────────────────────────────────────────────────┘
  48.  
  49.  
  50.   Unlike F-PC Version 2.25, F-PC Version 3.5 makes its own Forth PATH
  51. command and several directories to hold its files. This keeps the
  52. clutter down in the main F-PC directory while keeping files available
  53. when needed. F-PC's directory structure looks like this:
  54.  
  55.  
  56.                 C:\ ─────────── \FPC ─────┬──── \SRC
  57.                                           │
  58.                                           ├──── \HLP
  59.                                           │
  60.                                           ├──── \TOOLS
  61.                                           │
  62.                                           └──── \NEWZ
  63.  
  64.  
  65.   You can of course put F-PC on a drive other than C:, and in
  66. directories other than \FPC etc. but for this discussion we will
  67. assume you will be using the above directory structure.
  68.  
  69.   NOTE: A known bug in the install program prevents its working on a
  70.         drive higher than "F:".
  71.  
  72.   Create the above directory structure on your hard disk using the
  73. dos "MKDIR" (make directory) command.
  74.  
  75.   Use PKUNZIP.EXE to "unzip" the .ZIP files from floppy into the
  76. directories as shown below:
  77.  
  78.                 Directory               .ZIP File
  79.               ┌───────────────────────┬─────────────┐
  80.               │ \FPC                  │ FPC.ZIP     │
  81.               ├───────────────────────┼─────────────┤
  82.               │ \FPC\SRC              │ FPCSRC.ZIP  │
  83.               ├───────────────────────┼─────────────┤
  84.               │ \FPC\HLP              │ FPCDOC.ZIP  │
  85.               │                       │ FPCHLP.ZIP  │
  86.               ├───────────────────────┼─────────────┤
  87.               │ \FPC\TOOLS            │ SAMPLES.ZIP │
  88.               │                       │ SMITH.ZIP   │
  89.               │                       │ CURLEY.ZIP  │
  90.               │                       │ ZIMMER.ZIP  │
  91.               ├───────────────────────┼─────────────┤
  92.               │ \FPC\NEWZ             │ NEWZ.ZIP    │
  93.               └───────────────────────┴─────────────┘
  94.  
  95.   A typical PKUNZIP command line looks like this:
  96.  
  97.         C:> PKUNZIP A:FPC C:\FPC <Enter>
  98.  
  99.  
  100.   When you have finished the above, copy the following files from
  101. floppy to the "\FPC" directory:
  102.  
  103.         README      FLOPPY.TXT      INSTALL.TXT     INSTALL.EXE
  104.  
  105.   This completes installation, and leads us into configuration.
  106.  
  107.  
  108.  
  109. CONFIGURING F-PC WITHOUT USING INSTALL.EXE
  110.  
  111.   The following section will allow you to configure F-PC for your
  112. hardware without using INSTALL.EXE. It is however MUCH EASIER to
  113. configure F-PC using the install program, so PLEASE USE IT.
  114.  
  115.   F-PC uses a configuration file to hold several default
  116. configuration commands. The F-PC.CFG file is automatically loaded
  117. each time you startup F-PC from the DOS command line. Part of the
  118. installation process is creating a configuration file for your
  119. hardware environment. Since we are doing the installation manually,
  120. we need to create a configuration file.
  121.  
  122.   Using your favorite text editor (One that doesn't insert TABs or
  123. other special characters into the file.), place the following lines
  124. in a file named "F-PC.CFG" (don't include the box around the text).
  125.  
  126.         ┌─────────────────────────────────────────────────┐
  127.         │ FPATH C:\FPC;C:\FPC\SRC;C:\FPC\HLP;C:\FPC\TOOLS │
  128.         │ FAST                                            │
  129.         │ COLORIZEON                                      │
  130.         │ BLANKOFF                                        │
  131.         │ ' >COLOR IS INITCOLOR                           │
  132.         │ BACKUPON                                        │
  133.         └─────────────────────────────────────────────────┘
  134.  
  135.   When creating F-PC.CFG, if you installed F-PC on a hard drive other
  136. than "C:", change each occurance of "C:" following the FPATH command
  137. above to the drive letter you used.
  138.  
  139.   The above words setup F-PC for a normal configuration. It will work
  140. even if you have a MONOCROME system. The commands have the following
  141. meaning:
  142.  
  143.         FPATH C:\FPC;C:\FPC\SRC;C:\FPC\HLP;C:\FPC\TOOLS
  144.                         The Forth PATH tells F-PC which directories
  145.                         to search when you open or load a file. You
  146.                         can include other directories as well up to a
  147.                         maximum of 132 characters.
  148.  
  149.         FAST            Select direct video writes. The opposite
  150.                         option is "SLOW" DOS i/o.
  151.  
  152.         COLORIZEON      Use colors when displaying various Forth word
  153.                         classes. This is automatically disabled on
  154.                         Monocrome systems. The opposite option is
  155.                         "COLORIZEOFF".
  156.  
  157.  
  158.         BLANKOFF        Don't blank the screen when writing to the
  159.                         display. If you have a CGA display you may
  160.                         want to use "BLANKON"; all other displays
  161.                         use BLANKOFF.
  162.  
  163.         ' >COLOR is INITCOLOR
  164.                         Allow F-PC to support a color monitor if one
  165.                         is available. Will support monocrome even
  166.                         with this command included.
  167.  
  168.         BACKUPON        Keep a single backup file for each file
  169.                         edited. If you are very short on disk space,
  170.                         or are using F-PC on a floppy system, you may
  171.                         want to use "BACKUPOFF".
  172.  
  173.   Optionally you can add a command to select a default printer type,
  174. PROPRINT and LASERJET are the only two supported currently.
  175.  
  176.   After the configuration file is saved to disk, issue the following
  177. command from the DOS prompt while in the "\FPC" directory:
  178.  
  179.         C:> F-PC - FSAVE F BYE <Enter>
  180.  
  181.   This command will startup F-PC, which automatically reads in the
  182. configuration file we just created. The "-" above signifies no other
  183. file is to be opened. The next two words "FSAVE F", save F-PC to disk
  184. with the new name "F.EXE". You can of course use a name other than
  185. "F". "BYE" leaves F-PC and returns to DOS. This process creates a
  186. fully configured copy of F-PC called F.EXE that contains all of the
  187. default configuration parameters you specified. If you are doing this
  188. on a floppy based system, use "FSAVE F-PC" to save the executable back
  189. to the same file since there is not room for an additional executable.
  190.  
  191.   Be sure to include the "C:\FPC" directory in your system PATH
  192. command in AUTOEXEC.BAT.
  193.  
  194.   After rebooting your computer, you can run F-PC from any drive and
  195. directory by typing "F <filename> <enter>", and Forth will be able to
  196. find its source files, help files, and tools from wherever you are.
  197.  
  198.   I hope this clears up any questions you may have about what INSTALL
  199. does to your computer. Now if you haven't already done so, go ahead and
  200. use it to install F-PC, its really pretty painless.
  201.  
  202.