readme.txt

String hanlding library. Functions for crypto, token etc

                          *** HyperString v6.0 ***
                (c)1996-2000 EFD Systems, All rights reserved
                             [e-mail]

                 *** THIS IS NOT PUBLIC DOMAIN SOFTWARE ***
     See below for license agreement, disclaimer, installation and use.


    Introduction ---------------------------------------------------------

    Welcome to HyperString!

    One of the most significant new features with Delphi32 is long dynamic
    strings.  However, the built-in functions don't really exploit the full
    potential of these new strings. HyperString provides over 400 fast,
    efficient string management routines to help you realize the full power
    of this highly versatile new data type.


    Installation ---------------------------------------------------------

    NOTE: As of v5, all form, shell and printer related code has been moved
    to a separate unit (HyperFrm). The handful of affected routines have
    been clearly noted in the docs. This was done to reduce VCL overhead in
    non-visual (console mode) apps.

    HyperString is a NON-VISUAL code library not unlike "Windows", "Forms",
    "SysUtils" or any of the other system code units commonly listed in the
    "uses" clause. Installation is simple but very different from that of a
    component; there is nothing to register within the Delphi environment.

    1) Copy HYPERSTR.PAS and HYPERFRM.PAS (or the .DCU) to your Delphi
       Library directory.
       (..\DELPHI\LIB)

    2) Copy HYPERSTR.HLP and HYPERSTR.CNT to your Delphi Help directory.
       (..\DELPHI\HELP)

    3) (Optional, but highly recommended) With minimal effort, the WinHelp
       HyperString docs can be seamlessly integrated into Delphi's own
       on-line Help for convenient access during coding.

       DELPHI 5+ ----------------------------------------------------------

       Select "Help|Customize|Edit|Add Files" and add HYPERSTR.CNT to
       the file list. Select "File|Save" and you're done!


       DELPHI 3/4 ---------------------------------------------------------

       First, make a backup copy of ..\DELPHI\HELP\DELPHI?.CNT

       Edit DELPHI?.CNT (it's a simple text file) using NOTEPAD, WORDPAD or
       the ASCII editor of your choice.  Insert 2 lines as follows:

       --------------------------------------------------------------
       1) Add to Index Section   > :Index HyperString Library =hyperstr.hlp
          (near top of file)

       2) Add to Include Section > :Include hyperstr.cnt
          (near end of file)
       --------------------------------------------------------------

       The colons are a part of each line. The modified DELPHI.CNT should
       look something like this:

       --------------------------------------------------------------
          :Base delphi.HLP>main
          :Title Delphi Help
          :Index HyperString Library =hyperstr.hlp
                    .
                    .
                    .
          :Include hyperstr.cnt

       --------------------------------------------------------------

       NOTE: Be sure to press [Enter] after typing the last line in the
       file in order to insert a hard CRLF. WinHelp will sometimes ignore a
       line if it is not fully terminated.

       Save the file and you're done!

       The next time you access Delphi Help, you'll receive the message,

                   "Preparing Help files for first use"

       This indicates that WinHelp is rebuilding the Delphi Help indexes to
       include HyperString. Once this is complete, you should see a new
       entry for HyperString at the bottom of the Help Contents page and
       entries for the HyperString routines should be in the Index.


    Using HyperString ----------------------------------------------------

    As noted above, HyperString is a NON-VISUAL code library.  Once
    installed, simply add "HyperStr" (and "HyperFrm" if necessary) to the
    "uses" clause of any unit where you intend to make use of HyperString
    routines.


    Ordering HyperString -------------------------------------------------

    After using HyperString, you may decide that you would like to purchase
    a source code license (only $59US).  Currently there are 2 ways to order.

    1) From the World Wide Web.  Using a major credit and a secure link
    from our web site at:

    http://www.mindspring.com/~efd

    Source code will be delivered to your e-mail address.

    2) By mail.  Send check (US banks only) or money order to:

    EFD Systems
    304 Smokerise Circle
    Marietta, GA 30067
    USA

    Source code will be delivered via e-mail or ground carrier (our choice
    of carrier) upon request.


    UnInstall ------------------------------------------------------------

    Should you decide that HyperString is not for you (unlikely but
    possible <g>), delete the 3 files mentioned above.  If you modified
    DELPHI?.CNT, simply re-edit the file and delete the 2 lines that were
    added or better yet, simply replace the file with the backup copy.


    License Agreement and Disclaimer -------------------------------------

    By using this product, you indicate your understanding and acceptance
    of the terms and conditions below.

    This software (the product) is copyright 1996-2001, EFD Systems, all
    rights reserved. Except as detailed herein, you (the user) are granted
    a license to use this software without payment of fees.  You may
    distribute the non-source code version of this product for similar use
    by others, provided that no fees are charged and the software is
    distributed in it's entirety as originally released, including this
    documentation file.

    HyperString is a development tool intended to assist software authors
    in the creation of original works. As such, software authored by you
    with the assistance of this product (your product) may be freely
    distributed except as follows:

    1)  HyperString source code and derivatives thereof may not be
        re-distributed under any circumstances.  If you are working as a
        contractor or programmer for hire, your client/employer must
        purchase a source code license under the terms of this agreement in
        order to receive the HyperString source code.

    2)  Your product must not represent a simple re-packaging of some or
        all of this product.  HyperString may not be used to produce
        similar or competing products.

    3)  A source code license is required in order to use this product in
        the production of any development tool or component which will be
        licensed or sold for gain or profit.  As you ask of others, we ask
        of you.

    Except as noted above, a source code license grants the user the
    non-exclusive, non-transferable right to view and use the source as
    necessary to produce compiled, machine readable and executable object
    code.  The source code remains the exclusive, proprietary property of
    EFD Systems. The right to suspend the terms of this agreement upon
    refund of license fee is retained by EFD Systems.

    THIS SOFTWARE IS PROVIDED SOLELY AS-IS AND WITHOUT WARRANTY INCLUDING
    WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR
    FITNESS FOR A PARTICULAR PURPOSE.  THE USER AGREES TO INDEMNIFY AND
    HOLD THE AUTHOR HARMLESS FROM AND AGAINST ANY AND ALL CLAIMS ARISING
    FROM OR RELATED TO USE OF THE PRODUCT. UNDER NO CIRCUMSTANCES SHALL THE
    AUTHOR'S LIABILITY EXCEED THE SOFTWARE LICENSE FEE.

    By using this product, you indicate your understanding and acceptance
    of the terms and conditions above.


    Revision History -----------------------------------------------------

    v1.0 - 96/12/25, Original release (Happy holidays).
    v1.5 - 97/06/01, Many new routines, instructions for Delphi 3.
    v2.0 - 97/08/01, Added dynamic arrays and other new features.
    v2.2 - 97/12/15, Revised dynamic arrays, more new features.
    v2.5 - 98/01/30, Bigger and better than ever!
    v2.8 - 98/05/01, Improved performance, additions, bug fixes.
    v4.0 - 98/07/30, Modified for D4, changed version to match.
    v4.2 - 98/11/22, Modified to support SubScript.
    v5.0 - 99/05/01, Added user-defined case tables, reg expressions.
                     Moved form and shell related code to HyperFrm unit.
    v6.0 - 01/06/22, Modified for D6