OS/2 Shareware BBS: 10 Tools/10-Tools.zip/vp11demo.zip/vpinst.hlp

OS/2 Help File | 1996-10-08 | 23KB | 541 lines

ΓòÉΓòÉΓòÉ 1. Virtual Pascal for OS/2 - Evaluation Licence ΓòÉΓòÉΓòÉ

Virtual Pascal for OS/2 v1.10 (Evaluation Licence)

Welcome to the installation program for VP/2, the best and most powerful Pascal
development environment available for OS/2.

Using this installation program, you can Install Virtual Pascal for OS/2 (Eval)
on your hard disk, or you can add components to an already installed copy of
VP/2 (Eval).

If the VP/2 icons on the desktop have been deleted, you can also re-create
those icons.

Please select the Install button to install, the Recreate Icons button to
re-establish the icons, or press the Cancel button to exit this installation
program.


ΓòÉΓòÉΓòÉ 1.1. VP/2 - Install ΓòÉΓòÉΓòÉ

Press the Install button to start a new installation of Virtual Pascal for
OS/2.

You should select this option, if

     you have not already installed VP/2 on your system

     you want to add options to an existing installation

     you want to update your VP/2 desktop icons


ΓòÉΓòÉΓòÉ 1.2. VP/2 - Recreate Icons ΓòÉΓòÉΓòÉ

Pressing this button will make the installation program re-create the desktop
icons for all previously installed components of VP/2 that have at some point
had icons installed for them.

The list of installed items is loaded from the VP2.INI file, located in the
directory pointed to by the VPBASE environment variable.  If this environment
variable is not found in CONFIG.SYS or VP2.INI is not found, this option is
disabled.


ΓòÉΓòÉΓòÉ 1.3. VP/2 - Cancel ΓòÉΓòÉΓòÉ

If you press the Cancel button, the installation program will terminate.


ΓòÉΓòÉΓòÉ 2. VP/2 - Main Selections ΓòÉΓòÉΓòÉ

Virtual Pascal for OS/2 v1.10 (Evaluation Licence)

In this dialog, you can enter your choice of components to install to a hard
disk or network drive.

Disk Space

In the bottom right of the dialog, the total disk space required for the
currently selected components is displayed.  Just above that, a list of all
drive letters to which VP/2 can be installed is displayed together with the
currently available free space.

Note:  Your choice in selecting components is limited in this evaluation
       version of the software.  The full version allows you to fully customize
       the installation to your needs.

You can also instruct the installation procedure to automatically change
CONFIG.SYS and to create VP/2 Desktop Icons in a VP/2 folder on the desktop for
easy access to the VP/2 programs, documentation and examples.

When you have finished making your selection, press the Install button to start
the installation, or Cancel to return to the initial installation dialog
without installing VP/2.


ΓòÉΓòÉΓòÉ 2.1. VP/2 Base Installation ΓòÉΓòÉΓòÉ

The VP/2 Base Installation option should always be included when you first
install VP/2.  The base installation contains all components required to get a
working VP/2 working environment, and no other components are required.

In the Evaluation Licence, the VP/2 Base package consists of the following:

     The VP/2 compiler, VPCOMP11.DLL
     The VP/2 IDE, VPIDE11.DLL
     The PM IDE, VPPM.EXE
     VP/2 utilities: IMPLIB.EXE, LIB.EXE, HG.EXE and TPH2VPH.EXE.
     The VP/2 command-line compiler, VPC.EXE
     A set of VP/2 icons
     The OS/2 library files OS2.LIB with source
     DLL version of the Run-Time Library, VP11DEMO.DLL.
     The interface section of all units included in the Demo DLL.


ΓòÉΓòÉΓòÉ 2.2. VP/2 RTL Source ΓòÉΓòÉΓòÉ

Note:  The RTL source code is not included in the Evaluation Licence.

Installing this component is very much recommended.  The VP/2 Run-Time Library
source code is written in Virtual Pascal, and implements a lot of
functionality.  If you install the source code, you can browse through it, and
even change the way system functions work.

