home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / drtree.zip / READ.ME < prev   
Text File  |  1994-02-17  |  4KB  |  82 lines
  1. DIRTREE.CMD and DIRMATCH.CMD
  2. are simple, self contained command line utilities written in REXX
  3. for OS/2 2.1.
  4.  
  5. /*  you are licensed to use, copy, and redistribute as long */
  6. /*  as the 1st 5 lines of the .CMD files remain as is, and you and */
  7. /*  subsequent licensees agree that this program is distributed */
  8. /*  as is, use and consequences are solely the responsibility of the user. */
  9.  
  10.  
  11. To use, at an OS/2 window or full screen command prompt:
  12.   [d:][p:]dirtree [?] or [options]
  13.   [d:][p:]dirmatch [?] or [options]
  14.  
  15. DIRTREE lists matching files in the current directory and
  16. subdirectories, with display and sorting options.  It is a
  17. very handy file or directory finder/explorer, especially if
  18. you are doing command line stuff.
  19.  
  20. DIRTREE ?     provides a screen of on line help.
  21.  
  22. DIRTREE output may be customized, or sorted, or redirected
  23.  
  24. /*  DIRTREE R1.0 1/1/94 by Conrad W. Clark 70544,760 */
  25. /*  you are licensed to use, copy, and redistribute as long */
  26. /*  as the 1st 4 lines of this file remain as is, and you and */
  27. /*  subsequent licensees agree that this program is distributed */
  28. /*  as is, use and consequences are solely the responsibility of the user. */
  29.  
  30.  
  31. /*  [d:][path]dirtree[.cmd] filespec [sd|st|ss|sp|sn]  [nod|not|nos|noa] */
  32. /*  for example at the E:> dirtree e:\rxtste\*.*   */
  33. /*   optional arguments (in any order) to sort (major to minor) or shorten output */
  34. /*        sd - sort by file date             nod - do not display date */
  35. /*        st - sort by file creation time    not - do not display time */
  36. /*        ss - sort by file size             nos - do not display size */
  37. /*        sp - sort by name including drive and path */
  38. /*        sn - sort by name excluding drive and path */
  39. /*                                            noa - do not display attributes*/
  40. /*      dirtree ? displays online help */
  41.  
  42.  
  43. DIRMATCH lists matching files in two tree structures.  The matches
  44. may be based on file name (with wild cards), or file name and string
  45. within the files.  DIRMATCH is useful for finding lost or obsolete
  46. files when installing software upgrades, or for finding loose files
  47. such as Compuserve downloads.  If you want to find files with a string
  48. in a single file structure, use OS/2's file finder, or use DIRMATCH
  49. with identical 1st 2 arguments.
  50.  
  51. DIRMATCH ? lists online help.
  52.  
  53. DIRMATCH output is always sorted by file name (not including path).
  54. Matches are listed as pairs.
  55.  
  56. "  /*  INSERT FILTERS HERE */  "  is a good starting place for
  57. customization.
  58.  
  59. /*  Use of Program:  */
  60. /*  [d:\]dirmatch[.cmd] filestructure targetstructure [prn:|stdout:|filename] [string]*/
  61. /*    dirmatch ?  displays online help */
  62. /*  for example, if dirmatch.cmd is in e:\cmd,                                 */
  63. /*  */
  64. /*      e:\cmd\dirmatch c:\os2\dll\*.* c:\describe\dll\*.* will find files with matching */
  65. /*      names in the dll directories, and their subdirectories, and display matching pairs  */
  66. /*  */
  67. /*      e:\cmd\dirmatch c:\os2\dll\*.* c:\describe\dll\*.* prn: will find files with matching */
  68. /*      names, display matched pairs, and print target matches  */
  69. /*  */
  70. /*      e:\cmd\dirmatch c:\os2\dll\*.* c:\describe\dll\*.* prn: xyz will find files with matching */
  71. /*      names if they include the string xyz, display matched pairs, and print target matches  */
  72. /*         note that if the 3rd arg is a file, and it exists, it will be appended to.  */
  73. /*         note that if a 4th arg string is specified, you must specify the 3rd arg, since the   */
  74. /*         filter expects to lineout lines in the targetfiles.i containing xyz    */
  75. /*  the use of shell sorted source and targets give much better performance with large */
  76. /*  numbers of files.  for example, a 233 source by 1324 target took 15 mins unsorted, */
  77. /*  170 seconds sorted */
  78. /*  */
  79. /*  insert additional filters or selection logic at the comment INSERT FILTERS HERE */
  80. /*  */
  81.  
  82.