*** HyperString v6.0 ***
(c)1996-2002 EFD Systems, All rights reserved
[email protected]
*** 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
PO Box 680772
Marietta, GA 30068
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-2002, 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 (Ha