home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / ut-doc.lbr / README.UZS / README.UTS
Encoding:
Text File  |  1993-10-25  |  2.8 KB  |  53 lines
  1. file: readme.uts  date: 9/10/83   author: David H. Wolen
  2.  
  3. This disk contains the source for the UTOOLS -- a set of utility programs
  4. I recently submitted to the foglib.  See the appropriate foglib disks for
  5. user oriented documentation.  The programs are written in C, using
  6. version 1.46 of the BDS compiler.  The following notes about bringing
  7. up the UTOOLS on your own are disorganized and probably
  8. incomplete -- that should be fair warning.  Also, note that you'll need
  9. some files from the BDS C distribution package to complete this package.
  10. I'm not including them because I'm not sure if the source for them is
  11. public domain.
  12.  
  13. 1.   I've enabled alloc and free by making the appropriate change to bdscio.h
  14.      and recompiling the indicated libraries.  See the instructions in
  15.      bdscio.h.  Alloc and free are only (I think) used by the tail tool.
  16.      The other tools that  do storage allocation don't need to free it so
  17.      they use sbrk instead (reducing memory requirements and the size of
  18.      the .com file).
  19.  
  20. 2.   I've enabled console buffering by making the appropriate change to dio.h.
  21.      See the instructions in dio.h.
  22. 3.   Just about all the UTOOLS use something from mylib3.c.  I've made it
  23.      my deff3.crl.  There are probably some routines on mylib3.c that 
  24.      aren't used by the UTOOLS.
  25.      Note -- there's a bug in 1.46 that prevents deff3.crl
  26.      from being picked up automatically if you compile with source on b
  27.      and b as the logged drive.
  28.  
  29. 4.   Before my upgrade to double density, I kept dio.h and dio.crl on the
  30.      same drive as the source.  With double density, I keep everything
  31.      but the source on A and compile with A as the logged drive.  Some
  32.      of the "linkage" comments in the source code reflect the first method, 
  33.      while others reflect the second -- you've been warned.  Also, you
  34.      may have to change the drive designation in the #include lines to
  35.      correspond to your compile procedure.
  36.  
  37. 5.   The utdir tool needs wildexp.c which comes with the BDS C distribution
  38.      package.
  39.  
  40. 6.   spltscan.c contains a set of character handling functions.  Only
  41.      two of them (I think) are used by a UTOOL (vsplit).  Documentation for
  42.      these functions is on spltscan.doc.  Forgive the few gotos -- this 
  43.      was some of the first C code I wrote.
  44.  
  45. 7.   There are two tools here that I didn't include in the set of .com files
  46.      I submitted to foglib -- lline and makdoc.
  47.  
  48. 8.   I haven't experimented with the compiler options to optimize space or 
  49.      time.  That might be a useful thing for someone to try.
  50.  
  51. That's all that I can think of that you need to know.  Please forgive any
  52. omissions.
  53.