home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource3 / 134_01 / _readme.doc < prev    next >
Encoding:
Text File  |  1985-08-21  |  4.4 KB  |  135 lines
  1.  
  2.  
  3.  
  4.  
  5. BDS 'C' Users' Group                        Compiler Utilities II
  6.  
  7.  
  8.  
  9.  
  10.      ____                                                           
  11.      NOTE: Certain of the programs on this disc are copyright (c) 
  12. 1983 by Kevin Kenny.  They have been released to the Users' Group 
  13.                                 ____     
  14. for non-commercial distribution only.  
  15.  
  16.  
  17.      This  disc  contains  the  source  code for several programs
  18. which provide enhancements to the BDS 'C' environment.   Most  of
  19. these  programs  extend the capabilities of the compiler, in much
  20. the same spirit  as  the  very  successful  "Compiler  Utilities"
  21. disc.  
  22.  
  23.  
  24.      Full  documentation is provided in machine-readable form for
  25. the programs.  All of the documentation files  are  intended  for
  26. processing  by the NRO text formatter, available as "Utilities V"
  27. from the Users' Group.  The program documentation  is  mostly  in
  28. the  form  of  "manual  pages"  which  follow  Stephen Browning's
  29. recommended style.  
  30.  
  31.  
  32.      Installation instructions for  all  the  programs  are  also
  33. provided.   The  file  INSTALL.NRO  is  an  NRO  source for these
  34. directions.   
  35.  
  36.  
  37.      The file -CATALOG.DOC is a list of the files provided,  with
  38. a short  description  of  each.  The following programs appear on
  39. this disc: 
  40.  
  41.  
  42. _____    
  43. CASM2: 
  44.  
  45.  
  46.      This program provides a replacement for CASM, the CRL-format 
  47. ASM preprocessor supplied with BDS 'C'. It has been  enhanced  to
  48. allow   access   to   the   external   variable   area  from  the
  49. assembly-language  code,  to  permit  underscores  as   part   of
  50. identifiers  (transliterating  them  to  'Q's  so  that ASM won't
  51. complain), and to handle relocation directives under  conditional
  52. assembly.   The  usage  of  CASM2  is exactly the same as that of
  53. CASM, so no documentation file has been supplied.  
  54.  
  55.  
  56. _______    
  57. CMDUTIL: 
  58.  
  59.  
  60.      This is a collection  of  subroutines  intended  mainly  for
  61. processing  the  argc and argv passed to the main program in 'C'.
  62. It provides a common  processing  for  option  abbreviations  and
  63. keyword  values,  and  a  common  procedure  to  display  command
  64. syntax.  It also includes an 'initv' procedure that is similar to 
  65. 'initw' but can handle octal, hex, and symbolic constants as well 
  66. as decimal numbers.  
  67.  
  68.  
  69. ____    
  70. CORO: 
  71.  
  72.  
  73.      This  is  a  subroutine   library   for   the   support   of
  74. 'coroutines',    a   way   to   simulate   multi-tasking   on   a
  75. single-threaded machine.  A verbose description of coroutines and 
  76. how they operate is in the file CORODOC.NRO; the specifics of the 
  77. package are described in CORO.NRO.  
  78.  
  79.  
  80.  
  81. -README.DOC                    -1-               15 November 1983
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89. BDS 'C' Users' Group                        Compiler Utilities II
  90.  
  91.  
  92.  
  93. ________                                             
  94. CPROFILE: (Requires BDS 'C' release 1.50 or later) 
  95.  
  96.  
  97.      This is a "profiler" for BDS 'C' programs.   For  each  line
  98. in  a  target program, it lists the number of times that line was
  99. executed on a particular run.  This  information  is  useful  for
  100. debugging and in performance analysis.  
  101.  
  102.  
  103. ____                                             
  104. CTOA: (Requires BDS 'C' release 1.50 or later) 
  105.  
  106.  
  107.      This is a disassembler for BDS 'C' object code.  It produces 
  108. a source file acceptable to CASM2 which generates the same object 
  109. program that a 'C' source did.  It is useful in understanding how 
  110. the compiler  operates.   It may also be used (God forbid!) to ge
  111. assembly language source for modification or transport to another 
  112. environment.  
  113.  
  114.  
  115. ____    
  116. DIFF: 
  117.  
  118.  
  119.      This is a program to compare  two  text  files  and  give  a
  120. listing of   their   differences.    It  handles  insertions  and
  121. deletions correctly, so can be used with  files  such  as  source
  122. programs  to  determine  the  changes  made  between    different
  123. versions.  
  124.  
  125.  
  126. ______    
  127. GENREL: 
  128.  
  129.  
  130.      This is a utility program that extracts relocation data from 
  131. a function on a .CRL file.   It  is  used  as  part  of  building
  132. CPROFILE,  to  enable  the run-time supervisor to be relocated to
  133. high memory.  
  134.  
  135.  
  136. _____    
  137. RETAB: 
  138.  
  139.  
  140.      This is a sample  program  to  illustrate  the  use  of  the
  141. coroutine package.    See  CORODOC.NRO  for  a description of its
  142. use.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164. -README.DOC                    -2-               15 November 1983
  165.  
  166.  
  167.  
  168.  
  169. 
  170. program that a 'C' source did.  It is useful in understanding how 
  171. the compiler  ope