home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / forth / compiler / fpc / doc / chapter2.txt < prev    next >
Text File  |  1989-10-29  |  14KB  |  324 lines
  1. CHAPTER 2.  INSTALL F-PC
  2.  
  3.  
  4.  
  5.  
  6. 2.1.    THE ZIP FILES
  7.  
  8.  
  9. F-PC is distributed on four 360K 5.25" MS-DOS DSDD diskettes or one 1.2M
  10. quad density diskette.  The first diskette of the DSDD disk set contains
  11. the installation instructions and the main body of F-PC execution files.
  12. The second disk contains mostly the source code of F-PC.  The third disk
  13. contains documentation and help files, with some utilities.  The last
  14. disk contains the zip utility from PKware.  The file names and statistics
  15. are summarized in Appendix C1.
  16.  
  17. We will be using the PKUNZIP program to restore all the .ZIP files back
  18. to their original form. The PKZIP.EXE is the zip utility which you can
  19. use to compress your files.  The PKZ101.EXE file, when executed will
  20. produce PKZIP.EXE, PKUNZIP.EXE and the complete documentation on the zip
  21. utilities.  The zip utility is provided by PKWARE, Inc. as a shareware
  22. product. PKWARE, Inc. requires that the entire package be distributed
  23. with applications.  This is the reason why PKZ101.EXE is included in
  24. F-PC.
  25.  
  26. F-PC 2.25 was distributed in .ARC form.  The arc utility was also
  27. produced by PKWARE. However, the zip utility is adopted here because it
  28. has better compression efficiency than the arc utility.  You should be
  29. aware that the zip utility is not public domain program.  If you find it
  30. is useful, please register with PKWARE, Inc.  Send $47 to PKWARE and you
  31. will receive, when available, the next version of the PKZIP, PKUNZIP, and
  32. PKSFX programs. Please state the version of the software that you
  33. currently have.  Send check or money order to:   PKWARE, Inc. 7545 N.
  34. Port Washington Rd, Glendale, WI 53217.
  35.  
  36. The command syntax to unzip a zip file is:
  37.  
  38.          PKUNZIP [options] zipfile [d:outpath\] [file...]
  39.  
  40. Options are:
  41.         -c[m]               extract to screen [with more]
  42.          -d                 create directories stored in ZIP
  43.         -h                  display this help message
  44.         -j<H,S,R>           mask off Hidden/System/Readonly attributes
  45.                             upon extraction
  46.         -J<H,S,R>           don't mask off Hidden/System/Readonly attributes
  47.         -l                  display software license
  48.         -n                  extract only newer files
  49.         -o                  overwrite existing files
  50.         -p[a,b,c][1,2,3]    extract to printer [Asc mode,Bin mode,Com port]
  51.                             [port #]
  52.         -q                  enable ANSI in comments
  53.         -s<pwd>             unScramble with password
  54.         -t                  test zipfile integrity
  55.         -v[b,c,d,e,n,p,s,r] view ZIP(s) [Brief listing/sort by Crc/Date/Ext
  56.                             /Name/Percentage/Size/sort Reverse (descending)
  57.                             order]
  58.  
  59.         zipfile             ZIP file name, wildcards *,? ok.  Default
  60.                             extension is .ZIP file
  61.         Name(s) of files to extract. Wildcards *,? ok. Default is ALL files.
  62.         Unzip all .ZIP files on Drive A: to directory C:\FPC\SRC is:
  63.  
  64.         PKUNZIP  A:*.ZIP  C:\FPC\SRC
  65.  
  66. If you forget the options you want to use, type the following to get the
  67. above option list:
  68.  
  69.         PKUNZIP -h
  70.  
  71. An interesting unzip command is:
  72.  
  73.         PKUNZIP -v  A:*.ZIP
  74.  
  75. which lists all the zipped files on the monitor, with file statistics and
  76. checksums.  Appendix C2-C5 shows the lists of all zipped files in F-PC.
  77. You can compare your file lists against them to verify the integrity of
  78. your F-PC system.
  79.  
  80.  
  81. 2.2.    INSTALL F-PC USING INSTALL.EXE
  82.  
  83.  
  84. F-PC includes an installation program INSTALL.EXE.  It creates
  85. directories and expands .ZIP files onto your hard disk. This process
  86. takes only a few minutes, and will consume about 2 megabytes if all
  87. portions of F-PC are installed. After installation completes, the program
  88. proceeds into the configuration section. You are asked questions about
  89. your hardware. After which an installed copy of F-PC is created.
  90.  
  91. If the above process make you uncomfortable, or you just want to do the
  92. installation yourself, proceed to the next section. Otherwise just type:
  93.  
  94.         A:INSTALL
  95.  
  96. The first thing INSTALL.EXE does is ask you whether you are installing
  97. F-PC on your hard disk, or configuring a copy of F-PC already present on
  98. your hard disk. To this question, you would answer "I" for Install, or
  99. "C" for configure. The default is "I".  You can simply push the <return>
  100. key to select the default choice.
  101.  
  102. Question two is where you want F-PC placed on your hard disk and its
  103. directory.  The default is "C:\FPC".
  104.  
  105. Question three is where are you installing F-PC from, usually drive "A:".
  106.  
  107. At this point you are asked six (6) yes or no questions about what
  108. portions of F-PC to install. You will need all the files if you are new
  109. to F-PC.  Push <return> to make the default selections. However, after
  110. you gain experience and confidence in using F-PC, you will not need the
  111. help and text files, and you may eliminate these files by pushing "N" to
  112. some of the questions.
  113.  
  114. Lastly you are prompted to insert F-PC disk number one, and press <enter>
  115. to start the installation.  After the files on disk one is unzipped, you
  116. will be asked to remove disk one and insert disk 2, etc.  Follow the
  117. instructions and all the files needed will be unzipped and moved into the
  118. appropriate directories on your hard disk.
  119.  
  120. After the files are copied, you will be asked several questions to
  121. configure or customize F-PC to your computer environment, such as your
  122. monitor, whether backup files are created automatically for editing, etc.
  123. Detailed explanation to each question is displayed to guide your
  124. selection.  At the end of the configuration session, a file "F.EXE" will
  125. be created, which is the F-PC execution file you will use.  You can give
  126. it a different name if you do care.
  127.  
  128.  
  129. 2.3.    INSTALL F-PC WITHOUT USING INSTALL.EXE
  130.  
  131.  
  132. In this section you are assumed to be an experienced DOS user. If you are
  133. not, then please go ahead and use INSTALL.EXE. The process is pretty
  134. painless as INSTALL.EXE was designed to eliminate much of the problems in
  135. adapting F-PC to a wide variety of PC's and their clones.  There are
  136. occasions when INSTALL would fail to complete the installation process.
  137. This section will help you to get a working F-PC system in this
  138. unfortunate situation.
  139.  
  140. Unlike F-PC 2.25 and earlier versions, F-PC 3.5  has its own Forth PATH
  141. command and several directories to hold its files. This keeps the clutter
  142. down in the main FPC directory while keeping all the supporting files
  143. available when needed. F-PC's directory structure looks like this:
  144.  
  145.         C:\ ----------- \FPC --------- \SRC
  146.                                  |---- \HLP
  147.                                  |---- \TOOLS
  148.                                  |---- \NEWZ
  149.  
  150. You can of course put F-PC on a drive other than C:, and in directories
  151. other than \FPC etc. but for this discussion we will assume you will be
  152. using the above directory structure.
  153.  
  154. Create the above directory structure on your hard disk using the DOS
  155. "MKDIR" (make directory) command.  Use PKUNZIP.EXE to "unzip" the .ZIP
  156. files from floppy into the directories as shown below:
  157.  
  158.         Directory               .ZIP File
  159.  
  160.         \FPC                    FPC.ZIP
  161.         \FPC\SRC                FPCSRC.ZIP
  162.         \FPC\HLP                FPCDOC.ZIP
  163.                                 FPCHLP.ZIP
  164.         \FPC\TOOLS              SAMPLES.ZIP
  165.                                 SMITH.ZIP
  166.                                 CURLEY.ZIP
  167.                                 ZIMMER.ZIP
  168.         \FPC\NEWZ               NEWZ.ZIP
  169.  
  170. A typical PKUNZIP command line looks like this:
  171.  
  172.         C:> PKUNZIP A:FPC C:\FPC <Enter>
  173.  
  174. When you have finished the above, copy the following files from floppy to
  175. the "\FPC" directory:
  176.  
  177.         README      FLOPPY.TXT      INSTALL.TXT     INSTALL.EXE
  178.  
  179. This completes installation, and leads us into configuration.
  180.  
  181.  
  182. 2.4.    CONFIGURE F-PC
  183.  
  184.  
  185. F-PC uses a configuration file to execute several default configuration
  186. commands. The F-PC.CFG file is automatically loaded each time you start
  187. F-PC from the DOS command line. Part of the installation process is
  188. creating a configuration file for your hardware environment. Since we are
  189. doing the installation manually, we need to create this  configuration
  190. file.
  191.  
  192. At the end of the installation process, you are asked questions above
  193. your hardware configuration and some software preferences.  The
  194. INSTALL.EXE then generates a F-PC.CFG file, which is loaded by F.EXE when
  195. you invoke F-PC.  If you install the F-PC system yourself, you will still
  196. have to create the F-PC.CFG file to let F-PC know the precise
  197. configuration you have.  The easier way is to execute INSTALL.EXE again.
  198. After the first question is displayed:
  199.  
  200.         Do you want to install F-PC on your hard disk, or
  201.         Configure a copy of F-PC already on your hard disk [I/C]?  I
  202.  
  203. Type C instead of I followed by a <return>.  INSTALL.EXE will then bypass
  204. the installation procedure and go directly to the configuration
  205. procedure.  Answer the questions and the configuration file F-PC.CFG will
  206. be created for you.
  207.  
  208. The following procedure will allow you to configure F-PC for your
  209. hardware without using INSTALL.EXE. It is however much easier to
  210. configure F-PC using the install program, so please use it if possible.
  211.  
  212. Using your favorite text editor, place the following lines in a file
  213. named "F-PC.CFG".  If you have F-PC.EXE on the hard disk, you can use the
  214. F-PC editor to create and edit this file.
  215.  
  216.         FPATH C:\FPC;C:\FPC\SRC;C:\FPC\HLP;C:\FPC\TOOLS
  217.         FAST
  218.         COLORIZEON
  219.         BLANKOFF
  220.         ' >COLOR IS INITCOLOR
  221.         BACKUPON
  222.  
  223. When creating F-PC.CFG, if you installed F-PC on a hard drive other than
  224. "C:", change each occurrence of "C:" following the FPATH command above to
  225. the drive letter you are using.
  226.  
  227. The above words setup F-PC for a normal configuration. It will work even
  228. if you have a monochrome system. The commands have the following meaning:
  229.  
  230.         FPATH C:\FPC;C:\FPC\SRC;C:\FPC\HLP;C:\FPC\TOOLS
  231.                 The Forth PATH tells F-PC which directories to search
  232.                 when you open or load a file. You can include other
  233.                 directories as well up to a maximum of 132 characters.
  234.  
  235.         FAST    Select direct video writes. The opposite option is "SLOW"
  236.                 DOS i/o.
  237.  
  238.         COLORIZEON      Use colors when displaying various Forth word
  239.                 classes. This is automatically disabled on Monochrome
  240.                 systems. The opposite option is "COLORIZEOFF".
  241.  
  242.         BLANKOFF        Don't blank the screen when writing to the
  243.                 display. If you have a CGA display you may want to use
  244.                 "BLANKON", all other displays use BLANKOFF.
  245.  
  246.         ' >COLOR IS INITCOLOR           Allows F-PC to support a color
  247.                 monitor if one is available. Will support monochrome even
  248.                 with this command included.
  249.  
  250.         BACKUPON  Keep a single backup file for each file edited. If you
  251.                 are very short on disk space, or are using F-PC on a
  252.                 floppy system, you may want to use "BACKUPOFF".
  253.  
  254. For all the options or preferences that you might choose, consult Section
  255. 9.4.  In the hypertext root screen, there is a 'Preference' link.  You
  256. can browse from there to look at all the options.
  257.  
  258. After the configuration file is saved to disk, issue the following
  259. command from the DOS prompt while in the "\FPC" directory:
  260.  
  261.       C:> F-PC - FSAVE F BYE <Enter>
  262.  
  263. This command will start F-PC, which automatically reads in the
  264. configuration file we just created. The "-" above signifies no other file
  265. is to be opened. The next two words "FSAVE F", save F-PC to disk with the
  266. new name "F.EXE". You can of course use a name other than "F". "BYE"
  267. leaves F-PC and returns to DOS. This process creates a fully configured
  268. copy of F-PC called F.EXE that contains all of the default configuration
  269. parameters you specified.
  270.  
  271. Be sure to include the "C:\FPC" directory in your system PATH command in
  272. AUTOEXEC.BAT.
  273.  
  274. After rebooting your computer, you can run F-PC from any drive and
  275. directory by typing "F <filename> <enter>", and Forth will be able to
  276. find its source files, help files, and tools from wherever you are.
  277.  
  278.  
  279. 2.5.    INSTALL F-PC ON A DUAL FLOPPY SYSTEM
  280.  
  281.  
  282. If you are trying to install F-PC on a dual floppy system, then you will
  283. encounter some problems. When you are asked what to install while in the
  284. installation program, you will only be able to install the program, not
  285. the sources, help, or other things onto a 360k floppy. Therefore respond
  286. "Y" to only the first question (program), and "N" to the following
  287. questions.  After installation of the program section completes, enter "
  288. A:;B: " for the Forth path question. Answer the rest of the configuration
  289. questions about your hardware as you see fit.  The final question for the
  290. name of Forth, must be set to "F-PC.EXE" which will overwrite the copy of
  291. F-PC.EXE that was just installed on the floppy, as there is no room for
  292. an additional copy called "F.EXE".
  293.  
  294. When you have finished running the installation program, delete the
  295. following files from the installed disk to free up some space for your
  296. program files:
  297.  
  298.         INSTALL.EXE
  299.         EXTEND.BAT
  300.         EXTENDH.BAT
  301.         FMETA.BAT
  302.         PFMETA.BAT
  303.         KERNEL.COM
  304.         KERNEL.CFG
  305.  
  306. These files are not useful on a system that has no room to re-build F-PC
  307. anyway, so you might as well get rid of them as this will recover about
  308. 60k or so for you files.
  309.  
  310. You can run INSTALL.EXE again, and install the help  files on a second
  311. floppy, but you will have to set your FPATH to include the other floppy
  312. drive, and the directory into which the install program placed the help
  313. files.  After this is done, they should be available by typing
  314.  
  315.         BROWSE  <wordname>  <enter>
  316.  
  317. You will probably find F-PC fairly difficult to learn in this limited
  318. hardware environment, but its the best we can do.  Once you are familiar
  319. with F-PC and do not need all the handholding, you will only need the
  320. F-PC.EXE file on a floppy with your application files.  As F.EXE occupies
  321. 150K bytes of disk space, there are plenty of rooms for you to write
  322. programs and try them on a single floppy disk.
  323.  
  324.