home *** CD-ROM | disk | FTP | other *** search
/ QBasic & Borland Pascal & C / Delphi5.iso / Pascal / BPASCAL.700 / D1 / README < prev    next >
Encoding:
Text File  |  1992-10-01  |  14.8 KB  |  387 lines
  1.             Welcome to Borland Pascal with Objects 7.0
  2.             ------------------------------------------
  3.  
  4. This README file contains important, last minute information
  5. about Borland Pascal with Objects 7.0. In addition to this file,
  6. there are several files in the \BP\DOC directory that you should
  7. browse.
  8.  
  9.  
  10. TABLE OF CONTENTS
  11. -----------------
  12. 1. How to get help
  13. 2. Brief introduction to DOS Protected Mode Interface (DPMI)
  14. 3. Installation
  15. 4. New Features
  16. 5. Release Notes
  17. 6. Important note for Borland C++ and Paradox 4.0 users
  18.  
  19.  
  20. 1. HOW TO GET HELP
  21. ------------------
  22. If you have any problems, please read this file, the online
  23. documentation files in \BP\DOC, the online help files, and the
  24. Borland Pascal manuals first. If you still have a question and
  25. need assistance, help is available from the following sources:
  26.  
  27. 1. Type GO BPROGA on the CompuServe bulletin board system. If you
  28.    are not a member of CompuServe, see the enclosed special
  29.    offer.
  30.  
  31. 2. Check with your software dealer or user group.
  32.  
  33. 3. Write to us:
  34.  
  35.    Borland International
  36.    Borland Pascal with Objects 7.0 Technical Support, Dept 26
  37.    1800 Green Hills Road
  38.    P.O. Box 660001
  39.    Scotts Valley, CA  95067-0001
  40.  
  41.    Please include your serial number or we will be unable to
  42.    process your letter.
  43.  
  44. 4. If you have an urgent problem and you have sent in the license
  45.    agreement that accompanied this package, you can call the
  46.    Borland Technical Support Department at (408) 461-9177. Please
  47.    have the following information ready before calling:
  48.  
  49.    a. Product name and serial number from the distribution disks.
  50.  
  51.    b. Product version number. Both the IDE and the command-line
  52.       compiler display a version number when they are executed.
  53.  
  54.    c. Computer brand, model, and the brands and model numbers of
  55.       any additional hardware.
  56.  
  57.    d. Operating system and version number. (The version number
  58.       can be determined by typing VER at the DOS prompt.)
  59.  
  60.    e. If running Windows, the version and mode of your Windows
  61.       session. (From Program Manager, select Run from the File
  62.       menu, and enter "WINVER").
  63.  
  64.    f. Contents of your AUTOEXEC.BAT and CONFIG.SYS files.
  65.  
  66.  
  67. 2. BRIEF INTRODUCTION TO DOS PROTECTED MODE INTERFACE (DPMI)
  68. ------------------------------------------------------------
  69. Borland Pascal with Objects 7.0 includes DPMI-based tools, and
  70. allows you to produce DPMI applications. These applications gain
  71. access to all available extended memory by using a special mode
  72. of the computer's CPU, called protected mode. However, only 80286
  73. (and above) chips provide this capability. For this reason,
  74. Borland Pascal requires the following minimum configuration:
  75.  
  76.   Processor type  :  80286
  77.   DOS memory      :  640k
  78.   Extended memory :  1MB free
  79.  
  80. (On 80286 machines, it is recommended to have a memory manager
  81. such as HIMEM.SYS installed.  Refer to your DOS manuals for more
  82. information on memory managers.)
  83.  
  84. A protected mode application requires that the files DPMI16BI.OVL
  85. and RTM.EXE be located in the same directory as the application
  86. or on the DOS path. RTM.EXE provides the application with memory
  87. management services, while DPMI16BI.OVL is the DPMI server. You
  88. may also use other DPMI servers instead of DPMI16BI.OVL, such as
  89. the one provided by Windows when running in a DOS box.
  90.  
  91. Please refer to the Borland Pascal documentation for more
  92. information regarding protected-mode.
  93.  
  94.  
  95. 3. INSTALLATION
  96. ---------------
  97. Note: Borland Pascal with Objects 7.0 is not intended to be
  98. installed over any previous version of Turbo Pascal.
  99.  
  100. Use the INSTALL program to install Borland Pascal. The files on
  101. the distribution disks are all archived and INSTALL will
  102. de-archive them for you. INSTALL places them into subdirectories
  103. and automatically creates configuration files for the
  104. command-line compilers and the Integrated Development
  105. Environments (IDEs).
  106.  
  107. IMPORTANT: All further references to directory paths in this
  108. README file assume you've used INSTALL's default directory
  109. structure.
  110.  
  111. To start the installation, place the disk labeled INSTALL in
  112. Drive A:, and type A:INSTALL.
  113.  
  114. Borland Pascal allows you to create applications for these target
  115. platforms:
  116.  
  117.   o DOS real mode
  118.   o 16-bit DOS protected mode (DPMI)
  119.   o Windows
  120.  
  121. In addition, you can use either DOS or Windows as your host
  122. development environment. Both the DOS-hosted IDE (BP.EXE) and the
  123. Windows-hosted IDE (BPW.EXE) can produce applications for all
  124. three platforms.
  125.  
  126. You can disable target support for a particular platform by
  127. selecting the "Target Platforms" menu item (from the main install
  128. dialog box) and setting the target option to "Don't Install."
  129.  
  130. When you toggle any of the three target platforms (to either
  131. "Install" or "Don't Install"), the Install program automatically
  132. modifies the settings for the product components that relate to
  133. that platform.
  134.  
  135. Windows Installation Notes
  136. --------------------------
  137.  
  138.   o The following is a list of Windows .INI files and DLLs that
  139.     Install may modify:
  140.  
  141.     o WIN.INI - Temporarily modified if you install a Program
  142.       Manager group. The original WIN.INI is saved as WININI.OLD.
  143.       The next time you start Windows, the group creation program
  144.       will run and then WIN.INI will be restored to its original
  145.       state.
  146.  
  147.     o SYSTEM.INI - Modified if you install TDDEBUG.386.
  148.       The original file is saved as SYSINI.OLD. The line
  149.       "device=tddebug.386" is placed in the [386ENH] section, and
  150.       if the line "device=windebug.386" is present it is removed.
  151.  
  152.     o TDW.INI - Modified if you install Turbo Debugger
  153.       for Windows. The original file, if present, is saved as
  154.       TDWINI.OLD.
  155.  
  156.     o BPW.INI - Created if you install the Windows IDE
  157.       (BPW.EXE).
  158.  
  159.     o SYSTEM\BWCC.DLL - Overwritten with the BWCC version 1.3.
  160.       You can tell INSTALL where to place this file by selecting
  161.       "Directory Options", and changing the path for "BWCC.DLL".
  162.  
  163.  
  164. 4. NEW FEATURES
  165. ---------------
  166. Borland Pascal with Objects 7.0 offers many new features,
  167. including:
  168.  
  169.   o DOS protected-mode applications - Create DOS applications
  170.     that run in protected mode and gain access to all available
  171.     extended memory (up to 16 MB).
  172.  
  173.   o DOS DLLs - Produce DLLs (Dynamic-Link Libraries) for DPMI
  174.     applications. Using Borland Pascal with Object's WINAPI unit,
  175.     you can generate one Pascal DLL and use it in both DOS and
  176.     Windows programs. See \BP\EXAMPLES\COMMON\CHESS for an
  177.     extensive example of sharing a Pascal DLL between DOS and
  178.     Windows chess programs. See \BP\EXAMPLES\COMMON\GREP for an
  179.     extensive example of sharing a C DLL between DOS and Windows
  180.     programs.
  181.  
  182.   o Multi-target IDEs - Produce DOS, Windows, and protected mode
  183.     DOS applications from inside the same IDE (your choice of
  184.     Windows-hosted BPW or DOS protected mode-hosted BP).
  185.  
  186.   o ObjectBrowser - Browse units, objects, and symbols while you
  187.     edit your source code using either BP or BPW. Includes full
  188.     cross reference information for every identifier in your
  189.     program.
  190.  
  191.   o Syntax highlighting - Assign unique text colors (and font
  192.     attributes under Windows) for symbols, reserved words,
  193.     identifiers, strings, etc. You can also print your syntax
  194.     highlighted source code from inside the IDEs.
  195.  
  196.   o Tools menu in the IDEs that enable you to transfer control to
  197.     external programs, such as GREP or Turbo Assembler. You can
  198.     add your own tools to the Tools menu in the DOS IDEs.
  199.  
  200.   o Persistent browsing - BP and BPW save your program's symbol
  201.     information across sessions so you can instantly browse or
  202.     debug your program after exiting and then reloading the IDE.
  203.  
  204.   o User-installable help files in the DOS IDEs. Indexes from
  205.     multiple help files are automatically merged so you can
  206.     perform keyword or incremental searches.
  207.  
  208.   o Local Menus - A click of the right mouse button (or Alt+F10)
  209.     brings up a context-sensitive menu in all our new IDEs.
  210.  
  211.   o Optimizations and RTL enhancements
  212.  
  213.     o RTL now automatically recognizes 386 (or better) processors
  214.       and uses fast 32-bit instructions for longint arithmetic.
  215.     o Faster text file I/O.
  216.     o Faster string Pos routine.
  217.     o Optimized sets.
  218.     o Integer overflow checking {$Q+/-} - Integer, Word, etc.
  219.     o PChar support - Allows null terminated strings.
  220.     o OBJ file line number information pass-through - Allows
  221.       stepping through C or ASM code using the integrated
  222.       debugger.
  223.  
  224.   o Language extensions
  225.  
  226.     o Open array parameters {$P+/-} - Allows safer, more
  227.       flexible variable length array parameters.
  228.     o New OpenString type - Allows a procedure or function to
  229.       accept any type of string parameter, even in $V+.
  230.     o Constant parameters - Efficient, read-only value
  231.       parameters.
  232.     o Public/private sections - Allows public and private
  233.       sections of objects to be declared in any order.
  234.     o Typed @ operator {$T+/-} - Enforces type checking when
  235.       using the address (@) operator.
  236.     o Inherited reserved word - Allows references to an inherited
  237.       method without knowing the ancestor's name.
  238.  
  239.   o New standard procedures/functions
  240.  
  241.     o Assigned - Returns True if a pointer is not equal to nil
  242.       (especially useful for procedure and function pointers).
  243.     o Include - Adds an item to a set.
  244.     o Exclude - Removes an item from a set.
  245.     o Break & Continue - FOR, WHILE, REPEAT loop control.
  246.     o Low & High - Return the low or high bounds of open array
  247.       parameters or of any scalar type.
  248.  
  249.   o ObjectWindows enhancements
  250.  
  251.     o New printer objects to simplify printing in Windows.
  252.     o Data validation objects.
  253.  
  254.   o WinPrn unit - Enables easy printing of text files from
  255.     within your Windows programs.
  256.  
  257.   o Turbo Vision enhancements
  258.  
  259.     o Data validation objects.
  260.     o New outliner object.
  261.     o New methods for inserting/executing windows and dialog
  262.       boxes.
  263.     o Multi-state check boxes.
  264.     o Cluster items that can be disabled.
  265.  
  266.   o Turbo Debugger for DPMI (TDX.EXE) - Special version of Turbo
  267.     Debugger used for debugging DOS protected-mode applications.
  268.  
  269.   o Turbo Debugger for Windows now includes XGA/SVGA support for
  270.     several popular chip sets, including TSeng, Ultra, ATI, 8514,
  271.     and others.
  272.  
  273.   o Completely reorganized printed documentation, with new
  274.     tutorial programs.
  275.  
  276.   o Expanded online help system, covering all new features.
  277.  
  278. See the "What's new" section of the User's Guide for more
  279. information regarding the new features of Borland Pascal with
  280. Objects 7.0.
  281.  
  282.  
  283. 5. RELEASE NOTES
  284. ----------------
  285.  
  286.   o In ObjectWindows, the WObjects unit has been reorganized into
  287.     several smaller units to allow greater compatibility with DOS
  288.     units and easier compilation with debug information. It's
  289.     easy to modify your "uses" lists to reflect the new units: As
  290.     a general rule, any program that uses WObjects should now use
  291.     OWindows and ODialogs. Streams and collections are now found
  292.     in the Objects unit (which is shared between DOS and Windows
  293.     programs). Finally, the StdDlgs and StdWnds units have been
  294.     renamed to OStdDlgs and OStdWnds, respectively.
  295.  
  296.   o If you are using Windows 3.0, update your Windows Help system
  297.     (WINHELP.EXE and WINHELP.HLP) to the Windows 3.1 versions
  298.     which are in the \BP\BIN directory. You can safely overwrite
  299.     the 3.0 versions of these files with the 3.1 versions.
  300.  
  301.   o RTMRES.EXE - This program (found in \BP\BIN) causes the
  302.     Borland DPMI loader and server to be resident in memory. This
  303.     will speedup the loading of DPMI applications such as BP.EXE.
  304.  
  305.     If you have an 80286-based system and want to run BP.EXE in a
  306.     Windows standard-mode DOS box, you should run RTMRES before
  307.     running Windows. This is only necessary if you will run more
  308.     than one Borland protected-mode application at a time (BP
  309.     7.0, BC 3.x, Paradox 4.0, and so on).
  310.  
  311.     To use RTMRES.EXE for this purpose, specify the amount of
  312.     extended memory the Borland DPMI server should allocate,
  313.     using a DOS environment variable called DPMIMEM. For example:
  314.  
  315.       SET DPMIMEM=MAXMEM 2048
  316.  
  317.     This command, which can be executed from the DOS prompt or a
  318.     batch file, allocates 2 MB to the DPMI server and leaves all
  319.     remaining extended memory for Windows. Note that BP.EXE
  320.     requires a minimum of 1 MB of extended memory.
  321.  
  322.     The command-line syntax for RTMRES is:
  323.  
  324.       RTMRES [ProgName [arg1, arg2,...]]
  325.  
  326.     Where ProgName is the optional name of a program to
  327.     immediately execute (which avoids loading a copy of your
  328.     command processor if the program is an .EXE or .COM file).
  329.     You must include the program's extension, for example:
  330.  
  331.       RTMRES win.com
  332.  
  333.     The source code to RTMRES.EXE is located in
  334.     \BP\EXAMPLES\UTILS\RTMRES.PAS.
  335.  
  336.   o If you run BP.EXE from a Windows DOS box and want to modify
  337.     the BP.PIF file provided, make sure to specify at least 1 MB
  338.     XMS. Without a minimum memory setting, the DPMI application
  339.     may not be able to get the memory it needs; without a maximum
  340.     memory setting, the DPMI run-time manager (RTM) will grab
  341.     half of all available memory, slow Windows performance, and
  342.     prevent you from opening more than one or two Windows DOS
  343.     boxes.
  344.  
  345.  
  346. 6. IMPORTANT NOTE FOR BORLAND C++ AND PARADOX 4.0 USERS
  347. -------------------------------------------------------
  348. The DPMILOAD.EXE and DPMI16BI.OVL files provided with this
  349. release replace the older ones that came with Paradox 4.0 and
  350. BC++ 3.0 or later. Delete or rename the older versions and put
  351. \BP\BIN on your DOS path (so Paradox and BC can use the newer
  352. ones).
  353.  
  354. If you want to be able to run BC++ or Paradox from within BP.EXE,
  355. you will need to use the EXTLEAVE option for the RTM environment
  356. variable in order to leave enough memory available. For example,
  357. you can set aside 2 MB for other programs by using:
  358.  
  359.   SET RTM=EXTLEAVE 2048
  360.  
  361. See the printed documentation for more information regarding the
  362. RTM environment variable.
  363.  
  364. If you plan to shell out from Paradox or BC++ to run BP.EXE,
  365. limit the amount of extended memory used by those programs. For
  366. Paradox, use its /extk command-line parameter; and for BC++, use
  367. its /x command-line parameter. Refer to their documentation for
  368. more information on the use of command-line options.
  369.  
  370. Here's a summary for troubleshooting purposes:
  371.  
  372.   1.  Are there any copies of DPMILOAD.EXE or DPMI16BI.OVL on the
  373.       path prior to those provided \BP\BIN? Or in the same
  374.       directories as BC.EXE or PARADOX.EXE? If so, replace them
  375.       with BP 7.0's newer versions or remove them and set your
  376.       DOS path correctly.
  377.  
  378.   2.  Have you set the RTM environment variable? For example:
  379.  
  380.         SET RTM=EXTLEAVE 2048
  381.  
  382.   3.  If starting Paradox or BC first, have you used the required
  383.       command-line options?
  384.  
  385.                       *    *    *    *    *
  386.  
  387.