home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / RCUTILS.ZIP / README.TXT < prev    next >
Text File  |  1992-09-28  |  2KB  |  48 lines
  1.  
  2.      Enclosed are a few utilities which I like to use along with build
  3. procedures to generate them.  Build is setup for NMAKE: for instance
  4. NMAKE -F NEW.MAK<cr> will build new.exe.
  5.  
  6.     ascii [/nn] filename    - Dumps ascii strings found in specified file.
  7.     ddir [template]         - Prints current directory contents, sorted
  8.                               in double width.
  9.     new [/n] [template]     - Lists (in ddir format) all files written
  10.                               in the last 'n' days.  Days are calculated
  11.                               from 6 A.M.
  12.  
  13.      Note that the 'template' in 'ddir' and 'new' are very picky when
  14. used in the 'DosFindFirst' call.  I have attempted to fake the input
  15. argument to more follow the Dos-OS/2 'dir' command syntax.  This attempt
  16. on my part is by no means bullet-proof, but problems only show up when
  17. you try to abbreviate pathnames (i.e. using 'new \os2' to mean 'new
  18. \os2\*.*').  The error diagnostics should give you sufficient
  19. information if you run afoul of the limitations.
  20.  
  21.      Also, the output of NEW and DDIR has no 'newlines': in the interest
  22. of squeezing as much information as is possible on each line, 80
  23. characters are output and the default terminal driver's automatic wrap
  24. is relied on to get to the next line.  The only problem is if the output
  25. is redirected to a file, there will be NO CR/LF anywhere in the file.
  26. This can be corrected by the 'wrap' routine included.  There is no make
  27. file for 'wrap', but the instructions for build are included in the
  28. header of the source file.  Wrap is meant to be part of a pipe: (e.g.
  29. ddir | wrap >outfile.lst.)
  30.  
  31.      ASCII is generated as a 'bound' utility and will run in either
  32. Dos or OS/2 mode.  DDIR and NEW are not because of the way in which
  33. DosFindFirst is used.
  34.  
  35.  
  36.      Included in this source code are MSC 6.0 samples of:
  37.  
  38. DosFindFirst
  39. DosGetDateTime
  40. time
  41. localtime
  42. DosQFSInfo
  43. strtok
  44. qsort
  45. setvbuf
  46. perror
  47.  
  48.