PC Pro 1999 February/DPPCPRO0299.ISO/February/Delphi/Install/_SETUP.LIB/README.TXT

Text File | 1996-06-11 | 22.7 KB | 576 lines

            Welcome to Delphi Developer 2.0
            -----------------------------------------

This README file contains important, last minute information
about Delphi 2.0.

            ---------------------------------------------
            Before installing Delphi, you MUST un-install
            any previously installed version of Delphi 2.0.
            If you have installed any previous release
            of the MS Internet Control Pack, you must un-install
            that version before installing Delphi.
            ---------------------------------------------

For an overview of Delphi 2.0 and a list of new features, refer
to Chapter 2 of Getting Started.

Note that all printed and online documentation assume that you
have installed Delphi using the default directory structure.

Additional technical information can be found in following files:
      o DELPHI 2.0\RELNOTES.TXT
      o DELPHI 2.0\MANUALS.TXT
      o INTRBASE\READIB.TXT
      o RPTSMITH\READRS.TXT

IMPORTANT:
    ----------------------------------------
    For license information on deploying Delphi applications and for
    a list of files that may be redistributed, please read the
    DEPLOY.TXT file in the DELPHI 2.0 directory.
    ----------------------------------------


----------------------------------------
TABLE OF CONTENTS
----------------------------------------
 1. PRODUCT OVERVIEW
 2. MINIMUM SYSTEM REQUIREMENTS
 3. HOW TO GET HELP
 4. DELPHI 2.0 INSTALLATION
 5. INTERNET SUPPORT
 6. BINARY CODED DECIMAL (BCD) FIELDS
 7. ADDITIONAL TOOLS
 8. ADDITIONAL INFORMATION
 9. DEMONSTRATION PROGRAMS
10. MIGRATING 16-BIT DELPHI CODE


----------------------------------------
 1. PRODUCT OVERVIEW
----------------------------------------
Delphi's visual design environment lets you create sophisticated
32-bit Windows applications for Windows 95 and Windows NT faster
than any other development tool.  Because Delphi is built around
an optimizing 32-bit native-code compiler, Delphi applications
are up to 15-50 times faster than interpreted p-code.  You also
have complete support for all features of the operating system
including OLE automation, Internet connectivity and tools,
ActiveX, OCXs, Multi-threading, Unicode and MAPI.

Delphi has an object-oriented architecture with many new
components for quickly creating applications that offer the
Windows 95 user interface.  Delphi's component architecture is
completely extensible so you can easily create your own
components and add them to the environment.

Delphi integrates the Borland Database Engine, providing a high
performance, scaleable database architecture with an extensive
collection of data controls for quickly creating database
applications and reports.


----------------------------------------
 2. MINIMUM SYSTEM REQUIREMENTS
----------------------------------------
Delphi 2.0 requires Windows 95, Windows NT 3.51 or a 100%
compatible operating system, an 80486 or better processor, and
8Mb of system memory.  Delphi 2.0 has been tested under Windows 95
and Windows NT 3.51.

Disk Space Requirements:

    Version           Full        Compact
    --------------    --------    --------
    Desktop              75Mb        45Mb
    Developer           123Mb        60Mb
    Client/Server       128Mb        62Mb

    You can also perform a Custom installation selecting only
    those options you require for the smallest possible disk
    space.  Temporary space (10Mb) is used for install purposes
    and will be freed upon completion.


----------------------------------------
 3. HOW TO GET HELP
----------------------------------------
If you have any problems with this product, there are a number
documents that may contain the information you need:

  o This README.TXT file and RELNOTES.TXT
  o Documentation Updates in DELPHI20\MANUALS.TXT
  o Online help files
  o The Delphi manuals
  o Documentation on the Delphi CD in the INFO\BORLAND directory
  o Tech Info Sheets Help file contains answers to frequently
    asked questions.  It can be found on the Delphi CD in the
    INFO\BORLAND\TECHINFO directory