If you do not install the RTL source code, it is still available on the VP/2
CD-ROM, and can be found in the \RUNIMAGE\SOURCE\RTL directory.

 Unit name           Description
 Crt.Pas             Routines useful for text-mode applications
 Dos.Pas             Routines for disk I/O, date and time and manipulation of
                     the environment
 WinCrt              Equivalent to CRT, useable for PM applications
 WinDos              Equivalent to DOS, for PM applications
 Strings             String-manipulation routines for pChars
 Printer             A very simple interface to text-mode printing
 PMObj               A simple framework for PM applications
 VPUtils             A collection of utility functions easing the use of many
                     OS/2 API functions

 Source code is supplied for the following OS/2 interface units:

 Os2Def              Commonly used type definitions
 Os2Base             Basic OS/2 API functions for disk I/O as well as Keyboard,
                     Mouse and Text-mode screen handling
 Os2PmApi            The entire OS/2 PM API in one file.  All Presentation
                     Manager functions, Spooler functions, Graphical frawing
                     routines, Help functions, Standard dialogs and AVIO
                     functions are covered
 Os2Rexx             The API functions necessary for using and extending REXX
                     with Virtual Pascal
 Os2MM               All Multi-media extensions for OS/2.  Video, sound, Audio
                     CD and Mixing are all to be found here
 ExeHdr              Type definitions covering the different executable file
                     formats used in OS/2

 The following units adopted from Borland Delphi are supplied with the
 interface section of the source code only:

 SysUtils            Routines complementing the basic run-time library.  This
                     unit must be used by all programs using try..except or
                     try..finally constructs
 Math                Advanced highly optimised mathematical library
 Classes             All base classes used by the Visual Component library,
                     including collections, streams, string lists, components
                     etc.
 TypInfo             Unit used internally by VP to provide run-time type
                     information

 Please note, that source code can be installed for these units, if the Delphi
 VCL source code is available.  Click here for more information.


ΓòÉΓòÉΓòÉ 2.3. VP/2 Online Help ΓòÉΓòÉΓòÉ

The online help of VP/2 consists of a number of .VPH files which can be used
from the VP/2 Integrated Development Environment to get immediate
context-sensitive help.

The entire OS/2 API is covered, and the online help is an invaluable help when
programming for OS/2.

Since the help takes up a great deal of disk space, you can leave the files on
the CD-ROM by pressing the Options button and select CD-ROM. You will still be
able to use the help-files from within the IDE, provided the VP/2 CD-ROM is in
the drive.


ΓòÉΓòÉΓòÉ 2.4. VP/2 Online Documentation ΓòÉΓòÉΓòÉ

The Online Documentation consists of OS/2 .INF files describing the entire OS/2
API.

Since the files takes up a great deal of disk space, you can leave the files on
the CD-ROM by pressing the Options button and select CD-ROM.

If you check the VP/2 Desktop Icons, the OS/2 API references will be accessible
from the VP/2 Documentation folder, even if you leave them on the CD-ROM and do
not copy the files to the hard disk.


ΓòÉΓòÉΓòÉ 2.5. VP/2 Example Programs ΓòÉΓòÉΓòÉ

VP/2 comes with a large number of example programs, designed to illustrate
different aspects of OS/2 programming in Virtual Pascal.

All examples are included as executables, so you can experience the power of
programs written in VP/2, even without having installed the compiler!

In addition, all examples that are not part of a 3rd Party Toolkit are provided
with full source code for you to learn from.

Since installing the examples takes up a great deal of disk space, you can
leave them on the CD-ROM by pressing the Options button and select CD-ROM.

If you check the VP/2 Desktop Icons, a VP/2 example folder will be created,
containing references to all examples.  If you do not copy the examples to the
hard disk but leave them on the CD-ROM, the objects will be set to point to the
CD-ROM and the examples will of course only be available when the VP/2 CD is in
the drive.


ΓòÉΓòÉΓòÉ 2.6. VP/2 Users' Contributions ΓòÉΓòÉΓòÉ

A number of users have contributed to this release of VP/2 by supplying example
programs and source code, demonstrating different aspects of real-life
programming in VP/2.

The Users' Contributions contain a game written using DIVE, an audio CD player,
an archive converter, a Squish interface, an interface to dBASE3 database
files, and more.


