home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / btree / keytree / readme.doc < prev    next >
Encoding:
Text File  |  1992-05-11  |  5.9 KB  |  130 lines
  1. KEYTREE TOOLBOX VERSION 3.1 - MAY 1992 (Copyright Rewse Consultants Ltd)
  2. ________________________________________________________________________
  3.  
  4.           ┌─────────┐
  5.     ┌─────┴───┐     │              (R)
  6.       ──│         │o    │──────────────────
  7.     │   ┌─────┴╨──┐ │  Association of
  8.     │   │         │─┘  Shareware
  9.     └───│    o    │    Professionals
  10.       ──────│    ║    │────────────────────
  11.         └────╨────┘    MEMBER
  12.  
  13. ___________________________________________________________________________
  14.  
  15.  
  16. The KeyTree Toolbox is a set of library routines for PASCAL programmers for
  17. creation, access and maintenance of indexed files of variable length records.
  18. It requires Turbo PASCAL version 4 or later.
  19.  
  20. The files that should be on this disk are :
  21.  
  22.     README.DOC   - this file
  23.     KEYTREE.PAS  - the source code of the KeyTree Utilities
  24.     FUNCKEY.PAS  - customizable pascal code, used by KEYTREE.PAS
  25.     KTERRORS.PAS - plain language version of KeyTree exception codes
  26.     TUTOR.EXE    - a tutorial program which allows you to create simple
  27.            files and access them using the toolbox
  28.     NAMES.FIL    - a simple file which can be used by TUTOR.EXE
  29.     MANUALP.EXE  - an electronic manual describing the KeyTree Toolbox
  30.     MANUALP.FIL  - which is used by MANUAL.EXE
  31.     SAMPLESP.EXE - an electronic manual showing some useful examples
  32.     SAMPLESP.FIL - which is used by SAMPLES.EXE
  33.     LOOK.EXE     - a program for looking at KeyTree files in detail
  34.            (very good for understanding how the KeyTree system works)
  35.     CLEANUP.EXE  - a program for cleaning up KeyTree files (getting rid of
  36.            dead records)
  37.     ADDINDEX.EXE - a program for adding additional indexes to an existing
  38.            KeyTree file. It is unlikely that you will ever want to
  39.            add new keys permanently to a file. However suppose you
  40.            had a customer file keyed by customer number, and you
  41.            also had a one-off need to access these in post code
  42.            sequence. You could use this program to change the key
  43.            to post code plus customer number, and use the temporary
  44.            file created (TMP1.$$$) for the processing.
  45.     SCANPLUS.EXE - a program for finding keyboard scan codes - totally
  46.            unrelated to the KeyTree Toolbox, but we hope you find
  47.            it useful!
  48.     ORDER.DOC    - print this file and send it to us when you register your
  49.            use of the KeyTree Toolbox
  50.  
  51.     SHR-WARE.DOC - a description of shareware and the Association of
  52.            Shareware Professionals
  53.  
  54. COMPILING THE KEYTREE TOOLBOX
  55. _____________________________
  56.  
  57.     The first thing you should do is use your compiler to MAKE KEYTREE.TPU.
  58.     The file FUNCKEY.PAS is 'used' by KEYTREE.PAS and so it will be
  59.     compiled at the same time. If you intend using the ktError function,
  60.     you should also compile KTERRORS.PAS .
  61.  
  62.     Then, any source file that uses the KeyTree Toolbox should include the
  63.     following line :
  64.  
  65.     uses keytree,kterrors;
  66.  
  67.  
  68. WARRANTY & SUPPORT
  69. __________________
  70.  
  71.     Whilst we have taken every care to ensure that the KeyTree Toolbox works
  72.     as specified, there is an ancient programmers saying - "Every program
  73.     contains at least one bug!". We don't propose to enter into a deep
  74.     philosophical discussion on the truth or otherwise of this saying, but
  75.     it is a brave man indeed who offers any warranty on the accuracy of
  76.     software. Therefore, in common with every other software supplier we
  77.     have ever come across, we offer no particular warranty regarding the
  78.     use of the KeyTree Toolbox, and it is your responsibility to ensure
  79.     that your programs, which use the KeyTree Toolbox, work.
  80.  
  81.     However, in the unlikely event that you find some combination which does
  82.     not do what you expected, we want to hear from you. Please write to us
  83.     at the address below, and we will endeavour to explain the problem.
  84.  
  85.     The KeyTree Utilities has been tested using Turbo Pascal versions 4 & 5.
  86.     It would probably need amending to run successfully on other compilers.
  87.  
  88.  
  89. COPYRIGHT & (ABSENCE OF) ROYALTIES
  90. __________________________________
  91.  
  92.     The copyright in KeyTree Toolbox (which includes all the files listed
  93.     above) is the property of Rewse Consultants Limited. You may make as
  94.     many copies of the KeyTree Toolbox as you wish, BUT -
  95.  
  96.     i)  you may not SELL the KeyTree Toolbox to any third party and
  97.  
  98.     ii) if you GIVE the KeyTree Toolbox to any third party, you MUST
  99.     give them all of the files listed above, particularly this one,
  100.     and the same conditions apply to the third party.
  101.  
  102.     In other words, we are impoverished programmers trying to earn an
  103.     honest crust, and you wouldn't want to deprive our children of a new
  104.     pair of shoes, would you?
  105.  
  106.     No royalty is expected for programs which you create using the KeyTree
  107.     Toolbox and then distribute to third parties as executable files.
  108.     However, we would be interested to hear about your use of the software.
  109.  
  110.     The KeyTree Toolbox is issued as shareware. In case you are unaware of
  111.     how the shareware system works, it is NOT 'free' software. No initial
  112.     charge is made for the software, so that you can try it out without
  113.     obligation. However, if you continue to use the software (and in the case
  114.     of the KeyTree Toolbox, use programs created using it), then you are
  115.     required to pay a registration fee. If you don't think the KeyTree
  116.     Toolbox is worth the registration fee..... well, thanks for your
  117.     interest. Just stop using it, and you don't owe us a thing. To register
  118.     your use of the software, we ask you to pay a miserly £30 (UK Pounds), a
  119.     mere fraction of the amount that you are saving in time and effort.
  120.  
  121.     Please send your registration fee to :
  122.  
  123.        Rewse Consultants Limited
  124.        44, Horseshoe Road, Pangbourne, Reading, Berkshire RG8 7JL, UK
  125.  
  126.  
  127.     You can pay the registration fee by Visa or Mastercard - just send us the
  128.     account number and date of expiry, and sign the letter authorising us to
  129.     charge it to your account.
  130.