home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c004 / 1.ddi / READ.ME < prev   
Encoding:
Text File  |  1989-04-18  |  6.9 KB  |  189 lines
  1. c-tree(R) V4.3 Release C
  2. February 7, 1989 17:30
  3.  
  4. --------
  5. Installation
  6. ---------
  7. Use the accompanying INSTALLATION GUIDE to create your c-tree directories.
  8.  
  9. ---------
  10. Different Environment
  11. ---------
  12. If your environment is not one of the specific ones listed in the 
  13. INSTALLATION GUIDE, then proceed with the closest match.  The system 
  14. specific files are:
  15.  
  16.     CTCLIB.C - low level file I/O and optional record locking
  17.     CTCMPL.H - a few compiler dependent constants pertaining to
  18.             - file permissions
  19.             - signed or unsigned chars
  20.             - definition of a null data pointer
  21.     CTOPTN.H - c-tree configuration parameters
  22.     
  23. The root directory of Disk 1 contains generic versions of these files under 
  24. the names CTCLIB.D, CTCMPL.D and CTOPTN.D, respectively; and the root 
  25. directories of Disk 1 and Disk 2 contain all of the system independent files.
  26.  
  27. Note that you can compile and run CTTEST.C to help determine how to set-up 
  28. your system. You will need to consult with your C run-time library 
  29. documentation for the open() and creat() functions in order to specify the
  30. file permission parameters in CTCMPL.H.
  31.  
  32. ---------
  33. Code Changes
  34. ---------
  35. Be sure to carefully examine the c-tree START UP GUIDE which accompanies this 
  36. package. It may contain important source code changes which should be made 
  37. prior to compiling and using c-tree.
  38.  
  39. You can now create applications with Turbo C which use the c-tree Netbios
  40. Server and the c-tree Novell VAP Server. See README.TC in the "TC" subdirectory.
  41.  
  42. If you are using a 32 bit system, you may extend the maximum variable length
  43. data record beyond 65,536 bytes by modifying CTPORT.H as described in
  44. Installation Section 4.2.
  45.  
  46. ---------
  47. Installation Update
  48. ---------
  49. There is a new configuration option which controls how a c-tree automatic
  50. sequence number is stored in your record. Prior to Release C, the sequence
  51. number (see Reference Section 1.7.2) was always stored in MSB to LSB order
  52. (i.e., that most significant bytes first).
  53.  
  54. By adding the following preprocessor command to your CTOPTN header, c-tree
  55. will now store the sequence number as a long integer in your record.
  56.  
  57.     #define NATURAL_SERIAL
  58.  
  59.  
  60. Without this new definition, c-tree stores the sequence number in reverse byte
  61. order on 8086/286/386 machines. For example, sequence number 1 would appear
  62. as 16,777,216 if printed as a long integer.
  63.  
  64. This change should not affect HIGH_LOW machines (e.g., 68000) unless UNIFRMAT
  65. has been selected in which case the addition of NATURAL_SERIAL will cause
  66. the sequence number to be stored in LSB to MSB order (the natural order on
  67. LOW_HIGH machines).
  68.  
  69. If you are changing an existing application, note that you should first
  70. modify existing sequence numbers to make them consistent with the new ordering.
  71.  
  72. ---------
  73. Installation Guide Correction
  74. ---------
  75. In Installation Section 4.2.1, change CT_SERVER to CTSERVER.
  76.  
  77. ---------
  78. "End of Set" Modification
  79. ---------
  80. In prior c-tree releases, a NXTSET (PRVSET) call made from the End (Beginning)
  81. of a set, caused the set to become undefined. A LSTSET (FRSSET) call was re-
  82. quired to return to the set. In Release C, NXTSET (PRVSET) no longer causes
  83. an undefined set at the End (Beginning) of a set. In such a case, your position
  84. remains unchanged; you stay at the End (Beginning) of the set. To restore the
  85. code to the previous (Release B2) behavior, simply remove the comments from the 
  86.  
  87.         /* seqkey = -1; */
  88.  
  89. statements at lines 110 and 116 of CTSSET.C.
  90.  
  91. ---------
  92. Reference Card Additions
  93. ---------
  94. The following information is not included on your Reference Card. We
  95. suggest you manually add the appropriate information for your subsequent use.
  96. Error codes 25, 53, 55, 56, 57, 58, 59, 60 and 105 must be added (see
  97. Reference Section 8.1); and the low level functions DELFIL, FRCKEY, ESTKEY
  98. and LOADKEY must be added.
  99.  
  100. ---------
  101. r-tree Requirements
  102. ---------
  103. Before you perform any compilations or make files, be sure to set the 
  104. RTREE parameter appropriately in CTOPTN.H.
  105.  
  106. If you do not use r-tree, then
  107.  
  108.     - define NO_RTREE in ctoptn.h 
  109.     - rename CTEXAM.NOR and CTVXAM.NOR to CTEXAM.P and CTVXAM.P, 
  110.       respectively.
  111.     - skip the rest of this r-tree section.
  112.  
  113.  
  114. If you do use r-tree, be sure that RTREE is defined in CTOPTN.H.
  115.  
  116. To utilize c-tree V4.3 with r-tree, follow these steps:
  117.  
  118.     Step 0: ensure that the r-tree source code is installed (but not
  119.         yet compiled) in a sister directory
  120.  
  121.     ************************************************************************
  122.     *** STEPS 1, 2 and 3 DO NOT APPLY TO r-tree V1.1 Release E or later. ***
  123.     ************************************************************************
  124.  
  125.     Step 1: delete RTSSET.C, RTISAM.C and RTISMU.C from your r-tree
  126.         directory
  127.     Step 2: copy RTCTRE.H from your c-tree V4.3 Release C diskette #2
  128.         to your r-tree directory
  129.     Step 3: enable the FLOATKEY option in CTOPTN.H
  130.  
  131.     ************************************************************************
  132.  
  133.     Step 4: enable the RTREE option in CTOPTN.H
  134.     Step 5: compile and make a c-tree library
  135.     Step 6: compile and make an r-tree library
  136.  
  137. ---------
  138. Make Files
  139. ---------
  140. There are a wide variety of make files included with the c-tree package. They 
  141. fall into three broad categories:
  142.  
  143.     - UNIX-like make files which are top-down oriented (the main end-
  144.       products come first). In addition to Unix and Xenix, the Aztec C make
  145.       files are organized this way.  If you have the PLOYTRON make file
  146.       utility, you will want to adapt one of the existing top-down makes
  147.       to your environment.
  148.       
  149.     - Microsoft make files which are bottom-up oriented (the lowest level
  150.       components of the main end-products come first)
  151.       
  152.     - Project files which simply list the components of an end product. The
  153.       LightSpeed compiler uses this form of "make" file.
  154.       
  155. ---------
  156. Excessive Compiler Warnings
  157. ---------
  158. If, during compilation, you receive an excessive number of warning messages,
  159. check your definition for ct_NULL in CTCMPL.H.  You may want to
  160. change ct_NULL from 
  161.  
  162.     (char *) 0
  163. to
  164.     0 or 0L  (depending on the size of a zero data pointer.
  165.       
  166. ---------
  167. Start-Up Testing
  168. ---------
  169. Once you have compiled the source modules, made your libraries and created 
  170. the four example programs: CTEXMC, CTEXMG, CTVXMG and CTIXMG, run the 
  171. examples to determine if c-tree is performing correctly.  In particular, be 
  172. sure to add, delete, then add some more items with the examples.
  173.  
  174. ****    NOTE:    CTEXMC must be used with the parameter files ctexam.p and
  175. ****        ctvxam.p to create the files for the CTEXMG and CTVXMG
  176. ****        examples, respectively. CTEXMC must be run BEFORE attempting
  177. ****        to use CTEXMG and CTVXMG.
  178.  
  179. ---------
  180. Macintosh Files
  181. ---------
  182. FairCom no longer ships the Apple Macintosh files for c-tree on DOS diskettes.
  183. If you also require the c-tree files for a Macintosh, please contact FairCom;
  184. and have your c-tree serial number handy.
  185.  
  186. ---------
  187. End
  188. ---------
  189.