home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / fileutil / pacerutl / read.me < prev    next >
Encoding:
Text File  |  1989-08-14  |  5.9 KB  |  123 lines
  1. Here are three utilities for os/2.
  2. You may copy and distribute this program freely, provided that:
  3.  
  4.     1)   No fee is charged for such copying and distribution.
  5.     2)   It is distributed ONLY in its original, unmodified state.
  6.     3)   It is not distributed as part of any commercial product or service.
  7.  
  8. All of the tools have a /help option.  Inclosed is the output from that 
  9. option.
  10.  
  11. Our EMAIL address is uunet!pacvax!dch
  12.  
  13. David C. Hornbaker
  14. Pacer Software Inc.
  15. 1900 West Park Drive
  16. Westborough Ma. 01581
  17.  
  18. SCAN 5.1a (OS/2) [Copyright (C) 1989, Pacer Software, Inc. All rights reserved]
  19.  
  20. Searches one or more files for one or more strings. Usage is:
  21.  
  22. scan {d:}path_spec{;file_spec;...} string1 {string2 ... string20}
  23.         {/No_Case, /NC} {/STatistics} {/Fullpath} {/EDitlist {name}}
  24.         {/S, /TREEwalk, /TW}
  25.         {/EXecute <command line in double quotes>} {/Terse}
  26.   or
  27.  
  28. scan {/Help}
  29.  
  30. All options may be given using a dash (-) instead of a forward slash (/).
  31. The filename portion of the path specification may contain wildcards. It may
  32. also contain more than one filename specification by using semicolons between
  33. each name. More than one search string can be given. For example,
  34.  
  35.    scan \some.dir\*.c;*.h  search_for_me  and_me
  36.  
  37. will scan all .C and .H files in \SOME.DIR for "search_for_me" and "and_me".
  38. A search string can be enclosed between double quotes if literal spaces are
  39. needed. Use a backslash-quote (\") to enter a literal double quote.
  40.  
  41. "/S" or "/TW" causes all subdirectories to be scanned.
  42.  
  43. "/EDitlist" causes a list of the filenames found to contain a match to be
  44. put into the filename given, or "__EDLIST.___" if no name is specified.
  45.  
  46. "/EXecute" causes <command line in quotes> to be executed with all occurences
  47. of the token "%s" replaced with the just-found filename. This is done for
  48. each file found to contain a match. For example,
  49.  
  50.    scan *.c "look for me" /exec "myeditor %s /X"
  51.  
  52. would invoke the command "myeditor filename /X" for each filename with the
  53. suffix ".c" which contained the string "look for me".
  54.  
  55. LD 5.1a (OS/2) [Copyright (C) 1989, Pacer Software, Inc. All rights reserved.]
  56. "ListDir". Lists the contents of a directory.  Usage is:
  57.  
  58.     LD {{d:}path_spec_and_wildcard} {2nd wildcard {3rd...}}
  59.  
  60.     what:  {/DIr | /File} {/Modified} {/CRC} {/SUMsize, /SS} {/Room}
  61.            {/After {mm/dd/yy}{,hh:mm:ss}} {/Before {mm/dd/yy}{,hh:mm:ss}}
  62.            {/Subdirs, /TREewalk, /TW}
  63.     how:   {/Normal | /Detail | /Terse | /SUFfix} {/FULlpath, /FP}
  64.            {/ATtributes} {/ONName | /ONDatetime | /ONSize} {/REversesort}
  65.            {/HEAder | /NOHeader, /NH} {/Pause | /NOPause, /NOWait, /NW}
  66.            {/COmmas | /NOCOmmas} {/UPcase, /UC | /LOWcase, /LC | /MIXcase, /MC}
  67.            {/DELete {/NOQuery, /NQ}}
  68.     other: {/NOSTDoptions, /NSO} {/Help} {/KS}
  69.  
  70. »  The minimum recognized option is shown in capital letters.  All options are
  71.    order-independent: If any conflict, the one to the right takes precedence.
  72. »  A '-' may be used instead of a '/' for all options.  (If either a '-' or '/'
  73.    is part of a pathname or wildcard, enclose that name in double quotes.)
  74. »  The filename portion of the path specification may contain a wildcard. Up to
  75.    29 more wildcards can be given, but only the first may have a path spec.
  76. »  /After selects files modified 'on or after', /Before just 'before'.
  77. »  /Subdirs will cause all subdirectories below the initial start point to be
  78.    searched as well. (/Terse/FULl is very useful with /Subdirs.)
  79. »  /ONDatetime causes a sort on date and time, /ONSize on file size, /ONName on
  80.    name (the default).  /REversesort reverses the indicated sort order.
  81. »  /CRC will calculate and display a CRC of the contents of each file.
  82. »  /ONDate, /ONSize, /FULlpath, /ATtributes and /CRC imply /Detail.
  83. »  /SUFfix produces a special by-suffix display.  In this case, most other
  84.    display/sort options are ignored.
  85. »  The /DELete option can only delete files: Directories are ignored. Unless
  86.    the /NOQuery option is given the user is asked to verify deletes.
  87. »  Unless explicitly specified, PAUSE is ON for normal (to-the-tube) output,
  88.    OFF for redirected output.
  89. »  /Room displays the total disk space used and available.
  90. »  /SUMsize display a sum of all files sizes, plus actual disk-sector usage.
  91. »  LD may be customized via the environment variables LDDFLTOPT and LDSTDOPT.
  92.    If no explicit options or arguments are given, the value of LDDFLTOPT is
  93.    used.  If any explicit options or arguments are given, the value of LDSTDOPT
  94.    is prepended to those given before processing.
  95. »  /NOSTDoptions causes LDSTDOPT to be ignored.
  96. »  /UPcase causes all names to be displayed in upper case, /LOWcase in lower
  97.    case (the default).  /MIXcase causes directories to be displayed in upper
  98.    case, files in lower.
  99.              << Designed and developed by Kevin C. Little >>
  100.  
  101. TW 4.3 (OS/2) [Copyright (C) 1989, Pacer Software, Inc. All rights reserved.]
  102.  
  103. TreeWalk: walks down directories, executing a specified program
  104.           in each sub-directory it enters.
  105.  
  106. Usage is
  107.     tw  {tw options if any}  program_name  {program arguments and options}
  108.  
  109. where "tw options if any" include
  110.     /Level <maximum walk depth>     /INclude <dir spec>
  111.     /WAlkall                        /EXclude <dir spec>
  112.     /Terse
  113.  
  114. A "<dir spec>" may contain wildcards. If "/EX" is given, any dir matching
  115. any "/EX" spec is skipped. For "/IN", if any is given then only dirs matching
  116. one of the "/IN" specs are included. (The exception is the current directory,
  117. ".", which is always included unless explicitly excluded by a "/EX . ".) If
  118. no "/IN"s are given, all subdirectories are included by default. "/WA" forces
  119. a complete walk of the entire directory tree decending from the start point,
  120. thus allowing "/IN" and "/EX" to control only the execution of "program_name"
  121. and not the walk itself. Otherwise they do control the walk, and thus in turn
  122. the execution.
  123.