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