ΓòÉΓòÉΓòÉ 2.7. VP/2 3rd Party Toolkits ΓòÉΓòÉΓòÉ

Virtual Pascal for OS/2 supports a number of 3rd party Pascal-based toolkits.
If you do not want support for any toolkits, you can disable this option
entirely.

To select the toolkits you want, click the Select button to the right of the
checkbox.

In the Evaluation Licence of VP/2, only the MathPak and TTT toolkits are
supplied and supported.


ΓòÉΓòÉΓòÉ 2.8. VP/2 - Update CONFIG.SYS ΓòÉΓòÉΓòÉ

In order for VP/2 to run, your OS/2 environment needs to be updated.
Specifically, the LIBPATH statement in CONFIG.SYS should be changed to include
a reference to the BIN directory created by VP/2, as should the PATH
environment variable.

Select this option to have this installation program do the change for you
automatically.

After CONFIG.SYS has been changed, and VP/2 has finished installing, you need
to reboot OS/2 to let the changes take effect.

Note:  The routine for changing CONFIG.SYS does not make any changes, if the
appropriate paths are up to date already.  No harm will come from running the
installation program multiple times, even if this option is enabled.


ΓòÉΓòÉΓòÉ 2.9. VP/2 - Desktop Icons ΓòÉΓòÉΓòÉ

By checking this option, this installation program can create a VP/2 folder on
your OS/2 desktop, from which you can access most of the goodies coming with
VP/2.

In the Evaluation Licence, the following icons are created:

     Virtual Pascal for OS/2 v1.10
      This is the base folder, inside of which which every other icon will be
      created.

        -  VP/PM IDE icon.  Simply click this icon to start the VP/2 PM IDE.
        -  VP/2 Documentation Folder
             -- VP/2 Licence Agreement
             -- VP/2 Frequently Asked Questions
             -- MATHPAK87 documentation
             -- Last minute update - things that did not make it for the
                manuals

           Note:  The following icons are only created, if the Example Programs
           option is checked.
        -  VP/2 Examples Folder
             -- Virtual Pascal for OS/2 Examples
             -- Turbo Vision Examples
             -- MATHPAK87 examples
             -- The Art of OS/2 Warp Programming Examples
             -- Object Professional Examples
             -- B-Tree Filer Examples
             -- ASync Professional Examples


ΓòÉΓòÉΓòÉ 2.10. VP/2 - Install ΓòÉΓòÉΓòÉ

When you have selected the options you wish to install and set up the paths for
any toolkits requiring source code, click this button to start the installation
process.

Before the installation starts, the installation program attempts to determine
if there is enough free disk space on the disk on which you want to install.
If there is not, a warning message is displayed, and you are urged to select
another destination drive or delete some files.

As installation progresses, a progress-meter shows how much is left to do.
Installation usually takes only a few minutes.

During installation, you can press the Pause button to pause installation, and
resume installation with Resume.

If you press the Cancel button, the installation process will stop. Any files
unpacked or copied will not be deleted.


ΓòÉΓòÉΓòÉ 2.11. VP/2 - Cancel Install ΓòÉΓòÉΓòÉ

Click this button if you wish to abort installation and return to the welcome
screen.  Selections you have made in the Main Selections dialog are not lost.


ΓòÉΓòÉΓòÉ 2.12. VP/2 - Options ΓòÉΓòÉΓòÉ

A full installation of Virtual Pascal for OS/2 takes up a lot of hard disk
space.  As one possible alternative, you can leave one or more of the biggest
components on the VP/2 CD-ROM, and still be able to use it.  Doing so of course
requires that the VP/2 CD-ROM is in the CD drive.

Even if you leave some components on the CD, you can always instruct this
installation program to install those component at a later time.

 If you select the Install Desktop Icons option, Desktop objects will still be
made to components left on the CD-ROM.


ΓòÉΓòÉΓòÉ 2.13. VP/2 - Toolkits ΓòÉΓòÉΓòÉ

In this dialog, you should select which toolkits should be available for use
with VP/2 on your system.

