home *** CD-ROM | disk | FTP | other *** search
/ PC Pro 1999 February / DPPCPRO0299.ISO / February / Delphi / Install / _SETUP.LIB / RELNOTES.TXT < prev    next >
Encoding:
Text File  |  1996-06-11  |  22.8 KB  |  564 lines
  1.             ----------------------------------------
  2.                           RELNOTES.TXT
  3.             ----------------------------------------
  4.  
  5. Welcome to Delphi Client/Server Suite 2.0 Release Notes.
  6. This file contains information about new features, last-minute
  7. details about the current release, and additional technical
  8. information.
  9.  
  10.  
  11. ----------------------------------------
  12. TABLE OF CONTENTS
  13. ----------------------------------------
  14. 1. OLE/OCX
  15. 2. ENHANCED DEBUGGING LIBRARIES
  16. 3. BORLAND DATABASE ENGINE (BDE)
  17. 4. INSTALLSHIELD EXPRESS
  18. 5. UPDATED HELP FILES
  19. 6. INTERNET SOLUTIONS PACK HELP
  20. 7. BORLAND PASCAL 7.0 COMPATIBILITY
  21. 8. DELPHI COMMERCIAL VIDEOS
  22.  
  23.  
  24. ----------------------------------------
  25.  1. OLE/OCX
  26. ----------------------------------------
  27. OCX support has been expanded in this release to support the
  28. recently announced Microsoft ActiveX specification.  When you
  29. install OCXs into the Delphi IDE, new OCX interface units are
  30. generated. OCX interface units generated with older versions
  31. of Delphi will not be able to take advantage of any of the new
  32. features.
  33.  
  34. The OCX import unit generator now uses the base part of the OCX
  35. file name as the suggested import unit name instead of deriving
  36. the import unit name from the ProgID. This fixes problems with
  37. controls that have the same base name in their ProgIDs (such as
  38. MSICP), and also generally ensures that import unit names are
  39. unique and have no more that eight characters.
  40.  
  41.  
  42.     IPerPropertyBrowsing interface
  43.     ----------------------------------------
  44.     The Object Inspector now supports the IPerPropertyBrowsing
  45.     interface to obtain the list of valid values for a particular
  46.     OCX property.  Some OCX controls use this interface instead
  47.     of enum types to indicate valid values for a property.
  48.  
  49.  
  50.     Context sensitive (F1) help
  51.     ----------------------------------------
  52.     Context sensitive F1 help for OCX controls is now available
  53.     in the form designer and Object Inspector.  Some OCX controls do
  54.     not provide help context information in their type libraries.
  55.  
  56.  
  57.     Component methods which call OLE object methods
  58.     ----------------------------------------
  59.     Passing null or "missing" parameters to component methods which
  60.     directly call an OLE object method (for example, TSMTP.Connect)
  61.     can be done in one of two ways:
  62.  
  63.      1) Refer to the component's OLEObject property.
  64.  
  65.         For example, if a method takes five parameters, and you
  66.         want three of them null:
  67.             MyComponent.OLEObject.Method(,,Param3,,Param5);
  68.  
  69.       2) Define a function called None, then pass that directly to the
  70.          component's method:
  71.             function None: Variant;
  72.               begin
  73.                 TVarRec(Result).VType = varError;
  74.                 TVarRec(Result).VError := DISP_E_PARAMNOTFOUND;
  75.               end;
  76.               ...
  77.               MyComponent.Method(None, None, Param3, None, Param5);
  78.  
  79.     There is a slight performance advantage to the latter method,
  80.     although it is minor compared to the overhead of actually
  81.     dispatching the OLE method itself.
  82.  
  83.  
  84. ----------------------------------------
  85.  2. ENHANCED DEBUGGING LIBRARIES
  86. ----------------------------------------
  87.     When an exception occurs in a program that is being debugged, the
  88.     debugger attempts to locate and display the line of source code
  89.     nearest to the machine instruction that raised the exception.
  90.     The debugger uses stack frames (markers placed on the stack) to
  91.     walk back through the call stack looking for a routine with
  92.     source code.  The VCL core units are not compiled with stack
  93.     frames enabled, so if an exception is raised in a VCL core unit,
  94.     the debugger may have difficulty determining the nearest line of
  95.     source code that caused the error.
  96.  
  97.     The SLIB directory contains a recompiled version of VCL with
  98.     stack frames enabled.  You can compile your applications with the
  99.     SLIB units to improve the debugger's ability to locate the source
  100.     code corresponding to runtime exceptions.
  101.  
  102.     To use these files, add the directory containing the SLIB DCU
  103.     files to your project's search path.  In the Delphi IDE, select
  104.     the Project Options menu, open the Directories/Conditionals page
  105.     and add the SLIB path to front of the Directories Search Path
  106.     list.  In the Compiler page of the same dialog, enable the Stack
  107.     Frames option.  Finally, recompile your program.
  108.  
  109.     Code compiled with these libraries will be slightly larger and
  110.     slightly slower.  If you wish to restore the original libraries
  111.     before deploying your application, remove the path to these
  112.     libraries from the Directories/Conditionals page, disable the
  113.     Compiler Stack Frames option, and rebuild your application.
  114.  
  115.  
  116. ----------------------------------------
  117.  3. BORLAND DATABASE ENGINE (BDE)
  118. ----------------------------------------
  119.  
  120.     Updated 16-bit BDE
  121.     ----------------------------------------
  122.     An updated version of the 16-bit BDE is included with this 
  123.     version of Delphi.  Users of previous releases of the 
  124.     16-bit BDE must install the updated version if they wish
  125.     to use both 16-bit and 32-bit versions of the BDE.  The
  126.     updated 16-bit version of  the BDE can be found on the CD
  127.    in the DELPHI16\REDIST\BDEINST directory.
  128.  
  129.     BDE Configuration Compatibility Resolution
  130.     ----------------------------------------
  131.     The previous version of Delphi included two BDE configuration
  132.     files (SYB32.CFG and MSS32.CFG) that avoided
  133.     incompatibilities in the 16-bit and 32-bit configurations,
  134.     allowing concurrent installation of both versions.  This
  135.     incompatibility has been resolved in the current 16-bit and
  136.     32-bit releases of the BDE.
  137.  
  138.     Updated SQL Links
  139.     ----------------------------------------
  140.     The updated Delphi 2.0 Client/Server Suite contains updated
  141.     versions of both 32-bit and 16-bit SQL Links.  The 16-bit
  142.     SQL Links includes a DB2 driver.
  143.  
  144.     To install the new 16-bit SQL Links, run SETUP.EXE in the
  145.     \SQL16\DISK1 directory. This installs both the updated
  146.     16-bit BDE and the updated 16-bit SQL Links.
  147.  
  148.     Delphi 1.0 and 16-bit BDE Installation
  149.     ----------------------------------------
  150.     Delphi 2.0 includes an installable version
  151.     of the last release of Delphi 1.0.  It can be found on
  152.     the CD in the \DELPHI16 directory.  It includes the
  153.     16-bit BDE version that was shipped with that release of
  154.     Delphi.
  155.  
  156.     If you have a more current version of 16-bit BDE
  157.     installed, the Delphi 1.0 installation program will
  158.     detect this and allow you to forgo installing the
  159.     previous version of BDE.
  160.  
  161.     If you install Delphi 1.0, and it installs 16-bit BDE,
  162.     you should then also install the latest version of 16-bit
  163.     BDE, which can be found on the CD in the
  164.     DELPHI16\REDIST\BDEINST directory.
  165.  
  166.  
  167.     All BDE Applications
  168.     ----------------------------------------
  169.     There is a problem when running a BDE application from a
  170.     directory without "write" access under the Windows NT operating
  171.     system.  If there is no "temp" directory defined for the system,
  172.     the error DBIERR_OSACCESS (OS Permission Denied) will occur
  173.     during the call to DbiInit.  To continue, a "temp" directory will
  174.     need to be created.  Consult your Windows NT manuals for
  175.     instructions on how to specify a "temp" directory.
  176.  
  177.  
  178.     All SQL Drivers
  179.     ----------------------------------------
  180.     If an Index is added to any SQL table, this may change the
  181.     record buffer size.  If the cursor is live, make sure to
  182.     close and then reopen the table.
  183.  
  184.  
  185.     ODBC Driver
  186.     ----------------------------------------
  187.     Version 2.0 of the MS-SQL ODBC driver provided by Microsoft
  188.     does not support DECIMAL or NUMERIC field types
  189.     (TTable.CreateTable will fail).  However the version 2.11
  190.     MS-SQL driver supplied by InterSolv does support the above
  191.     field types.
  192.  
  193.  
  194.     Schema Cache for SQL Drivers
  195.     ----------------------------------------
  196.     The schema cache option (i.e., "Enable Schema Cache" set to
  197.     true with BDECFG32) is designed to be used with static
  198.     databases.  Changes to the database while this option is
  199.     enabled may cause errors.
  200.  
  201.     You should not have the schema cache enabled if you
  202.     frequently:
  203.       - add columns to a table
  204.       - add/drop indexes from a table
  205.       - change validity checks on fields (i.e., "not null"
  206.         added or removed)
  207.  
  208.     A good sign that a database is not static enough to use schema
  209.     cache is if "Unknown SQL Errors" are returned whose error context
  210.     refers to:
  211.       - "Unknown Column"
  212.       - "Invalid Bind Type"
  213.       - "Invalid Type"
  214.       - "Invalid Type Conversion"
  215.       - "Column Not a Blob"
  216.  
  217.     If these types of error contexts are encountered, try disabling
  218.     schema cache.
  219.  
  220.  
  221.     ORACLE DRIVER
  222.     ----------------------------------------
  223.     Live queries for Oracle tables require a table qualifier or an
  224.     alias name if the field names are quoted.  The following line of
  225.     code will produce an error:
  226.       select * from someTable where "fieldname" = someValue
  227.  
  228.     Instead use one of the following statements:
  229.       select * from someTable T1 where T1."fieldname" = someValue
  230.     or:
  231.       select * from someTable where "someTable"."fieldname" = someValue
  232.  
  233.  
  234.     Database Notes
  235.     ----------------------------------------
  236.       o SQL Database floating point precision - Servers that
  237.         support a single-precision floating point type typically
  238.         offer only seven significant digits.  If no
  239.         TField.DisplayFormat is specified and the precision of
  240.         the underlying field is less than 15 digits, you should
  241.         set the TField.Precision property accordingly.
  242.  
  243.       o When using Cached Updates on a TQuery that is the detail
  244.         of a master/detail relation, make sure to apply updates
  245.         to the detail query before scrolling the master.
  246.  
  247.       o In order to delete a data dictionary attribute set that
  248.         is based on another or has another set based on it, use
  249.         the SQL Explorer to set the child's "based on" relation
  250.         to none before deleting.
  251.  
  252.  
  253.     Updateable SQL queries
  254.     ----------------------------------------
  255.       o The online help on Syntax Requirements for a Live Result Set
  256.         should state that ORDER BY clauses are allowed in
  257.         updateable queries.
  258.  
  259.       o The online help on Syntax Requirements for a Live Result
  260.         Set incorrectly states that a unique index must exist on
  261.         Sybase servers.  Only the original column values implied
  262.         by the setting of TQuery.UpdateMode must be unique.
  263.  
  264.       o All Oracle column names are case sensitive (as if they
  265.         were quoted explicitly).  Oracle table names are never
  266.         quoted (and thus must be uppercase).
  267.  
  268.       o Quoted columns must be prefixed with a table alias.
  269.  
  270.       o Tables owned by another user must be qualified by owner
  271.         name.  Use quotes around the owners and around the table,
  272.         for example "OWNER"."TABLE".
  273.  
  274.       o Dataset synchronization on SQL Databases - Whenever supported
  275.         by the server, Delphi supports inserts against updateable
  276.         queries, views, non-indexed Sybase and InterBase tables.
  277.         However, a newly inserted record is not present in the
  278.         current cache (dataset) when it is no longer the current
  279.         record.  The table must be reopened or the query executed
  280.         again to refresh the cache and retrieve the inserted
  281.         record.
  282.  
  283.  
  284.     InterBase
  285.     ----------------------------------------
  286.     Delphi Client/Server comes with the InterBase Server running on
  287.     Windows NT with a two user license.  For information about
  288.     installing the InterBase Server, refer to "InterBase Server running
  289.     on Windows NT" located in the Delphi Help under  "What's New in
  290.     Delphi."  The InterBase Server files are located on the Delphi
  291.     CD-ROM in \NT_IBSVR
  292.  
  293.     The InterBase Server requires Windows NT 3.51 or higher, an 80486
  294.     or better processor, and 8Mb of system memory.  A full
  295.     installation of InterBase Server requires approximately 8 Mb of
  296.     hard disk space free during installation, 2 of which are used for
  297.     install purposes and will be freed upon completion.
  298.  
  299.         NOTE
  300.         ----------------------------------------
  301.         Local InterBase Server for Windows 95/NT should not be
  302.         installed on the same PC as InterBase Server for Windows
  303.         NT. Please refer to the READIB.TXT in the
  304.         BORLAND\INTRBASE directory for further information.
  305.         ----------------------------------------
  306.  
  307.     The InterBase Server included with Delphi Client/Server Suite 2.0 is
  308.     for development purposes only.  No deployment of this server is
  309.     permitted.  To have more than two users connect to this server, or
  310.     to deploy Delphi/InterBase applications, contact Borland for server
  311.     and user pricing.
  312.  
  313.  
  314.     DataPump Expert Tool (International Users)
  315.     ---------------------------------------------------------
  316.     Before upsizing tables, ensure that the language driver setting
  317.     for the server alias in BDECFG32 matches the servers language
  318.     driver and character set.  Contact your database administrator
  319.     for details about your server configuration.
  320.  
  321.     Some servers have certain restrictions when using extended
  322.     characters in metadata (table names, index names and field
  323.     names).  To avoid these server limitations, the DataPump gives
  324.     you the ability to modify the names of fields, indexes and tables
  325.     before upsizing.  On the final stage of the DataPump, you can
  326.     modify the table name, index names or field names by selecting
  327.     the option "Modify Mapping For Selected Item".  Please see the
  328.     on-line help topic "Inspect or modify Items" for more
  329.     information.
  330.  
  331.  
  332. ----------------------------------------
  333.  4. INSTALLSHIELD EXPRESS
  334. ----------------------------------------
  335.  
  336.     BDE/SQL Links
  337.     ----------------------------------------
  338.     We highly recommend that when deploying SQL Links you deploy a full
  339.     BDE, not a partial BDE.
  340.  
  341.     InstallShield Express may ask for the location of any BDE files
  342.     that are needed.  This will only happen if you install the BDE and
  343.     SQL Links in separate directories during your application's install
  344.     process.
  345.  
  346.     In a Partial BDE install the BDE and SQL Links files will be placed
  347.     in the same directory as your program files.
  348.  
  349.     A Default Full BDE install will place the files in the \Program
  350.     Files\Borland\Common Files\BDE directory.
  351.  
  352.  
  353.     Partial BDE install
  354.     ----------------------------------------
  355.     Please note that Borland recommends a Full BDE install but allows a
  356.     partial BDE install in cases where minimization of disk space is a
  357.     requirement.
  358.  
  359.     If you choose to distribute an application using a partial install
  360.     of the BDE, Borland is not responsible for supporting this
  361.     application or ensuring that the user is getting updated versions of
  362.     the BDE.
  363.  
  364.     Note: Please ensure that these files are installed in a manner that
  365.     will not affect other installed BDE applications.
  366.  
  367.     A Partial BDE install imposes the following limitations:
  368.  
  369.       o No two BDE Client applications can run on the same machine at
  370.         the same time.  If a BDE Client application is already running
  371.         on your system you will receive the following error message on
  372.         startup:
  373.  
  374.         "An Error occurred while attempting to initialize to Borland
  375.         Database Engine (Error $210C)"
  376.  
  377.       o A Partial BDE install must place BDE DLL files in your
  378.         program's run directory.
  379.  
  380.       o BDE files will not be automatically updated with the latest
  381.         version when other BDE Applications are installed.
  382.  
  383.     A Full BDE install will help insure compatibility with future
  384.     releases of the Borland Database Engine and BDE applications.
  385.  
  386.     Paradox for Windows, Visual dBASE for Windows, Delphi,
  387.     ReportSmith and other programs using the Borland Database 
  388.     Engine may not run properly with other applications that
  389.     have been installed using a partial install of the BDE.
  390.  
  391.  
  392.     InstallShield Un-install issues
  393.     ----------------------------------------
  394.       o InstallShield Express will not check to see if your
  395.         application is running when you try to un-install, and may leave
  396.         some files on disk.  To avoid this problem, make sure that you
  397.         shut down your application prior to un-installing.
  398.  
  399.       o When testing the un-install feature, make sure you are on a
  400.         test machine and not your production machine.  An un-install may
  401.         remove registry entries and files that are needed by other
  402.         applications.
  403.  
  404.  
  405.     InstallShield Known Problems
  406.     ----------------------------------------
  407.       o The install script is updated when you move off a project
  408.         step.  In order to make changes in a step you have already left,
  409.         you first need to remove prior settings for that step and save
  410.         the project.  You will then be able to return to that step and
  411.         make the changes.
  412.  
  413.         For example: You have selected General Options on the Setup
  414.         Checklist and specified a partial BDE install that includes two
  415.         of the drivers.  Later, you wish to add a third driver.  You
  416.         must select General Options, un-select the InstallShield BDE
  417.         Object and click OK to remove your prior BDE settings.
  418.  
  419.       o Selecting a folder in the Choose Folder dialog box in large
  420.         projects may cause the application to perform numerous actions
  421.         in the background without any notification to the user before
  422.         the Destination Location dialog appears.
  423.  
  424.       o Occasionally InstallShield will report an erroneous
  425.         insufficient disk space error when copying files to a network
  426.         drive when none exists.  If you receive this error, and have
  427.         determined that there is sufficient disk space, build the
  428.         project locally and use the Copy to Floppy option on the Setup
  429.         Checklist to copy the disk images to the network drive.
  430.  
  431.       o If your project installs files to the root directory of a
  432.         drive, and it needs to create sub-directories it will fail.
  433.  
  434.         For example, if a user directs your SETUP.EXE program to install
  435.         the application to C:\, it will fail when SETUP.EXE tries to
  436.         create a sub-directory.  Installing to C:\TEST\ will work.
  437.  
  438.       o Using the Copy to Disk option to copy files to a network drive
  439.         will fail on NTFS.
  440.  
  441.         A known problem exists in Windows 95 when deploying a 
  442.         partial BDE with SQL Link drivers.  Under certain
  443.         conditions, such as deployment using InstallShield
  444.         Express,  partial deployment of the BDE causes improper
  445.         running of any existing full BDE deployment.
  446.  
  447.  
  448. ----------------------------------------
  449.  5. HELP FILES
  450. ----------------------------------------
  451. Updated help files:
  452.       o DELPHI.HLP
  453.       o VCL.HLP
  454.       o OBPASCAL.HLP
  455.       o CWG.HLP
  456.       o WIN32.HLP
  457.  
  458.  
  459.     F1 AND HELP BUTTON SUPPORT IN THE IDE
  460.     -----------------------------------------
  461.     Many broken context-sensitive help jumps have been corrected and
  462.     many missing topics for help buttons in the IDE have been added.
  463.  
  464.  
  465.     WIN32.HLP PATH
  466.     -----------------------------------------
  467.     Many products install the WIN32.HLP file, including Delphi.  If some
  468.     other product has installed these files and subsequently been
  469.     un-installed, there may be entries in the WINHELP.INI file (in your
  470.     Windows directory) specifying a non-existent path to these files.
  471.  
  472.     If this is true and you press F1 in the code editor while a Windows API
  473.     function is selected, an error dialog may be presented with no message.
  474.     If you press Cancel in the dialog twice and help comes up normally, you
  475.     should edit WINHELP.INI and either:
  476.  
  477.           o change any path specifications for WIN32.HLP to
  478.             C:\PROGRAM FILES\BORLAND\DELPHI 2.0\HELP or
  479.  
  480.           o delete entries in the WINHELP.INI file that refer to
  481.             WIN32.HLP
  482.  
  483.  
  484.     JUMPS AND LINKS
  485.     ----------------------------------------
  486.     The updated Delphi 2.0 help files contain numerous fixes to previously
  487.     known broken jumps and links.  For some existing topics and all new
  488.     topics, additional jumps and links have been added.
  489.  
  490.  
  491.     NEW TOPICS
  492.     ----------------------------------------
  493.     A significant number of new topics have been added to Delphi help.
  494.     Including information on DBLogDlg Unit, DBPWDlg Unit, Queries
  495.     (and other query topics), TApplication, TBatchMove, TBits
  496.     object (and related entries), TChangeLink object,
  497.     TColorDialog, TConversion object (and related entries),
  498.     TDatabase, TDataModule, TDataSet, TDBGrid (and related
  499.     entries), TDBLookupComboBox, TDBLookupListBox,
  500.     TDragControlObject object, TDragObject object (and related
  501.     entries), TField and TFieldDef, TFontDialog, TForm,
  502.     TImageList (and related methods), TNumericField component,
  503.     TOleContainer control (and related entries), TOpenDialog,
  504.     TPanel, TParam, TPrintDialog, TQuery, TRegIniFile, TRegistry,
  505.     TReport, TRichEdit, TSession, TStoredProc, TTable, TThread
  506.     object (and related entries).
  507.  
  508.  
  509.     WIN32.HLP
  510.     -----------------------------------------
  511.     Browse sequences are added to the WIN32.HLP file.
  512.  
  513.  
  514.     DELPHI.HLP
  515.     -----------------------------------------
  516.     The topic "Declaring Interface Routines," under "Reusing
  517.     Forms as DLLs," includes an extensive, updated example.
  518.  
  519.  
  520. ----------------------------------------
  521.  6. INTERNET SOLUTIONS PACK HELP
  522. ----------------------------------------
  523.  
  524.     The following help files for the Internet Solutions Pack are
  525.     installed in the Windows system directory:
  526.         APPA.HLP
  527.         CONVENT.HLP
  528.         FTPCLINT.HLP
  529.         GENERIC.HLP
  530.         GETSTRT.HLP
  531.         HTML.HLP
  532.         NNTP.HLP
  533.         OCXSDK.HLP
  534.         POP.HLP
  535.         SDGLOSHL.HLP
  536.         SMTP.HLP
  537.         TCP.HLP
  538.         UDP.HLP
  539.  
  540.  
  541. ----------------------------------------
  542.  7. BORLAND PASCAL 7.0 COMPATIBILITY
  543. ----------------------------------------
  544.       o Passing Borland Pascal 7.0 style object variables as
  545.         arguments in an open array constructor is not supported.
  546.  
  547.       o Don't use the Borland Pascal 7.0 Fail procedure with Delphi
  548.         classes.
  549.  
  550.       o ObjectWindows Library (OWL) code cannot be compiled using
  551.         Delphi 2.0.
  552.  
  553.  
  554. ----------------------------------------
  555. 8. Delphi Commercial Videos
  556. ----------------------------------------
  557.  
  558.     We have added two new, uncompressed AVI files.  They can both be
  559.     found in the INFO\BORLAND directory.
  560.       o Delphi morphing race car (DELCAR2.AVI)
  561.       o Delphi Oktoberfest commercial (DELCOM2.AVI)
  562.  
  563. ----------------------------------- END -----------------------------------
  564.