═══ 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: vpascal@ibm.net www: http://www.fprint.co.uk/vpascal ftp: ftp.fprint.co.uk/fprint Phone: +44 (0)181 563 2359 Fax: +44 (0)181 563 2361 BBS: +44 (0)181 563 8624 ═══ 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: 70401.2606@compuserve.com Phone: (519) 657-0633 Fax: (519) 657-0283 ═══ 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: (719) 260-9136 Fax: (719) 260-7151 Toll-free: (800) 333-4160 ═══ 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.