home *** CD-ROM | disk | FTP | other *** search
/ Programming Tool Box / SIMS_2.iso / vb_tools / vbit11 / readme.win < prev   
Text File  |  1995-01-22  |  20KB  |  417 lines
  1. _____________________________________________________________________________
  2.  
  3. IDBTOOLS 1.1 FOR VISUAL BASIC                NORWEGIAN TEXT: SEE README_N.WIN
  4. _____________________________________________________________________________
  5.  
  6. > WHAT IS IDBTOOLS?                                                   +-----+
  7.                                                                       ªMICROª
  8.   IdbTools is a library of useful and timesaving routines which       +-----+
  9.   makes life easier for any Visual Basic programmer.                  ª I   ª
  10.                                                                       ª  D  ª
  11.   Basic contents are as follows:                                      ª   B ª
  12.                                                                       +-----+
  13.   + Simple, but very powerful routines for string-manipulation        ªADEPTª
  14.                                                                       +-----+
  15.   + Extensively simplified reading/writing of INI-files compared
  16.     to API-calls
  17.  
  18.   + Routines for reading system-information, i.e. available
  19.     disk space, memory, screen resolution etc.
  20.  
  21.   + Dynamic one/two-dimensional tables (arrays) consisting of dynamic text-
  22.     strings enables you to manipulate significantly bigger amounts of data
  23.     than Visual Basic alone can handle. Smart sorting, seek, read files,
  24.     write to file, linking to spreadsheets etc. is also included.
  25.  
  26.   + Encryption algorithms (with no "back-door") enables you to easily
  27.     protect your data against unwanted intruders.
  28.  
  29.   + Elegant copy protection of software and applications. This software
  30.     (IDBTOOLS) is using the same copy protection itself, so try it out and
  31.     evaluate.
  32.  
  33.   IdbTools is a IDB MICRO ADEPT AS product. This package is intended for
  34.   Visual Basic, but the same software is also available for C++.
  35.  
  36.   Please see the enclosed files IDBTOOLS.WRI and IDBTABLE.WRI (standard
  37.   Windows 3.1 Write format - can also be read from MS Word) for a detailed
  38.   description of routines and functionality.
  39.  
  40.   This software is distributed as "shareware" (se below for details), and we
  41.   intend to ship regular updates in the near future. If this file is more
  42.   than a couple of months old (see file-date), it is likely that there is a
  43.   newer release in circulation, so call your favorite BBS's to get the
  44.   most recent version.
  45.  
  46.  
  47.   Any comments and/or suggestions are welcome, and can be sent/mailed to:
  48.  
  49.   Idb Micro Adept AS                                    idb@vestnett.no
  50.   Strandgt. 207                                         """""""""""""""
  51.   5004 BERGEN
  52.  
  53.  
  54.  
  55. _____________________________________________________________________________
  56.  
  57. NB: This file contains special characters based on WINDOWS (Ansi) character
  58.     set. If you use a DOS program to read this, special characters will not
  59.     occur correctly,  and the enclosed examples will not be readable.
  60.     If that is the case, quit this file and access the file README.TXT
  61.     instead which contains this text based on the Ascii character set.
  62. _____________________________________________________________________________
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. _____________________________________________________________________________
  71.  
  72. > TABLES
  73.  
  74.   A table is a matrix of text-strings, which can be compared to an invisible
  75.   spreadsheet in RAM. The tables can be dimensioned according to your needs,
  76.   and dynamic changes can be made at any time. You can read tables directly
  77.   from a number of file formats, and the tables are automatically
  78.   dimensioned according to the file-contents. The same applies for writing
  79.   tables to different file formats.
  80.  
  81.   Reading and writing data from/to tables, seek and sort are very fast
  82.   operations.
  83.  
  84.   The sorting routine for tables has some unique features. It is the only
  85.   sorting routine known that gives a logical sorting of text containing
  86.   numbers.
  87.  
  88.   Example:      Ordinary sorting                IDBTOOLS SmartSort
  89.  
  90.                 Number 1 of 100                 Number 1 of 100
  91.                 Number 10 of 100                Number 2 of 100
  92.                 Number 100 of 100               Number 10 of 100
  93.                 Number 2 of 100                 Number 20 of 50
  94.                 Number 20 of 100                Number 20 of 100
  95.                 Number 20 of 50                 Number 100 of 100
  96.  
  97.   Sorting of special characters is greatly improved compared to most
  98.   competing sort-routines. Characters like /E/╔/e/Θ/Φ/δ/Ω/ are treated as
  99.   variations on the same letter, i.e. the difference is only significant
  100.   for the sort-order when the remaining characters are identical.
  101.  
  102.   Example:
  103.                 Sequence 1
  104.                 SequΦnce 2
  105.                 Sequence 3
  106.                 SequΦnce 3
  107.                 SequΦnce 4
  108.                 SequencΦ 5
  109.                 SequencΘ 6
  110.  
  111.   Between record 1 and 2 the difference between "e" and "Φ" has no
  112.   significance since the remaining characters are different. The same
  113.   applies for record 2 and 3. The only difference between record 3 and 4
  114.   is "e"/"Φ", and consequently the record containing "e" will be sorted in
  115.   front of the other, since "e" is defined before "Φ".
  116.  
  117.   You may say that this is plain trivia, but may change your mind when you
  118.   see how most other programs handles sorting of the same records:
  119.  
  120.                 Sequence 1
  121.                 Sequence 3
  122.                 SequencΘ 6
  123.                 SequencΦ 5
  124.                 SequΦnce 2
  125.                 SequΦnce 3
  126.                 SequΦnce 4
  127.  
  128.   IdbTools contains several different seek-routines for finding data in a
  129.   table, i.e. exact match, wildcards and binary-search (data in a sorted
  130.   table)
  131. _____________________________________________________________________________
  132.  
  133. > STRING-HANDLING / INI-FILES
  134.  
  135.   Most Visual Basic programmers sooner or later faces the "problem" that
  136.   most program-utilities for returning strings, anticipates that the calling
  137.   program has allocated space for the returned string. To illustrate this
  138.   we will show you the difference between reading INI-files traditionally
  139.   (via API) and using IdbTools:
  140.  
  141.   ' Read name of starting program for Windows from SYSTEM.INI:
  142.  
  143.     Declare Function GetPrivateProfileString% Lib "Kernel" (ByVal pAppName$,
  144.                      ByVal pKeyName$, ByVal pDefault$,
  145.                      ByVal pReturnedString$, ByVal nSize%, ByVal pFileName$)
  146.  
  147.     txt$ = String$(80, " ") ' Reserve space for 80 chars
  148.     len% = GetPrivateProfileString("boot","shell","",txt$,80,"SYSTEM.INI")
  149.     StartProg$ = Left$(txt$, len%) ' Possible result: "progman.exe"
  150.  
  151.   ' Same as above using IdbTools (IDBTOOLS.BAS is included in the project):
  152.  
  153.     StartProg$ = IniFileGetString("SYSTEM.INI", "boot", "shell")
  154.  
  155.   I think we have made our point, and showed beyond reasonable doubt which
  156.   method is the easiest to PROGRAM, MAINTAIN and last but not least to
  157.   UNDERSTAND!
  158.  
  159.   IdbTools provide a number for powerful routines for string-manipulation
  160.   that Visual Basic "lacks": pick words from strings, swap part of strings,
  161.   formatting, translation between DOS and Windows character sets and much
  162.   more. See IDBTOOLS.WRI for a complete and detailed documentation.
  163.  
  164. _____________________________________________________________________________
  165.  
  166. > SYSTEM INFORMATION
  167.  
  168.   Routines that gives easy access to system-information: screen resolution,
  169.   number of colors, free disk-space, available RAM, disk(ette)-unit status
  170.   etc. Details on environment variables and directory information can be
  171.   read directly into tables.
  172.  
  173. _____________________________________________________________________________
  174.  
  175. > ENCRYPTION
  176.  
  177.   If you want to protect data against unwanted intruders, you can achieve
  178.   this by using the IdbTools encryption routines. These routines are not
  179.   based on any standard algorithm specified by "Big Brother", and has
  180.   therefore no "back door". There is no possibility what so ever to recover
  181.   an encrypted string without the correct key - not even for us who made
  182.   the program.
  183.  
  184.   The routines are very simple in use; you specify the text-string to be
  185.   coded together with the "secret key" and the result is a completely
  186.   unreadable string. When decoding the same string, you specify the
  187.   unreadable string and its key, and the original string is returned.
  188.   Using wrong keys will not unlock any doors.
  189.  
  190.   Example:
  191.  
  192.           TextIn$  = "Private information..."
  193.           Secret$  = "Sesam$╔zaM"
  194.           Crypt$   = Encrypt (TextIn$, Secret$)
  195.           TextOut$ = Decrypt (Crypt$,  Secret$)
  196.  
  197.   ' TextOut$ and TekstIn$ will be identical, and
  198.   ' Crypt$ will contain an unreadable string.
  199. _____________________________________________________________________________
  200.  
  201. > COPY PROTECTION
  202.  
  203.   The program library IDBTOOLS.DLL is copy protected. If you have no valid
  204.   license, you will be made aware of this by an annoying pop-up window
  205.   reminding you to contact IDB and purchase a copy. Most of the IdbTools
  206.   routines will for the time being function without the annoying reminder,
  207.   but when you use table-functions or the encryption routines, the testing
  208.   for a valid license is activated.
  209.  
  210.   The only way to get rid of the "license-alarm" is to purchase a license
  211.   code from IDB. The license-code consists of a 6-letter alphanumeric string
  212.   which is derived from the name of the licensee. The license-name and
  213.   corresponding code must be inserted into all programs using IdbTools:
  214.  
  215.      status% = LisenseIdbTools("User Name, Address", "CODE01")
  216.  
  217.   This code is inserted in Form Load in the applications startup form.
  218.  
  219.   All applications using IdbTools must have a license for the name holding
  220.   Copyright for the application. IDBTOOLS.INI will contain a list of all
  221.   programs using IDBTOOLS. If the application is using a licensed version
  222.   of IdbTools, the licensee name will appear as the copyright holder of the
  223.   application. This means that an application using a "borrowed" license
  224.   code will appear as copyrighted by the name connected to the violated
  225.   license. Somebody actively programming a call to LicenseIdbTools using
  226.   somebody else's name and code, can not claim to have acted in good faith.
  227.  
  228.   A similar copy protection scheme is available for all applications
  229.   using IdbTools, provided a valid license:
  230.  
  231.   The call      code$ = LicenseGetCode("User Name","SECRET_KEY")
  232.   will return a code for the given user name. This call is supposed
  233.   to be used in a program only available for the distributor of
  234.   the application.
  235.  
  236.   The following statement is put into the application:
  237.                 status% = LicenseProgram(UserName$, Code$, "SECRET_KEY")
  238.  
  239.   Depending on the result, status%, your application can determine whether
  240.   the username/code is valid for this program, and take appropriate actions.
  241.   Different applications can have different keys ("SECRET_KEY_PROG2").
  242.  
  243.   When LicenseProgram has been called with a valid code, the user name will
  244.   be inserted in IDBTOOLS.INI connected to the name of your application in
  245.   the group [License].
  246. _____________________________________________________________________________
  247.  
  248. > SHAREWARE: RULES FOR USE AND DISTRIBUTION
  249.  
  250.   IdbTools is distributed as "shareware". This term must not be mixed up
  251.   with "Freeware" or "Public domain". "SHAREWARE" is a method for
  252.   distribution of software which is protected by COPYRIGHT like all other
  253.   commercial software.
  254.  
  255.   The "shareware" concept give potential users the opportunity to evaluate
  256.   the software before they decide whether they want to pay for the right
  257.   to use it.
  258.  
  259.   It is perfectly legal to use this software for testing in a trial period.
  260.   A reasonable test period is estimated to be 30 days. Using the software
  261.   beyond a reasonable trial period, or including it in a commercial
  262.   program without a legal license, will be regarded as a violation of
  263.   our copyright.
  264.  
  265.   An important part of the "shareware" concept is that the user must have
  266.   a chance to test all parts of the software. If the software is only
  267.   partly working, or deliberately causes erroneous results, it should not
  268.   be called "shareware", but "crippleware". Some "shareware" software
  269.   is also called "nagware" because of the annoying pop-ups constantly
  270.   reminding the user about the lack of license. IdbTools is using this
  271.   approach, but you can still test all parts of it.
  272.  
  273.  
  274.   IDBTOOLS can be distributed freely on the following conditions:
  275.  
  276.   - All files in this package must be included (see PACKING.LST).
  277.  
  278.   - The files must be unchanged.
  279.     Archive file name must include version number (VBIT11.ZIP -> ver 1.1).
  280.     The date and time of the files should not be changed.
  281.     Time must correspond to the version number.
  282.  
  283.   - No files can be added to the package, with one exception: The BBS
  284.     distributing this software may include a short text file with a
  285.     short presentation of the BBS.
  286.  
  287.   - It is not allowed to charge any cost for the distribution of this
  288.     software, except for normal downloading fees (if any), without the
  289.     express permission from IDB MICRO ADEPT AS.
  290.  
  291.   We encourage you to give copies of this software to your friends and
  292.   colleagues, and to upload it to any BBS's that you use. For sample
  293.   descriptions suitable for BBS file listings, please see FILE_ID.DIZ
  294.   and DESC.SDI.
  295.  
  296. _____________________________________________________________________________
  297.  
  298. > COPYRIGHT / LIABILITY / CONDITIONS FOR USE
  299.  
  300.  
  301.   !    IDBTOOLS  Copyright (C) 1995  IDB MICRO ADEPT AS, BERGEN, NORWAY     !
  302.   !    ________________________________________________________________     !
  303.   !    Use this software  only  if you accept the following conditions:     !
  304.   !    """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""     !
  305.   !    THE SOFTWARE IDBTOOLS AND ACCOMPANYING DOCUMENTATION IS PROVIDED     !
  306.   !    AS IS WITHOUT WARRANTY OF ANY KIND. ALL USE IS AT YOUR OWN RISK.     !
  307.   !    IDB MICRO ADEPT AS CAN NOT BE MADE LIABLE FOR ANY DAMAGES CAUSED     !
  308.   !    BY USE OF THIS SOFTWARE AND DOCUMENTATION.                           !
  309.   !    OWNER OF A LEGAL LICENSE FOR IDBTOOLS  IS COMMITTED TO KEEP THIS     !
  310.   !    CODE  UNAVAILABLE FOR OTHERS.    DELIBERATE  DISTRIBUTION  OF  A     !
  311.   !    LICENSE  CODE  WILL  BE REGARDED AS  A  SEVERE  VIOLATION OF THE     !
  312.   !    LICENSE CONDITIONS AND A VIOLATION OF IDB'S COPYRIGHT,  AND WILL     !
  313.   !    BE PROSECUTED.                                                       !
  314.  
  315. _____________________________________________________________________________
  316.  
  317. > LICENSE-CODES / PRICE
  318.  
  319.   Contact IDB MICRO ADEPT AS to get a license code.
  320.   Current prices are:
  321.  
  322.   In Norway:           NOK 425 incl. M.V.A.  (REG: NO865975392MVA)
  323.   All other countries: US $ 55
  324.  
  325.   A valid license code gives you the right to distribute IDBTOOLS.DLL
  326.   with your programs.
  327.  
  328.  
  329.   ------------------------------
  330.   * TIME LIMITED SPECIAL OFFER *
  331.   ------------------------------
  332.   If you pay for a IdbTools license before march 1st 1995, you will
  333.   also get the right to use and distribute IDBVTSS.DLL. This module
  334.   contains the necessary routines for connecting IdbTools to the
  335.   spreadsheet product Formula One from Visual Tools. This product is
  336.   exceptionally suitable for presentation of IdbTools Tables, and also
  337.   give the possibility to import/export Excel (4.0) spreadsheets to
  338.   the Tables via Formula One.
  339.  
  340.   In future versions, IDBVTSS will be sold as a separate add-on tool.
  341.  
  342. _____________________________________________________________________________
  343.  
  344. > ORDERING INFORMATION / PAYMENT:
  345.  
  346.   Send to:                                              Idb Micro Adept AS
  347.                                                         Strandgaten 207
  348.                                                         N-5004 Bergen, Norway
  349.  
  350.   ___________________________________________________________________________
  351.   |                                                                         |
  352.   |         The following information must accompany the payment:           |
  353.   |         =====================================================           |
  354.   |                                                                         |
  355.   |     Name       _________________________________________________________|
  356.   |                                                                         |
  357.   |     Address    _________________________________________________________|
  358.   |                                                                         |
  359.   |     Postcode   _________________________________________________________|
  360.   |                                                                         |
  361.   |     City       _________________________________________________________|
  362.   |                                                                         |
  363.   |     Country    _________________________________________________________|
  364.   |                                                                         |
  365.   |     Date       ___________________________   Phone: ____________________|
  366.   |                                                                         |
  367.   |     Has paid   ___________ for IdbTools license (see PRICE above):      |
  368.   |          _                                                              |
  369.   |         [_]    Check / money order enclosed                             |
  370.   |         [_]    BankGiro: 9521.05.69325 (A/S Bergens Skillingsbank)      |
  371.   |         [_]    PostGiro: 0826.02.47787 (CCP du bΘnΘficiaire             |
  372.   |                                         NorvΦge Service des             |
  373.   |                                         chΦques postaux)                |
  374.   |                                       _                                 |
  375.   |     Want to receive the license code [_] via E-mail: ___________________|
  376.   |                                      [_] via post.                      |
  377.   |                                      [_] via Fax:    ___________________|
  378.   |     IdbTools version:      ________                                     |
  379.   |                                                                         |
  380.   |     Where did you find IdbTools? _______________________________________|
  381.   |_________________________________________________________________________|
  382.  
  383.   If you pay directly to the bank account or international Post services,
  384.   you may prefer to send the above information as E-mail via internet to:
  385.  
  386.   idb@vestnett.no
  387.  
  388.   We will send the code to you as soon as we have confirmed the payment.
  389.  
  390. _____________________________________________________________________________
  391.  
  392. > DOCUMENTATION - LANGUAGES
  393.  
  394.   This text is available in the following languages:
  395.  
  396.         Norwegian       README_N.TXT    (Windows: README_N.WIN)
  397.         English         README.TXT      (Windows: README.WIN)
  398.  
  399.   The documentation (IDBTOOLS.WRI and IDBTABLE.WRI) is for the time being
  400.   only available in English.
  401.  
  402.   If your native language is not one of the above, and you wish to
  403.   contribute making this text and/or the documentation available in
  404.   your language, please contact us for discussing terms of cooperation.
  405. _____________________________________________________________________________
  406.  
  407. > FEEDBACK
  408.  
  409.   If you have comments, error reports, suggestions for improvements and
  410.   extensions, please write to:
  411.  
  412.   Idb Micro Adept AS                                    idb@vestnett.no
  413.   Strandgaten 207                                       ^^^^^^^^^^^^^^^
  414.   N-5004 Bergen, Norway
  415. _____________________________________________________________________________
  416. _______________________________END_OF_README_________________________________
  417.