home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_200 / 213_01 / headers.bds < prev    next >
Text File  |  1979-12-31  |  5KB  |  193 lines

  1. HEADERS.BDS      VERS:- 01.00  DATE:- 09/26/86  TIME:- 09:36:37 PM
  2.  
  3. Short descriptions of C programs and related files.
  4.  
  5. Written for BDS C compiler, version 1.50a, by
  6.  
  7. John A. Rupley
  8. 30 Calle Belleza
  9. Tucson, AZ  85716
  10. (602) 325-4533
  11.  
  12. /***************************************************************************/
  13.  
  14.  
  15. BATCHR.C   
  16. BATCHR.COM 
  17.  
  18. Submit utility BATCH from Van Nuys Toolkit, by Eugene H. Mallory.
  19.  
  20. Minor modifications: 
  21.     converted to standard C tokens;
  22.     extended menu to include all BAT, ZEX, AND SUB files in all 
  23.         user areas of current drive and of drive A:, 
  24.         if no valid file given on command line;
  25.     error exit if no files found.
  26.  
  27.  
  28.  
  29.  
  30.  
  31. CBPREPR.C   
  32. CBPREPR.COM 
  33.  
  34. Filter to prepare C code for indentation by control level:
  35.     add and delete white space to produce consistent text;
  36.     introduce newlines to produce one statment per line;
  37.     left justify all lines.
  38.  
  39. DIO redirection.
  40.  
  41. To indent according to control level, output from CBPREP
  42. must be filtered by CB, the formatting program written 
  43. by W.C. Colley and R. Hollinbeck.
  44.  
  45. CBPREP uses the routines getch() and comment() of CB.
  46.  
  47.  
  48.  
  49.  
  50.  
  51. CBPREPR.BAT 
  52.  
  53. Submit file for filtering C code through cbprepr then cbr.
  54.  
  55. Usage:  batchr  cbprepr  input_file  output_file
  56.  
  57.  
  58.  
  59.  
  60.  
  61. CBPRETST.C   
  62.  
  63. Some meaningless code, for use in testing CBPREPR and CBR:
  64.  
  65. Usage:  cbprepr  <cbpretst.c  +|  cbr  +output_file.c
  66.         or
  67.     batchr  cbprepr[.bat]  cbpretst  output_file
  68.  
  69.  
  70.  
  71.  
  72.  
  73. CBR.C   
  74. CBR.COM 
  75.  
  76. Filter to format C code, from CUG distribution disk.
  77. Indents according to control level.
  78.  
  79. Minor modifications:
  80.     adapted for BDS C v1.50a;
  81.     adapted for use as filter under DIO;
  82.     Corrected: 
  83.         exit test; 
  84.         read of strings of *'s.
  85.  
  86. Best to filter input file first through CBPREP, to produce 
  87. consistent spacing of text and one statment per line.
  88.  
  89. CR.C    
  90. CR.COM 
  91.  
  92. Opens fname.c, extracts lines with key "%", constructs and runs submit file.
  93. Simplifies compilation and linking in C program development.
  94.  
  95. From Van Nuys Toolkit, by Eugene H. Mallory.
  96. No changes except converted to standard C tokens.
  97.  
  98.  
  99. DIOR.C   
  100. DIO.CRL 
  101. DIO.H   
  102.  
  103. IO redirection library and header from BDS C and Van Nuys Toolkit, 
  104. by Eugene H. Mallory.
  105.  
  106. Minor modification: 
  107.     avoid CR-CR pair before LF by patch in putchar() and by adding
  108.         declaration of _putc_last in DIO.H;
  109.  
  110. STDLIB3R.C   
  111. DEFF.CRL 
  112. DEFF2.CRL 
  113.  
  114. STDLIB3R has file-handling functions that allow use of du: in addition 
  115. to u/d: drive/user prefix.
  116. The functions have been added to DEFF.CRL
  117. They replace functions of same name in DEFF2.CRL, which must be 
  118. patched (DEFF2.CRL: open -> xpen, etc).
  119.  
  120. Functions:
  121.     open(), creat(), unlink(), rename(), execv(), exec(), du_ud().
  122.  
  123. In DEFF2.CRL:
  124.     patched header for routines (open...exec -> xpen...xxec);
  125.           patched body of routines open and unlink;
  126.     edfile or similar program used to make changes.
  127.  
  128. Execl is not patched and does not take du: form.
  129.  
  130. An alternate route, consuming less memory:
  131.     revise "setfcu" routine of ccc.asm,
  132.     then recompile: 
  133.            ccc.asm....c.ccc
  134.            bds.lib
  135.            deff2*.csm...deff2.crl
  136.  
  137. UNVANR.C   
  138. UNVANR.COM 
  139.  
  140. Filter to convert Van Nuys Toolkit format back to standard C tokens.
  141.  
  142. DIO redirection.
  143.  
  144. Adapted from Van Nuys Toolkit program CASE, by Eugene H. Mallory.
  145.  
  146.  
  147.  
  148.  
  149.  
  150. WILDEXPR.C   
  151. WILDEXP.CRL 
  152.  
  153. Modification of Van Nuys Toolkit - BDS C distribution version of WILDEXP:
  154.     use of <du:>, by conversion to <u/d:> form;
  155.     expansion of <d?:> and <?/d:>;
  156.     all output given uu/d: prefix, even files in current drive/user area;
  157.     restructuring of much of the code.
  158.  
  159. Size of code:            hex bytes
  160.     this version:        CC1         wildcard nos & du: (d?:, ?/d:)
  161.     Van Nuys:        C8E        user numbers (u/d: form only)
  162.     BDS C v1.50a:        A8E        no user numbers (d: form only)
  163. (Inclusion of wildcard user numbers costs a little but not much.)
  164. (The size of the du_ud() function is not included in the value cited for the
  165.     memory requirement for this version)
  166.  
  167. The number of !names allowed is 40 (= 2 !d?: + 8 !du:).
  168.  
  169. NOTE:
  170. There must be a <du:> --> <u/d:> conversion function = du_ud().
  171. If the conversion is required only for WILDCARD, then it is sufficient
  172.     to compile and link the du_ud function given at the end of this file.
  173. A more general approach is to modify DEFF.CRL and DEFF2.CRL, 
  174.     by adding the functions of STDLIB3R to DEFF.CRL, and 
  175.     by patching the functions of DEFF2.CRL, as described in STDLIB3R.
  176. If this is done, then all file opening, creation etc operations accept the
  177.     <du:> form.
  178.  
  179.  
  180.  
  181.  
  182.  
  183. XCR.C   
  184. XCR.COM 
  185.  
  186. Cross-reference utility, from cug distribution disk:
  187.  
  188. Minor modification:
  189.     added check on characters of output per line (char_count),
  190.         to obtain correct pagination.
  191.  
  192.  
  193.