If you still have a question and need assistance, help is
available from the following sources:

  o You can use your modem or Internet connection to easily
    obtain assistance online.  Borland maintains support forums
    on CompuServe.  These forums put you in contact with
    thousands of other programmers using Borland products.
    You'll be able get your questions answered and share
    information and ideas with others.

    You can also download the latest technical information, sample
    code, utilities, patches, etc., from these online services as
    well as from Borland's Download Bulletin Board Service (DLBBS).

    Access Borland's online services in the following manners:

        CompuServe
        ----------------------------------------
        GO BORLAND
        GO DELPHI
        GO BDELPHI32


        World Wide Web
        ----------------------------------------
        Browse the Delphi WWW page (http://www.borland.com) to
        find tips and techniques, the latest Delphi book list,
        links to other Delphi pages, newsgroups, and other
        references.

        Other sites of interest include:
          news://comp.lang.pascal.delphi.misc
          news://comp.lang.pascal.delphi.components


        Borland DLBBS
        ----------------------------------------
        You can reach the Borland DLBBS by dialing
        [phone] (up to 14,400 Baud, 8 data bits, No
        Parity, 1 Stop bit).  No special setup is required.


  o TechFax is a toll-free, 24-hour automated service
    that sends free technical information to your fax machine.  More
    than 1,000 documents discussing Borland software are available
    through TechFax.  These documents provide valuable technical
    reference information.

    You can obtain TechFax bulletins or documents by calling
    [phone] from any touch tone telephone.

  o For information about installation, system configuration,
    and compatibility, call the Technical Support Hot Lines at
    [phone] from 6:00 AM to 5:00 PM Pacific Time.

  o If you need assistance beyond product installation,
    Borland offers the Advisor Lines service where you can get advice
    on program design, debugging, and performance tuning.  Advisor
    Lines operate from 6:00 AM to 5:00 PM Pacific Time at
    [phone].  Each call is $2.00 per minute, with the first
    minute free.  If you want to pay for this service using a credit
    card, call [phone].  (Available in U.S. only).

  o The specific steps necessary to reproduce the problem
    you are experiencing.

  o Computer name and model and the name and model of any
    additional hardware (video adapters, modems, etc.).

  o Operating system and version number (to obtain the
    version number, type VER at the command-line prompt).


----------------------------------------
 4. DELPHI 2.0 INSTALLATION
----------------------------------------
Please refer to the file INSTALL.TXT on the Delphi CD in the
\INSTALL directory for complete installation instructions.

To start the installation, run the SETUP.EXE program on the
Delphi CD in the INSTALL directory.


----------------------------------------
 5. INTERNET SUPPORT
----------------------------------------
Delphi supports the development of Internet applications with the
inclusion of:


    The Internet Solutions Pack
    ----------------------------------------
    The Internet Solutions Pack supplies eight ActiveX components
    from NetManage that allow you to build custom Web Browsers,
    manage Internet mail, transfer files or connect to network
    newsgroups.  As with other Delphi controls, you can create custom
    controls that inherit their properties.

        NOTE
        ----------------------------------------
        Delphi installs an updated version of the Internet
        Solutions Pack that supersedes the Microsoft Internet
        Control Pack.  If you have installed any previous release
        of the MS Internet Control Pack, you must un-install
        that version before installing Delphi.
        ----------------------------------------


    WININET.PAS
    ----------------------------------------
    The WININET.PAS file contains Delphi 2.0 interface types and
    function prototypes for the Microsoft Internet Extensions.

    You must first download and install the WinINet DLLs available
    from Microsoft in the "Internet Data Download Services" section
    found on the Microsoft web site at:
        http://www.microsoft.com/intdev/sdk/


    ISAPI.PAS
    ----------------------------------------
    The ISAPI.PAS file contains Delphi 2.0 interface types and
    function prototypes to implement an extension DLL for the
    Microsoft Internet Server.

    Information on the Internet Server is available on the Microsoft
    web site at:
        http://www.microsoft.com/intdev/server


    Additional information
    ----------------------------------------
    Additional technical information and a list of Internet
    Solutions Pack help files can be found in the RELNOTES.TXT file
    in the DELPHI 2.0 directory.


    QuickSite from DeltaPoint
    ----------------------------------------
    QuickSite is a web site "wizard" that automatically creates,
    structures and organizes your web pages.  Based on your input and
    content, the QuickSite publishing engine creates all the HTML
    code and manages the links.  QuickSite features include:
          o HTML 3.0 support
          o A complete on-line HTML reference
          o Automatically establishes and maintains links
          o Testing using all popular browsers
          o Automatic connection and transfer of files to appropriate
            directories on your Internet service provider's site


----------------------------------------
 6. BINARY CODED DECIMAL (BCD) FIELDS
----------------------------------------
Binary Coded Decimal is an exact numeric type that allows high
precision values to have exact representation in a binary format.
Approximate numeric types, like a double, are stored as a
mantissa and exponent.  Some numbers are not well suited to being
stored accurately in this format.

A new entry has been added to the Borland Database Engine (BDE)
configuration file and is installed with all versions of Delphi.
The "ENABLE BCD" setting specifies whether BDE translates numeric
and decimal fields into floating point values or BCD values.

The "ENABLE BCD" setting is FALSE by default for all drivers.
This setting can be changed with the BDE Configuration Utility
supplied with Delphi.

Existing aliases will not have the "ENABLE BCD" setting.  In
order to use this new setting, existing aliases will have to be
removed and re-created.  Once this is done, "ENABLE BCD" can be
set to TRUE.

Applications that use TDatabase components can be modified to use
BCD, regardless of the status of any associated alias.  A
TDatabase component takes its default parameter settings from the
BDE alias specified by the AliasName property.  These settings
may be changed in the Parameter Overrides associated with that
component.  The "ENABLE BCD" setting may be added to this list to
allow a specific TDatabase component to use BCD values.

The following table lists field types converted to BCD when
"ENABLE BCD" is set to TRUE:

    Driver        Field types
    --------------------------------------------------------
    dBASE         All NUMBER and FLOAT fields
    InterBase     DECIMAL and NUMERIC
    MS SQL        MONEY, SMALLMONEY, DECIMAL, and NUMERIC
    ODBC          DECIMAL and NUMERIC
    Oracle        NUMBER and FLOAT
    Paradox       BCD
    Sybase        MONEY, SMALLMONEY, DECIMAL, and NUMERIC

    A field is translated to BCD only if the target driver supports
    BCD fields.

When a table or query is opened in a database with "ENABLE BCD"
set to TRUE, all fields which can be BCD fields will be mapped to
TBCDField.  You cannot select specific fields for BCD enabling.

When using Paradox, any BCD field will be mapped to TBCDField
regardless of the "ENABLE BCD" setting.

    NOTE
    ----------------------------------------
    TBCDField stores BCD values in the Currency data type, which
    supports up to 4 decimal places.  If your data has more than 4
    decimal places you SHOULD NOT enable BCD. If you do so, values
    beyond the 4th decimal place will be lost when you save the data.
    ----------------------------------------

Additional information about using the Borland Database Engine
(BDE) with Delphi can be found in RELNOTES.TXT


----------------------------------------
 7. ADDITIONAL TOOLS
----------------------------------------

    Item                          Location on the Delphi CD
    -------------------------------------------------------------
    Delphi 1.0                    \DELPHI16\INSTALL\SETUP.EXE
    InstallShield Express         \ISXPRESS\DISK1\SETUP.EXE
    Delphi Demo Explorer          \INFO\BORLAND\DEMOEXPL\READDX.TXT
    Delphi Informant Works 95     \INFORM\README.TXT
    Delphi Infmnt Acrobat Search  \INFORM\ACROREAD\DISK1\SETUP.EXE


    Delphi 1.0
    ----------------------------------------
    Delphi 2.0 also includes the 16-bit version of Delphi 1.0 for
    creating 16 bit Windows 3.1 applications.  This can be installed
    by running the SETUP.EXE program on the Delphi CD in the DELPHI16
    directory.  You may also want to read the INSTALL.TXT and
    README.TXT on the Delphi CD in the DELPHI16\DISK1 directory for
    Delphi 1.0 system requirements and installation notes.

    This version of Delphi 1.0 installs an older version of the
    16-bit Borland Database Engine (BDE).  If you do not have a
    more current version of the 16-bit BDE installed, and Delphi 1.0
    installs this older version, you should install the current
    version of the 16-bit BDE.  Additional information on
    installing the current version of the BDE can be found in the
    RELNOTES.TXT file.


    InstallShield Express
    ----------------------------------------
    This is a customized version of InstallShield that makes it easy
    to deploy Delphi applications to your customers.  See the
    DEPLOY.TXT file in the DELPHI 2.0 directory for information on
    deploying your Delphi-generated applications.


    Delphi Demo Explorer
    ----------------------------------------
    The Demo Explorer allows you to browse a database of all Delphi
    demonstration programs.  It can be found on the Delphi CD in the
    \INFO\BORLAND\DEMOEXPL directory.  Refer to the ReadDX.txt file
    there for instructions on installing the Demo Explorer.


    Delphi Informant Works 95
    ----------------------------------------
    This includes a complete reference to all the articles and code
    that appeared in the Delphi Informant in 1995.


    Third Party Products
    ------------------------
    Listed below are the third party products installed with Delphi
    or provided on the Delphi CD. For more information, please refer
    to each product's online help or README file.  In addition, a
    copy of the Delphi Power Tools Catalog is provided.  The Delphi
    Power Tools Catalog lists a wide variety of third party software
    available for use with Delphi.

    Installed with all versions of Delphi:
      o InstallShield Express from InstallShield Corp.

      o QuickReport from QSD AS. The file
        DELPHI20\QUICKRPT\QRMANUAL.DOC contains complete product
        information.

      o ChartFX from SoftwareFX For help on the ChartFX sample
        OCX component refer to the file OCX\CHARTFX\CFX2OCX.HLP

    Installed with the Delphi Developer and Delphi Client/Server:
      o Graphics Server OCX from Pinnacle Publishing.
      o Formula One Spreadsheet from Visual Components, Inc.
      o First Impression Charting from Visual Components, Inc.
      o Visual Speller from Visual Components, Inc.

        For help on these sample OCX components please refer to
        the following help files:

            OCX\PINNACLE\GRAPH.HLP
            OCX\VCI\FORM1\VCF1.HLP
            OCX\VCI\IMPRESS\VCFI.HLP
            OCX\VCI\VSPELLER\VSPELLER.HLP

    Installed with the Delphi Client/Server Suite:
      o 32-Bit Visual Query Builder from Integra
      o InterSolv PVCS team development support

    On the Delphi CD:
      o Information on Delphi 1.0 Link for Lotus Notes from
        Brainstorm (See INFO\BORLAND\DEL1_LNK.DOC)

      o WinBeep from Integra (See INFO\INTEGRA)

      o DemoShield from InstallShield (demonstration version)
        (See INFO\ISCORP\DEMOWM)

      o Media Architects sample products.  (See INFO\MEDIARCH)

      o CodePrint from Pinnacle: A demo version that prints Delphi
        source files.  (See INFO\PINNACLE\CODEPRNT)

      o GraphX a demo of 3D graphics support for the Pinnacle Graphic
        server OCX. (See INFO\PINNACLE\GRAPHX)

          o Subscription information for a free issue of the
            Delphi Developer Newsletter from Pinnacle Pub.
            (See INFO\PINNACLE\FREESTUF)

      o ProtoView: Two sample OCX controls for the ProtoView
        Interactive Diagramming Object and Date Button control.
        (See INFO\PROTOVW)


    Accessing OCX Help Contents
    ---------------------------
    You can modify your DELPHI.CNT file to merge OCX help contents
    into Delphi's help system.  For example, here's how to add online
    help for the OCX controls that are installed on Delphi's
    component palette.

    Use NOTEPAD.EXE or another text editor to open the DELPHI.CNT
    file in the DELPHI 2.0\HELP directory.  Add the following to the
    bottom of the file:

:Include C:\PROGRAM FILES\BORLAND\DELPHI 2.0\OCX\VCI\FORM1\VCF1.CNT
:Include C:\PROGRAM FILES\BORLAND\DELPHI 2.0\OCX\VCI\IMPRESS\VCFI.CNT
:Include C:\PROGRAM FILES\BORLAND\DELPHI 2.0\OCX\VCI\VSPELL\VSOCX.CNT

    This will merge the content screens from OCX help files into
    Delphi's help contents screen.


----------------------------------------
 8. ADDITIONAL INFORMATION
----------------------------------------
You can find additional information and/or sample files from
Borland, Integra Technology, Stirling Technologies, Media
Architects, Protoview Development Corporation and Pinnacle
Publishing on the Delphi CD in the \INFO directory.

The following Borland technical documents can be found on the
Delphi CD in the \INFO\BORLAND directory:

    D32_NOTE.DOC   - Migration notes for upgrading code from Delphi 1.0
    D32_COMP.DOC   - Compiler architecture white paper
    D32_DB.DOC     - Database architecture white paper
    D32_95C.DOC    - Windows 95 controls white paper
    D32_VCS.DOC    - Version control white paper
    D32_F&B.DOC    - Features and benefits summary
    D32_Q&A.DOC    - Common questions and answers
    BOR_OEC1.DOC   - Open Environment Corporation Strategic Fit
    DEL1_LNK.DOC   - Delphi/Link for Lotus Notes

You can also find Borland Tech Info Sheets and answers to
frequently asked questions on the Delphi CD in the
INFO\BORLAND\TECHINFO directory.


----------------------------------------
 9. DEMONSTRATION PROGRAMS
----------------------------------------
Here's an overview of the directory tree structure containing
demonstration programs:


  DELPHI 2.0\DEMOS
    - Contains numerous demonstration programs, each in their own
      directory.

  DELPHI 2.0\DEMOS\DATA
    - Contains all data used by sample programs.  Note that the
      MASTAPP example defines referential integrity rules on the
      CUSTOMER, ORDERS, ITEMS and PARTS tables.  These rules, which
      require that the master record be posted before a detail record
      may be posted, are defined in both the Paradox tables (.DB) the
      Local InterBase Server database (MASTSQL.GDB) versions of this
      data.  If you write database applications that insert data into
      these tables and your insertions violate the referential
      integrity rules that are defined, a "Master Record Missing"
      exception will be raised.

  DELPHI 2.0\DEMOS\DOC
    - Contains sample projects from the printed documentation.
      Data used by these examples is in the DELPHI 2.0\DEMOS\DATA
      directory and is accessed using the DBDEMOS database alias
      created by SETUP.

  DELPHI 2.0\DEMOS\DB
    - Contains additional database sample projects.  Data used by
      these examples is in the DELPHI 2.0\DEMOS\DATA directory and is
      accessed using the DBDEMOS database alias created by SETUP.

  DELPHI 2.0\RPTSMITH\DEMOS
    - Contains DelphiRS.dpr, a Delphi project that shows how a
      ReportSmith report acquires its data from Delphi table or query
      objects.

  DELPHI 2.0\DEMOS\INTERNET\FTP
    - Implements a File Transfer Protocol component, allowing users
      to display and manipulate files on an FTP server.

  DELPHI 2.0\DEMOS\INTERNET\HTML
    - Implements a web browser.

  DELPHI 2.0\DEMOS\INTERNET\HTTP
    - Implements a web browser that retrieves the contents of a
      document from an HTTP server.

  DELPHI 2.0\DEMOS\INTERNET\NNTP
    - Implements a Usenet newsgroup browser.

  DELPHI 2.0\DEMOS\INTERNET\SIMPMAIL
    - Implements an SMTP and POP mail client.

  DELPHI 2.0\DEMOS\INTERNET\TCP
    - Implements a computer-to-computer 'chat' or 'talk' program.


----------------------------------------
10. MIGRATING 16-BIT DELPHI CODE
----------------------------------------
The D32_NOTE.DOC file on the Delphi CD in the INFO\BORLAND
directory discusses a number of issues important to program
authors migrating code from Delphi 1.0 to Delphi 2.0.  The new
Delphi 2.0 compiler has many features that change such
fundamental mechanisms as calling conventions, string handling,
and memory allocation.  If you are porting Delphi 1.0
applications to Delphi 2.0, we recommend reviewing the
D32_NOTE.DOC file first.

Here are two issues that are not related to porting applications
but Delphi 1.0 users should be aware of:

  o Delphi 2.0's IDE makes extensive use of context menus.  In many
    cases, such as the fields and string property editors, buttons
    were replaced with context menu items instead.  Most views in the
    IDE use Windows 95-style right click menus to provide additional
    functionality.

  o Delphi 2.0 DLLs that use the Borland Database Engine do not
    require any special initialization or shutdown code.  (The Delphi
    1.0 BDEDLL.DPR sample is no longer necessary for 32-bit DLLs and
    will, in fact, not compile with Delphi 2.0.)

----------------------------------- END -----------------------------------