DiskMAG Volume 1 Number 2 (Nov 1988) : UTILITIES / duIII2.doc





























                               DirUtil III Plus HR

                 File Management Utility for the Commodore Amiga

                       Copyright 1987, 1988 Nathan Barber

                         Release Date September 19, 1988



     DirUtil III  Plus HR is Copyright 1987,1988 by Nathan Barber and is NOT
     in the Public Domain.  However, the author hereby releases the included
     demo  version  of  the  program and this documentation for distribution
     under the conditions described in the following paragraphs:

     This program is distributed as a demo ONLY.   If  you use  and like the
     demo of this program and wish to receive the fully operational version,
     send a minimum of  $25  in  United  States  currency  to  the following
     address:

                    Nathan Barber
                    227 Chateaugay St. NW
                    Fort Walton Beach FL  32548

     For further  information regarding enhancements or other questions, you
     may also contact me on GEnie as NBARBER and with FIDOnet mail addressed
     to Nathan Barber sent to 366/3.

     With the first $25 of your payment, you will receive the latest version
     of the program and  a personal  demo version  that you  may freely dis-
     tribute in order to collect commission bonuses (see below).  Amiga User
     Groups are invited to inquire about bulk distribution of the program at
     reduced rates.   Any  funds remaining after the initial fee will be put
     towards the purchase of enhanced versions of the program as they become
     available at  the rate of $10.00 each.  I will supply the blank disk as
     a bonus for advance payment of at least one updated version at the time
     of initial purchase.

     If  you  wish  to  have  a  change made to the program, enclose its de-
     scription with your payment and I will try to add it to your copy prior
     to shipping.  Bugs (none currently known) reported prior to the release
     of an enhanced version will be fixed for  registered owners  of DirUtil
     III Plus HR for the cost of shipping and materials.  Normal enhancement
     updates are available for $10.00 and  a blank,  formatted disk  sent to
     the address above ($11.50 with no disk).

     DirUtil III  Plus HR  will perform very closely to what is described in
     this documentation.  However, because of the nature of the program, the
     author cannot assume responsibility for any lost time and/or profits or
     claims of fitness for a particular  purpose resulting  from the  use of
     the program.

     Commission Sales:
     ---------------- 

     The following  policy supercedes all other commission offers previously
     extended to Amiga User Groups and individuals.

     After registering your copy of the program, the  disk you  receive will
     contain a  personal demo version of the program with your serial number
     prepended with the letter "D".  The disk  will also  contain a  file in
     the popular  ARChive format  that you  may upload  to any  BBS or tele-
     communications service in the country that is not specifically excluded
     by the  listing that  follows this  paragraph.  You may also distribute
     your personal demo copy through any  other channel  except as  noted in
     the  following  paragraph.    Commissions  are  paid as credits towards
     future updates unless otherwise requested.   An update  credit of $5.00
     will be awarded for each copy of DirUtil III Plus HR that is registered

                                     Page 2


     using the serial number contained in  your personal  demo.   It is VERY
     important  that  you  make  sure  that  persons registering a copy dis-
     tributed by you include their serial numbers as no credit  can be given
     without this  number.   Cash credits will be given ONLY if requested in
     writing at 50% of the current credit balance in your  account.  Program
     updates will  be mailed  automatically when your account reaches $10 of
     credit if an enhanced  version of  the program  is available.   Persons
     wishing  cash  payment  should  address  a letter to me informing me of
     their desires.  Cash payments  will  be  sent  out  every  three months
     (approximately) or when the cash balance reaches $50.  

     Restrictions on Distribution:
     ----------------------------

     DirUtil III Plus HR, its documentation, support programs, and all asso-
     ciated works MAY NOT  be  distributed  through  the  following entities
     without  prior  written  permission  of  the  author.  Furthermore, all
     previous versions  of this  program written  by Nathan  Barber and col-
     lectively known as DirUtil III and DirUtil III Plus must be removed and
     destroyed if any part of  this  package,  or  any  collection  of files
     containing  this  package  is  available  from  the same source as this
     package.

     DirUtil III Plus HR (demo version) must not be distributed to:

     1.   Any person in the employ of Random Access Computers in Fort Walton
          Beach Florida, nor to the business itself.
     2.   Any person  in the employ of Oscar's Computers in Okaloosa County,
          Florida, nor to the business itself.
     3.   Any officer of the Okaloosa Amiga Research Society  (OARS) in Fort
          Walton Beach, Florida.
     4.      Any  other  business,  organization, or computer Bulletin Board
          Service in Florida having  one  of  the  following  area  code and
          prefix combinations:

               904-862   904-863   904-837   904-243   904-244   904-581
               904-664   904-651   904-678   904-897   904-729   904-939
               904-267

     5.   The  General  Electric  Network  for  Information Exchange (GENIE)
          EXCEPT for releases uploaded by NBARBER.

     These restrictions are to allow a  limited  beta  test  area  free from
     prior versions. Item 5 is included as this is the national network that
     will have the most current version and will be handled by myself and no
     one else.

     System Requirements:
     -------------------

     DirUtil III  Plus HR  requires any  Amiga with 512K of memory, one disk
     drive, and Kickstart  1.2  or  higher.    Two  disk  drives  are highly
     recommended and  certain commands  may require more than 512K of memory
     ie. SHOWING large picture files.





                                     Page 3


     Introduction:
     ------------

     DirUtil III Plus HR has been around in  one incarnation  or another for
     over a  year (since  March 1987).   For a year, DirUtil III Plus HR has
     been "marketed" as a pay before  you  play  product  with  various demo
     versions of  the program being distributed.  I must say that I am quite
     pleased with all the people who supported the previous versions  of the
     product and  were willing  to bear  with me as I made improvements that
     delayed shipment of a fully operational  copy.   I previously  placed a
     $20 charge  on the  program.   I am now releasing an updated two window
     version of the program which included many user  suggested enhancements
     in the  hope that  it will  make the  Amiga a  better place to live and
     play.  I plan on releasing a new  version with  user suggested improve-
     ments approximately  every two  months or when I have received ten user
     requested improvements.

     Features of DirUtil III Plus HR:
     -------------------------------

     DirUtil III Plus HR was made to be a replacement for the AmigaDOS Work-
     Bench and  CLI interfaces  and an alternative to the other file manage-
     ment systems now on the market.   DirUtil  III Plus  HR encompasses the
     best features  of both  Workbench and CLI and consumes little memory or
     disk space.  DirUtil  III  Plus  HR  also  provides  many  features not
     available or tedious to perform in the normal AmigaDOS environment.

     DirUtil  III  Plus  HR  contains  over  100  functions  with variations
     including user definable gadgets.

     DirUtil III  Plus HR  is not  limited to  the preset  devices that some
     programmer thought  up.   The program  automatically reads YOUR devices
     upon startup.

     With DirUtil III Plus HR, you can delete 90% of the commands in your C:
     and  SYS:system/  directories,  thereby  freeing valuable space on your
     disks.

     Unlike other file management programs, DirUtil III Plus HR contains all
     the code  you need  to do  normal disk  functions such as COPY, DELETE,
     DISKCOPY (with multiple copy ability), FORMAT  and SHOW.   Other lesser
     programs make you reinsert the Workbench disk to load the command.

     DirUtil III  Plus HR  is the  ONLY program that will show full overscan
     pictures successfully and allow scrolling of those pictures.

     DirUtil III Plus HR is a  viable  hard  disk  backup  program  when the
     program's powerful file selection and archiving features are used.

     Known Problems beyond the control of DirUtil III Plus HR:
     --------------------------------------------------------

     Some  older  device  drivers  such  as  VDK:,  do not support setting a
     filedate after a file is created.  This causes DirUtil  III Plus  HR to
     sometimes fail  to set  the datestamp on a file it has just copied.  If
     this happens, just select the file with the bad date  (hitting the DATE
     gadget will show you the files to select), then hit the RIGHT button on
     FIXOBJ.

                                     Page 4



     The Amiga Workbench has  a  very  poor  and  inconsistent  interface to
     AmigaDOS.   It does not honor the DOS path command in a predictable way
     and does not support the setting of a current directory without the use
     of  the  DOS  CD  command.    Consequently, the DOS batch file commands
     listed under the description of the RUN command are practically useless
     if DirUtil III Plus HR is invoked from WorkBench.  If you have only one
     drive and are trying  to run  DirUtil III  Plus HR  strictly from Work-
     Bench, be  prepared for  a lot  of disk swapping when using the RUN and
     EXEC commands.

     Occasionally, the SHIFT and ALT keys will appear  to have  become stuck
     in the wrong position.  This is caused by hitting the SHIFT or ALT keys
     when the DirUtil III Plus HR main window is active, then releasing them
     when it's windows are not active.  Hitting and then releasing the SHIFT
     or ALT key after activating one of the DirUtil III Plus HR windows will
     eliminate  the  problem  should  this  occur.   Also, it has come to my
     attention that the TimeSaver Clock/Macro  add-on  from  C-Ltd  uses the
     right SHIFT  key for  it own  purposes.   If you have this product, you
     must use the LEFT SHIFT key on those commands that  specify the  use of
     EITHER SHIFT key.

     Certain IFF pictures, most notably gray scale, hi-res pictures produced
     by DigiView V2.0, save  incorrect color  cycling information.   DirUtil
     III Plus  HR compensates  for this  but certain combinations might slip
     through as new IFF picture formats  are  introduced.    Also,  the new,
     large scrollable pictures produced with Express Paint from PAR Software
     have been reported to cause a crash when  viewed from  DirUtil III Plus
     HR.   As I do not have this software, proper handling of these pictures
     might be a long  time in  coming.   The maximum  size picture  thus far
     shown successfully shown is 768x480.


     IMPORTANT TRACKING INFORMATION:
     ------------------------------

     The copy  of DirUtil III Plus HR you received contains a serial number.
     You can view the serial number and version  number by  hitting the ALT-
     SHIFT-CONTROL key  combination at the same time.  This serial number is
     used to track distribution of the  program and  to provide  me with the
     internal version  number of  the program for update purposes.  When you
     register your copy of DirUtil III  Plus HR,  include the  serial number
     and version  number of  the copy you are registering.  This will enable
     me to pay commissions as outlined above.















                                     Page 5


     Instructions:

          Workbench Startup:  Click on the DirUtil III  Plus HR  icon.  The
          program will load and open a small window on the Workbench screen
          as well as its own screen.  DirUtil  III Plus  HR will  then load
          the filelists  from the  default device if it is known, otherwise
          it will default to the RAM: device.

          CLI Startup:   Type  "du" or  "run du"  (no quotes)  to start the
          program.   A stack of 25000 is recommended if running the program
          on a hard disk or on a floppy disk with a large  number of files.
          DirUtil III Plus HR will then load the filelists from the default
          device if it is known, otherwise  it  will  default  to  the RAM:
          device.

          NOTE:   The small window that opens on the Workbench screen while
          DirUtil III Plus HR is running may not close when  the program is
          exited.    If  this  happens,  it  means that another program has
          "adopted" that window as its own.  The window will close when all
          programs using it have closed.

          THE DISPLAY WINDOWS:  DirUtil III Plus HR opens its own 640x400 4
          color interlaced Intuition screen  during operation.   If  you do
          not like  interlace mode,  or need to save memory, hitting SHIFT-
          ESC will toggle DirUtil III Plus  HR into  a non-interlaced mode.
          The title  bar of the largest window on this screen has a display
          of "F: xxxxxxx C: xxxxxxxx".  The  number after  the "F:"  is the
          amount of  FAST ram you have available in your Amiga.  The number
          after the "C:" is the amount  of CHIP  ram you  have available in
          your Amiga.   The  CHIP ram  number is  the most important as the
          Amiga does not perform well when CHIP ram is extremely low (below
          32000 bytes).  Just above the Intuition window front/back gadgets
          on the upper right is a  one  pixel  tall  screen  front  to back
          gadget for moving the DirUtil III Plus HR screen. The majority of
          the rest of this window contains the filenames and subdirectories
          associated with  the "S"ource and "D"estination directories.  You
          may manually change the "S" and "D" directories by entering a new
          name in  the string  gadgets just above this file display.  Above
          the "S" and "D" gadgets are  two  lines  used  for  status infor-
          mation.   The two  slider gadgets  running down the middle of the
          screen are used to position the file display window.   The second
          window, labeled  "Function Window", contains all the gadgets that
          control what functions will be  done  to  the  highlighted files.
          This window  may be  dragged or moved to the back to of the large
          window to allow more filenames  to  be  displayed.  Also, hitting
          ALT-ESC will  resize this window to show just he built-in DirUtil
          III Plus HR functions (useful for use in non-interlaced mode). 

          To select/deselect a directory  entry, click  on its  name in the
          file window with the left mouse button.  Click on one of the 
          gadgets to take the selected action on the selected names.

          To enter  a subdirectory,  click on its name with the RIGHT mouse
          button.  NOTE: in order for  any function  using the  RIGHT mouse
          button to  function, one  of the  two DirUtil III Plus HR windows
          must be active.  To automate this requirement, I highly recommend
          either DMouse  or MachMouse  (both available  on many BBS' around
          the country).

                                     Page 6



          If you invoke a function that you really did not  mean to invoke,
          click anywhere  in the  DirUtil III  Plus HR screen with the LEFT
          mouse button to abort the operation.   You  will be  asked if you
          really want to abort the next time DirUtil III Plus HR checks the
          status of the mouse.  The mouse is  checked before  any operation
          that would  write to  a disk  and periodically  while DirUtil III
          Plus HR  is passively  acting on  a disk.   Any  operation can be
          aborted, even reading the directory of a disk.

          If you  hit and  drag either of the slider gadgets, the filenames
          will scroll in real time with the movement of the gadget.

          The two file windows are treated on an  equal basis.   Either may
          be the  "S"ource or  "D"estination  directory.  To switch between
          them, just click on the half of the screen containing the window.
          You will  see the highlighting change and the letters "S" and "D"
          change places.

          The string gadgets at the top of the  DirUtil III  Plus HR window
          are:

                    S: The source directory.
                    D: The destination directory.

     Device Gadgets:
          The first  two rows of four gadgets each are reserved for the
          first eight file system devices that you have in your system.
          These gadgets  will always include the disk device from which
          the program was booted.   DirUtil  III Plus  HR automatically
          fills these  in alphabetical  order when the program is first
          booted.  If you have less  than eight  devices, the remainder
          of these gadgets will remain blank and not used.  If you have
          more than eight devices,  any  unused  user  gadgets  will be
          filled with  the overflow.   If  DirUtil III Plus HR must use
          this "overflow" area, the gadget text  will be  prefixed with
          the  '@'  symbol  to  signify  a  temporary allocation.  Such
          temporary device gadgets will not be  saved upon  exiting the
          program.   DirUtil III Plus HR can update this listing at any
          time with a command from you (see USER GADGET descriptions).
          Hitting the left button on  one  of  these  gadgets  sets the
          "S"ource  directory  to  the  root of the selected device and
          reads the filelist of that device  if possible.   Hitting the
          right button  on these  gadgets sets the "D"estination gadget
          to the root of  the selected  device and  reads its filelist.
          While reading  the filelist  of a  disk, DirUtil  III Plus HR
          might bring up the prompt "Directory Loop - Continue?".  This
          means that  the current  filelist has  over 256 entries in it
          and DirUtil  III  Plus  HR  is  warning  you  that  your disk
          directory might  be damaged  in such  a way  as to eventually
          hang the machine if processing is continued.  If you  are not
          sure of  the contents of the directory you are reading, it is
          good procedure to click "ABORT" and see what DirUtil III Plus
          HR has read so far.  There are many valid situations in which
          a directory can have more than  256 proper  entries.   If you
          know this  to be  the case, feel free to click "CONTINUE" and
          proceed.  If you click "CONTINUE" and the directory really is
          in a  loop, you  will have  to click the left mouse button to

                                     Page 7


          abort the filelist scan operation.  Since DirUtil III Plus HR
          is only limited by available memory as to the number of file-
          names it can process, you run  the  risk  of  running  out of
          memory if a directory loop is allowed to continue forever.

          REMINDER:   One of the two windows on the DirUtil III Plus HR
          screen must be active in order for any function that involves
          the right button to work properly.

     ALL(D)
          Select all  files in the current "S" directory, including the
          ones "scrolled off" the  window.    Hitting  the  RIGHT mouse
          button will  highlight all  subdirectories as  well.  Hitting
          the  right  mouse  button  while  holding  a  SHIFT  key will
          highlight  all  files  whose  protection  flag  includes  the
          archive flag.

     CLEAR
          De-select all selected files in the  "S" directory.   Hitting
          the right button will clear all selected subdirectories.

     COPY
          Copy  selected  files  to  the directory specified in the "D"
          gadget.  "D" must contain an existing directory  path and CAN
          go  across  devices.    COPY preserves the protection status,
          file comment, and creation date  of  the  original  file when
          making the  copy.  DirUtil III Plus HR will clear the archive
          bit on any copied file as  per AmigaDOS  convention.   If you
          select  to  copy  a  subdirectory,  DirUtil  III Plus HR will
          create that directory on the "D" disk and copy all  the files
          to the  new directory.   If an error condition is encountered
          while copying files inside the subdirectory  or anywhere else
          in  its  particular  "tree",  all  files  associated with the
          subdirectory  will  be  deleted  from  the  destination disk.
          Hitting the  right mouse  button on  COPY copies all selected
          files as above and sets  the  archive  bit  for  the original
          file.  Non disk devices such as PRT:, SER:, and PAR: may have
          files copied  to them  by manually  entering the  name of the
          device into the "D" gadget.

     DELETE
          Delete selected  files and directories.  You will be prompted
          for confirmation before any files are deleted.

     RENAME
          Renames selected files to  a different  name or  path (on the
          same device).   You  must enter the COMPLETE PATH and NAME of
          the renamed file. You will be  prompted for  the new  name of
          the file for every highlighted file.

     MAKEDIR
          This will  create a  new subdirectory.   You will be prompted
          for the name of the new subdirectory.  Enter the FULL PATH of
          the directory  you wish  to create.  DirUtil III Plus HR will
          prompt you with the current "S" directory as a starting point
          to try  and save  you some  typing.  Hitting the right button
          will create a directory AND create a drawer  icon to  go with


                                     Page 8


          it.   Also, using  the right  button option will allow you to
          create a drawer icon for an existing directory.

     PARENT
          Go to the parent directory of  the "S"  gadget.   Clicking on
          the gadget  with the right mouse button will go to the parent
          directory of the "D" gadget.

     TYPE
          Use this to view standard ASCII  files on  your screen.   Use
          the  slider  gadget  to  move anywhere in the text instantly.
          Hitting the LEFT mouse button moves back a page.  Hitting the
          RIGHT mouse  button moves  forward a  page.   Cursor LEFT and
          RIGHT emulate the LEFT  and RIGHT  mouse buttons.   Cursor UP
          and  DOWN  pages  four  lines  at  a  time either up or down.
          Hitting "T" will go to the top of a file and "B"  key goes to
          the bottom of a file.  Hit the CLOSE WINDOW gadget or the ESC
          key when you are through looking  at the  file.   Hitting the
          right  mouse  button  on  the  gadget will type a file to the
          screen in  HEX and  ASCII 20  numbers at  a time.   The mouse
          pages the file as above and the cursor left, cursor right and
          ESC keys also function as above.  If you have trouble reading
          the text  displayed in  the interlace mode, try dropping into
          non-interlace mode before hitting TYPE.

     INFO
          Used to  show  the  number  of  free  bytes  from  the device
          associated with  the "S" gadget.  Hitting the right button on
          this gadget will display  the same  data for  the "D" gadget.
          The  numbers  given  in  parentheses  are  the number of disk
          sectors used  and  free  respectively  and  can  generally be
          compared  to  the  corresponding  numbers  given  by the BYTE
          command.  INFO also  supports  Workbench  1.3  with  the Fast
          Filing System.   Comparing the numbers INFO gives for FFS and
          non-FFS devices is not very useful due to  varying data block
          sizes.

     PRINT
          Copies the chosen files to PRT: using the current Preferences
          settings.

     SWAP
          Flips the highlighted status of  all  files  in  the  "S" di-
          rectory, including  subdirectories.  Hitting the RIGHT button
          will copy DirUtil III Plus HR's file information from the "S"
          file window  to the  "D" file window WITHOUT actually copying
          any files.   This  effectively  gives  you  two  windows that
          contain the  same information  without having  to re-read the
          disk's directory over again.

     BYTE
          Adds up the number  of  bytes  of  the  selected  files, sub-
          directories and  any files in the subdirectories and displays
          the sum, the  number  of  files,  and  the  number  of subdi-
          rectories.   The number  in parentheses is the number of disk
          sectors used by the files  and  subdirectories  and  can gen-
          erally be  compared to the corresponding numbers given by the
          INFO command.

                                     Page 9



     RUN
          "RUNS" the selected files  from inside  DirUtil III  Plus HR.
          The file  C:RUN must be available for RUN to function proper-
          ly.  If you only have one disk drive or you do not want to be
          bothered with  having to reinsert the system disk to load the
          AmigaDOS "run"  command,  add  the  following  lines  to your
          startup-sequence and  only run  DirUtil III  Plus HR from the
          CLI:

               copy c:run ram:
               copy c:cd ram:
               path add sys:c
               assign c: ram:

          This batch file  will,  however,  fail  to  find  the  normal DOS
          commands if  the system disk is not in the drive when the command
          is invoked.  Hitting this gadget with the right button  will EXEC
          a batch  file.  The files "NEWCLI" and "ENDCLI" must be available
          in your  search path  for EXEC  to function.   If  the batch file
          aborts, you  will have  to type "ENDCLI" to close the DOS window.
          As a useful side effect to this abnormally  ended batch  file, if
          you need  a quick  NEWCLI, just  EXEC a  file that is NOT a batch
          file.  EXEC will abort, but you will have a  newcli and  you will
          not have to waste a user gadget on the command!

     EDITOR
          Call the  program named "ED" in order to edit the selected files.
          The editor is a completely separate  task and  runs independently
          of DirUtil  III Plus  HR once  started.  Hitting the right button
          will call "ED" and put quotes around the  filename to  be edited.
          Many editors cannot parse quotes; this alternate format is a last
          resort when trying to  edit files  which contain  spaces in their
          filenames.   Since the  editor runs  as a separate task, the file
          length of the edited file may not match  the number  displayed by
          DirUtil III  Plus HR.   All commands will adopt the new file size
          if the edited file is accessed again.

     LIST
          LIST will print the names,  sizes,  dates  of  creation  and pro-
          tection  status  of  ALL  files  in  the  filelist.   You will be
          prompted for an output  filename.    If  the output  file already
          exists,  LIST  will  append  its  data to the end of the existing
          file.

     DATE
          DATE is a toggle.   If  highlighted,  the  date  of  creation and
          protection status  of the files in the filelist will be displayed
          instead of their size.   Hitting  the right  button on  DATE will
          check all the files in the "S" directory against all files in the
          "D" directory and highlight all those that are newer than  a file
          of the same name found in the "D" directory.

     PROTECT
          PROTECT  summons  a  requester  containing ten gadgets.  Eight of
          these  gadgets  are  the  alphabetic  flags  associated  with the
          protection status  of a  selected file.   Click  on these gadgets
          until you  have the  pattern you  wish to  use for  all the high-

                                     Page 10


          lighted files.   Hitting  OK will  protect the  file according to
          your pattern.  Hitting ABORT leaves the pattern as it  was before
          the requester was entered.

     MOVE
          MOVE performs  a COPY and DELETE on the selected file(s) from the
          "S" directory to the "D" directory.   MOVE  will move  whole sub-
          directories to  any other  path including another subdirectory or
          another device.  MOVE is the recommended way  to get  a file from
          one place to another quickly since it will do a RENAME command if
          the files are destined to be on the same device  rather than copy
          then delete  a file.   Successful MOVES between different devices
          will result in the original file being deleted.

          BEWARE:  there is a bug in the DOS 1.2  RAM: device.   You should
          not MOVE a file to RAM: if it already exists.

     SEARCH
          Search a file for a pattern.  You will be prompted for the search
          string.  Upper/lowercase characters  are  different  ONLY  if you
          select this  function with  the right  mouse button.   If the "\"
          character is found in the search string, the  next two characters
          are converted  into a  single hexadecimal  digit and  used as one
          character in the overall search.  If a question mark  is found in
          the pattern,  it will match any character found in that position.
          The search pattern is limited  to  60  characters.    SEARCH will
          abort if  you hit  the close  window gadget  on its output window
          while the search is in progress.  When  searching a  file using a
          hexadecimal  pattern,  it  is  recommended  that you only use the
          right  button   option   to   prevent   unwanted  upper/lowercase
          conversions. 

     DISKCOPY
          COPY a whole disk without regard to file structure.  You can copy
          with one drive or two and  can copy  using the  5.25" Transformer
          drive.   DISKCOPY will prompt for a source and destination drive.
          In the case of one drive copies, you  will be  prompted when disk
          swaps are  needed.   Click the DirUtil III Plus HR window's close
          window gadget in the  upper left  corner of  the screen  when you
          have swapped  disks.   DISKCOPY works ONLY with the floppy drives
          listed in the prompt requester.  DISKCOPY assumes you are copying
          disks with the same number of cylinders ie. 3.5" to 3.5" or 5.25"
          to 5.25", but not  3.5" to  5.25".   Hitting the  right button on
          this gadget  will perform  a DISKCOPY and verify the written data
          more stringently.  DISKCOPY does not require that the destination
          disk  be  pre-formatted,  it  will  do  that  itself  if  needed.
          DISKCOPY uses  all  available  RAM  starting  with  FAST  RAM and
          continuing with  CHIP RAM if needed.  If you have enough free RAM
          to load the entire contents of the disk into memory  at one time,
          DirUtil III Plus HR will ask you if you wish to make another copy
          of the disk after the  first  copy  is  complete.    If  you tell
          DirUtil III  Plus HR  you would like another copy, it will prompt
          you to insert another blank disk (formatted or  unformatted) into
          the drive that was specified as the destination and click the 
          close  gadget  on  the  larger  of  the  two  DirUtil III Plus HR




                                     Page 11


          windows.  You may make as  many copies  of the  same disk  as you
          would like, just hit "ABORT" when you wish to stop making copies.

     ARCV
          List the contents of an ARC file to the screen. Hitting the right
          button on this gadget will list the contents of a ZOO file (up to
          V1.31 of  ZOO) on the screen.  DirUtil III Plus HR will print the
          names of V1.40 (or higher) ZOO files, but not the  full pathnames
          allowed in  V1.40.   This will  be included in future versions of
          DirUtil III Plus HR.  Hit  the Window  Close gadget  to exit from
          the listing window.

     FIXOBJ
          FIXOBJ will  "pad" a file you have downloaded to enable the Amiga
          scatter loader to process it correctly.  FIXOBJ has two  modes of
          operation.   First, if  the file  is NOT already padded and is an
          executable,  FIXOBJ  pads  it  so  that  upon  uploading,  anyone
          downloading that  file need  not FIXOBJ  it again,  just load and
          run.  Second, FIXOBJ will pad a file that has been downloaded but
          not yet  fixed.  FIXOBJ will not pad any file that is not a stand
          alone executable ie. ARC files.  Hitting the right button on this
          gadget  will  change  the  dates  of the highlighted files to the
          current date.  This is to fix a bug in  some device  handlers and
          will  not  be  needed  using  floppies,  RAM:  or hard disks with
          properly written drivers.

     SAVE OLD
          SAVE OLD is a toggle.  If enabled, you cannot  copy/move/rename a
          file to a file that already exists in the new directory path with
          the same name.  Hitting the right button  will highlight  all the
          files that exist on both the "S" and "D" devices.

     FREEZE
          FREEZE  is  a  toggle.    If  FREEZE mode is active, any name you
          highlight will not be  de-selected upon  completion of subsequent
          functions that act upon highlighted files.

     SHOW
          SHOW the  selected files as IFF pictures.  If you have selected a
          subdirectory, DirUtil III Plus HR  will  also  show  any pictures
          contained within  these subdirectories.   Click in the upper left
          hand corner of the screen or hit the ESC key  to cease  viewing a
          picture.  If the selected pictures have color cycling information
          imbedded  in  them  in  Dpaint  format,  the  picture  will cycle
          automatically.  This automatic cycling may be manually overridden
          by hitting the right button on  SHOW.   DirUtil III  Plus HR will
          reject any  file that  is not a picture.  It will also attempt to
          show a  picture recorded  in "overscan"  mode.   Overscan mode is
          very desirable  in professional  video, but  many monitors cannot
          display the full picture at one  time.   If this  is the  case on
          your monitor,  use the  left, right,  up, and down cursor keys to
          move the picture around on the  monitor.   I have  purposely left
          out bounds  checking for this scrolling picture feature to enable
          the largest possible pictures  to be  shown.   If you  scroll the
          picture too far in a given direction, the Amiga will show it in a
          manner not conducive to pleasant display.   No  harm will result,
          but  the  picture  will  not  look  like a picture!  To correct a


                                     Page 12


          situation such as this, just scroll in the opposite direction and
          the strange display mode will correct itself.

     SLIDE
          SLIDE is  a toggle.   The  slideshow mode  will show all selected
          pictures with a blank backdrop screen.  You do not  have to click
          in the  upper left  hand corner  to view  the next picture.  When
          starting the slide show,  you  will  be  prompted  for  the delay
          factor between  pictures.  There are 50 time units per second ie.
          entering 50 (the default) will pause one second between pictures.
          The  normal  abort  procedure  for  DirUtil III Plus HR functions
          still holds:  just click the  backdrop  screen  to  the  back and
          click inside  DirUtil III Plus HR' window as usual.  Clicking the
          right mouse button on  SLIDE will  toggle a  continuous SHOW mode
          that will  show the  selected files and directories until DirUtil
          III Plus HR is manually aborted.

     CHANGE
          Perform a DISKCHANGE command on a  floppy  drive.    You  will be
          prompted for the drive name.
            
     FORMAT
          FORMAT a  floppy drive.   You will be prompted for both the drive
          name to format and the new name for the disk.  Disknames  must be
          less than  32 characters in length.  Format destroys all previous
          data on a disk so be careful when using it.  Format works on 3.5"
          drives and the 5.25" Transformer drive.  Hitting the right button
          will format the disk and do a more  complete verification  of the
          disk at  the same  time.   Either method  of formatting a disk is
          faster than the standard AmigaDOS format command.

     RELABEL
          Change the name of the disk represented in  the "S"  gadget.  You
          will be  prompted for  the new diskname.  Names must be less than
          32 characters in length.

     COMMENT
          Set the comment  field  of  the  selected  files.    You  will be
          prompted for  the new  comment to attach to each selected file in
          succession.  You  must  use  the  AmigaDOS  LIST  command  or the
          WorkBench INFO  command to  see the  comment from outside DirUtil
          III Plus HR.  DirUtil III Plus HR's  COPY command  will replicate
          the comment  on any  file you  copy unlike  normal AmigaDOS (upto
          V1.2) and is the preferred way  to preserve  comments on  a file.
          Hitting  the  right  button  on  COMMENT  will  show the comments
          attached to the highlighted files.

     CRYPT
          CRYPT is a toggle.  If lit, any file you TYPE, COPY, MOVE or SHOW
          will be crypted/de-crypted according to the current password key.
          To enter this password key, hit the right mouse button  on CRYPT.
          The decryption  password must  be at least 5 characters long.  If
          the CRYPT gadget is lit, this password will  be used  for various
          commands listed  below.   DirUtil III  Plus HR encodes 33.5 kilo-
          bytes of data per  second so  using this  function will  not slow
          down operation significantly.  The encryption mode is reversible;
          ie. copying a file twice  with  data  encryption  turned  on will
          result in  an unchanged copy of the original file.  No encryption

                                     Page 13


          algorithm is foolproof, but the one used in  DirUtil III  Plus HR
          is as  good as  you will see outside the government.  Without the
          password, no one (even  the author)  will have  any kind  of rea-
          sonable change of gaining access to the file's data.

     WHEREIS
          WHEREIS is  used to  find a file on a disk when you only know the
          first few  letters of  the name.   You  will be  prompted for the
          filename which you wish to find.  Enter as many characters as you
          can remember (upper/lower case are the same).   WHEREIS will scan
          from the  current "S"  directory through  all the  files and sub-
          directories on the disk looking for a match.  For example, if you
          entered  "du",  DirUtil  III  Plus HR will locate "du", "dudemo",
          "du2.config", etc.  If DirUtil III Plus HR finds a match, it will
          print the  full pathname  where the  file or  subdirectory may be
          found and ask you if it should continue searching.   Any group of
          characters  may  be  searched  for, although searching for a file
          with no name will not succeed.

     SORT
          Clicking on SORT with the left  mouse button  rotates the current
          sorting criteria  of the  file listings.  The three possibilities
          are: SORT by NAME (the default), SORT by DATE, and  SORT by SIZE.
          The  new  status  of  the  file  listing  will be immediately re-
          displayed according to  the  new  settings.    Hitting  the right
          button  on  SORT  toggles the sort routine's ascending/descending
          progression.  The default is to sort in  ascending order.   Files
          with bad  datestamps will  be set  to have a date of 0, IE Jan 0,
          1978 in the Amiga scheme of things.  By definition subdirectories
          have  not  a  file  length,  so  they are treated as files with a
          length of 0.  Observe that this allows all the  subdirectories of
          a disk  to be  grouped at  the top or bottom of a file listing if
          sorting by size is performed.

     PLAY
          PLAY an IFF sound file or a raw  data file.   If  the file  has a
          valid IFF  header, the  period of  the sound  will be set accord-
          ingly.  Hitting the right button on PLAY will cause  the sound to
          play continuiously until the user performs an abort.

     ARC
          Click on the files to be contained in the ARC file, but remember,
          a command line can  only be  255 characters  total.   You will be
          prompted for  the name of the ARC file to create.  You must enter
          the WHOLE path and  name of  the ARC  file to  create WITHOUT THE
          .ARC EXTENSION.  The ARC command will be loaded from your current
          path if DirUtil III Plus HR was run from the CLI or  from your C:
          directory if run from the Workbench.  See the endnotes to help in
          ARCing files with one disk drive.   Hitting  the right  button on
          ARC will  UNARC the selected ARC files.  You will be prompted for
          the device and/or subdirectory into which  the UNARCed  files are
          to be  placed.   The default is the "D" directory.  If you change
          this default, it must be changed to a device or subdirectory that
          already exists.   UNARC  will overwrite any file by the same name
          that previously existed in  the output  directory.   Both ARC and
          UNARC  open  a  console  window  on  the  screen to display their
          progress.  ARC and UNARC require that the  file C:RUN  be present


                                     Page 14


          on your  disk.   You may follow the instructions listed under the
          RUN command to change this requirement.

     ZOO
          Uses the exact same syntax as the ARC gadget.   Hitting the right
          button  on  the  gadget  will  UNZOO  a  file  following the same
          sequence as described in  the UNARC  command above.   DirUtil III
          Plus HR  requires Amiga  ZOO V1.40 or above to function properly.
          Unlike Amiga ARC, ZOO will allow the archiving and unarchiving of
          subdirectories.   DirUtil III  Plus HR  will not  list these cor-
          rectly (yet), but will extract  them  properly.    ZOO  and UNZOO
          require that  the file  C:RUN be  present on  your disk.  You may
          follow the instructions listed  under the  RUN command  to change
          this requirement.

     USER GADGETS
          These are completely user definable gadgets which perform various
          functions depending on the  definition  string  for  a particular
          gadget.   To set  a command string for any of these gadgets under
          normal circumstances, hit the  right  button  on  the  gadget and
          enter a  string the  format NNNNNNNNMCCCCCCCCCCCCCCCCCC where "N"
          represents the name to be displayed in place of the  default USER
          definition, "M" is a modifier or a normal letter (see below), and
          "C" is the command  string  attached  to  this  USER  gadget.   A
          complete definition  should be  no more  than 255 characters.  If
          the definition you are changing is already occupied  by a special
          device  name  (discussed  below),  you  must  hold either ALT key
          before hitting the right  mouse button.   A  successful operation
          will replace  the old definition with the new one.  The next time
          you hit the LEFT button over the same gadget, the  command string
          will be  interpreted depending  on the modifier used.  If the "M"
          character is not a "\" or "|", the command string  will be parsed
          (based on the commands below) and the result sent to AmigaDOS for
          execution.  If the modifier  is  a  "\",  the  command  string is
          parsed  and  sent  to  AmigaDOS  without  the  need to click on a
          filename.    This  form  is  used  for  invoking  frequently used
          external commands that may require parameters, but not filenames.
          If the modifier is a "|", the string of characters  following the
          "|", but not including it, are taken to be the new setting of the
          "S" gadget and the appropriate directory will be read.   Any USER
          gadget  containing  the  "|"  modifier  will behave just like its
          counterpart on the top two rows of gadgets ie. hitting  the right
          button on it will set the "D" gadget to the drive/path associated
          with it.  This explains the need for using the ALT key  to set or
          reset these definitions.  For full compatibility with all DOS and
          NON-DOS commands, DirUtil  III  Plus  HR  uses  the  AmigaDOS RUN
          command when  executing any USER gadget with the exception of the
          special  "|"  modifier  above.    The  file  called  "du2.config"
          included  with  this  package  is  a  working  example of a conf-
          iguration.

          The parser looks  for  a  %  character  followed  by  one  of the
          following characters:

               "S"  refers to the current "S" directory.
               "D"  refers to the current "D" directory.
               "F"  refers to  the full  path and  filename of a high-
                    lighted file.

                                     Page 15


               "N"  refers  to  the  filename  of  a  highlighted file
                    excluding the path name.
               "E"  refers to  a parameter  that you  will be prompted
                    for during the execution  of  the  user definition
                    (entered only  once at  the beginning  of a multi-
                    file operation unless %R is encountered).
               "C"  refers to the hexadecimal  address of  DirUtil III
                    Plus HR' screen for use in the CONMAN program.
               "Bn" this  character  does  not  generate any text, but
                    tells DirUtil III Plus  HR to  move its  screen to
                    another location.  If the character represented by
                    "n" is a "0", DirUtil  III  Plus  HR'  screen will
                    immediately move to the back of all other screens.
                    If the character is a "1", the DirUtil III Plus HR
                    screen  will  move  to  the  front  of  all  other
                    screens.    This  command  is  used  primarily  in
                    conjunction with the "W" command listed below.
               "U"  causes DirUtil  III Plus  HR to immediately update
                    the file lists  in  the  "S"  and  "D"  windows if
                    needed.     This  command  is  used  primarily  in
                    conjunction with the "W" command listed below.
               "Wn" causes DirUtil III  Plus  to  WAIT  on  a specific
                    condition.   Currently only one option is defined.
                    If "n" is "0", DirUtil will wait until a window on
                    the WorkBench  Screen with a given name is closed.
                    DirUtil III Plus HR will interpret  the characters
                    that  follow  the  "0"  in  the following pattern:
                    nnnnnnnnnn|wwwwwwwwww|.

                    Example:

                         %w0testingwindow|%b1%u|

                    This will  cause DirUtil  III Plus  HR to complete
                    the other  commands contained  in the user defined
                    gadget, then wait until a window title whose first
                    characters   are   "testingwindow"   (no   quotes,
                    upper/lower  case  ARE  SIGNIFICANT),  has closed.
                    When this  condition is  met, DirUtil  III Plus HR
                    will execute the commands "%b1%u" (also no quotes)
                    which will bring the program's screen to the front
                    and update the file  listings.   The wait commands
                    are designed to be able to let DirUtil III Plus HR
                    interact better with external programs that may be
                    launched from  within the  program.   If you spell
                    the name of the window wrong, DirUtil III  Plus HR
                    will  appear  to  lockup, clicking the left button
                    will bring up the normal abort  function requester
                    as  always.    The  string  that is to be executed
                    after the wait is  complete is  reinterpreted from
                    scratch based  on the values that were in place at
                    the end of the initial operation  that started the
                    wait.    There  may  theoretically  be %w commands
                    inside other %w  commands  although  this  has not
                    been tested.
               "R"  resets the  flag and allows a user to subsequently
                    enter new text at  a %E  prompt.   This allows for
                    multiple user inputs in the same user definition.

                                     Page 16


               "P"  Sets the  prompt string for use by the %E command.
                    %P should occur before the  %E  command  it  is to
                    affect.   The string should end with a | character
                    and be no more than 30 characters long.
               "%"  Use a real percent sign instead of interpreting it
                    as a  command introduction.  IE if you want a % in
                    your user text, type %% instead.
               "I"  If interlace mode is  not already  active, turn it
                    on.
               "L"  If interlace mode is already active, turn it off.
               "Z"  Stands for  ZAP devices.  It will clear all device
                    definitions from the first eight device gadgets as
                    well as  any overflow  that has been stored in the
                    user definable area.  It will  then scan  the list
                    of  current  file  system  devices and fill in the
                    appropriate gadget boxes with  your current device
                    list.   DirUtil III  Plus HR will handle a removed
                    device (as of Workbench 1.3).

     EXAMPLE:
     -------

          The "S"  directory is  "df0:s" and  your have  clicked on the
          file "startup-sequence".  The "D" directory is "df1:backups".
          The definition string for one of the user gadgets looks like:

          "MAKEBAK copy %f to %d/%n.bak"

          The quotes in the above definition ARE NOT TO BE  TYPED, they
          are for  delineation only. DirUtil III Plus HR will interpret
          this string and send the following string to AmigaDOS:

          "copy    df0:s/startup-sequence    to    df1:backups/startup-
          sequence.bak"

          Notice the  "/" character in the definition, this is required
          to make a valid  path  name.    The  carriage  return between
          startup- and  sequence is  caused by  the word processor this
          document  is  printed  with  and  is  not  actually  sent  to
          AmigaDOS.  The included config file shows many of the ways to
          use the parser.

     EXAMPLE 2:
     ---------
          A user gadget definition looks as follows:

          "  PKAX  %pEnter Output Dir|run > nil: cd %e+<CR>pkax %f"

          This definition  will set  the prompt  for the  %E command to
          "Enter  Output  Dir",  prompt  for  a  string, then use the +
          option of the RUN  command to  run two  commands in sequence.
          The <CR> symbol means to type a CTRL-J in its place.  This is
          the way AmigaDOS recognizes a  carriage  return  in  a manner
          equivalent to typing it from the keyboard.  The first command
          will CD to the string  just  entered  ie.  the  disk  or sub-
          directory where you wish the files to be unARCed into.  After
          CD runs, the file named PKAX  will be  run with  the filename
          and path  currently being  processed.   I will leave you with

                                     Page 17


          the method I use to unARC files when I am not using the built
          in  ARC  functions  of  DirUtil  III  Plus  HR.  This example
          requires a version of DirUtil III Plus HR dated June  2, 1988
          or later to function.

          "  PKAX  %Enter Output Dir|run > nil: cd %e+<CR>pkax 
          > CON:0/150/640/50/UNARCing_%n_to_%e -r %b%f"

     IMPORTANT:
     ---------
          When DirUtil III Plus HR first boots, it will look in your S:
          directory for a  file  called  "du2.config".    If  this file
          exists, the  USER gadgets  will be  preloaded with the file's
          contents.  On leaving DirUtil III Plus HR, this file  will be
          saved ONLY IF you have changed the definition of a gadget.

     HINT:
     ----
          You can  use the AmigaDOS Execute command to run a batch file
          using a user gadget.  This  will allow  more flexibility when
          creating your  user definitions  by allowing parameters to be
          passed to the batch file for conditional testing.





































                                     Page 18



          IMPORTANT OPERATIONAL NOTES:
          ---------------------------

          There are no known conditions that will crash DirUtil III Plus HR.
          If you  get a  software failure during use, be sure that the error
          is not caused by another task running at the same time.   When all
          else fails, AND you can replicate the error using DirUtil III Plus
          HR AND provide an exact command sequence that  produces the error,
          let me  know and I will fix the bug.  I have gone to great lengths
          to provide low memory and stack error checking, however if you get
          sporadic guru  meditations during usage of DirUtil III Plus HR, or
          you have a hard drive, I highly recommend you increase  your stack
          size to  25000.   This can  be done from the CLI or using the Info
          command on the Workbench.

          DirUtil III Plus HR'  "S" directory  will default  to RAM:  if the
          default directory  cannot be  determined.  If the RAM disk handler
          cannot be loaded, DirUtil III Plus HR will exit cleanly.

          DirUtil III Plus HR has a  limit of  255 characters  for directory
          path names.   This is based on the length of a command line in the
          AmigaDOS CLI environment.

          While you are using DirUtil III Plus HR, various prompts will come
          up  asking  for  confirmation.    There  will  be  two selections:
          "CONTINUE" or "ABORT".   "CONTINUE" is  always the  affirmative to
          the prompt  and "ABORT" is the negative response.  The most common
          requestor you will get when calling external programs  such as ARC
          or  ZOO  is  the  "UPDATE  FILELIST"  requestor.  Getting this re-
          quester, means that DirUtil III  Plus  HR  has  detected  that the
          filelist in  memory is  not current for one reason or another.  If
          re-reading the filelist would disturb  your  current  set  of file
          selections, DirUtil III Plus HR will ask you if you want to update
          the filelist.  If you have no files and/or subdirectories selected
          from the  filelist that  needs updating,  DirUtil III Plus HR will
          update the listing automatically.

          AmigaDOS, and consequently DirUtil III Plus HR, has  problems with
          spaces in  file and volume names.  This problem will result in un-
          expected results when using  some  external  commands  from within
          DirUtil III  Plus HR.   DirUtil III Plus HR tries to minimize this
          problem by putting quotes around commands with spaces in them, but
          not  all  programs  can  parse  quotes in the way AmigaDOS handles
          them.  Also, DirUtil III Plus HR uses  the volume  name of  a disk
          rather  than   its  device   specification  for  most  operations.
          Consequently, disks with the same volume name mounted  at the same
          time tend to produce unpredictable results.

          The DISKCOPY  command of DirUtil III Plus HR assumes it is copying
          a normal AmigaDOS disk.  However,  DirUtil III  Plus HR  will copy
          any non-copy  protected disk non-AmigaDOS disk.  If a non-AmigaDOS
          disk is detected, DirUtil III Plus HR will not update the creation
          date on  the destination  disk, thus  making an  exact copy of the
          original.

          DirUtil III Plus HR was developed and tested on an Amiga 1000 with
          2  3.5"  drives,  1  5.25"  Transformer  drive,  1 5.25" 880K Quad

                                     Page 19


          Density drive (emulating a 3.5" drive), 2.5 Megabytes of RAM and 2
          50 meg  C-Ltd SCSI hard drives.  DirUtil III Plus HR has also been
          tested on the Amiga 500 with  and without  the A501  RAM Expander,
          and on an Amiga 2000 with and without RAM expansion and hard disk.
          This implies that some users may find it difficult to  use DirUtil
          III Plus HR on a machine with only one drive.  DirUtil III Plus HR
          has been tested under these  conditions  and  performs  quite well
          although disk  swapping will  cause irritation when using external
          commands.  It is also not recommended that you invoke  ARC, UNARC,
          ZOO, or  UNZOO with  only one  drive (don't  forget the RAM: drive
          however).  Also, in order to provide the best possible throughput,
          DirUtil III  Plus HR  buffers a  whole picture  in ram while it is
          being decoded for showing.  This buffering may cause problems when
          showing  some  pictures  on  a  512K  machine if memory has become
          fragmented.












































                                     Page 20


                    Quick Reference Chart for DirUtil III Plus HR


          GADGET    LEFT BUTTON      RIGHT BUTTON         R/SHIFTED
          ------------------------------------------------------------

          EIGHT     "S" = DRIVE      "D" = DRIVE
          DEVICE    IN GADGET        IN GADGET 
          GADGETS

          ALL(D)    ALL FILES        ALL FILES/SUBDIRS    ALL ARCHIVE
          INFO      "S" INFO         "D" INFO
          PARENT    "S" PARENT       "D" PARENT
          PROTECT   PROTECT FILES
          CLEAR     CLEAR FILES      CLEAR SUBDIRS
          SWAP      SWAP "S" & "D"   COPY "S" TO "D"
          TYPE      TYPE ASCII       TYPE HEX/ASCII
          RUN       DOS RUN          DOS BATCH FILE
          COPY      COPY SELECTED    ARCHIVE COPY
          MOVE      MOVE SELECTED
          PRINT     PRINT SELECTED
          DELETE    DELETE SELECTED
          FORMAT    FORMAT FLOPPY    FORMAT W/VERIFY
          MAKEDIR   CREATE SUBDIR
          RENAME    RENAME FILES
          DISKCOPY  COPY WHOLE DISK  DISKCOPY W/VERIFY
          LIST      LIST FILES
          SEARCH    STRING W/UL CASE SEARCH U <> L CASE
          EDITOR    EDIT WITH ED     EDIT + QUOTES
          BYTE      SIZE OF FILES    COMPARE FILE SIZES
          FIXOBJ    PAD FILES        FIX FILE DATE
          CHANGE    DISKCHANGE
          ARCV      LIST ARC         LIST ZOO
          RELABEL   CHANGE "S" NAME  CHANGE "D" NAME
          SORT      SET SORT FIELD   SET ASCEND/DESCEND
          PLAY      PLAY A SOUND     PLAY CONTINUOUSLY
          ZOO       MAKE ZOO FILE    UNZOO FILE
          ARC       MAKE ARC FILES   UNARC FILE
          COMMENT   SET FILE COMMENT PRINT FILE COMMENT
          SHOW      SHOW W/CYCLE     SHOW W/O CYCLE
          WHEREIS   FIND A FILE
          CRYPT+    ENCRYPTION       SET ENCRYPT KEY
          DATE+     SHOW DATES       COMPARE DATES
          FREEZE+   FILE SELECTION
          SAVE OLD+ KEEP SAME NAMES  CHECK EXISTENCE
          SLIDE+    SSHOW ON/OFF     SHOW CONTINIOUS
          USER**    INVOKE USER      SET USER

          ** ALT KEY REQUIRED TO SET SOME FUNCTIONS
           + FUNCTIONS AS TOGGLE
             VERSION NUMBER IS SHOWN BY CTRL-ALT-SHIFT
             INTERLACE TOGGLED VIA SHIFT-ESC




                Documentation for DirUtil III Plus HR Palette Program

          The program named PAL on the DirUtil III Plus HR disk is used to
          change the colors of the file window and type window.  The program
          can only be run when DirUtil III Plus HR is already running. 
          Also, PAL will only search out the front most DirUtil III Plus HR
          screen in case you have multiple copies of the program running. 
          You have two options upon loading PAL:  MAIN and TEXT.  Click on
          MAIN to alter the colors of the file window and click on TEXT to
          change the colors for the TYPE, HTYPE, SEARCH, ARCV, and ZOOL
          commands.  Upon exiting the program, a file called "du2.color"
          will be written to the S: directory for future use.  DirUtil III
          Plus HR is still running when the palette program is active and
          you can switch between all the various displays until you have the
          colors set just right.  You cannot exit DirUtil III Plus HR, nor
          change its resolution, until the palette program has terminated.











































                                     Page 22


          Update list for May 12, 1988 release (internal)

          1. Fixed bug that would sometimes cause crash when run from Work-
          bench.
          2. Eliminated all constraints on number of filenames and number of
          lines of text when reading directories and displaying text files
          respectively.  IF DIRUTIL III PLUS HR PROMPTS YOU THAT THE
          DIRECTORY IS IN A LOOP, IT IS UP TO YOU TO DECIDE WHETHER TO
          CONTINUE READING FILENAMES.

          3. ARCV and ZOOL now use a custom window on the DirUtil III Plus
          HR screen.

          4. Added new option (%C) for the user gadgets.
          ------------------------------------

          Update list for June 2, 1988 release (internal)

          1. Added two new options for the user gadgets (%P and %R).
          2. Added limited support for showing overscanned pictures, NOT
          PERFECTED.
          ------------------------------------

          Update list for June 14, 1988 release (internal)

          1. Added two new options for the user gadgets (%I and %L).
          2. Added switchable screen interlace mode to save memory. See docs
          for command key.
          3. DISKCOPY now uses FAST RAM as a buffer if present.
          4. DISKCOPY now prompts for a source disk instead of assuming "S".
          5. DISKCOPY w/ right mouse button changed, see docs.
          ------------------------------------

          Update List for July 7, 1988 (internal)

          1. More error checking for DISKCOPY (disk in drive and write
          protect status now checked)
          2. Support for file copying to non disk devices added, see docs.
          ------------------------------------

          Update List for July 12, 1988 (internal)

          1. ESC key now exits the SHOW command.  In addition, the cursor
          keys will scroll the picture.  SEE DOCS FOR LIMITS.
          2. Fixed bug in SHOW command that kept 768x480 pictures from
          showing.  INFORMATION: ShowPrint II and uShow have the same bug!
          3. DirUtil now makes no assumptions about font size to allow
          running from a truly stock Workbench disk set to use Topaz 9 font.
          4. RENAME now renames multiple files in one pass.
          5. RELABEL can relabel "D".
          6. COMMENT now allows different comments to be put on files when
          more than one file is selected at a time.
          ------------------------------------

          Update List for July 14, 1988 (internal)

          1. Completely keyboard free operation available when using string


                                     Page 23


          gadget.  If you want the default, hit CONTINUE.  Hit ABORT to stop
          the function.
          2. FORMAT now checks for the presence of a disk before proceeding
          and will not try to format a write protected disk.
          3. Directories now updated properly after a RENAME or MAKEDIR to a
          volume not listed.
          4. Major overhaul of previously ignored error conditions. None are
          fatal, but they are annoying since they cause the in memory repre-
          sentation of a file to not match its physical counterpart on disk.
          No error is printed, but the file will not unhighlight after being
          processed.
          5. MAKEDIR (with icon option on) will now create a drawer icon
          even if the directory already existed. (Allows easy addition of
          icons to already existing directories)
          6. Default text for unused user gadgets is now a blank space
          rather than the former "USER1", "USER2" setup to reduce clutter on
          the screen.
          7. Added more error messages to DISKCOPY and FORMAT.
          8. Fixed a memory allocation bug in FORMAT.
          ------------------------------------

          Update List for July 18, 1988 (internal)

          1. Aborting a function when DirUtil III Plus HR is processing a
          subdirectory is now much cleaner.
          2. Cleaned up overscan handling code to use a "best guess" on very
          large pictures.
          3. Fixed a problem with SHOWing Deluxe Photo Lab (c) pictures
          caused by larger than standard color map setup use by this
          program.  INFORMATION: ShowPrint II and uShow have the same bug!
          4. MOVE not unhighlighting a file fixed.
          5. Stack requirements reduced in SHOW and SLIDESHOW modes.
          6. Sped up SHOW by 8 cycles per scan line. (big deal, no bug)
          7. Fixed SHOWCONT (broken since May 12, 1988)
          8. Being unable to open the default device now causes a clean exit
          rather than a lockup.
          9. Added output directory prompt to UNARC and UNZOO.
          ------------------------------------

          Update List for July 19, 1988 (internal)

          1. Device gadgets now updated after every file operation to
          reflect possible changes by outside programs, makes %Z user
          definition obsolete in most cases.
          ------------------------------------

          Update List for July 21, 1988 (internal)

          1. Added multiple DISKCOPY capability.
          2. Added case insensitive search (now default).
          ------------------------------------

          Update List for July 22, 1988 (general release)

          1. Code cleanup and optimization, docs updated, released to
          public.
          ------------------------------------


                                     Page 24


          Update List for July 30, 1988 (general release)

          1. Several small bugs fixed following initial release.
          ------------------------------------

          Update List for August 4, 1988 (internal)

          1.  Fixed small memory allocation error in SHOW.
          2.  Added more error messages for low memory conditions.
          3.  Fixed small problem with volume name handling.
          ------------------------------------

          Update List for August 13, 1988 (internal)

          1.  Main program and PAL now agree on the correct pallete settings
          through multiple window switches.
          2.  DirUtil III Plus HR will now wait until the ARC, ZOO, UNARC,
          UNZOO, and EXEC functions are through, it will then update the
          filelists according.  This is done by monitoring the opening and
          closing of the output windows on the Workbench screen.  If any
          other program (or more likely two DirUtils running at the same
          time), has a window open on the WorkBench Screen with the same
          name that DirUtil is trying to use, the program will get confused
          and probably not update the listings properly.  If for some reason
          the program appears to hang, you can still abort manually and
          worry about any unclosed windows later.  While DirUtil III Plus HR
          is waiting for an external function to finish, it lowers its
          priority by two to take less CPU time.
          3.  Small bug that sometimes occurred when entering a directory
          name directly into the "S" or "D" gadgets corrected.
          4.  DirUtil III Plus HR is now much smarter at detecting changes
          in the file listings caused by external programs.  DirUtil will
          automatically update the file entries if the need arises.
          ------------------------------------

          Update List for August 14, 1988 (internal)

          1.  Added WHEREIS command, see docs.
          2.  Because of addition of above, there are now only 30 user
          definable gadgets (down from 31).  If you previously had a
          du2.config file in which the last user gadget is defined, you will
          lose this definition.  A solution is to copy the definition to
          another unused gadget before installing this version.
          3.  Recursive actions on subdirectories now faster and use cause
          less memory fragmentation.
          4.  Added %U and %W options to user gadgets, see docs.
          5.  Modified operation of %B user gadget option, see docs.
          ------------------------------------

          Update List for September 1, 1988 (internal)

          1.  Added SORT and PLAY gadgets, see docs for details.
          2.  ARCV now prints the date and time of a file.
          ------------------------------------

          Update List for September 12, 1988 (internal)



                                     Page 25


          1. Added command to show partial Function Window, (hit ALT-ESC)
          see docs.
          2. Hitting ABORT when being prompted for input into a user gadget
          will abort the running of that function.
          3. Sort routines speeded up 50%.
          4. Fixed bug that caused sort by date to malfunction.
          5. When changing resolutions, the position of the Function Window
          is retained if at all possible.
          6. Changed order of some gadgets (all toggle gadgets are now at
          the bottom of the window).
          7. Fixed bug in RELABEL command.
          8. Program tested under OMEGA 8 of WorkBench 1.3, works!
          9. Added CLEAR gadget to string input requester.  (Right Amiga-X
          does the same thing, but this way you have more hands free
          operation.)
          ------------------------------------

          Update List for September 17, 1988 (internal)

          1.  Removed right button access for PROTECT which was never
          documented anyway.
          2.  RELABEL now prompts with the old name of the disk instead of a
          blank requester.
          ------------------------------------

          Update List for September 19, 1988 (release)

          1.  Changed the system requesters previously used to look and
          appear in the same place as all other DirUtil requesters.
          2.  Point of clarity:  if aborting a function, the "CONTINUE"
          gadget is the one to select to actually abort (think "continue
          abortion")



























                                     Page 26