home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Internet 2000 May / MICD_2000_05.iso / CBuilder5 / INSTALL / README.TXT < prev    next >
Text File  |  2000-01-31  |  41KB  |  1,216 lines
  1. ===============================================
  2. C++BUILDER 5 TRIAL 
  3. RELEASE NOTES
  4. ===============================================
  5.  
  6. This file contains important supplementary and 
  7. late-breaking information that may not appear 
  8. in the main product documentation. We recommend
  9. that you read this file in its entirety.
  10.  
  11. This document may contain references to 
  12. features that are not included in the Trial
  13. edition. Please ignore these items, as well as 
  14. the edition markings ("Enterprise, Professional, 
  15. Standard", etc.) that are contained in this and 
  16. other documentation.
  17.  
  18. For information on new features in this release,
  19. choose "What's New" in the online Help contents.
  20.  
  21. **** IMPORTANT ****
  22. Distributing applications generated with this
  23. Trial version is prohibited.
  24.  
  25. CONTENTS
  26. ===============================================
  27.  
  28. -- OTHER RELEASE NOTES 
  29.       INCLUDED WITH THIS PRODUCT
  30.  
  31. -- ABOUT EDITING THE WINDOWS REGISTRY
  32.  
  33. -- THIRD-PARTY PRODUCT NOTES 
  34.       AND KNOWN ISSUES
  35.  
  36. -- KNOWN ISSUES IN THIS RELEASE
  37.  
  38. -- ADDITIONAL COMPATIBILITY NOTES
  39.  
  40. -- ONLINE HELP OMISSIONS, 
  41.       CORRECTIONS, AND CLARIFICATIONS
  42.  
  43. -- PRODUCT INFORMATION ON THE WEB
  44.  
  45.  
  46. OTHER RELEASE NOTES 
  47. INCLUDED WITH THIS PRODUCT
  48. ===============================================
  49.  
  50. INSTALL.TXT contains system requirements 
  51. and product installation information.
  52.  
  53. DEPLOY.TXT contains information about 
  54. redistributing your applications. 
  55.  
  56. LICENSE.TXT contains information on 
  57. licensing allowances and limitations for this 
  58. product and other Inprise software that is 
  59. bundled with it.
  60.  
  61. The three text files listed above, along with
  62. this file, are installed to your main product
  63. directory (default: c:\Program Files\Borland\CBuilder5).
  64.  
  65. You can also find detailed information about new
  66. features and compatibility issues in 
  67. BCB5NEW.HLP, which is part of the main online 
  68. Help system (look for "What's New" in the Help 
  69. contents or index).
  70.  
  71. BDEREADME.TXT, BDEINST.TXT and 
  72. BDEDEPLOY.TXT contain release notes, 
  73. installation, and deployment information about 
  74. the Borland Database Engine (BDE) and 
  75. Borland SQL Links products. These files are 
  76. located in your main BDE directory 
  77. (installation default: 
  78.   c:\Program Files\Common Files\Borland Shared\Bde).
  79. IMPORTANT: Any BDE-related information in this
  80. README.TXT overrides any corresponding information
  81. provided in the BDE release notes.
  82.  
  83. Additional notes about existing issues with BDE 
  84. and utility applications supplied with BDE are 
  85. covered in the KNOWN ISSUES section later in 
  86. this document.
  87.  
  88.  
  89. ABOUT EDITING THE WINDOWS REGISTRY
  90. ===============================================
  91.  
  92. Warning: 
  93. Registry edits are performed at your own risk.
  94.  
  95. Several items in this document and in other 
  96. parts of the documentation that accompany this 
  97. product describe how to edit your Windows 
  98. registry. In most cases, we recommend that you 
  99. use the Microsoft Regedit tool to perform your 
  100. editing. Whatever tool you use, however, you 
  101. should, before making any edits, make backups
  102. of your registry and thoroughly familiarize
  103. yourself with the editing tool and the 
  104. registry editing process. The registry is a 
  105. critical component of your operating system, 
  106. and any mistakes made while editing it can 
  107. cause your machine to stop functioning.
  108.  
  109.  
  110. THIRD-PARTY PRODUCT NOTES 
  111. AND KNOWN ISSUES
  112. ===============================================
  113. The following items describe issues and problems
  114. you may encounter when using this product with 
  115. other tools and applications. Additional 
  116. third-party and external application issues may 
  117. also appear in the KNOWN ISSUES section.
  118.  
  119. Microsoft ImageList common control 
  120. and video drivers
  121. -----------------------------------------------
  122. Some older video drivers (S3 Virge GX, Diamond 
  123. Viper, Riva TNT, Matrox Millennium, and others) 
  124. have trouble handling the quantity of images 
  125. that the component palette places in its internal 
  126. ImageList control. This can cause the component 
  127. icons to appear shifted or corrupted in the IDE 
  128. component palette. The solution is to contact 
  129. your video card vendor for an updated video 
  130. driver. At the time of this writing, all of the
  131. video drivers known to exhibit problems with 
  132. the Microsoft ImageList control have been 
  133. updated with fixes by the video card vendors.
  134.  
  135. You can also work around this ImageList problem 
  136. by reducing or disabling video hardware 
  137. acceleration in your Windows configuration 
  138. settings. For instructions, consult your operating
  139. system and video hardware documentation.
  140.  
  141. If IDL2CPP won't start
  142. -----------------------------------------------
  143. (Enterprise and Professional editions only)
  144.  
  145. If an older version of the JavaSoft JRE is
  146. installed on your machine (if, for example,
  147. you installed VisiBroker with Delphi 5), you
  148. may receive an error message when attempting
  149. to run the command-line application IDL2CPP.
  150. Cause: The older JRE is probably still
  151. referenced on your path.
  152. Solution: Change your path to point to the
  153. new Java 1.2 JRE installed with C++Builder 5.
  154.  
  155. Microsoft Transaction Server (MTS)
  156. -----------------------------------------------
  157. (Enterprise and Professional editions only)
  158.  
  159. If MTS is installed after this product has 
  160. been installed, additional steps must be taken
  161. to enable use of the BDE as a resource dispenser
  162. (to pool database connections):
  163.  
  164. 1. Copy DISP.DLL from the RUNIMAGE directory 
  165.    on your product CD into the BDE directory 
  166.    on the host computer.
  167. 2. Issue the following command:
  168.     REGSVR32 <BDE directory>\DISP.DLL
  169. 3. In Transaction Server Explorer, install the
  170.    BDE-MTS package:
  171.      a. Right-click on Packages Installed.
  172.      b. Choose New | Package.
  173.      c. Choose Install prebuilt packages.
  174.      d. Add file DISP.PAK from the BDE 
  175.         directory.
  176. 4. Set the value of MTS POOLING to True in 
  177.    the System/Init section of the BDE 
  178.    configuration.
  179.  
  180. Microsoft icon cache prevents icon updating
  181. -----------------------------------------------
  182. If running this product on a Windows 95 or 98 
  183. machine on which an earlier version of the
  184. product was previously installed (even if it 
  185. is no longer present), the earlier version's
  186. icon set may persist in its association to 
  187. applications for this product, overriding the 
  188. new icon set. This is a known problem with 
  189. Microsoft's icon cache updating mechanism on 
  190. Windows 95/98. To read about the problem and 
  191. its solution:
  192. 1. Visit the Microsoft KnowledgeBase at
  193.    http://support.microsoft.com/search/default.asp
  194. 2. Choose Search All Microsoft Products from the
  195.    listbox.
  196. 3. Choose the "Keywords" option. 
  197. 4. In Search Options (lower part of the page), 
  198.    choose to search against Titles. 
  199. 5. Type the phrase "icons randomly change" 
  200.    (no quotes) into the Question field. The search 
  201.    should yield a number of article titles, any of
  202.    which should lead you to a resolution.
  203.  
  204. IntelliMouse driver v2.2
  205. -----------------------------------------------
  206. Version 2.2 of the Microsoft IntelliMouse 
  207. driver writes an invalid value to the registry
  208. when it is installed. This default value can
  209. cause some applications, including this product,
  210. Outlook Express, and Windows Explorer, to
  211. crash. To correct the problem:
  212. 1. Use Regedit to locate the key
  213.    HKEY_USERS\.Default\Control Panel\
  214.                Microsoft Input Devices\Mouse
  215. 2. If the value of TrayIcon is "ON", edit
  216.    the value to make it "TRUE" ("FALSE"
  217.    works as well).
  218.  
  219. ODBC certification
  220. -----------------------------------------------
  221. (Enterprise and Professional editions only)
  222.  
  223. The following ODBC drivers  are certified for 
  224. use with this product and BDE.
  225.  
  226. ODBC Driver Manager 3.5
  227.  
  228. Fully certified drivers:
  229.  
  230. ACCESS (Microsoft 3.40-Access 95 and 97)
  231. FOXPRO (Microsoft 3.40)
  232. MSSQL Server (Microsoft 3.00-Server version 6.5)
  233. MSSQL Server (Intersolv 3.01-Server version 6.5)
  234. ORACLE 7 (Intersolv 3.01-Server version 7.3)
  235.  
  236. Certified for basic functionality:
  237.  
  238. INFORMIX (Intersolv 3.01
  239.     - Server version 7.20 and 9.11)
  240. DB2 (IBMv5 client 6/98
  241.     - No driver version info available: 
  242.       tested against 2.12 and 5.0(UDB) server
  243. SYBASE (Intersolv 3.01
  244.     - Server version 11.02)
  245.  
  246. ODBC Driver Manager 3.51
  247.  
  248. Fully certified drivers:
  249.  
  250. ACCESS (Microsoft 3.51-Access 95 and 97)
  251. FOXPRO (Microsoft 3.51)
  252. MSSQL Server (Microsoft 3.6
  253.     - Server version 6.5 and 7.0)
  254. MSSQL Server (Intersolv 3.11
  255.     - Server version 6.5 and 7.0)
  256. ORACLE7 (Intersolv 3.11
  257.     - Server version 7.3)
  258.  
  259. Certified for basic functionality:
  260.  
  261. DB2 (IBMv5 client 6/98
  262.     - No driver version info available: 
  263.       tested against 2.12 and 5.0(UDB) server
  264. SYBASE (Intersolv 3.11
  265.     - Server version 11.02)
  266. ORACLE8 (Intersolv 3.11
  267.     - Server version 7.3 and 8.04)
  268.  
  269. Microsoft rich edit control in Asian locales
  270. -----------------------------------------------
  271. The Microsoft rich edit control may not be able
  272. to save eight-bit European extended characters 
  273. when running under Asian (multibyte) versions 
  274. of Windows 2000.
  275.  
  276. Using the Global IME under Windows 95 and 98
  277. -----------------------------------------------
  278. If you are using an Asian (multibyte) version 
  279. of Windows 95 or 98 and you install the Global 
  280. IME, you may have trouble running programs in 
  281. debug mode. Specifically, you may get access 
  282. violations when you quit the program (by 
  283. choosing Run|Reset) after a runtime exception. 
  284. You can avoid this problem by adjusting your 
  285. Windows settings as follows: From the Control 
  286. Panel, select Keyboard|Input Locales, uncheck 
  287. "Enable indicator on taskbar," and click OK.
  288.  
  289.  
  290. KNOWN ISSUES IN THIS RELEASE
  291. ===============================================
  292.  
  293. Header file optimization and failed builds
  294. -----------------------------------------------
  295. (Enterprise and Professional editions only)
  296.  
  297. If a build fails with "can't find symbol" errors
  298. or with errors that suggest that structures can't
  299. be defined, you may need to add the following:
  300. NO_WIN32_LEAN_AND_MEAN
  301. to your project defines. This forces the .HPP 
  302. files in your project to include more of the Win32 
  303. header files, and should correct the build errors.
  304.  
  305. Such errors may be encountered if your project 
  306. includes a Pascal component that uses structures 
  307. from the ActiveX or shell object libraries
  308. ACTIVEX.HPP, SHLOBJ.HPP, or URLMON.HPP.
  309. (Structures were removed from these files to 
  310. reduce overall build times).
  311.  
  312. Type Library import issue
  313. -----------------------------------------------
  314. (Enterprise and Professional editions only)
  315.   
  316. Certain servers export properties which, 
  317. at the COM level, are arrays of VARIANT. 
  318. These servers, when imported in C++Builder, 
  319. cannot be given VCL-style properties because 
  320. the getters and setters are of inconsistent 
  321. types: arrays TVariant and TVariantInParam, 
  322. respectively. (The getters and setters 
  323. themselves will work without problem.) The 
  324. importer unfortunately attempts to generate 
  325. these VCL properties, and the resulting code 
  326. fails to compile.
  327.  
  328. An example:
  329.  
  330. 1. Select Project|Import type library.
  331. 2. Click Add.
  332. 3. Select the Excel8.olb type library.
  333. 4. Install the components into the default 
  334.    user package.
  335. 5. Compile the package.
  336. Result:
  337. //[C++ Error] Excel_OCX.h(2186): 
  338.   E2347 Parameter mismatch in read access 
  339.   specifier of property Range
  340. //[C++ Error] Excel_OCX.h(4141): 
  341.   E2347 Parameter mismatch in read access 
  342.   specifier of property Range
  343. //[C++ Error] Excel_OCX.h(4611): 
  344.   E2347 Parameter mismatch in read access 
  345.   specifier of property Range
  346.  
  347. BDE/COM+ limitation
  348. -----------------------------------------------
  349. (Enterprise and Professional editions only)
  350. There is no resource dispenser for the BDE 
  351. under COM+.
  352.  
  353. Using PACKAGE to export forms and datamodules
  354. -----------------------------------------------
  355. Using the class modifier PACKAGE to export 
  356. forms and datamodules prevents correct object 
  357. creation when not used in a forward declaration.
  358.  
  359. Workaround:
  360. Use the PACKAGE modifier only in a forward 
  361. declaration:
  362.  class PACKAGE TDataModule1;
  363.  class TDataModule1 : public TDataModule
  364.  
  365. SelectDirectory and inaccessible drives
  366. -----------------------------------------------
  367. If a control uses SelectDirectory 
  368. (filectrl.hpp/.pas) to access a drive on a 
  369. Windows NT/2000 system, and the drive is 
  370. inaccessible (e.g., the control attempts to 
  371. access drive A, and no disk is in the drive), 
  372. two system error messages are generated. In 
  373. addition, if a Hint is attached to the control 
  374. and the Hint is visible when the control is 
  375. activated, the Hint text will appear in the title 
  376. bar of the first error message. On Windows 95/98 
  377. systems, only one "drive not ready" error message 
  378. appears, and the Hint text is not picked up.
  379.  
  380. CodeGuard and custom packages
  381. -----------------------------------------------
  382. (Enterprise and Professional editions only)
  383.  
  384. We strongly recommend the practice of building
  385. and linking custom packages using the dynamic 
  386. runtime libraries (RTL). However, if you have 
  387. reason to use the static RTL when creating a 
  388. package, the package should be CodeGuarded IF
  389. the application using the package is CodeGuarded.
  390. Otherwise, the package will, when used with other 
  391. CodeGuarded elements, generate a Borland
  392. Memory Manager (BORLNDMM.DLL) warning. If you
  393. choose "yes" in the warning dialog, false leaks 
  394. will be reported. If you choose "no", memory 
  395. will not be tracked for leaks from that point
  396. onward, though CodeGuard will otherwise continue 
  397. to operate normally.
  398.  
  399. Windows2000 date issues
  400. -----------------------------------------------
  401. Windows 2000 uses the short date format of 
  402. "m/d/yyyy". Previous Windows versions used the
  403. "m/d/yy" format.
  404.  
  405. If a two-digit date is required, the value 
  406. of the variable "ShortDateFormat" may be set 
  407. programmatically to "m/d/yy".
  408.  
  409. Also, the short date format for Windows2000
  410. may be altered by selecting Regional Settings 
  411. in Control Panel.
  412.  
  413. Such system date defaults and modifications 
  414. should be considered carefully when handling
  415. any dates, but most particularly when using 
  416. the EncodeDate function of SysUtils.
  417.  
  418. Providing this function a two-digit year may 
  419. generate unexpected results. For instance, 
  420. passing the results of
  421.  
  422.     EncodeDate("96, 7, 11");
  423.  
  424. to DateToStr will yield the string "7/11/0096" 
  425. instead of "7/11/1996", as might be expected.
  426.  
  427. Integrated Translation Environment (ITE) issues
  428. -----------------------------------------------
  429. (Enterprise edition only)
  430.  
  431. If you make a copy of the directory that 
  432. contains your main project group, you should 
  433. manually edit the copied BPR file. Find the 
  434. line in the BPR file that says
  435.     RootDir=[directorypath] 
  436. and either replace [directorypath] with the 
  437. correct path or simply delete [directorypath] 
  438. (leaving "RootDir=" in place); if you delete 
  439. [directorypath], the ITE tools will query you 
  440. for a new root directory the next time you 
  441. access the project.
  442.  
  443. Under Asian versions of Windows 2000, 
  444. limitations of the Windows rich edit control 
  445. prevent the multiline editor from correctly 
  446. saving eight-bit European extended characters.
  447. (Also see earlier note regarding Asian
  448.  Locales in the Third Party Products section.)
  449.  
  450. The Resource DLL wizard requires a distinct 
  451. two- or three-letter file extension for each 
  452. translated version of a project it maintains. 
  453. For some languages that are written in both 
  454. Latin and Cyrillic characters, however, 
  455. Windows 2000 uses the same default extension 
  456. regardless of the character set. For example, 
  457. Uzbek in Latin characters (locale ID 443) and 
  458. Uzbek in Cyrillic (locale ID 843) both get the 
  459. extension UZB. If you want to maintain both 
  460. Latin and Cyrillic versions for such a 
  461. language, change the extension for one of the 
  462. translations when you run the Resource DLL 
  463. wizard.
  464.  
  465. ADO issues
  466. -----------------------------------------------
  467. (Enterprise and Professional editions only)
  468.  
  469. When using TADOTable or TADODataSet, an error
  470. may occur when retrieving a list of table names 
  471. from Microsoft SQL Server 6.5. To correct the 
  472. problem, you must install the latest 
  473. SQL Server 6.5 Service Pack (currently 5a), 
  474. or update the system catalog as described in 
  475. the MDACREADME.TXT file that accompanies 
  476. MDAC 2.1. 
  477.  
  478. When using the Filter property on the ADO
  479. dataset components, ADO requires a space  
  480. between operators and field names. 
  481. For example, field>0 fails, field > 0 works.
  482.  
  483. You cannot open tables or procedures that 
  484. contain mixed case names on Oracle servers 
  485. unless the names containing lower case letters
  486. are enclosed in quotation marks. Affects 
  487. ADODataSet, ADOCommand, ADOTable, and 
  488. ADOStoredProc objects.
  489.  
  490. The IndexName and Seek methods of TADODataSet 
  491. currently only work with the Microsoft Jet 4.0 
  492. provider when using a database file created with 
  493. Access 2000.
  494.  
  495. The Oracle provider included with the MDAC runtime 
  496. does not support Oracle 8 datatypes (CLOB, BLOB, 
  497. NVARCHAR2, NCHAR, etc.).
  498.  
  499. When using the Merant (Informix 7, 9) provider, 
  500. MSADO15.DLL generates an AV when working with
  501. Stored Procedure parameters.
  502.  
  503. ADO does not support case-sensitive filters
  504. or find operations.  Because of this, the
  505. FilterOptions and LocateOptions on the ADO
  506. dataset components do not respect the case
  507. sensitive option and always return case-insensitive
  508. results.
  509.  
  510. When opening tables or stored procedures on an 
  511. Oracle server, you must put double quotes around 
  512. any mixed case names as required by the server 
  513. ("TableName").
  514.  
  515. When using the ADO Dataset components on a 
  516. MIDAS application server, ensure that the
  517. Active property is set to false at design
  518. time to ensure that any Refresh after
  519. an update will return the correct data.
  520.  
  521. When using the TParameters::CreateParameters
  522. method, ADO requires that the size parameter
  523. be set to a value greater than zero if the
  524. value parameter is null.
  525.  
  526. When using the Microsoft Jet 3.51 provider,
  527. an error will occur if you bind values to
  528. boolean columns using ftBoolean.  The problem
  529. is corrected in the 4.0 provider.  You can
  530. bind the parameters as ftInteger to workaround
  531. the problem.
  532.  
  533. When using the pfXML option with the 
  534. TADODataSet.SaveToFile method, you
  535. must first install version 5.0 of Internet
  536. Explorer in order to reload the data.  The XML
  537. parser which is required to interpret the data
  538. is not included with the 2.1 MDAC runtime.
  539.  
  540. MIDAS\InternetExpress
  541. -----------------------------------------------
  542. (Enterprise edition only)
  543.  
  544. There is a known design-time problem when 
  545. building an Internet Express application 
  546. that uses a local provider: Each time the project 
  547. is reloaded, the XMLBroker Connected property 
  548. is reset to False, and you must manually reset
  549. it to True.
  550.  
  551. When a MIDAS server will not shut down as 
  552. expected: 
  553. A client Web application may not always be 
  554. able to shut down a MIDAS server launched via 
  555. an HTTP connection or via DCOM from an 
  556. InternetExpress client unless the DCOM user 
  557. account is set to "Interactive User" on the 
  558. server machine. To set this permission, run 
  559. DCOMCNFG.EXE on the server machine, choose 
  560. your MIDAS server from among the listed 
  561. Applications, press Properties, then 
  562. Identities, and select Interactive User. In 
  563. subsequent sessions, the server may be shut 
  564. down as expected.
  565.  
  566. "Invalid Filename" is returned trying to 
  567. Activate a ClientDataSet when:
  568. -- A MIDAS server has a provider located on a 
  569.    Novell network; or
  570. -- A ClientDataSet attempts to connect to a 
  571.    MIDAS server on another machine.
  572. The solution to both of these situations is the
  573. same as that described in the previous note 
  574. (set the MIDAS server Application Identity 
  575. to "Interactive User").
  576.  
  577. The Netscape browser does not support XML Islands,
  578. and, as a result, will crash with an out-of-memory
  579. error when the InternetExpress application 
  580. accesses MIDAS data with a very large data packet.
  581. This behavior also occurs if using Internet Explorer
  582. without XML Islands support (if using Islands, 
  583. it does not occur).
  584.  
  585. Current versions of the Netscape browser do not
  586. support Unicode. Thus, if you input DBCS 
  587. characters into a Dataset field, the characters
  588. will not display correctly in a Netscape 
  589. browser. This problem does not occur in 
  590. Internet Explorer.
  591.  
  592. InternetExpress clients accessing multibyte 
  593. character set (MBCS) data from a MIDAS 
  594. server will receive the error 
  595. "<MBCS fieldname>:name not found in rowset"
  596. unless the MIDAS server is running on an MBCS
  597. operating system.
  598.  
  599. MIDAS servers and NT
  600. -----------------------------------------------
  601. (Enterprise edition only)
  602.  
  603. When activating or running a MIDAS server 
  604. from the IDE or a Web server on a Windows NT 
  605. machine, you may receive the the following 
  606. error message: "The dynamic link library 
  607. BORLNDMM.DLL could not be found in the 
  608. specified path." 
  609.  
  610. To fix this problem: 
  611. -- Add the path to BORLNDMM.DLL and 
  612.    CC3250MT.DLL to your System path; or
  613. -- Copy the two files above to a directory
  614.    already specified in your System path; or
  615. -- Turn off "Dynamic RTL" on the MIDAS 
  616.    server's Project|Options|Linker tab.
  617.  
  618. ActiveX imports
  619. -----------------------------------------------
  620. (Enterprise and Professional editions only)
  621.  
  622. Note: This problem occurs only on machines
  623.       running Windows 98.
  624.  
  625. Importing certain OLE servers when running 
  626. this product under Windows 98 will result in the 
  627. generation of packages with invalid bitmaps. 
  628. These bitmaps will be replaced with the default 
  629. three-object icon when the package is installed 
  630. on the component palette.
  631.  
  632. To get the correct icons, re-import the server 
  633. under Windows NT and use the .dcr generated by 
  634. that import, rather than the .dcr generated 
  635. under Windows 98, when installing the package
  636. onto the palette.
  637.  
  638. Innocuous VCTOBPR warning
  639. -----------------------------------------------
  640. If you convert an ATL file using the VCTOBPR 
  641. utility, a message box informs you that the 
  642. file BCBATL.CPP will be added to your project. 
  643. The message is incorrectly identified as a 
  644. "warning" when, in fact, it is informational only.
  645.  
  646. Frames
  647. -----------------------------------------------
  648. Multilevel references and indirect event 
  649. calls are not automatically generated in 
  650. nested frames. Such multilevel functionality
  651. must be coded separately.
  652.  
  653. When creating templates from frames make sure 
  654. the frame source is saved before creating the
  655. template or adding the frame to the palette. 
  656. Doing so will avoid later problems if the frame
  657. is saved under a different name.
  658.  
  659. When using TChart components and frames on the 
  660. same form, changes to the components are not 
  661. inherited from frame to frame. 
  662. Recommendation: Do not change TChart component
  663. settings when using the components on forms 
  664. with frames.
  665.  
  666. Cached updates and master-detail relationships
  667. -----------------------------------------------
  668. (Enterprise and Professional editions only)
  669.  
  670. Cached Updates cannot be used effectively with
  671. TQuery components when doing master-detail 
  672. links (DataSource property). This is because 
  673. the detail query is reexecuted each time the 
  674. master record pointer moves. 
  675.  
  676. BLOB limitations
  677. -----------------------------------------------
  678. (Enterprise and Professional editions only)
  679.  
  680. When using ODBC, BLOB size is limited to 
  681. 1,000,000 (1 million, not 1 MB) bytes. 
  682. Attempting to post a larger record generates an
  683. "Invalid Blob Size" error.
  684.  
  685. You may experience more severe limitations 
  686. using BLOBs with SQL Anywhere. When using 
  687. that product, problems have been encountered 
  688. when trying to read BLOBs as small as 24-32K 
  689. in a dead query.
  690.  
  691. Images in a TTreeView
  692. -----------------------------------------------
  693. TTreeView cannot repaint a node's image when 
  694. its ImageIndex is set outside of 
  695. OnGetImageIndex (e.g., in a button click) 
  696. and OnGetImageIndex is assigned (if the event 
  697. handler is not assigned, it works correctly). 
  698. This is due to a limitation in the TreeView 
  699. control and is designed to avoid recursion. 
  700. A simple workaround is to call 
  701. TreeView.Invalidate after setting the 
  702. ImageIndex.
  703.  
  704. RichEdit controls
  705. -----------------------------------------------
  706. If CoInitializeEx is called with 
  707. COINIT_MULTITHREADED or CoInitFlags has 
  708. been set to COINIT_MULTITHREADED and you
  709. have a form containing a RichEdit control, 
  710. creation of the RichEdit control will fail. 
  711. If you need to use the RichEdit control in a 
  712. multi-threaded OLE server, subclass the control
  713. and override CreateParams in order to set the 
  714. correct style.
  715.  
  716. Note: the CoInitFlags are determined by the 
  717. settings on the ATL page of the project options 
  718. dialog. This page appears only in projects 
  719. that contain an _ATL unit.
  720.  
  721. Docking issues
  722. -----------------------------------------------
  723. On a dockable form, TreeViews will lose their 
  724. items when docking and undocking from a 
  725. docksite parented by an MDI form. 
  726. Workarounds:
  727. 1. Parent the TreeView to something other than
  728.    the docking form (such as a panel).
  729. 2. Use the TreeView's FloatingDockSiteClass 
  730.    form as the floating dock host.
  731.  
  732. Warning: Do not use duplicate menu names
  733. -----------------------------------------------
  734. If a form contains a menu control and all of the
  735. names in the menu control are not unique, an 
  736. error will occur if you use the form to create a 
  737. new inherited form. The error will occur, for 
  738. example, if two or more blank menu items exist.
  739.  
  740. Menu Shortcut Conflicts
  741. -----------------------------------------------
  742. Menu shortcuts in the IDE may conflict with 
  743. system shortcuts and international character key
  744. combinations. If you want to disable the Ctrl+Alt 
  745. hot keys in the IDE, set this DWORD registry key:
  746.  
  747. HKEY_CURRENT_USER\Software\Borland\C++Builder\5.0\
  748.    Editor\Options\NoCtrlAltKeys to "1"
  749.   
  750. BDE and related utility application issues
  751. -----------------------------------------------
  752. (Enterprise and Professional editions only)
  753.  
  754. A threading problem occurs if you set the 
  755. session property sesCFGMODE2 to cfgmVirtual
  756. and/or cfgmSession (though cfgmPersistent 
  757. works). Specifying either of the two noted
  758. settings can cause a GPF in your program.
  759.  
  760. A mismatch between Oracle client and server 
  761. versions can cause BLOB and CLOB access 
  762. problems. SQL Links is not certified to 
  763. overcome this limitation. 
  764. Details: BLOB and CLOB access problems will 
  765. be encountered when an Oracle 8.1.5 client 
  766. communicates with an Oracle 8.0.4 server.
  767. (This product is certified only with the 
  768. Oracle 8.1.5 client/Oracle 8.1.5 server 
  769. configuration.)
  770.  
  771. TStoredProc components that attempt to get an
  772. spParamList value from an invalid stored
  773. procedure will cause an AV in ORACLIENT8.DLL.
  774. To avoid this problem, make sure the procedure
  775. is valid on the server.
  776.  
  777. Using TQuery with Oracle 8 BLOBs and CLOBs
  778. -----------------------------------------------
  779. (Enterprise and Professional editions only)
  780.  
  781. Accessing BLOB/CLOB in ORACLE 8 requires a 
  782. LOB locator. The SQL statements for inserting 
  783. LOBS using TQuery is as follows:
  784.  
  785. INSERT INTO LOBTAB ( F_BLOB, F_CLOB) VALUES 
  786. ( EMPTY_BLOB( ), EMPTY_CLOB() ) RETURNING 
  787. F_BLOB, F_CLOB INTO :P1, :P2
  788.  
  789. Here, parameter P1, P2 should be bound as 
  790. OraBlob and OraClob, respectively, and the 
  791. BLOB values can be assigned to the parameters.
  792. SQL Links internally gets the locators from 
  793. the returning clause of the above query and 
  794. populates the LOB.
  795.  
  796. Similarly, an update SQL statement would read:
  797.  
  798. UPDATE LOBTAB SET F_CLOB = EMPTY_CLOB( ) 
  799. RETURNING F_CLOB INTO :P1
  800.  
  801. Oracle 8, VARRAYs and ADTs
  802. -----------------------------------------------
  803. (Enterprise and Professional editions only)
  804.  
  805. An application can crash when opening an 
  806. Oracle 8 table that contains a large VARRAY of 
  807. ADTs. Oracle recommends using nested tables
  808. instead of VARRAYs when such configurations are
  809. required.
  810.  
  811. Other issues
  812. -----------------------------------------------
  813. Starting C++Builder 5 in Safe Mode on a 
  814. Windows 98 machine may cause the IDE to hang.
  815.  
  816. COM+ event client support
  817. -----------------------------------------------
  818. (Enterprise and Professional editions only)
  819.  
  820. In the Help topic entitled "Handling events in 
  821. an Automation Controller" (index keyphrase:
  822. "Automation controllers, handling events"), a
  823. reference is made to a global routine named
  824. RegisterComPlusEventSubscription. This function
  825. is not available in this release.
  826.  
  827.  
  828. ADDITIONAL COMPATIBILITY NOTES
  829. ===============================================
  830. The following items describe compatibility 
  831. issues between this release and earlier versions
  832. of the product, as well as issues that may
  833. arise between this product and other products.
  834.  
  835. NOTE: The information below was confirmed late
  836. in the development process and may not appear 
  837. in the online Help system's "Compatibility
  838. Issues" section.
  839.  
  840. Windows 2000 support
  841. -----------------------------------------------
  842. Applications generated by the Windows 2000 
  843. logo application wizard will run ONLY on
  844. Windows 2000.
  845.  
  846. CORBA, BCB4, and VBroker 3.3
  847. -----------------------------------------------
  848. (Enterprise editions only)
  849.  
  850. CORBA projects created with C++Builder 4 and 
  851. VisiBroker 3.3 that reference cerr or cout may 
  852. not compile with C++Builder 5. If you use cerr 
  853. or cout and a compiler error is generated,
  854. either:
  855.  
  856. -- Change cerr and cout to Cerr and Cout, 
  857.    respectively; or
  858.  
  859. -- Add a line containing USE_STD_NS after the 
  860.    #includes at the top of the source file.
  861.  
  862. Cerr, Cout, and USE_STD_NS are defined in the 
  863. VisiBroker 4.0 header files. 
  864.  
  865. MIDAS.DLL replaces DBCLIENT.DLL
  866. -----------------------------------------------
  867. (Enterprise and Professional editions only)
  868.  
  869. When redistributing MIDAS clients, you must
  870. redistribute the new MIDAS.DLL with your
  871. applications. This file replaces DBCLIENT.DLL
  872. as the primary MIDAS support library.
  873. (DBCLIENT.DLL is also supplied to provide 
  874. support for earlier versions of MIDAS.)
  875.  
  876. DBTABLES has been split up
  877. -----------------------------------------------
  878. (Enterprise and Professional editions only)
  879.  
  880. Some members of DBTABLES have been moved to a
  881. new library called VCLBDE50. Consequently, when
  882. recompiling C++Builder 4 database applications,
  883. you may see linker errors indicating that 
  884. members of DBTABLES cannot be found. To build 
  885. these applications, you must manually add 
  886. VCLBDE50.LIB to your project file.
  887. To do so, follow these steps:
  888.  
  889. 1. Load the project in C++Builder.
  890. 2. Select File|Save All.
  891. 3. Close the project.
  892. 4. Open the project's .BPR file in an external
  893.    text editor.
  894. 5. Find the two lines that look like these:
  895.  
  896.    <LIBRARIES value="vcldb50.lib vcl50.lib"/>
  897.    <SPARELIBS value="vcl50.lib vcldb50.lib"/>
  898.  
  899.    (They may have more libraries listed.)
  900.    Add "vclbde50.lib" to the end of each line:
  901.  
  902.    <LIBRARIES value="vcldb50.lib vcl50.lib vclbde50.lib"/>
  903.    <SPARELIBS value="vcl50.lib vcldb50.lib vclbde50.lib"/>
  904.  
  905. 6. Save the project file.
  906. 7. Reopen the project in C++Builder.
  907.  
  908. Porting ActiveX control projects
  909. created in earlier versions
  910. -----------------------------------------------
  911. (Enterprise and Professional editions only)
  912.  
  913. Due to changes in the ATL's implementation of 
  914. persistent streaming, all VCL-based ActiveX 
  915. controls (created via File|New AX Control, 
  916. File|New AX Form, or File|New Property Page)
  917. that were created in previous versions of 
  918. C++Builder will not stream properly when 
  919. rebuilt under this version.
  920.  
  921. The problem is automatically corrected the first
  922. time you refresh inside the Type Library Editor
  923. --but is NOT corrected if you do not refresh.
  924.  
  925. In addition, the style of the header guard 
  926. used in C++Builder 4 ActiveX projects is not 
  927. consistent with the header guards used by the 
  928. C++Builder 5 IDE to determine if a file should 
  929. be managed. Please update the header guards in 
  930. server implementation files to be of the format: 
  931. <Filename>H
  932. e.g.:
  933. #ifndef Unit1H //this guard is case sensitive
  934. #define Unit1H
  935. //...header file code...
  936. #endif
  937.  
  938. OldCreateOrder and enabling the Legacy View
  939. -----------------------------------------------
  940. A reminder for those upgrading from C++Builder 3 
  941. that the TCustomForm::OldCreateOrder property 
  942. was added in C++Builder 4. For C++Builder 5, 
  943. you may need to explicitly set this form property 
  944. to false in your existing C++Builder 3 programs 
  945. that use OnCreate or OnDestroy. For example, you
  946. may see access violations when running an upgraded
  947. C++Builder 3 application if (in error) a String 
  948. variable is set to NULL before the form's destroy 
  949. handler is called. A program might set a String to 
  950. a file name in an OnCreate and then save text to 
  951. that file in an OnDestroy. In the OnDestroy 
  952. handler, the contents of the String would be gone 
  953. unless the OldCreateOrder property were set to false.
  954.  
  955. Also note that in C++Builder 5, the legacy 
  956. OldCreateOrder property is turned off by default 
  957. in the Object Inspector. To view this and other
  958. legacy properties, right-click on the Object 
  959. Inspector, choose View, and click Legacy.
  960.  
  961. Functions removed
  962. -----------------------------------------------
  963. (Enterprise and Professional editions only)
  964.  
  965. The DBError and DBErrorFmt functions no longer
  966. appear in the DB unit.
  967.  
  968. Earlier projects may require STDVCL32.DLL
  969. -----------------------------------------------
  970. Projects created in version 3 and earlier 
  971. releases require the presence of STDVCL32.DLL
  972. to enable their loading into the current
  973. release. When the older project is saved in 
  974. this release, it is upgraded to use the new 
  975. STDVCL40.DLL, and the older library is no 
  976. longer required for that project.
  977.  
  978. GraphicsServer component no longer included
  979. -----------------------------------------------
  980. The GraphicsServer component (GRAPH32.OCX)
  981. that shipped with earlier versions of this product 
  982. is no longer a part of the product. Information 
  983. about the GraphicsServer component is available 
  984. from the vendor at http://www.graphicsserver.com/
  985.  
  986.  
  987. ONLINE HELP OMISSIONS, 
  988. CORRECTIONS, AND CLARIFICATIONS
  989. ===============================================
  990.  
  991. The following items describe late-breaking
  992. features and elements that are either not 
  993. covered or require correction or clarification 
  994. in the online Help system that ships with 
  995. C++Builder 5. Most items include a title and
  996. keyword that will help you locate the affected
  997. topics. These issues will be corrected in future
  998. Help updates that will be made available on the
  999. documentation Web site (www.borland.com/techpubs).
  1000.  
  1001. TMonthCalendar, TMonthCalColors documentation
  1002. missing from Standard edition
  1003. -----------------------------------------------
  1004. Documentation for the TMonthCalendar and 
  1005. TMonthCalColors VCL components was omitted from
  1006. the Standard edition Help file set..
  1007.  
  1008. System::LeadBytes
  1009. -----------------------------------------------
  1010. Online Help reports the declaration for the
  1011. system variable LeadBytes as:
  1012.   extern PACKAGE System::Set<char, 0, 255> LeadBytes;
  1013. It should be:
  1014.   extern PACKAGE System::Set<byte, 0, 255> LeadBytes;
  1015.   
  1016. Delphi code
  1017. -----------------------------------------------
  1018. Delphi code appears in a number of third-party
  1019. topics, as well as in a number of topics in
  1020. the InterBase Express Help file. We are working
  1021. to resolve this issue, and will offer updated
  1022. files for download from the documentation
  1023. Web site (address below) as the code translations
  1024. are completed and tested.
  1025.  
  1026. -VM compiler switch
  1027. -----------------------------------------------
  1028. The topic describing the -VM compiler switch
  1029. (search Help index for "-VM compiler option")
  1030. is incorrect. It should read:
  1031.  
  1032. "This switch turns on __msreturn for all
  1033. functions, thus allowing the function to return
  1034. structs in a Microsoft-compatible fashion.
  1035. Structure contents, not a pointer to the
  1036. structure, are returned via the EAX/EDX
  1037. registers.
  1038.  
  1039. "-VM only affects the way a function returns a
  1040. struct and does not affect the name mangling.
  1041.  
  1042. "-VM affects all functions, regardless of
  1043. explicit calling conventions."
  1044.  
  1045. Additional information, -pm compiler switch
  1046. -----------------------------------------------
  1047. (Search Help index for "calling conventions".)
  1048.  
  1049. Additional information:
  1050.  
  1051. The -pm compiler switch is the -VM compiler
  1052. switch plus Microsoft-style name-mangling and
  1053. MS parameter-passing. -pm adds 'qm' to name
  1054. mangling when there is no modifier, or when
  1055. the modifier is __msreturn.
  1056.  
  1057. Additional information,
  1058. __msfastcall calling convention
  1059. -----------------------------------------------
  1060. (Search Help index for "__msfastcall".)
  1061.  
  1062. Additional information:
  1063.  
  1064. __msfastcall adds 'qm' to name mangling.
  1065.  
  1066. Error message clarification
  1067. -----------------------------------------------
  1068. Pressing F1 on the Compiler Error
  1069. "[Linker Fatal Error] Fatal: Expected a file 
  1070. name: " opens a topic with incomplete information.
  1071. The topic should read:
  1072. "This error always occurs during builds when 
  1073. C++Builder is installed into a directory with a 
  1074. + or - in the name, or a target file has an 
  1075. invalid path, or if a BPR file is corrupt."
  1076.  
  1077. Additional information,
  1078. Using files with CC and CXX file extensions
  1079. -----------------------------------------------
  1080. (Search Help index for "CC files".)
  1081.  
  1082. Additional usage information:
  1083.  
  1084. After you edit the CFLAG1 line and add the file
  1085. to the project, the project source includes this
  1086. line:
  1087.  
  1088. USE("foo.cxx", File);
  1089.  
  1090. This needs to be changed to:
  1091.  
  1092. USEUNIT("foo.cxx");
  1093.  
  1094. or the file will not compile.
  1095.  
  1096. When you make the USEUNIT change, you will see
  1097. an 'Edit Local Options' item on the local menu,
  1098. but the item will not be operable.
  1099.  
  1100. #import example missing
  1101. -----------------------------------------------
  1102. If you click the Example link in the topic
  1103. covering #import (BCB5LANG.HLP), only the
  1104. example heading appears in a popup window. The
  1105. example lines are:
  1106.  
  1107. #import "test.lib" no_namespace
  1108. or
  1109. #import "c:\path\typelib0.tlb"
  1110.  
  1111. Objects misnamed in online Help
  1112. -----------------------------------------------
  1113. (Enterprise and Professional editions only)
  1114.  
  1115. Due to a late change to an object name, the
  1116. new TCRemoteDataModule object may be incorrectly
  1117. identified as TCustomRemoteDataModule in the 
  1118. online Help system.
  1119.  
  1120. In online Help, instances of TWebBrowser should 
  1121. read TCppWebBrowser.
  1122.  
  1123. Snippet does not compile
  1124. -----------------------------------------------
  1125. (Enterprise and Professional editions only)
  1126.  
  1127. The code snippet offered in the Help topic
  1128. "Updating the object" (index keyphrase "property 
  1129. pages, updating the object") does not compile.
  1130.  
  1131.  
  1132. PRODUCT INFORMATION ON THE WEB
  1133. ===============================================
  1134. In addition to numerous private sites that 
  1135. offer C++Builder information, instruction, and 
  1136. samples, the following C++Builder/Inprise 
  1137. Web-based resources provide a continuous stream
  1138. of news, product information, updates, code, 
  1139. and other materials. You can connect to many of
  1140. these resources directly from the C++Builder 
  1141. Help menu.
  1142.  
  1143. C++Builder Direct [Help|C++Builder Direct]
  1144. -----------------------------------------------
  1145. This IDE add-in resource provides an 
  1146. automatically updated list of links to the 
  1147. latest news, downloads and other information 
  1148. about C++Builder and Inprise.
  1149.  
  1150. Code Central
  1151. -----------------------------------------------
  1152. The CodeCentral Repository is a free, 
  1153. searchable database of code, tips, and other 
  1154. materials of interest to developers. For details 
  1155. and registration information, visit 
  1156. http://community.borland.com/codecentral
  1157.  
  1158. The Borland/Inprise Web site
  1159. -----------------------------------------------
  1160. Borland/Inprise home page:
  1161.   http://www.borland.com or 
  1162.   http://www.inprise.com
  1163.   [IDE: Help|Borland Home Page]
  1164.  
  1165. C++Builder home page:     
  1166.   http://www.borland.com/bcppbuilder/
  1167.   [IDE: Help|C++Builder Home Page]
  1168.  
  1169. C++Builder developer support:
  1170.   http://www.borland.com/devsupport/bcppbuilder/
  1171.   [IDE: Help|C++Builder Developer Support]
  1172.  
  1173. Web-based bug-reporting system:
  1174.   http://www.borland.com/devsupport
  1175.   Then click the "Bug Reports" link,
  1176.   choose Borland C++Builder, and follow
  1177.   the instructions for bug submissions
  1178.  
  1179. C++Builder updates and other downloads:
  1180.   http://www.borland.com/devsupport/
  1181.        bcppbuilder/downloads/
  1182.   
  1183. C++Builder documentation site:
  1184.   http://www.borland.com/techpubs/bcppbuilder
  1185.  
  1186. Information for C++ developers:
  1187.   http://www.borland.com/bcppbuilder/cpp/
  1188.  
  1189. Information for Visual Basic developers:
  1190.   http://www.borland.com/bcppbuilder/vb/
  1191.  
  1192. Newsgroups:
  1193.   http://www.borland.com/newsgroups/
  1194.  
  1195. Electronic newsletter subscriptions:
  1196.   http://www.inprise.com/feedback/listserv.html
  1197. International list server:
  1198.   http://www.inprise.com/feedback/intlist.html
  1199.  
  1200. Worldwide offices and distributors:
  1201.   http://www.borland.com/bww/
  1202.  
  1203. Inprise FTP site (anonymous access):
  1204.   ftp.borland.com
  1205.  
  1206. TechFax
  1207. -----------------------------------------------
  1208. Technical documents are available via fax at:
  1209.   1-800-822-4269 (North America)
  1210.  
  1211.  
  1212. ===============================================
  1213. Copyright (c) 2000 Inprise Corporation. 
  1214. All rights reserved.
  1215.  
  1216.