home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / dirutl / run102.arc / RUN.DOC < prev    next >
Encoding:
Text File  |  1989-10-01  |  5.6 KB  |  132 lines
  1.  
  2.  
  3. RUN Version 1.02             Documentation                    10/02/89
  4.  
  5.  
  6.  
  7. ABSTRACT:           RUN is a utility that allows you to repeat
  8.                     actions for selected files in a directory. It
  9.                     uses both a file pattern with wildcards and
  10.                     "point-and-shoot" selection to choose the
  11.                     files to process. RUN is capable of passing
  12.                     parameters to the batch file or program that
  13.                     you are running.
  14.  
  15. COPYRIGHT:          This program and the associated documentation
  16.                     are the property of the author, Bob
  17.                     Breedlove, and may not be sold without
  18.                     permission. The program and its documentation
  19.                     may be freely distributed, unaltered and as a
  20.                     unit, via electronic bulletin board systems
  21.                     or via diskette, provided that only a
  22.                     distibution fee is charged, not to exceed
  23.                     $5.00.
  24.  
  25.                     The author does not guarantee the program to
  26.                     be free ofdefects and may not be held
  27.                     responsible for loss caused by such. Your use
  28.                     of this program constitutes your acceptance
  29.                     of these terms.
  30.  
  31. REGISTRATION:       Register your copy of RUN.EXE by sending
  32.                     $5.00 to:
  33.  
  34.                     Bob Breedlove
  35.                     3196 Swallowsnest Dr.
  36.                     Sacramento, CA 95833
  37.  
  38. EXECUTION:          RUN is executed from the command line with
  39.                     the following command syntax:
  40.  
  41.                     RUN {pattern} "{command}"
  42.  
  43.                     where {pattern} is a wildcard file
  44.                     specification indicating the files to be
  45.                     processed and {command} is the program or
  46.                     batch file to be executed.
  47.  
  48.                     Entering just "RUN" will display a help
  49.                     screen.
  50.  
  51. SUBSTITUTIONS:      The following substitution variables can be
  52.                     included in {command}:
  53.  
  54.                     $P = Complete Pathname
  55.                     $F = Filename including extension
  56.                     $N = Filename only
  57.                     $E = Extension only
  58.                     $D = Directory only
  59.  
  60.  
  61. FILES:              The archive/diskette you received should
  62.                     contain the following files:
  63.  
  64.                     RUN.EXE  The RUN execuatable.
  65.                     RUN.DOC  This documentation.
  66.                     AZIP.BAT Sample batch file that will
  67.                              rearchive files in a directory.
  68.  
  69. DISCUSSION/
  70. EXAMPLES:           RUN is a very straightforward utility that
  71.                     will execute a program or batch file
  72.                     substituting selected files in a directory.
  73.                     To execute RUN, use the command line above.
  74.  
  75.                     Suppose you have a program -- TEXTFIX -- that
  76.                     removes trailing blanks from text files. You
  77.                     want to run it against all the text files in
  78.                     the directory C:\TEXT. TEXTFIX requires that
  79.                     you enter the full filename on the command
  80.                     line. To execute TEXTFIX enter:
  81.  
  82.                     RUN C:\TEXT\*.TXT "TEXTFIX $F"
  83.  
  84.                     First, RUN presents you with a selection box
  85.                     listing all files which match the {pattern}
  86.                     ("C\TEXT\*.TXT"). Use the arrow keys to move
  87.                     around the selection box. Press the
  88.                     <spacebar> to select files. When you press
  89.                     the <spacebar>, RUN places a small box next
  90.                     to the filename and moves to the next file in
  91.                     the list. If you select a file by mistake,
  92.                     move the cursor over the filename and press
  93.                     the <spacebar>.
  94.  
  95.                     Only files which have been selected will be
  96.                     processed. Once you have selected the files
  97.                     that you wish to process, press <Enter>. To
  98.                     abort the process, press <Esc>.
  99.  
  100.                     When you press <Enter> RUN asks if you wish
  101.                     to pause between each file. CHOOSE CAREFULLY!
  102.                     If you answer (N)o to this prompt, you will
  103.                     not be able to stop RUN processing. For most
  104.                     processing, this is not a problem. However,
  105.                     if you are uncertain about the file you are
  106.                     executing, you might want to answer (Y)es to
  107.                     the prompt.
  108.  
  109.                     After answering the pause prompt, RUN begins
  110.                     processing the files you have selected. If
  111.                     you answered (Y)es to the "pause between
  112.                     files" prompt, RUN will prompt you before
  113.                     processing each file.
  114.  
  115.  
  116.                     After processing, RUN clears the screen and
  117.                     returns to the DOS prompt.
  118.  
  119. SUPPORT:            Since this is a relatively simple utility,
  120.                     support will only be given to registered
  121.                     users of RUN. Support is available at the
  122.                     address above or by calling BOBsBBS
  123.                     916/929-7511 (PCPursuit CASAC).
  124.  
  125. REVISION HISTORY:    1.01 - Original distribution.
  126.  
  127.                     1.02 (10/02/89) : Minor bug fix. No change in
  128.                     function.
  129.  
  130.  
  131. (C) Copyright 1989           Bob Breedlove         All Rights Reserved
  132.