home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 133.dms / in.adf / Á / duIII.doc < prev    next >
Encoding:
Text File  |  1988-07-26  |  10.2 KB  |  194 lines
  1.           D I R U T I L   I I I   - a file/disk utility program
  2.                 Orignal Version by Chris Nicotra
  3.                 Revisions/Enhancements/Fixes by Dave Jobusch
  4.                 More Revisions/Enhancements/Fixes by Nathan Barber 
  5.  
  6. *********************************************************************
  7. * READ the bottom of this file if you already know how to run the   *
  8. * other versions of this program!                                   *
  9. *********************************************************************
  10.  
  11.    A feature that I really like is being able to get a screen 
  12. display of ASCII files from programs like "Sweep".  The only 
  13. version of DirUtil that has ever had this lacked the numerous 
  14. gadget buttons of this version.  Unfortunately, on that version, 
  15. the individual that added the TYPE feature, decided to keep the 
  16. code.  It's a pity, he had a good implimentation.  When I found this 
  17. version on a local board,  there were only two things that I didn't like. 
  18. The lack of a TYPE was one.  The other is that I have three floppies on my 
  19. Amiga, but the utility only had gadgets for df0: and df1:.  Well, now it 
  20. supports df2:.  When I compiled the code, I got over 50 compiler warnings, 
  21. I cleaned up over half of them and, hopefully, didn't add any new ones. 
  22. Don't worry about the warnings, the code compiles and links fine -- it's 
  23. just that I got tired of looking for errors in midst of the field of 
  24. warnings. It compiled fine with Lattice 3.03 and Manx 3.2
  25.  
  26.         This program is in the public domain. That means you can't
  27.         sell the damn thing to anyone, and further more, I doubt
  28.         you'd get much for it. As a matter of fact, I beat this
  29.         thing to death for 2 weeks, and it still isn't perfect,
  30.         but it works. I got the original program from a BBS 
  31.         in Omaha, and do not know who Chris Nicotra is.
  32.  
  33.         Instructions:
  34.         Click on file or directory names in the file window to 
  35.         select a file to take action on. Click on one of the
  36.         many gadgets to take the selected action on the selected
  37.         files/directory (yes, only one directory at a time).
  38.         The four string gadgets at the bottom are:
  39.  
  40.                 E: The string to be passed to any file you EXEC.    
  41.                 S: The current directory. Mess with this. If you
  42.                    enter an existing path, you just selected the
  43.                    new current directory.
  44.                 D: The destination gadget. This one is used to enter
  45.                    destination directories, and is also where you
  46.                    enter requests for directories to create.
  47.             4th  : Status window. Error descriptions and DOS error
  48.                    numbers appear here. Entries of text into this
  49.                    gadget will result in the destruction of the world.
  50.  
  51.  
  52.         df0:,df1:,df2,ram:,hd0:,hd1:,hd2: --->
  53.                 Set current directory to the root of the selected device.
  54.  
  55.         ALL --->
  56.                 Select ALL files in the current directory, including
  57.                 the ones "scrolled off" the window.
  58.         CLEAR --->
  59.                 De-select all selected files
  60.         COPY --->
  61.                 Copy selected files to the directory specified in the
  62.                 second string gadget. Mind you, you CANNOT enter a
  63.                 filename here. It must be an existing directory 
  64.                 path and CAN go across devices. You should be able
  65.                 to enter paths relative to the current directory.
  66.                 (I think I fixed that...) 
  67.         DELETE --->
  68.                 Delete selected files. Will not delete directories.
  69.         RENAME --->
  70.                 Renames first selected file or directory to the name
  71.                 or path (on the same device) in the D string gadget.
  72.         GETDIR --->
  73.                 If you want to go to a new directory, select
  74.                 a directory in the file window, and click on this
  75.                 gadget. DO NOT USE this to get a directory that is
  76.                 listed in the first string gadget! If you must type
  77.                 it in, you hit return while in the string gadget -
  78.                 then that will be your new current directory.
  79.         MAKEDIR --->
  80.                 This will create the directory that you have typed in
  81.                 the second string gadget. You MAY use relative paths.
  82.         DELETEDIR --->
  83.                 This will delete the non-empty diretory that you have
  84.                 selected in the file window. You will get and error
  85.                 if the directory is not empty.
  86.         PARENT --->
  87.                 Go to the parent directory
  88.         ROOT --->
  89.                 Go to the root of the current device
  90.         TYPE --->
  91.                 Use this to view standard ASCII (readme, docs, etc) on
  92.                 stdout; usually your CRT.  Select the files you want to
  93.                 view, then select the TYPE gadget.  A new window, with 
  94.                 the window name being the file that you are currently
  95.                 viewing, will open.  Use the space bar to advance by one
  96.                 screen, a <CR> will advance one line.  Entering ESC will
  97.                 advance you to the end of that file.  The space bar will
  98.                 then exit from that file.  If you have selected to view
  99.                 more than one file, the next will automatically be
  100.                 displayed.  After all selected files have been viewed,
  101.                 the window will close, returning you to DirUtil's main
  102.                 screen.
  103.         HTYPE --->
  104.                 Types a file to the screen in HEX and ASCII 16 numbers
  105.                 at a time.
  106.         SINFO --->
  107.                 Used to show the number of USABLE bytes from the DEVICE 
  108.                 associated with the current directory (S).
  109.         DINFO --->         
  110.                 Used to show the number of USABLE bytes from the DEVICE 
  111.                 associated with the destination directory (D).
  112.         PRINT --->
  113.                 Same as TYPE, but the output goes to PRT:
  114.         SWAP --->
  115.                 Used to flip the S and D windows.
  116.         BYTE --->
  117.                 Adds up the number of bytes of the selected files and
  118.                 displays the sum and the number of files.  Remember
  119.                 that each file takes up 512 more bytes than indicated
  120.                 because of its directory entry.  
  121.         EXEC ---> 
  122.                 "RUNS" the selected files from inside DIRUTIL. If DIRUTIL
  123.                 was called from CLI, any output from the program is
  124.                 directed to the calling CLI.
  125.         MOVE --->
  126.                 Same basic principle as RENAME, but assumes that you
  127.                 want to just move the file to a new directory, not
  128.                 actually rename it.  It will move multiple files from
  129.                 one directory to another.  The D gadget should have
  130.                 the destination path in it, NOT the whole filename
  131.                 as with RENAME.  MOVE will also move whole subdirectories
  132.                 to another subdirectory, or to ROOT. DO NOT put a / after
  133.                 the path name, MOVE adds it for you if needed.  MOVE is
  134.                 the recommended way to get a file from one place to
  135.                 another quickly since the directory need not be reloaded
  136.                 after the MOVE.
  137.         SHOWILBM --->
  138.                 If you select this to be included, the program will try
  139.                 to copy a SHOW command into the ram disk from SYS:C
  140.                 and lock it (to save it frlom accidental deletion), then
  141.                 will perform consecutive Execute's to show the selected
  142.                 files. The show command that has been floating around
  143.                 here needs you to click the upper left hand corner
  144.                 after showing each file - so there is no loop to wait
  145.                 for a picture to show. If SYS:C/SHOW does not exist,
  146.                 DIRUTIL will continue but will not allow the SHOW gadget
  147.                 to be clicked. 
  148.  
  149.         NEW NOTES: 6-Aug
  150.                 Because of a problem with locking and unlocking the
  151.                 current directory on a disk that had been removed,
  152.                 I had to make a change to what the program defaulted
  153.                 to (for a current directory).
  154.                 Changes made:
  155.                         - Initial current directory is ALWAYS set to RAM: 
  156.                         - if you really confuse it, it will go to RAM:
  157.                           rather than SYS:
  158.  
  159.                 I forgots :
  160.                         I neglected to mention a rather important feature.
  161.                         If you did something stupid like select all files
  162.                         and then hit delete, and suddenly realize that
  163.                         you REALLY didnt want to do that, there is a
  164.                         STOP IDIOT feature. When you are doing operations
  165.                         on a group of files, CLICKING ANYWHERE IN THE
  166.                         WINDOW WILL ABORT THE OPERATION.
  167.  
  168.  
  169.         This version incoorporates all the changes from previous hacks,
  170.         I call it DirUtil III since I was getting tired of saying 
  171.         DirUtil II v1.7 or something long-winded like that.  I have not
  172.         crashed it yet, but would appreciate knowing if all the functions
  173.         work with memory above 512K.
  174.  
  175.         As soon as I get the new Aztec compiler, I will use the new features
  176.         in it to compact and enhance the code some more. Specifically,
  177.         Aztec has a function that will eliminate the need to load the
  178.         SYS:c/Run command whenever an Execute() call is made. Unfortunately,
  179.         this command is buggy under Aztec 3.20a.
  180.  
  181.         This program is "HackerWare", a program that contains executable,
  182.         source, icon, and docs.  PLEASE keep all the files intact if you
  183.         upload the ARC file to another BBS or Information Service and give
  184.         credit where credit is due, Chris, Dave, and myself have worked hard
  185.         on the parts of this program to make it a smooth, efficient tool
  186.         and I hope you enjoy using it!
  187.  
  188.         One last thing, the simple make file in the ARC assumes that you
  189.         have an Aztec precompiled file called s/INT.  If you don't, you 
  190.         either 1> Have Aztec and are too stupid to use the precompiled
  191.         files to cut the compile time to ZIP. or 2>  You are really
  192.         bonkers and use Lattice!
  193.  
  194.