Since the toolkits are 3rd party toolkits sold commercially by companies other
than fPrint UK Ltd, we cannot provide full source code for the toolkits without
the consent of the copyright owner.  For you to be able to install support for
some of the toolkits, you must already own a licence for that toolkit.  Other
can be installed even if you do not already have a licence:

 Toolkit     Description

 Turbo Vision v2.0x - Borland Int.
             This toolkit is part of Borland Pascal v7 for DOS, and implements
             an object-oriented library of screen handling and various other
             routines. Support for this toolkit can be installed in the form of
             a DLL and of OBJ files that can be linked seamlessly into your
             program, even if you do not own a licence of Borland Pascal or
             Turbo Vision already.
             If you do have an installed version of TV on your system, this
             installation program can upgrade the source code for compatibility
             with VP/2.

 Object Windows Library - Borland Int.
             This GUI library is part of Borland Pascal v7.00, 7.01 and the
             16-bit versions of Delphi.  It implements an object-oriented
             library of PM GUI routines that allow easy production of GUI
             applications for OS/2. Support for this toolkit can be installed
             in the form of a DLL and of OBJ files that can be linked
             seamlessly into your program, even if you do not own a licence of
             OWL already.  In any case, VP/2 will at least copy the interface
             sections of the OWL libraries to the SOURCE\OWL directory so you
             can see which functions are defined.
             If you do have an installed version of OWL on your system, this
             installation program can upgrade the source code for compatibility
             with VP/2.  Note, that this library was quite closely linked with
             Windows, and source code for existing OWL applications should
             potentially be changed substantially to work with VP/2.
             fPrint UK extends a special thanks to Christoph Bratschi of
             Switzerland for making this library available for Virtual Pascal
             for OS/2.

 MATHPAK87/32 - NiTek Corp.
             This toolkit is a powerful subset of a fullblown mathemathics
             library, and is provided without source code.  It contains a large
             number of optimised math routines, optimised for both speed and
             size.  Full documentation of all functions is provided as well.
             To get the full version of MATHPAK87 including source code and
             with many more functions available, please contact Precision Plus
             Software.

 TechnoJock's Turbo Toolkit - TJ Software
             This shareware toolkit is provided with full source code and
             documentation, ready for both Virtual Pascal for OS/2 and Borland
             Pascal for DOS.
             If you use this excellent toolkit (providing a host of routines
             for screen I/O, data entry, etc), please register the software -
             the registration form is included in the package.

 Object Professional - TurboPower Software
              Object Professional is the most productive way to create
             flexible, full-featured text mode user interfaces.  It provides
             high-level window objects for validated data entry, text editing,
             file browsing, pick lists, directory lists, menu systems,
             context-sensitive help, CUA-style dialog boxes and others.  Also
             includes container classes for lists, hash tables, queues,
             bitsets, and more.  Menus and entry screens can be designed
             interactively and source code generated at the touch of a key.
             Installing support for this toolkit requires that v1.30 is already
             installed on the hard disk.  If you have an older version, or wish
             to purchase the toolkit whith a 20% discount, please contact
             TurboPower Software Co..

 B-Tree Filer - TurboPower Software
             B-Tree Filer is a compact, high-speed library for indexed file
             management. It supports 2 billion records and 100 indexes per
             database, variable length records, and precise control of network
             access and locking.  Filer is compatible with NetWare, OS/2 LAN
             Manager and all networks that support DOS locking calls.  Also
             includes functions for merge sorting, index generation, dBase
             import/export and more.
             Installing support for this toolkit requires that v5.51 is already
             installed on the hard disk.  If you have an older version, or wish
             to purchase the toolkit whith a 20% discount, please contact
             TurboPower Software Co..

 ASync Professional - TurboPower Software
              ASync professional is a powerful, easy to use serial
             communications library.  It uses a layered architecture that
             provides both OOP and traditional calling interfaces.  You get
             low-level port control, terminal emulation, file transfer
             protocols (XModem, YModem, ZMode, Kermit, CompuServe B+, and
             ASCII), modem control, ZIP data compression and more.
             Installing support for this toolkit requires that v2.02 is already
             installed on the hard disk.  If you have an older version, or wish
             to purchase the toolkit whith a 20% discount, please contact
             TurboPower Software Co..


ΓòÉΓòÉΓòÉ 2.14. Source code could not be found ΓòÉΓòÉΓòÉ

