home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c222 / 1.ddi / README < prev   
Encoding:
Text File  |  1991-01-25  |  7.7 KB  |  180 lines
  1.        Copyright (C) 1991 MetaWare Incorporated.  All Rights Reserved.
  2.  
  3.                          BlackStar C Function Library
  4.                                 January 1991
  5.  
  6. Installing the Library
  7. ----------------------
  8.  
  9. To install the BlackStar library files, make a subdirectory on the disk on
  10. which the library is to be installed, change to that directory, and with the
  11. BlackStar diskette in drive A type:
  12.  
  13.    a:install
  14.  
  15. For example, if you are installing the library on hard drive C and the
  16. BlackStar diskette is in drive A, type the following sequence of commands:
  17.  
  18.     c:
  19.     md blackstr
  20.     cd blackstr
  21.     a:install
  22.  
  23. If you are installing to a hard disk other than C or from a diskette drive
  24. other than A, the install batch file accepts explicit parameters for the
  25. source drive and destination drive.  For example, to install from diskette
  26. drive B to hard drive D:
  27.  
  28.     d:
  29.     md blackstr
  30.     cd blackstr
  31.     b:install b: d:
  32.  
  33.  
  34. Introduction
  35. ------------
  36.  
  37. The complete source code for the BlackStar Library is included in this
  38. distribution, in the following directories:
  39.  
  40.    clib      - System-independent C source code.
  41.  
  42.    ibmlib    - System-dependent C and assembly code.
  43.  
  44. Each of these directories has three object subdirectories that contain files
  45. for recompiling the libraries for use with different High C compilers:
  46.  
  47.    dx86_o    - Version 1.6 locally optimizing compiler for MS-DOS 80x86.
  48.  
  49.    d386_o    - Version 1.7 locally optimizing compiler for extended DOS
  50.                80386/486.
  51.  
  52.    gd386_o   - Version 2.3 globally optimizing compiler for extended DOS
  53.                80386/486.
  54.  
  55. In each object subdirectory you will find the following batch files:
  56.  
  57.    comp.bat  - Rebuild libraries.  Make the appropriate object directory (such
  58.                as d386_o) your current working directory, and type "comp".
  59.                comp invokes the compiler driver, setting the appropriate
  60.                macros for the given compiler.
  61.  
  62.    recomp.bat - Remake only the object modules for which source modules have
  63.                changed.  If you modify a source file, change directory to the
  64.                appropriate object directory and delete the corresponding
  65.                object module.  Then type recomp and the batch file will
  66.                recompile or reassmeble the source files for which object files
  67.                are missing, and then rebuild the library.
  68.  
  69. NOTE:  The batch files invoke some tools not supplied with High C.  The
  70. 386/486 versions of the batch files use the Phar Lap tools 386asm and 386lib.
  71. The 80x86 versions of the batch files use the Microsoft tools masm and lib to
  72. build the libraries.
  73.  
  74. WARNING:  IF YOU ARE USING MICROSOFT'S LINK.EXE, the linker must be told to
  75. increase the maximum number of segments allowed during the link.  This may be
  76. accomplished by setting the link environment variable with the following
  77. command (which may be included in your autoexec.bat file):
  78.  
  79.    set link=/SE:400
  80.  
  81.  
  82. Structure of this distribution
  83. ------------------------------
  84.  
  85. \source\clib            -- Source code for the machine-independent
  86.                             portions of the BlackStar library.
  87. \source\clib\dx86_o     -- Object modules for the 80x86 libraries.
  88. \source\clib\d386_o     -- Object modules for the 80386/486 libraries.
  89. \source\clib\gd386_o    -- Object modules for the 80386/486 for the
  90.                             globally optimizing compiler libraries.
  91. \source\ibmlib          -- Source code for the machine-dependent
  92.                             portions of the BlackStar library.
  93. \source\ibmlib\dx86_o   -- Object modules for the 80x86 libraries.
  94. \source\ibmlib\d386_o   -- Object modules for the 80386/486 libraries.
  95. \source\ibmlib\gd386_o  -- Object modules for the 80386/486 for the
  96.                             globally optimizing compiler libraries.
  97. \inc                    -- Header files for the BlackStar library.
  98. \lib                    -- Libraries for each of the three High C compilers:
  99.      clibs,ibmlibs      -- Small-model libraries for 80x86.
  100.      clibs,ibmlibc      -- Compact-model libraries for 80x86.
  101.      clibs,ibmlibm      -- Medium-model libraries for 80x86.
  102.      clibs,ibmlibl      -- Large-model libraries for 80x86.
  103.      clibs,ibmlibb      -- Big-model libraries for 80x86.
  104.      clib3,ibmlib3      -- Small-model emulation libraries for 80386/486.
  105.      clibg3,ibmlibg3    -- Small-model emulation libraries for the
  106.                            globally optimizing 80386/486 compiler.
  107.  
  108. \demos                  -- Source code for programs demonstrating the use of
  109.                             some of the BlackStar functions.
  110. \demos\dx86_o           -- Executables created with the 80x86 compiler.
  111. \demos\d386_o           -- Executables created with the 80386/486 compiler.
  112. \demos\gd386_o          -- Executables created with the 80386/486 globally
  113.                             optimizing compiler libraries.
  114. \utils                  -- Source code for three utility programs which use
  115.                             some of the BlackStar functions.
  116. \utils\dx86_o           -- Executables created with the 80x86 compiler.
  117. \utils\d386_o           -- Executables created with the 80386/486 compiler.
  118. \utils\gd386_o          -- Executables created with the 80386/486 globally
  119.                             optimizing compiler libraries.
  120.  
  121.  
  122. Using the BlackStar C Function Library with High C
  123. --------------------------------------------------
  124.  
  125. If you want to link in the BlackStar libraries every time you link with the
  126. High C driver, set the USERLIB variable in your hcset.cnf or hc386set.cnf
  127. driver configuration file.  If you want to specify the additional libraries
  128. each time you link, use the -l and -L driver options.
  129.  
  130. If you want the BlackStar include files included in the compiler include
  131. search path, set environment variable SPATH or use driver option -I or
  132. -Hipath.
  133.  
  134. See the High C Programmer's Guide for more information about these options.
  135.  
  136.  
  137. Floating-Point Instructions
  138. ---------------------------
  139.  
  140. The libraries supplied with the distribution are compiled for floating-point
  141. instruction emulation.  If you want to rebuild the libraries to support a
  142. coprocessor, you must edit the files comp.bat and recomp.bat in the _o
  143. directories to add the appropriate command-line option(s) to generate
  144. floating-point code.
  145.  
  146. For example, to cause the 80x86 compiler to generate 80287 floating-point
  147. code, use command-line option -Hon=Floating_point.
  148.  
  149. To generate 80387 floating-point code with the 80386/486 compiler, change
  150. command-line option -fsoft in the batch files to -f387.  
  151.  
  152. See the Programmer's Guide for more information about floating-point code.
  153.  
  154.  
  155. Notes
  156. -----
  157.  
  158. GRAPHICS    -- The gr_fill() function puts dots to the screen in the
  159.                background color, and is slow.  Use the sc_clr() function if
  160.                you want to clear the whole screen or if you can clear to
  161.                character boundaries (bytes).
  162.  
  163. HEADERS     -- You should include your standard headers before blackstr.h.
  164.                The blackstr.h has #ifndefs for some macros, etc.
  165.  
  166. INDOSF      -- The utility for indosf (DOS in critical section) is
  167.                undocumented and should be used with care.
  168.  
  169. MOUSE       -- The mouse functions have not been implemented for the
  170.                80386/486.
  171.  
  172. INTERRUPTS  -- The interrupt functions have not been implemented for the
  173.                80386/486.  This, also, affects the routine pr_signal() which
  174.                calls the unimplemented function sy_getintv() and
  175.                sy_setintv().
  176.  
  177. MEMMODELS   -- The library is now distributed and supported for Small, Medium,
  178.                Large, Compact, and Big memory models for the 80x86, and Small
  179.                model for the 80386/486.
  180.