home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / dirtools.zip / read.me < prev    next >
Text File  |  2000-08-17  |  4KB  |  121 lines
  1. 15 August 2000. Daniel Hellerstein (danielh@crosslink.net)
  2.  
  3.   DIRtools ver 1.04: Utilities for copying, deleting, and viewing directories
  4.  
  5.     DELDIR.CMD -- Delete a directory tree
  6.    COPYDIR.CMD -- Copy a directory
  7.    DIRTREE.CMD -- Display files in a directory tree
  8.     
  9.                 --------------------------------------------
  10.  
  11. Requirements:
  12.  
  13.     COPYDIR.CMD and DELTREE use the REXXLIB library. A copy of REXXLIB.DLL
  14.     is included. COPYDIR also uses ZIP.EXE.
  15.  
  16.     Further details concerning these requirements are listed in the
  17.     disclaimer at the bottom of this document.
  18.  
  19.                 --------------------------------------------
  20.  
  21. Installation:
  22.  
  23.     Just copy the .CMD files to a directory in your path (say, C:\OS2\APPS);
  24.     and copy REXXLIB.DLL to a directory in your libpath (say, C:\OS2\DLL).
  25.  
  26.     Note that these utilities are designed to be run from an OS/2 command prompt.
  27.  
  28.                 --------------------------------------------
  29.   
  30. Short Descriptions:
  31.  
  32. For details on the usage and options of these tools, please look at the
  33. various .CMD files.  You can get a short synopsis of these utilities
  34. by entering a ? as an argument (for example: COPYDIR ?).
  35.  
  36.  
  37. *** DELDIR 
  38.  
  39. DELDIR is used to delete a directory tree.  
  40.  
  41. If a readonly file is encountered, DELDIR will ask if readonly files should
  42. also be deleted. If you answer YES, all subsequent readonly files will
  43. be deleted.
  44.  
  45. Examples:
  46.    D:>deldir e:\oldjunk
  47.  
  48. *** DIRTREE:
  49.  
  50. DIRTREE is used to sort and display all files in a directory tree. It is
  51. a useful tool for finding multiple occurence of a given file in a 
  52. directory tree.  
  53.  
  54. Sorting can be by name, size, and/or date (you can sort my multiple
  55. criteria); with display in either ascending or descending order.
  56.  
  57. Example. This will sort and display all *.DOC files in or under
  58.          e:\manyfile\set1, with files sorted by filename, and by 
  59.          date within a file name.
  60.  
  61.   D:>dirtree e:\manyfile\set1\*.DOC -Ond
  62.  
  63. Notes
  64.    *  DIRTREE can use, but does not require, REXXLIB.  However,
  65.       when examining many files (several thousand), the ability to use
  66.       REXXLIB procedures can substantially improve progam speed.
  67.  
  68.    * DIRTREE.CMD contains several directory oriented procedures that 
  69.      REXX programmers might find useful.
  70.  
  71.  
  72.  
  73. *** COPYDIR:
  74.  
  75. COPYDIR will copy the contents of a directory tree to a new location.  Among
  76. it's several features are:
  77.  i) If an error occurs, say due to an uncopyable file, COPYDIR will
  78.     note the error, and go to the next file (it is "robust" against
  79.     failures)
  80. ii) If copying from HPFS to FAT directories, COPYDIR will convert
  81.     longnames to 8.3 names.
  82. iii) COPYDIR will not overwrite newer files in the destination directories.
  83. iv) Instead of copying files from a source to a destination directory,
  84.     COPYDIR can create a "destination directory specific .ZIP file", and
  85.     ZIP the files into it. This retains the original structure of the
  86.     source directory, with a unique .ZIP file in each destination directory
  87.     containing the actual files.
  88.  
  89. Example:
  90.   D:>copydir  e:\oldspot  f:\archive\oldspot  -8
  91.  
  92.                 --------------------------------------------
  93.  
  94. Disclaimer:
  95.  
  96.   Permission to use these utility programs for any purpose is hereby granted 
  97.   without fee, provided that the author's name not be used in
  98.   advertising or publicity pertaining to distribution of the software 
  99.   without specific written prior permision. This includes the right to 
  100.   subset and reuse the code,  with proper attribution.
  101.  
  102.   This may not apply to the DELDIR.CMD program, since it is based on
  103.   earlier work; see DELDIR.CMD for details on authorship.
  104.  
  105.   REXXLIB.DLL is NOT freeware. It may freely be used in conjunction
  106.   with COPYDIR, but NOT in REXX software that you develop.  Hence, 
  107.   if you use subsets of these utility programs in your own programs,
  108.   you may need to obtain a licence. 
  109.   For details on obtaining a license for REXXLIB, check 
  110.   http://www.quercus-sys.com.
  111.  
  112.   ZIP.EXE can be obtained from http://quest.jpl.nasa.gov/Info-ZIP/ 
  113.  
  114.   Lastly, the author of these utilities (and any potenially affiliated
  115.   institutions), disclaim any and all liability for damages due to the 
  116.   use, misuse, or  failure of these utilities or of subsets of these
  117.   utilities.
  118.  
  119.  
  120.  
  121.