This dialog is displayed if the source paths specified in the entry box for a
toolkit does not contain all files required to install source code support for
that toolkit.

In case of the Turbo Vision toolkit, support will be installed without source
code.

For the TurboPower toolkits, support cannot be installed if the source code is
not available.

Below the error message, a list of all required files that could not be found
is displayed in a list box.  Please correct the error by entering the correct
path specification in the entry field next to the toolkit and retry.  The
toolkit cannot be installed until this check has been passed.


ΓòÉΓòÉΓòÉ 2.15. Path to VP/2 CD-ROM ΓòÉΓòÉΓòÉ

In this dialog, you should enter the path to the root directory of the CD-ROM
drive in which the original VP/2 CD-ROM resides.

VP/2 will suggest the letter of the first CD-ROM installed in the system, but
will allow any path to be specified.  This allows you to copy the content of
the entire CD-ROM to the hard disk or a network drive and simply specify the
base directory of the location where the VP/2 files can be found.

Once you have entered this path once, VP/2 will only display the dialog again,
if the VP/2 CD-ROM cannot be found at the specified location.  The information
entered is stored in the VP2.INI file in the VP/2 base directory.


ΓòÉΓòÉΓòÉ 2.16. fPrint UK Ltd ΓòÉΓòÉΓòÉ

fPrint UK Ltd is based in London, UK, and has been in the software business for
about 5 years.

fPrint UK Ltd can be contacted on the following address:

  fPrint UK Ltd
  Cambridge House
  100 Cambridge Grove
  Hammersmith
  London W6 0LE
  United Kingdom

  e-mail:    [e-mail]
  www:       http://www.fprint.co.uk/vpascal
  ftp:       ftp.fprint.co.uk/fprint
  Phone:     [phone]
  Fax:       [phone]
  BBS:       [phone]


ΓòÉΓòÉΓòÉ 2.17. Precision Plus Software ΓòÉΓòÉΓòÉ

Presision Plus Software is based in Canada, where they develop and market their
own powerful MATHPAK 87 library.  They also distribute VP/2 in Canada and the
US.

Precision Plus Software can be contacted on the following address:

  Precision Plus Software
  38 Longview CRT
  London, ON N6K 4J1
  Canada

  e-Mail:   [e-mail]
  Phone:    [phone]
  Fax:      [phone]


ΓòÉΓòÉΓòÉ 2.18. TurboPower Software ΓòÉΓòÉΓòÉ

TurboPower Software develop and market a wide range of sophisticated toolkits
for both Pascal and C.  VP/2 supports the ones most widely used (Object
Professional, ASync Pro and B-Tree Filer), and support for more toolkits is
planned for later releases.

Special Offer!  In the VP/2 box, you will find a Voucher that gives you a
special 20% discount on any VP/2 compatible toolkit bought directly from
TurboPower.  TurboPower software can be contacted on the following address:

  TurboPower Software Co.
  P.O. Box 49009
  Colorado Springs, CO 80949-9009
  USA

  www:       http://www.tpower.com/turbopower
  ftp:       ftp://tpower.com/pub/turbopower
  Phone:     [phone]
  Fax:       [phone]
  Toll-free: [phone]


ΓòÉΓòÉΓòÉ 2.19. Source code upgrade failed ΓòÉΓòÉΓòÉ

This dialog is displayed if the source code being upgraded to VP/2
compatibility is not the original.

The listbox displays a list of all files that were not succesfully updated.
Note, that the toolkit that failed the upgrade may still work.

Please reinstall the original source code and repeat the installation procedure
to repeat the upgrade.


ΓòÉΓòÉΓòÉ 2.20. VP/2 RTL Source code ΓòÉΓòÉΓòÉ

The run-time library of Virtual Pascal for OS/2 is included with full source
code for all modules that are (C) fPrint UK Ltd.

Three units: Classes, SysUtils and Math are derived from the Visual Component
Library of Borland Delphi, and are (C) Copyright Borland Int.  For these units,
only the interface sections are installed.

If you do have a copy of the source code for the Delphi VCL installed on your
PC, the installation program can upgrade these units to VP/2 compatibility and
you will have full source code available for them.

Specify the fully qualified path to the source code in the entry field - the
installation program takes care of the rest.