home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / VP21B274.ZIP / readme.txt < prev    next >
Text File  |  2003-10-18  |  8KB  |  236 lines
  1. -----------------------
  2.   Virtual Pascal v2.1
  3.     Build 274, Beta
  4.   Ottawa, November 2003
  5. -----------------------
  6.  
  7. Thank you for taking an interest in Virtual Pascal. This document outlines
  8. the installation procedure, and provides last-minute information not
  9. included in the online manuals.
  10.  
  11.  
  12. A note about units
  13. ------------------
  14.  
  15.   The VP installer uses SI units for disk space as detailed by this page:
  16.   http://physics.nist.gov/cuu/Units/binary.html
  17.  
  18.   This means that 1KiB is 1024 bytes and 1MiB is 1024*1024 bytes.  Using
  19.   the old-fashioned KB and MB is ambiguous as it sometimes means 1000
  20.   and sometimes 1024.  Expect to see this more often in the future :)
  21.  
  22.  
  23. Installation
  24. ------------
  25.  
  26. To install this version of Virtual Pascal 2.1
  27.  
  28.  - Extract all archives you have downloaded to a temporary directory, not
  29.    the one in which Virtual Pascal is to be installed. (Do not extract
  30.    the inner archives called W*.RAR, O*.Rar, L*.Rar, and A*.Rar; the
  31.    installation program will do this for you).
  32.  
  33.  - Run the appropriate installation program, SetupW32.Exe for Windows,
  34.    SetupOs2.Exe for OS/2 and setuplnx for Linux. This program is a text
  35.    mode Turbo Vision application compiled from the same source code for
  36.    all platforms - of course using Virtual Pascal to do so.
  37.  
  38.  - The licence agreement is displayed. Read it and press Alt-I or select the
  39.    Install option from the File menu to start the installation.
  40.  
  41.  - The welcome page of the installation wizard is displayed.
  42.  
  43.    Press the Next button to proceed.
  44.  
  45.  - On the next page, the pre-selection screen, choose from one of 3 default
  46.    options. Select "Full Install" to install all parts of the product and
  47.    "Everything That's Free" to install all of the free stuff.  Choose the
  48.    "Custom Setup" option to pick and choose.
  49.  
  50.    Note: If you choose Full Install or Custom Setup, you will need an
  51.    original copy of Borland Pascal and/or Delphi in order to complete
  52.    the installation.
  53.  
  54.    Press the Next button to continue.
  55.  
  56.  - If you chose Custom Setup, the next dialog allows you to choose
  57.    individual components to install. Review the settings, by using the
  58.    Detail button to review the inclusion of sub-components.
  59.  
  60.    Press the Next button to continue.
  61.  
  62.  - In Windows and OS/2, the next screen is used to select the drive to which
  63.    Virtual Pascal 2.1 should be installed; if a drive does not have enough
  64.    space to install the selected options, the drive space indicator will
  65.    be red. Ifinstalling to such a drive, you can insist that there is enough
  66.    space and continue anyway. The directory will be chosen on the next
  67.    screen.
  68.  
  69.    Press the Next button to continue.
  70.  
  71.  - Choose your preference regarding the case of directory names. You can
  72.    choose UPPER case, lower case or Mixed Case. All directories created
  73.    by the installation program will use the choice selected here.
  74.  
  75.    Press the Next button to continue.
  76.  
  77.  - Enter the installation directory, excluding drive letter. This can be any
  78.    directory (spaces not allowed), whether it exists or not. If it is a new
  79.    directory, the installation program will ask if it should be created for
  80.    you.  In Linux, the installation directory should start with a /, such
  81.    as /usr/local/vp21.
  82.  
  83.    Press the Next button to continue.
  84.  
  85.  - If any of the components requiring original source code were included
  86.    in the selection (Object Windows Library, Visual Class Library) you will
  87.    be prompted to enter the path to the original sources.
  88.  
  89.    Press the Next button to continue.
  90.  
  91.    If any of the required source files are not found, an error message
  92.    will be displayed and you will be prompted to enter a new path.
  93.  
  94.  
  95. While you wait
  96. --------------
  97.  
  98.   The installation program will now unpack the selected archives and copy
  99.   (and patch, where required) the selected source code.
  100.  
  101.   When it has finished, please read the rest of this readme file. Or, since
  102.   all of the platforms supported by VP are multitasking systems you can just
  103.   read it while the installation program is running. The OS/2 programs are
  104.   installed to the bin.os2 directory, the Win32 programs to bin.w32 and the
  105.   files used for the experimental Linux support to bin.lnx.
  106.  
  107.   Full information about Virtual Pascal, the directory structure, etc. is
  108.   included as .PDF manuals readable by the free Adobe Acrobat viewer v3.0
  109.   or later. These files can be found in the DOC directory.
  110.  
  111.  
  112. Acknowledgements
  113. ----------------
  114.  
  115.   This version of Virtual Pascal is dedicated to my dear and loving wife,
  116.   Mamta. She supports me in everything I do - if it wasn't for her, VP
  117.   would not have happened so you can thank her too :)
  118.  
  119.   I also wish to thank everybody who has contributed to VP over the years.
  120.   Many, many people have downloaded and used the software (around 100.000!)
  121.   and several dedicated individuals have contributed significantly.  Thanks!
  122.  
  123.  
  124. Upgrade Patches
  125. ---------------
  126.  
  127.   The upgrade patches for non-VP source code included with this software is
  128.   version specific. This means that the update program requires an original,
  129.   unmodified source file in order to be able to perform the update.
  130.  
  131.   The following versions can be upgraded to compatibility with Virtual
  132.   Pascal:
  133.     Visual Component Library (Requires Borland Delphi)
  134.       Delphi v1.00
  135.       Delphi v2.00-v2.01
  136.       Delphi v3.00
  137.       Delphi v4.01
  138.       Delphi v5.00
  139.       Delphi v5.01
  140.  
  141.     Object Windows Library (Requires Borland Delphi or Pascal)
  142.       v7.00 (BP v7.0 or BP for Windows)
  143.       v8.00 (Delphi v1.00)
  144.       v8.01 (Delphi v1.01)
  145.  
  146.  
  147. Known Issues
  148. ------------
  149.  
  150.   This release of Virtual Pascal v2.1 has several known issues.  Please
  151.   create an account and log in to the VP Bugs Database for the latest
  152.   information.
  153.  
  154.   The database can be accessed at http://www.vpascal.com/bugs.
  155.  
  156.  
  157. What is new
  158. -----------
  159.  
  160.   This build adds new features and fixes several problems reported in the
  161.   previous builds 243 and 270.  For a complete list of new features and 
  162.   fixes, please refer to the whatsnew.txt file.
  163.  
  164.  
  165. Feedback
  166. --------
  167.  
  168.   I welcome your feedback!  If you have suggestions for a new feature or
  169.   want to report a bug, please create an account in the VP Bugs Database
  170.   and file it there.
  171.  
  172.   The database can be accessed at http://www.vpascal.com/bugs.
  173.  
  174.  
  175. Licence
  176. -------
  177.  
  178.   Virtual Pascal is Copyright (C) Virtual Pascal 2003 by vpascal.com
  179.   and must not be distributed or copied except as allowed by the terms
  180.   of the licence.
  181.  
  182.   Please refer to licence.txt for the full licence.
  183.  
  184.  
  185. Manuals
  186. -------
  187.  
  188.   Comprehensive manuals covering the use of Virtual Pascal v2.1 and a
  189.   completelanguage reference are included as Adobe Portable Document
  190.   Format (PDF) files in the DOC directory.
  191.  
  192.   The User's guide, vp21user.pdf, introduces the installation program,
  193.   features of VP v2, IDE usage, debugger, and cross-platform support.
  194.  
  195.   The Language Reference, vp21lang.pdf, provides in-depth documentation
  196.   of the Pascal language as implemented by Virtual Pascal.
  197.  
  198.   Both documents can be viewed using the widely available free Adobe Acrobat
  199.   Reader v3.0 or later, and can be printed to provide a hard copy manual.
  200.   Download Acrobat Reader from Adobe's web site. The manuals are secured
  201.   from changing, although users of Adobe Exchange can add notes to the
  202.   documents.  The User Manual is also included in plain text format, as
  203.   vp21user.txt for easier viewing and searching on less powerful machines.
  204.  
  205.  
  206. More information
  207. ----------------
  208.  
  209.   To get more information about VP, I encourage you to set up an account at
  210.   www.vpascal.com - make use of the forums, etc.
  211.   
  212.   You can also join the Virtual Pascal mailing list hosted on topica.com.
  213.   To subscribe to it, send an email to virtualpascal-subscribe@topica.com.
  214.  
  215.  
  216. Contact Address
  217. ---------------
  218.  
  219.   Feedback can be directed to one of the following addresses:
  220.  
  221.   Support issues          support@vpascal.com
  222.   Other issues            vpascal@vpascal.com
  223.   News                    http://www.vpascal.com
  224.  
  225.  
  226. Trademarks
  227. ----------
  228.  
  229.   Company names, brand names and product names are trademarks or registered
  230.   trademarks of their respective holders.
  231.  
  232.  
  233. Copyright (C) 1999-2003 Allan Mertner and vpascal.com
  234.  
  235.  
  236.