home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vp21beta.zip / README.TXT < prev    next >
Text File  |  2000-09-06  |  9KB  |  227 lines
  1.  
  2.    Virtual Pascal v2.1 Beta Build 229
  3.    Paris, September 2000
  4.    (C) Copyright 2000 vpascal.com
  5.  
  6. Thank you for taking an interest in Virtual Pascal.  This document outlines the
  7. installation procedure, and provides last-minute information not included in the
  8. online manuals.
  9.  
  10. Installation
  11. ~~~~~~~~~~~~
  12.  
  13. To install this version of Virtual Pascal 2.1,
  14.  
  15.  - Extract all archives you have downloaded to a temporary directory,
  16.    not the one in which Virtual Pascal is to be installed. (Do *not*
  17.    extract the inner archives called W*.RAR, O*.RAR, L*.RAR, and A*.RAR;
  18.    the installation program will do this for you).
  19.  
  20.  - Run the appropriate installation program, SetupW32.Exe for Windows or
  21.    SetupOs2.Exe for OS/2. This program is a text mode Turbo Vision
  22.    application compiled from the same source code for OS/2 and Win32
  23.    (of course using Virtual Pascal).
  24.  
  25.  - The licence agreement is displayed. Read it and press Alt-I or select
  26.    the Install option from the File menu to start the installation.
  27.  
  28.  - The first page of the installation wizard is displayed.  Press the
  29.    Next button to proceed.
  30.  
  31.  - On the next page, the pre-selection screen, choose from one of 3
  32.    default options.  Select Full Install to install all parts of the
  33.    product, Typical Install to install all components for the current
  34.    platform only, and Custom to pick and choose.
  35.    Press the Next button to continue.
  36.  
  37.  - Based on your choice on the pre-selection screen, some or all
  38.    components of the installation will be selected for installation.
  39.    Review the settings, by using the Detail button to review the
  40.    inclusion of sub-components.
  41.    Press the Next button to continue.
  42.  
  43.  - Select the drive to which Virtual Pascal 2.1 should be installed;
  44.    if a drive does not have enough space to install the selected options,
  45.    the drive space indicator will be red.  If installing to such a drive,
  46.    you can insist that there is enough space and continue anyway.
  47.    The directory will be chosen on the next screen.
  48.    Press the Next button to continue.
  49.  
  50.  - Choose your preference regarding the case of directory names.  You
  51.    can choose UPPER case, lower case or Mixed Case.  All directories
  52.    created by the installation program will use the choice selected
  53.    here.
  54.    Press the Next button to continue.
  55.  
  56.  - Enter the installation directory, excluding drive letter.  This
  57.    can be any directory (spaces not allowed), whether it exists or
  58.    not.  If it is a new directory, the installation program will ask
  59.    if it should be created for you.
  60.    Press the Next button to continue.
  61.  
  62.  - If any of the components requiring original source code were included in the
  63.    selection (Object Windows Library, Visual Class Library, OPro) you will be
  64.    prompted to enter the path to the original sources.
  65.    Press the Next button to continue.  If any of the required source files are
  66.    not found, an error message will be displayed and you will be prompted to
  67.    enter a new path.
  68.  
  69. The installation program will now unpack the selected archives and copy
  70. (and patch, where required) the selected source code. When it has
  71. finished, please read the rest of this readme file. Or, since OS/2 and
  72. Win32 are multitasking systems you can just read it while the
  73. installation program is running. The OS/2 programs are installed to the
  74. BIN.OS2 directory, the Win32 programs to BIN.W32 and the files used for
  75. the experimental Linux support to BIN.LNX.
  76.  
  77. Full information about Virtual Pascal, the directory structure, etc.
  78. is included as .PDF manuals readable by the free Adobe Acrobat viewer
  79. v3.0 or later.  These files can be found in the DOC directory.
  80.  
  81.  
  82. Upgrade Patches
  83. ~~~~~~~~~~~~~~~
  84.  
  85. The upgrade patches for non-VP source code included with this software
  86. is version specific.  This means that the update program requires an original,
  87. unmodified source file in order to be able to perform the update.
  88.  
  89. The following versions are supported:
  90.  
  91. Object Windows Library
  92.   v7.00 (Borland Pascal v7.00 or Borland Pascal for Windows)
  93.   v8.00 (Borland Delphi v1.00)
  94.   v8.01 (Borland Delphi v1.01)
  95.  
  96. Visual Component Library
  97.   v1.00, v2.00, v2.01, v3.00, v4.01, v5.00 (From Borland Delphi of same version)
  98.  
  99. Object Professional
  100.   v1.30
  101.  
  102.  
  103. Known Issues
  104. ~~~~~~~~~~~~
  105.  
  106. This release of Virtual Pascal v2.1 has the following known issues that
  107. you may need to consider:
  108.  
  109.  - Cut/Paste between the VP IDE and other applications may have a
  110.    problem in Windows 98.
  111.  
  112.  - The text-only version of the User's Guide, vp21user.txt, is not
  113.    included.  (Word simply refuses to produce it; I'm investigating).
  114.  
  115.  - Keyboard handling in Win32 for both your own programs and for
  116.    the VP IDE is handled by routines in VpSysLow/VpSysW32.Pas.  On
  117.    some keyboard layouts, these routines cause problems, and the
  118.    VpKbdW32.Dll library can be used to dynamically substitute the
  119.    statically linked keyboard handlers.  Please refer to the source
  120.    code and documentation for more information on this.
  121.  
  122.  - In several units of the Run-Time Library, definitions are enclosed
  123.    in {$IFDEF DPMI32} .. {$ENDIF} blocks.  However, this release of
  124.    Virtual Pascal does not support 32-bit DOS as a target without
  125.    additional support files, and this code is included in order to
  126.    ease the implementation of 32-bit DOS target code.  For an example
  127.    of such a library, please refer to
  128.    http://www-user.tu-cottbus.de/~kannegv/vpascal
  129.  
  130.  - In several units of the Run-Time Library, definitions are enclosed
  131.    in {$IFDEF LINUX} .. {$ENDIF} blocks.  Support for the Linux
  132.    platform is very experimental at this stage though, and you should
  133.    not expect it to work very well, if at all.
  134.  
  135.    A group of VP users has initiated a project to port VP to Linux,
  136.    and can be found at www.trantor.de/joerg.pleumann/.  The Virtual
  137.    Pascal team is working with this group of users to finalise Linux
  138.    support in Virtual Pascal.
  139.  
  140.  - The built-in linker throws an error message if two resources with
  141.    the same resource ID are included in your program.  This prevents
  142.    resource conflicts and minimises the size of the executable.
  143.    In OS/2, the Resource Editor creates a resource with ID 1 for
  144.    every dialog; to link these resources, manually edit these to
  145.    have different IDs.
  146.  
  147.  - To better facilitate Linux integration (which requires that the
  148.    executables compiled by VP are converted to ELF format), an
  149.    option to execute a user-defined program after linking has been
  150.    added.  Please refer to the User's Guide for details.
  151.  
  152.  
  153. What is new
  154. ~~~~~~~~~~~
  155.  
  156. This release of Virtual Pascal implements a long list of features
  157. requested by Virtual Pascal users worlwide, and corrects several problems
  158. reported in v2.0 and previous beta releases of the product.
  159.  
  160. Much of the work has gone into making Virtual Pascal compatible with
  161. the Linux operating system; for a complete list of changes, please
  162. refer to the WhatsNew.txt file in the doc\ directory.
  163.  
  164.  
  165. Copy protection
  166. ~~~~~~~~~~~~~~~
  167.  
  168. This Beta version of Virtual Pascal v2.1 is (C) Copyright 2000 vpascal.com
  169. and must not be distributed or copied.  Please refer to the licence
  170. agreement in LICENCE.TXT for details.
  171.  
  172. As opposed to previous versions of Virtual Pascal, no built-in copy
  173. protection system is active in this beta version and the original
  174. distribution archive can be copied and distributed in unmodified form.
  175.  
  176.  
  177. Feedback
  178. ~~~~~~~~
  179.  
  180. We want and welcome your feedback!  If you have suggestions or want
  181. to report a bug, please refer to the FEEDBACK.TXT file in the DOC
  182. directory.  It contains a list of the data we require to handle the
  183. feedback most efficiently.
  184.  
  185. If at all possible, please submit feedback to feedback@vpascal.com.
  186.  
  187.  
  188. Manuals
  189. ~~~~~~~
  190.  
  191. Comprehensive manuals covering the use of Virtual Pascal v2.1 and a
  192. complete language reference are included as Adobe Portable Document
  193. Format (PDF) files in the DOC directory.
  194.  
  195. The User's guide, VP21USER.PDF, introduces the installation program,
  196. features of VP v2, IDE usage, debugger, and cross-platform support.
  197.  
  198. The Language Reference, VP21LANG.PDF, provides in-depth documentation
  199. of the Pascal language as implemented by Virtual Pascal.
  200.  
  201. Both documents can be viewed using the widely available free Adobe
  202. Acrobat Reader v3.0 or later, and can be printed to provide a hard
  203. copy manual.
  204.  
  205. The manuals are secured from changing, although users of Adobe Exchange
  206. can add notes to the documents.
  207.  
  208. The User Manual is also included in plain text format, as VP21USER.TXT,
  209. for easier viewing and searching on less powerful machines.
  210.  
  211.  
  212. Contact Address
  213. ~~~~~~~~~~~~~~~
  214.   Feedback should be directed to
  215.  
  216.   Support issues:       support@vpascal.com
  217.   Registrations:        registrations@vpascal.com
  218.   Bug reports:          feedback@vpascal.com
  219.   Other issues:         vpascal@vpascal.com
  220.  
  221.   WWW:                  http://www.vpascal.com
  222.  
  223. Trademarks
  224. ~~~~~~~~~~
  225.   Company names, brand names and product names are trademarks or
  226.   registered trademarks of their respective holders.
  227.