home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / turbo_c / tclib1.arc / TCLIB.DOC next >
Text File  |  1987-06-19  |  7KB  |  164 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                              TCLIB 1.0 DOCUMENTATION
  7.  
  8.                           TCLIB - The Turbo C Librarian
  9.            Created for use with Borland Internationals Turbo C Compiler
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.            This product is being distributed under the Shareware concept.
  28.            This gives you the right to try before you buy and pass on a
  29.            good thing to others. You may not reproduce this product or its
  30.            documentation for a profit or include it in a commercial pack-
  31.            age of any kind without written permission of Panama City Soft-
  32.            ware. If you find that you like this product well enough to use
  33.            it, please show your support by registering it. Registration
  34.            will assure you of timely notice of upgrades (which will most
  35.            certainly occur). To register, please send $25.00 in U.S. funds
  36.            to:
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                     Rodney B. Rich
  46.                                  Panama City Software
  47.                                     2661-A Garfield
  48.                                 Tyndall AFB, Fl. 32403
  49.  
  50.                                      (904) 286-6265
  51.  
  52.  
  53.  
  54.  
  55.        The TCLIB librarian is an object code library manager for use with
  56. Turbo C librarys used with TLINK. The libraries created and managed by
  57. this program are NOT Microsoft .LIB compatible but are compatible with
  58. those produced by QLIB, the quick and dirty library CREATE ONLY utility
  59. written by Roger Schlafy for Borland. It can however, read and convert
  60. Microsoft format library files, such as those supplied with Turbo C. The
  61. TCLIB libraries have the advantage of being much smaller (an average of
  62. 10K on a 70-80k Microsoft format lib). The TCLIB program is also much
  63. faster than LIB from Microsoft. It can extract, delete, and append files
  64. using an all command line approach or a command line and response file
  65. approach (for long lists of commands). It can also provide a list of
  66. object modules in a library.
  67.  
  68.         To use TCLIB, invoke it with at least the name of a library on the
  69. command line as TCLIB libname. Do NOT use any extensions, .LIB is assumed.
  70. If all you supply is a library name, the library will be scanned and a
  71. file with the same name as the library and an extension of .LST will be
  72. created. This file contains a list of all object modules in the library in
  73. order of occurance, along with thier offset and size.
  74.  
  75.         If the library is not already in TCLIB format (ie, its in
  76. Microsoft library format), the library will be converted to the TCLIB
  77. format. This involves renaming the existing library to have an .MSF
  78. extension and creating the new library under the old library name. If the
  79. program detects that the library is in need of conversion, this will
  80. happen automatically, so ensure that sufficient space is available on the
  81. current drive/directory for the new library.
  82.  
  83.          Following the library name on the command line should be the
  84. names of any object modules you wish to work with, each proceded by the
  85. desired switch character with no intervening space between the switch and
  86. object module name. There should also be NO extension used on the object
  87. file names on the command line. OBJ is the assumned extension. See the
  88. example below for command line format:
  89.  
  90.     Assuming the library contains the following modules:
  91.  
  92.         absread
  93.         plot
  94.         write
  95.         writea
  96.  
  97.     and you issue the following command:
  98.  
  99.     TCLIB libname -absread +scanf +fprintf +plot *write *writea
  100.  
  101.     then absread will be deleted (- switch), scanf, fprintf will be added
  102. (+ switch), plot will be deleted (since it is being added and it already
  103. exists) and then the new copy appended, and write and writea will be
  104. copied from the library to independant object files on the disk, though
  105. not in that order. TCLIB will always delete and replace (the new copy is
  106. appended at the end) a module if it already exists in the library. So if
  107. you wish to replace an existing module, simply specify add for that module
  108. on the command line. This is the equivalent of Microsoft LIBs -+ switch.
  109. Commands are processed in the following order; extracts, deletes, then
  110.  
  111. adds. To accomplish the same as Microsofts command to extract and remove a
  112. module (move, as they call it) just do an extract and delete of the same
  113. file. Operations take place in the appropriate order no matter what order
  114. they are given in. A new library will be created any time you add or
  115. delete modules. The existing library will be renamed to an .OLD extension
  116. and a new library will be constructed on the currently logged drive /
  117. directory. Make sure you have the room for this! If it fails, you can
  118. simply rename the .OLD library with no loss other than time however.
  119.  
  120.          If you are dealing with more commands than will fit on the
  121. command line, you can use a response file. This is nothing more than an
  122. ASCII file in which each command is on a SEPARATE line, and consists of
  123. the same switch and object module format as the command line given above.
  124. Unlike the Microsoft librarian, you do NOT put the library name in the
  125. reponse file. It must be on the command line as the first parameter. The
  126. response file must be the second parameter and is the name of your
  127. response file with an @ switch appended to the front of it. No extension
  128. is assumned so if it has one, you must supply it. Also, unlike LIB, you
  129. do not use any line continuation characters in the file. Each line should
  130. consist of just ONE switch/filename combination. Invalid switches and/or
  131. files without switches will be ignored! No other parameters should follow
  132. the response file name on the command line and will be ignored if they do.
  133. A sample of this format appears below:
  134.  
  135.      TCLIB libname @rspfile
  136.  
  137. To accomplish what was done in the full command line example previously,
  138. the response file should contain the following:
  139.  
  140. -absread
  141. +scanf
  142. +fprintf
  143. +plot
  144. *write
  145. *writea
  146.  
  147.  
  148.          I am very interested in hearing comments and suggestions
  149. concerning this product. My Compuserve ID is 74126,60 and my phone and
  150. address are given at the top. I plan to optimize this product for better
  151. speed during the delete and append processes, as well as add more
  152. features, such as a full symbolic cross reference but I felt the product
  153. would best serve the many users of Turbo C who either aren't happy with
  154. the speed of the Microsoft librarian, or who like myself, don't have it,
  155. if I got it out there quickly. Thanks in advance for your support!
  156.  
  157.                                                       Rodney B. RIch
  158.                                                    Panama City Software
  159.  
  160.  
  161.  
  162.                           TCLIB is (c) copyright 1987
  163.  
  164.