home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c023 / 1.img / PROGRAMS / README.SET < prev    next >
Encoding:
Text File  |  1987-11-05  |  6.9 KB  |  134 lines
  1.               Setting up the CBTREE compilation environment
  2.  
  3. After reading this, read README.230 for updates to the manual.
  4.  
  5. CBTREE comes in two parts: the CBTREE Library modules and the modules for the
  6. support programs.  These come on two separate disks or in two directories
  7. on the same disk.  The directories/volumes will be named 'Library' and
  8. 'Programs' respectively.
  9.  
  10. In each case there will be subdirectories attached to each of the main
  11. directories representing the compilers which are directly supported.  For
  12. example, you will see subdirectories named:
  13.  
  14.                   AZTEC       - for Manx Aztec compiler
  15.                   COMPINNO    - for Computer Innovation's C86 compiler
  16.                   DESMET      - for DeSmet compiler
  17.                   LATTICE     - for Lattice C
  18.                   MARKWILL    - for Mark Williams compiler
  19.                   MICROSOFT   - for Microsoft
  20.                   TURBOC      - for Borland's Turbo C
  21.                   XENIX       - for Xenix and Unix environments.
  22.  
  23. Separate versions of these subdirectories will be found in both the 'Library'
  24. and the 'Programs' directories.
  25.  
  26. In the 'Library' subdirectories, there will generally be found four files:
  27.  
  28.                   CBTRDEF.H   - the CBTREE definition header file.
  29.                                 This file specifies which compiler is in use
  30.                                 along with other environment-specific
  31.                                 definitions.
  32.                   SETUPxx.BAT - this batch file sets up the compilation
  33.                                 environment for the compiler specified by
  34.                                 the code 'xx'.  THIS FILE SHOULD BE MODIFIED
  35.                                 to suit your particular development
  36.                                 environment.
  37.                   CCLIBxx.BAT - this batch file compiles the CBTREE Library
  38.                                 modules into object form.  YOU MAY NEED TO
  39.                                 MODIFY THIS BATCH FILE so that it will
  40.                                 correctly find the local "cbtree.h" and
  41.                                 standard <stdio.h> header files.
  42.                   MKLIBxx.BAT - this batch file will regenerate the library
  43.                                 from the object modules.  The order in which
  44.                                 the modules are combined may be significant
  45.                                 in certain environments.  The library is
  46.                                 then copied into the standard directory for
  47.                                 compiler libraries.  The library has the
  48.                                 name:
  49.                                          LIBCBxxm.LIB
  50.                                 where xx is the compiler code and m is the
  51.                                 model.  The name may vary in different
  52.                                 environments.
  53.  
  54. In the 'Program' subdirectories, there will generally be found two files:
  55.  
  56.                   CCALLxx.BAT - this batch file compiles all the CBTREE
  57.                                 support programs and functions modules into
  58.                                 object form.  YOU MAY NEED TO MODIFY THIS
  59.                                 BATCH FILE so that it will correctly find
  60.                                 the local "cbtree.h" and standard <stdio.h>
  61.                                 header files.  The local headers will be in
  62.                                 the 'Library' directory.
  63.                   LNALLxx.BAT - this batch file will link all the CBTREE
  64.                                 programs to the CBTREE Library and the
  65.                                 compiler's standard library.  YOU MAY NEED
  66.                                 TO MODIFY THIS BATCH FILE so that it will
  67.                                 correctly locate the CBTREE Library.
  68.  
  69. To prepare for compilation, create two working directories: 'Library' and
  70. 'Programs'.  For ease of use of the existing batch files, these should be
  71. sibling directories, i.e. they should have the same parent.  This parent
  72. can be a special CBTREE directory.  For example, for version 2.20 you
  73. might set your directories up as follows:
  74.  
  75.                   \CB220
  76.                   \CB220\Library
  77.                   \CB220\Programs
  78.  
  79. The working 'Library' directory should have all the files from the main
  80. 'Library' distribution directory, PLUS all the files from the subdirectory
  81. for YOUR compiler.  After modifying the batch files to make sure they conform
  82. to your development environment, you are ready to type:
  83.  
  84.                   SETUPxx
  85.                   CCLIBxx
  86.                   MKLIBxx
  87.  
  88. This will create the library and place it in the standard compiler directory
  89. with other libraries.
  90.  
  91. Likewise, the working 'Programs' directory should have all the files from the
  92. main 'Programs' distribution directory, PLUS all the files from the
  93. subdirectory for YOUR compiler.  After modifying the batch files to make sure
  94. they conform to your development environment, you are ready to type:
  95.  
  96.                   CCALLxx
  97.                   LNALLxx
  98.  
  99. This will create all the CBTREE support programs.
  100.  
  101.  
  102.  
  103. Environments with MAKE Utilities:
  104. ---------------------------------
  105.  
  106. In the 'Library' subdirectories, these files (amoung others) will be found:
  107.  
  108.                   CBTRDEF.H   - the CBTREE definition header file.
  109.                                 This file specifies which compiler is in use
  110.                                 along with other environment-specific
  111.                                 definitions.
  112.                   SETUPxx.BAT - this batch file sets up the compilation
  113.                                 environment for the compiler specified by
  114.                                 the code 'xx'.  THIS FILE SHOULD BE MODIFIED
  115.                                 to suit your particular development
  116.                                 environment.
  117.                   MKLIBxx.BAT - this batch file invokes the MAKE file which
  118.                                 regenerates the object modules. YOU MAY NEED
  119.                                 TO MODIFY THE MAKE FILE so that it will
  120.                                 correctly locate the standard header files.
  121.                                 The newly created CBTREE library is then
  122.                                 copied into the standard directory
  123.                                 for your compiler's libraries.
  124.  
  125. In the 'Program' subdirectories, there will generally be found many make 
  126. files but only a single batch file:
  127.  
  128.                   MKPGMxx.BAT - this batch file invokes a series of MAKE
  129.                                 files which compile and link the CBTREE
  130.                                 support programs.  YOU MAY NEED TO MODIFY
  131.                                 THE MAKE FILES so that they will correctly
  132.                                 find the CBTREE and standard header files.
  133.                                 They must also find the CBTREE Library.
  134.