home *** CD-ROM | disk | FTP | other *** search
/ Collection of Education / collectionofeducationcarat1997.iso / COMPUSCI / TOT11.ZIP / TOTDOC11.ZIP / CHAPT2.TXT < prev    next >
Text File  |  1991-02-11  |  27KB  |  535 lines
  1.                                                                  Getting Started
  2.  
  3.  
  4.  
  5.          "It is common sense to take a method and try it. If it fails, admit it
  6.          frankly and try another. But above all, try something."
  7.  
  8.                                                            Franklin D. Roosevelt
  9.  
  10.  
  11.  
  12. Installing the Toolkit
  13.          The Toolkit is available in a variety of disk densities and sizes. This
  14.          section assumes that you are installing the software from a two disk
  15.          set. If you are using a single disk set, simply assume that all the
  16.          files are contained on a single disk and ignore the instructions for
  17.          inserting the second disk.
  18.  
  19.          The program disk includes an installation program INSTALL.EXE. This
  20.          program can be used to automatically install the software onto your
  21.          hard disk. It will prompt you to enter the appropriate source and tar-
  22.          get directories, and will not modify your CONFIG.SYS and AUTOEXEC.BAT
  23.          files. Alternatively, you may install the Toolkit manually. Please note
  24.          that the files are stored on disk in compressed form, and must be
  25.          uncompressed (decompressed?) before they can be used.
  26.  
  27.  
  28. Using INSTALL.EXE
  29.          The Install program will transfer the Toolkit files from the diskettes
  30.          to a specified hard drive. To run the install program, insert the
  31.          Source Disk in drive A (or another floppy drive) and then:
  32.  
  33.          q    Type the command: A:INSTALL [KEYCAP].
  34.          q    Press [KEYCAP] at the installation screen.
  35.  
  36.          q    Follow the prompts.
  37.          It is recommended that you install the source files in a sub-directory
  38.          TOT beneath the main Turbo Pascal directory. Similarly, the demo files
  39.          should be installed in a TOTDEM subdirectory.
  40.  
  41.          During the installation process, files will be copied from the Toolkit
  42.          disks to your hard drive. The files will then be compressed. Once the
  43.          files have been installed, the Installation program will ask if you
  44.          want to view the README file. This file contains last-minute details
  45.          about the Toolkit. A following section describes how to view the README
  46.          file after installation.
  47.          If the installation is not successful, follow the manual installation
  48.          method described in the next section.
  49.  
  50.  
  51. 2-2                                                                 User's Guide
  52. --------------------------------------------------------------------------------
  53.  
  54. Manual Installation
  55.  
  56.          The disks contain the following files:
  57.          INSTALL.EXE     the Toolkit Installation program
  58.  
  59.          SOURCE.EXE      a self-extracting file which contains the .PAS source
  60.                          files for the Toolkit units
  61.          DEMO.EXE        a self-extracting file which contains the .PAS demon-
  62.                          stration files, which illustrate how to use the Toolkit
  63.  
  64.          DOCS.EXE        a self-extracting file containing all this documenta-
  65.                          tion in ASCII form
  66.          README.COM      a self-displaying text file which lists all the last-
  67.                          minute changes and enhancements
  68.  
  69.          REGISTER.EXE    a self-extracting file which contains all the ShareWare
  70.                          information and instructions
  71.  
  72.  
  73.          We recommend that the source files are installed in a separate sub-
  74.          directory "underneath" the compiler directory. For example, if your
  75.          compiler is stored in the directory C:\TP, then create a directory
  76.          C:\TP\TOT. You can insert the source disk in the A drive and install
  77.          the source files as follows:
  78.                   C: [KEYCAP]
  79.                   MD\TP\TOT [KEYCAP]
  80.                   CD\TP\TOT [KEYCAP]
  81.                   A:SOURCE [KEYCAP]
  82.  
  83.  
  84.          The SOURCE.EXE program will then place all the source code files in the
  85.          newly created directory. The README.COM file should also be copied to
  86.          the TOT sub-directory.
  87.  
  88.                   COPY A:README.COM [KEYCAP]
  89.  
  90.  
  91.          Although not essential, the demonstration files are referred to
  92.          throughout the documentation and it is recommended that you do install
  93.          them. Furthermore, it is recommended that you install them in a sepa-
  94.          rate subdirectory as follows:
  95.                   C: [KEYCAP]
  96.                   MD\TP\TOTDEMO [KEYCAP]
  97.                   CD\TP\TOTDEMO [KEYCAP]
  98.                   A:DEMO [KEYCAP]
  99.  
  100.  
  101.  
  102.  
  103. Getting Started                                                              2-3
  104. --------------------------------------------------------------------------------
  105.  
  106.          You do not need to install the DOCS.EXE and REGISTER.EXE files, since
  107.          you are a registered user and you are reading the documentation. These
  108.          files are included so that you may give an evaluation copy of the
  109.          Toolkit to a colleague who may try the software. Refer to the License
  110.          Agreement for further information.
  111.  
  112. The Toolkit Files
  113.          Listed below are the source files that have been installed on your hard
  114.          disk:
  115.  
  116.          TOTFLAGS.INC    contains global compiler directives
  117.          TOTLOOK.PAS     controls the overall look and feel of your programs
  118.  
  119.          TOTREAL.PAS     provides numeric co-processor support and supports
  120.                          extended reals
  121.          TOTSYS.PAS      contains objects for ascertaining hardware and operat-
  122.                          ing system configurations
  123.  
  124.          TOTINPUT.PAS    provides mouse and keyboard support
  125.          TOTFAST.PAS     supports writing to physical and virtual screens
  126.  
  127.          TOTWIN.PAS      contains a variety of window objects
  128.          TOTMSG.PAS      provides objects for displaying messages and prompts in
  129.                          Pop-up windows
  130.  
  131.          TOTLINK.PAS     includes a variety of objects for managing linked lists
  132.          TOTLIST.PAS     provides objects for displaying string arrays or linked
  133.                          lists in a window
  134.  
  135.          TOTDIR.PAS      includes a directory display object
  136.          TOTIO1,2,3.PAS  three units for building full screen input
  137.  
  138.          TOTMENU.PAS     includes routines for building pop-up and pull-down
  139.                          menus
  140.          TOTSTR.PAS      contains a host of string manipulation functions
  141.  
  142.          TOTDATE.PAS     includes a set of functions for managing Julian and
  143.                          Gregorian dates
  144.          TOTMISC.PAS     provides a potpourri of procedures and functions
  145.  
  146.          TOTBUILD.PAS    used to re-build all the TOT TPUs
  147.  
  148.  
  149.          In addition to the source code files, there are a host of demonstration
  150.          files. All the demonstration filenames begin with DEM. The files which
  151.          demonstrate how to extend the Toolkit begin with EXT. The major demon-
  152.  
  153. 2-4                                                                 User's Guide
  154. --------------------------------------------------------------------------------
  155.  
  156.          stration file is DEMTOT.PAS. All the other files are designed to be
  157.          small and concise illustrations of how to get the most from the
  158.          Toolkit.
  159.  
  160.  
  161.  
  162. The README File
  163.          The file README.COM is actually a self-displaying text file which con-
  164.          tains any last-minute changes or additions to the documentation. To
  165.          view the contents of the README file, simply change the default
  166.          directory to the TOT source and execute README, e.g.
  167.  
  168.                   CD\TP\TOT [KEYCAP]
  169.                   README [KEYCAP]
  170.  
  171.  
  172. Configuring Turbo Pascal
  173.  
  174.          Having installed the Toolkit, you must configure Turbo Pascal so the
  175.          compiler knows where to locate the Toolkit files. Configure the inte-
  176.          grated environment as follows:
  177.          q    Execute the IDE by changing the default directory to the main
  178.               Turbo Pascal directory, and enter TURBO.
  179.  
  180.          q    Select the Directories