home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / AUTOLZ.ZIP / DOTREE.DOC < prev    next >
Encoding:
Text File  |  1990-07-27  |  4.4 KB  |  94 lines
  1.             DoTree Command Executor   (version 1.0)
  2.  
  3.             Copyright 1990 by A. Preston Moser
  4.  
  5.  
  6.              Description
  7.  
  8.      The DoTree Command Executor is a program that will execute a program,
  9. execute a command, or run a batch file once from every directory on a given
  10. drive or [optionally] path. It does this by changing directories and
  11. executing the command from the new directory and then changing directories
  12. again and repeating the process. When it is done, or if it is halted, it
  13. will return to the original directory. Unless you specify a path, DoTree
  14. will do the entire drive.
  15.  
  16.              Operation
  17.  
  18.      To use DoTree, place the DOTREE.EXE file in a directory that is in
  19. your path (if that is not clear, read about PATH in your DOS manual.)
  20. Then, from any directory, type "DOTREE <enter>". Doing this will not
  21. run the program, however it will display a help screen that will show how
  22. the program is used. The useage line of this help screen shows the syntax:
  23.  
  24.      "DOTREE [path] [/Q] /Xcommand"
  25.  
  26.      What this tells you is that the "path" and the "/Q" are optional, and
  27. the only required command line argument is the "/X" and the command that
  28. comes after it. Further on, an example is given that will display all of the
  29. batch files on the D drive. If you run this program, (substituting a C for
  30. the D if you don't have a D drive) you will see that it scrolls off the
  31. screen faster than you can read it. This illustrates two points: the program
  32. is FAST, and also the program is not very useful for viewing all of the
  33. batch files if you don't use the "/Q" option. Try running the example again,
  34. but this time, include the "/q". Alternately, press the "Y" or "n", or press
  35. any other key.
  36.      There are ways to use DoTree that are far more useful, for instance,
  37.  
  38.      "DOTREE /X copy *.bat a:\" would copy all of the batch files on the
  39. current drive over to the A drive's root directory (assuming they would
  40. all fit.)
  41.  
  42.      Using DoTree to execute batch files is a better use, but I think the
  43. best use of this program is in conjunction with DI.COM (The Directory Dicer.)
  44. With this program and DI.COM, you can execute a command or batch file once
  45. for every file on a drive, and pass the command or batch file the full name
  46. of the file, and/or the name of the file minus the extension, and/or the
  47. file's extension.
  48.  
  49.      DoTree and Di can be very powerful tools providing the user mixes in
  50. a large dose of imagination. The more imaginative the user, the more useful
  51. these two programs will be.
  52.  
  53.  
  54.  
  55.  
  56.              STOP!!!
  57.  
  58.  
  59.      I designed DoTree to cease operation if ESC, CTRL-C, or CTRL-BREAK are
  60. pressed, (providing the program being executed by DoTree does not disable
  61. breaks,) however, despite having captured Int 23h (the Break Interrupt) I
  62. have found that the program does not always stop for me when I think it should.
  63. I have found that leaning on the ESC key will usually get it to stop. <Sigh>
  64. This is the only thing that I wish I could improve about the program.
  65. If you may need to dump out in the middle of a program, you might consider
  66. using the "/Q" option. Pressing ESC once when the program pauses to ask if
  67. you want to do the next directory will surely terminate the program.
  68.  
  69.              Terms & Conditions
  70.  
  71.      I wrote DoTree as a companion program to DI.COM, The Directory Dicer.
  72. (DI.COM can be found in a file named DIRDI.COM.) While DI.COM is a Chareware
  73. program with donations sent to The Hunger Project, I have decided to release
  74. DoTree into the public domain as FREEWARE. You may use DoTree for any legal
  75. purpose, commercial or non-commercial, and you may freely distribute copies
  76. of DoTree along with this .DOC file. If DoTree is to be included in any
  77. software product that is sold, please contact this author and let me know.
  78. (Nothing formal, I'm just curious.) The only restriction is that you may not
  79. alter DOTREE.EXE or this .DOC file and then distribute the altered versions
  80. without permission of the author. (Archiving excepted.)
  81.  
  82.      DoTree is distributed as is, and is completely without warranty of any
  83. kind. This author shall not be liable for any damage or loss of data or
  84. profits resulting from the use of this program. Not withstanding all of that,
  85. I am not aware of any bugs in the program as of this writing.
  86.  
  87.      Comments and questions and will gladly be accepted and answered.
  88.  
  89.              A. Preston Moser
  90.              807 Bennett Ave. #6
  91.              Medford, Oregon 97504
  92.  
  93.              CompuServe #72621,1377
  94.