home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a072 / 1.img / README.TXT < prev   
Encoding:
Text File  |  1991-09-19  |  10.1 KB  |  236 lines
  1.                               FlexFile
  2.                             Version 1.07
  3.                         Ganahl Software, Inc.
  4.                          Copyright (c) 1991
  5.  
  6.  
  7.     Please read the contents of this file.  It represents changes to
  8.     the documentation which occurred after printing and in some cases
  9.     represents information critical to the use of FlexFile.
  10.  
  11.     In all cases, the Norton Guides database (FlexFile.ng) and the
  12.     (FlexFile.doc) supercede the printed manual. In addition, all
  13.     elements discussed in this readme file are incorporated into the
  14.     Guides and FlexFile.doc.
  15.  
  16.     Note: FlexFile is a commercial product.  Do not make any copies
  17.     except for archival purposes.
  18.  
  19.  
  20. Ganahl Software, Inc.
  21. P.O. Box 4275
  22. Deerfield Beach
  23. Tel: (305) 566-1796
  24. FAX: (305) 566-3517
  25.  
  26. *************************************************************************
  27. General Notes (Ver 1.07)
  28.  
  29. This readme file is updated in reverse chronological order.  Therefore,
  30. if you already own FlexFile and receive this as an update, you will only
  31. have to read down to your previous version.
  32.  
  33. The only change in Ver 1.07 is the addition of the encryption and
  34. decryption functions V_ENCRYPT(), V_DECRYPT() and V_SETKEY().  See the
  35. Norton Guides Database (included in self extracting arcive FlexFile.exe).
  36.  
  37. *************************************************************************
  38. General Notes  (Ver 1.06)
  39.  
  40. Version 1.06 is a minor upgrade addressing a few minor bugs and adding a
  41. couple of new functions.
  42.  
  43. The main feature, however, is internal error checking for programmer
  44. errors.  There were several instances in previous versions where, if the
  45. program went awry, the DBV file would get corrupted.  Error checking has
  46. been introduced to thwart corruption (even by code that behaves poorly).
  47.  
  48. *************************************************************************
  49. General Notes  (Ver 1.03, 1.04, 1.05)
  50.  
  51. Minor bug fixes.
  52.  
  53. *************************************************************************
  54. General Notes  (Ver 1.02)
  55.  
  56. Version 1.02 of FlexFile is primarily a maintenance release.  However, the
  57. system which saves and restores Clipper arrays has been completely
  58. rewritten.  This should only affect you if ALL of the following three
  59. conditions apply to you.
  60.  
  61.    1. You have an application written in Clipper 5.0x that is sharing a
  62.    FlexFile DBV file with an application written in S87.
  63.  
  64.    2. You had saved a Clipper S87 array to this FlexFile DBV using the
  65.    FLEX_87.LIB version 1.01 or less (version 1.01 was dated 2/18/91).
  66.  
  67.    3. You want to retrieve that array with a program linked with
  68.    FLEXFILE.LIB version 1.02 or greater (version 1.02 is dated 7/27/91).
  69.  
  70. The only change you must make is to use V_FILLEN() in place of V_LEN() when
  71. DECLAREing the array.  To get a full description of this process, read the
  72. documentation on V_FILLEN() and V_FILLARR() in the Norton Guides data base
  73. or the FlexFile.doc documentation.
  74.  
  75. The good news is that any array saved with this *new* FLEX_87.LIB (version
  76. 1.02) are totally compatible with single dimentional arrays saved or
  77. restored with the *new* FLEXFILE.LIB (version 1.02).  That means that you
  78. do not have to use the V_FILLARR() functions in your 5.0 code to read
  79. arrays that are created with S87 code version 1.02.  Read the documentation
  80. on V_ARETRIEVE() and V_FILLARR() to understand how to implement these
  81. functions for Clipper 5.0x code and for Summer 87 code, respectively.
  82.  
  83. The reason for all these array changes is a vast improvement in speed and a
  84. substantial reduction in size of the *new* stored arrays.
  85.  
  86. *************************************************************************
  87.  
  88. The following functions were omitted from the manual because they are new
  89. since the time of printing. They are fully documented in the Guides and the
  90. text documentation "FlexFile.doc".
  91.  
  92. V_ARETRIEVE() - Retrieve an array from a field (Clipper 5.0 only)
  93. V_AREPLACE()  - Replace old data with an array (Clipper 5.0 only)
  94. V_COMMIT()    - Commit DOS buffers to disk. (DOS 3.3 or greater)
  95. V_DECRYPT()   - Decrypt a variable previously encrypted with V_ENCRYPT().
  96. V_ENCRYPT()   - Encrypt a Clipper string to an unreadable form.
  97. V_FILLEN()    - Get length of array saved by FLEX_87.lib (ver 1.01 or less).
  98. V_HANDLE()    - Return the DOS file handle for a DBV file.
  99. V_ISOPEN()    - Determine if a file is open in a DBV work area.
  100. V_RANDOM()    - Return or seed a psuedo random number.
  101. V_SET_COMMIT()- Set DBV/DOS buffer flushing automatically on/off.
  102. V_SETKEY()    - Set a password key to be used with V_ENCRYPT() and V_DECRYPT()
  103. V_TOPPTR()    - Read/Replace FlexFile data without a DBF file (advanced).
  104. V_WALK_DBV()  - Step from field to field in a DBV file without a DBF.
  105. V_WNDCREATE() - Create a Proclip window from one previously V_REPLACE()d
  106.  
  107. ******************************************************************************
  108. Disaster Recovery
  109.  
  110. Read the documentation on Disaster Recovery in the Norton Guides data base
  111. or the FlexFile.doc file.  This outlines probable causes of corrupted DBV
  112. files, methods for recovery of corrupted DBV files, and how to manage a DBV
  113. file when its related DBF file is lost or dammaged.  Read the documentation
  114. on V_WALK_DBV() if you have lost the controlling DBF for a DBV.
  115.  
  116. ******************************************************************************
  117. FlexFile Strongly Typed Arrays
  118.  
  119. FlexFile's Strongly Typed Arrays were designed primarily to allow
  120. multi-dimensional arrays in far less memory.  However, because of the new
  121. VMM system in Clipper, flexfile's "S"tring type arrays SHOULD NOT BE USED
  122. with Clipper 5.0x.  They will actually use more conventional memory than
  123. their Clipper counterparts.  However, all other types of FlexFile arrays
  124. are handled properly by the VMM system and will be smaller and more
  125. efficient than their Clipper counterparts.
  126.  
  127. The Clipper 5.0 A_ADD() and A_SIZE() had some problems in the version 1.01
  128. and version 1.00.  These functions have been fixed in version 1.02.
  129.  
  130. ******************************************************************************
  131. Version 1.01
  132. *************************************************************************
  133.  
  134. The manual (pg. 10) states that V_USE will fail (returning -1) if
  135. you are V_USE()ing a file in shared mode and are working on a
  136. local drive that does not have SHARE.EXE loaded.  This was
  137. changed in order to be compatable with Clipper's USE and locking
  138. functions.
  139.  
  140. The new implementation allows a file to be opened in shared mode
  141. on a local drive (even if SHARE.EXE is not loaded).  No actual
  142. locking is provided, of course, until SHARE.EXE is loaded or
  143. until a network shell such as NET4 is introduced into the
  144. environment.
  145.  
  146. *************************************************************************
  147.  
  148. A_DECLARE() has a main syntax and an optional syntax.  The
  149. printed documentation has a misprint in the optional sytax for
  150. the function (bottom of page 77).
  151.  
  152. The printed documentation reads (incorrectly):
  153.  
  154.     aLargeArr = A_DECLARE(@<aLargeArr>,
  155.                            <cType>,
  156.                            <nElement>,
  157.                            [<nElements>...] )
  158.  
  159. The following syntax is what was intended:
  160.  
  161.     // Do not use the return value from A_DECLARE when passing
  162.     // the array by reference.  Also, note the order of parameters
  163.     // one and two.
  164.      A_DECLARE( <cType>,
  165.                @<aLargeArr>,
  166.                 <nElement>,
  167.                 [<nElements>...] )
  168.  
  169. *************************************************************************
  170.  
  171. Binary (logical) arrays are not supported by many of the FlexFile
  172. array functions.  For example, you cannot A_SORT() a binary array. The
  173. FlexFile array functions which operate on binary arrays are:
  174.  
  175.              A_STORE()
  176.              A_SCAN()
  177.              A_RETRIEVE()
  178.              A_LEN()
  179.              A_TYPE()
  180.  
  181. The printed manual failed to recognize this fact in several of the
  182. array functions.
  183.  
  184. Note also, that the previous "Readme.txt" file specifically stated that
  185. A_SCAN() did not support binary arrays.  A_SCAN() does support binary
  186. arrays; the readme file was in error.
  187.  
  188.  
  189. *************************************************************************
  190.  
  191. Many of the array functions are described in the manual as having a
  192. default scope of "to the end of the row in the current dimension".
  193. This was changed in every case to be "to the end of the array".
  194.  
  195. So, for example, if you are copying one array into another and do not
  196. pass a parameter indicating how many elements to copy, FlexFile will
  197. copy all elements to the end of the array.  This is true for multi-
  198. dimensional arrays as well. See the section on ARRAYS in the manual
  199. to understand the "wrapping" behavior of functions like these that span
  200. several dimensions.
  201.  
  202. *************************************************************************
  203. The following functions have had minor changes in the written
  204. documentation.  The Norton Guides and the "FlexFile.doc" file have
  205. the most up to date documentation on these functions.
  206.  
  207.    A_AVERAGE()
  208.       if nCount is not specified, the average will continue until
  209.       the end of the array, not the end of the current row.
  210.    A_ADD()
  211.       <aTarget> _must_ be passed by reference.
  212.       return is .t. or .f. not value.
  213.       value is no longer a parameter.
  214.    A_SIZE()
  215.       <aTarget> _must_ be passed by reference.
  216.    V_REPLACE()
  217.       returns a (.F.) on error
  218.    A_RETRIEVE()
  219.       returns a '' on error
  220.    V_POKE()
  221.       optional parameter  #3 was not originally optional
  222. **************************************************************************
  223.  
  224.    The error codes in Appendix B have be defined explicitly in
  225.    the Guides and in FlexFile.doc
  226.  
  227. **************************************************************************
  228.  
  229.    The manual states that a V_REPLACE( "", old_fld ) is not the same
  230.    as a V_DELETE().  This has been changed so that the two have the
  231.    same affect.  The above stated V_REPLACE will return six spaces
  232.    which is a "null pointer" to FlexFile. All space that was associated
  233.    with old_fld will become available for use by other data.
  234.  
  235. **************************************************************************
  236.