home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 026.lha / DirUtil2v4.doc < prev    next >
Text File  |  1987-04-02  |  9KB  |  181 lines
  1. January, 1987                                                   AMIGAZINE!
  2.  
  3.  
  4.                           D I R U T I L   2  v4.0
  5.                         a file/disk utility program
  6.                      Original Version by Chris Nicotra
  7.                 Revisions/Enhancements/Fixes by Dave Jobusch
  8.                        Rich Medved and Nathan Barber
  9.  
  10.  
  11.  
  12.         Instructions:
  13.         Click on file or directory names in the file window to 
  14.         select a file to take action on. Click on one of the
  15.         many gadgets to take the selected action on the selected
  16.         files/directory (yes, only one directory at a time).
  17.         The three string gadgets at the bottom are:
  18.  
  19.                 S: The current directory. Mess with this. If you
  20.                    enter an existing path, you just selected the
  21.                    new current directory.
  22.                 D: The destination gadget. This one is used to enter
  23.                    destination directories, and is also where you
  24.                    enter requests for directories to create.
  25.                 E: The string to be passed to any file you EXEC. 
  26.  
  27. df0:,df1:,df2:,df3:,ram:,hd0:,hd1:,hd2: --->
  28.                 Set current directory to the root of the selected device.
  29. ALL --->
  30.                 Select ALL files in the current directory, including
  31.                 the ones "scrolled off" the window.
  32. BYTE --->
  33.                 Adds up the number of bytes of the selected files and
  34.                 displays the sum and the number of files.  Remember
  35.                 that each file takes up 512 more bytes than indicated
  36.                 because of its directory entry.  
  37. CLEAR --->
  38.                 De-select all selected files
  39. COPY --->
  40.                 Copy selected files to the directory specified in the
  41.                 second string gadget. Mind you, you CANNOT enter a
  42.                 filename here. It must be an existing directory 
  43.                 path and CAN go across devices. You should be able
  44.                 to enter paths relative to the current directory.
  45. DELETEDIR --->
  46.                 This will delete the non-empty diretory that you have
  47.                 selected in the file window. You will get and error
  48.                 if the directory is not empty.
  49. DELETE --->
  50.                 Delete selected files. Will not delete directories.
  51. DINFO --->         
  52.                 Used to show the number of USABLE bytes from the DEVICE 
  53.                 associated with the destination directory (D).
  54. EDIT --->
  55.                 EDIT allows you to use a text editor from within
  56.                 DirUtil2v4.  First click on the file you want to
  57.                 edit, then click on the EDIT gadget.  To enable this
  58.                 feature, you must rename your text editor to "editor"
  59.                 and place it in the SYS:c directory.  From WB, DirUtil
  60.                 will load a copy of EDITOR into ram: and write protect it.
  61.                 i.e. you will not be able to delete it from within DirUtil.
  62.                 However, DirUtil will automatically delete it from ram: 
  63.                 when you exit the program.  If EDITOR can not be found,
  64.                 DirUtil will load successfully, but the EDIT gadget will
  65.                 be ghosted and inactive.
  66.                   
  67.                 From CLI entering "DirUtil2v4 editor" will cause the same
  68.                 action as when loading from WB.  However, if DirUtil can
  69.                 not find EDITOR, it will abort with an error message.  
  70.                 Entering "DirUtil2v4" only, from CLI will cause DirUtil to
  71.                 load itself without trying to find EDITOR.  The program will
  72.                 load with the EDIT gadget ghosted and inactive.
  73.  
  74. GETDIR --->
  75.                 If you want to go to a new directory, select
  76.                 a directory in the file window, and click on this
  77.                 gadget. DO NOT USE this to get a directory that is
  78.                 listed in the first string gadget! If you must type
  79.                 it in, you hit return while in the string gadget -
  80.                 then that will be your new current directory.
  81. HTYPE --->
  82.                 Types a file to the screen in HEX and ASCII 16 numbers
  83.                 at a time.
  84. MAKDIR --->
  85.                 This will create the directory that you have typed in
  86.                 the second string gadget. You MAY use relative paths.
  87. MOVE --->
  88.                 Same basic principle as RENAME, but assumes that you
  89.                 want to just move the file to a new directory, not
  90.                 actually rename it.  It will move multiple files from
  91.                 one directory to another.  The D gadget should have
  92.                 the destination path in it, NOT the whole filename
  93.                 as with RENAME.  MOVE will also move whole subdirectories
  94.                 to another subdirectory, or to ROOT. DO NOT put a / after
  95.                 the path name, MOVE adds it for you if needed.  MOVE is
  96.                 the recommended way to get a file from one place to
  97.                 another quickly since the directory need not be reloaded
  98.                 after the MOVE.
  99. PARENT --->
  100.                 Go to the parent directory
  101. PRINT --->
  102.                 Selected text files are sent to the printer via PRT:
  103.                 Make sure the desired parameters are set in Preferences.
  104. RENAME --->
  105.                 Renames first selected file or directory to the name
  106.                 or path (on the same device) in the D string gadget.
  107. ROOT --->
  108.                 Go to the root of the current device
  109. RUN ---> 
  110.                 "RUNS" the selected files from inside DIRUTIL. If DIRUTIL
  111.                 was called from CLI, any output from the program is
  112.                 directed to the calling CLI.  Parameters may be passed
  113.                 to the program by entering them in the E window.
  114. SEARCH --->
  115.                 Searches the marked group of files for the pattern found
  116.                 in the E window.  Upper/lower ARE different. If the \
  117.                 character is found, the next two characters are converted
  118.                 into a single Hexadecimal digit and used as one
  119.                 character in the overall search.  The search pattern was
  120.                 limited to 60 max characters by choice.  The search has
  121.                 two modes, SLOW and FAST, which it will choose depending
  122.                 on how much memory is available in the machine. I HIGHLY
  123.                 recommend freeing up enough RAM to allow the FAST mode to
  124.                 run since the SLOW mode is AT LEAST 10 times slower.
  125.                 The SLOW mode search can be aborted by hitting the ESC
  126.                 key. The FAST mode cannot be aborted, it is so fast you
  127.                 will not mind the slight wait.
  128. SHOW --->
  129.                 Select the IFF files you wish to display, one or more,
  130.                 then click on the SHOW gadget.  DirUtil will attempt to
  131.                 display these files.  This function will work with most,
  132.                 but not all forms of IFF files.  If DirUtil can not 
  133.                 display the file, an error message will be displayed in
  134.                 the error msg. window and DirUtil will go on to the next
  135.                 selection, if there is one.
  136.  
  137.                 DirUtil opens a new screen for the IFF file, displays the
  138.                 file, then waits for you to continue.  When finished
  139.                 viewing the image, click in the upper-left corner of the 
  140.                 image.  There is an invisible close gadget located there.
  141.                 DirUtil will close the screen and procede to display 
  142.                 the next file.
  143.  
  144. SINFO --->
  145.                 Used to show the number of USABLE bytes from the DEVICE 
  146.                 associated with the current directory (S).
  147. SWAP --->
  148.                 Used to flip the S and D windows.
  149. TYPE --->
  150.                 Use this to view standard ASCII (readme, docs, etc) on
  151.                 your monitor screen.  Select the files you want to
  152.                 view, then select the TYPE gadget.  A new window, with 
  153.                 the window name being the file that you are currently
  154.                 viewing, will open.  Use the space bar to advance by one
  155.                 screen, a <CR> will advance one line.  Entering ESC will
  156.                 advance you to the end of that file.  The space bar will
  157.                 then exit from that file.  If you have selected to view
  158.                 more than one file, the next will automatically be
  159.                 displayed.  After all selected files have been viewed,
  160.                 the window will close, returning you to DirUtil's main
  161.                 screen.
  162.  
  163.  
  164.                 NOTES:
  165.  
  166.                 The source directory always starts out as the RAM:
  167.                 device by default.
  168.  
  169.                 I neglected to mention a rather important feature.
  170.                 If you did something stupid like select all files
  171.                 and then hit delete, and suddenly realize that
  172.                 you REALLY didnt want to do that, there is a
  173.                 STOP IDIOT feature. When you are doing operations
  174.                 on a group of files, CLICKING ANYWHERE IN THE
  175.                 WINDOW WILL ABORT THE OPERATION.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.