home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u394.dms / in.adf / docs / dirwork.doc.pp / dirwork.doc
Encoding:
Text File  |  1989-07-26  |  40.9 KB  |  969 lines

  1.  
  2.     DirWork V1.61 - Chris Hames 2nd June 92.  All rights Reserved.
  3.     --------------------------------------------------------------
  4.             DW Size 70968 bytes
  5.  
  6.     Need to get around your directories fast and simply.  Force yourself
  7. to read fully this doc file and I think you will find this program of great
  8. use.  What makes DirWork better than the rest ?
  9.  
  10.     VERY Configurable.  Buttons/Button-keys/Options/Screen Mode/
  11.     Screen Colors/Window Size/Window Position/PopKeys/Tools etc can be
  12.     modified and the DW executable modified to have these values.
  13.     External configuration editor program to make changes easier.
  14.  
  15.     Detaches.  So when you type DW from Shell/CLI you can still use your
  16.     Shell/CLI as if nothing happened.  No need to Run!  Paths are kept!
  17.  
  18.     Sleep. Can be put to sleep so it disappears completely until you
  19.     select it from the workbench tools menu (kick2.0-) or press left
  20.     Ctrl-Shift-Alt-D or whatever keys you configured it to.
  21.     Also can be started in sleep mode so "DW -s" in your
  22.     startup-sequence will have it there for when you want it later.
  23.     You can also place DW in your WBStartUp drawer and add the ToolTypes
  24.     SLEEP & DONOTWAIT.
  25.  
  26.     Intelligent.  Double click the left mouse button on the filename of
  27.     a IFF picture and it will be automatically displayed.  Double click
  28.     a text file to display it, press the right mouse button to edit it!
  29.     Double Click a .lzh file and you see the contents, right mouse
  30.     button on one extracts the contents to the destination dir and then
  31.     reads in the new entries.  If you have a middle button then pressing
  32.     it on the .lzh will extract the files in the background so you can
  33.     continue doing other things.
  34.     As well as many other instant actions on different types of files
  35.     and the instant types are configurable.
  36.  
  37.     The inbuilt text viewer, picture viewer and disk functions
  38.     run as separate processes on separate screen so you can double
  39.     click a text file and then continue working with DW then swap
  40.     the screen and the text viewer is still there.  Your diskcopy
  41.     can be going on one screen while you a copying files with DW as
  42.     normal.
  43.  
  44.     A show built in that loads in the next picture while your looking
  45.     at the last.  Does icons, SHAM and some DHIRES pictures.  You can
  46.     of course set up a button to use your own show utility.
  47.  
  48.     Buffered directories.  Press the right mouse button over the dir
  49.     text gadget and you get a menu of previous directories which you
  50.     can instantly go to.  Parent buttons that will use the buffered
  51.     dir when appropriate to save you heaps of dir loading time.
  52.  
  53.     A completely mouse controlled type/hxtype which will automatically
  54.     decrunch powerpacker crunched text files.
  55.  
  56.     Both memory and BootBlock virus checking.
  57.  
  58.     Inbuilt Diskcopy/Format/Install with multiple destinations etc.
  59.  
  60.     PopKeys.  Define keys to start up programs. eg make Amiga-P start
  61.     your paint program.  Amiga-Escape start a NewShell etc etc etc
  62.     Also adds these programs to DW's menu and your workbench Tools menu
  63.     if using Kick2.0-.
  64.  
  65.     ScreenBlanker so that the phosphors on your monitor get a rest.
  66.     AutoPoint option so that the window the mouse is over is selected.
  67.     MouseAccelerator with selectable threshold.
  68.  
  69.     Copy & move cloning so that the date/protection/filenote is same.
  70.  
  71.     Fast and Smooth Floppy Dirs!  Getting a directory off a floppy
  72.     is up to 2 times faster.  And your drive doesn't grind back and
  73.     forward anywhere near as much as normal.
  74.  
  75.     Size.  At less than 70K uncompressed it makes mince meat of most
  76.     of those huge memory hungry utilities.
  77.  
  78.  
  79. This program is SHAREWARE so please support the work that has gone into it.
  80. To minimize bank charges please try to contribute with one of the following:-
  81.     Australian Cash or Cheque.
  82.     Any cheque drawn on a Australian Bank.
  83.     Foreign Cash (US, English or German preferred).
  84.     International Money Order or Bank Cheque.
  85. The suggested contribution of $35 makes you a registered user.  This allows
  86. you to get direct support from me as well as access to updates.  You also a
  87. disk containing the next version (when it is available) of this program
  88. sent to you.
  89. Please send the contribution & any ideas etc to:-
  90.     C Hames           |Internet:
  91. Snail:    6 Pamela Crt      |   bytey@phoenix.pub.uu.oz.au
  92.     Blackburn South   |   bytey@phoenix.apana.org.au
  93.     VIC 3130          |FidoNet BBS:
  94.     Australia         |   3:633/353
  95. And don't forget to include the version number you have!
  96.  
  97. This program may be copied as long as it is accompanied by this doc file
  98. both unaltered & no money is charged(except for a reasonable copying fee
  99. such as what Fred Fish charges).  All use of this program is at your own
  100. risk & I assume no responsibility or liability for any problems that occur.
  101.  
  102. Future Improvements:- (When registering please tell me which ones you want)
  103.     More configurable. ie Screens/ButtonPositions/Colors/Priority etc
  104.     copy/move not going to fit requester
  105.     Sort by date and size.
  106.     Text viewer handle ANSI better(& 8 color option).
  107.     BootBlock brain file.
  108.     Play Stereo sound samples.
  109.     PointerBlanker.
  110.     print separate process.
  111.     Window to front by double clicking.
  112.     Recorded keystrokes.
  113.     Auto load of directory on startup. DW dh0:
  114.     Copy/delete/move option to copy .infos as well
  115.     copy,delete,move want to quit, try again unprotected, continue.
  116.     Faster(the need for speed!).
  117.  
  118. NOTE:
  119.  **************************************************************************
  120. * Updates don't magically appear.  So support the product by contributing. *
  121. * If there aren't many contributing in the future no updates, crippleware  *
  122. * or similar will be what happens.                                         *
  123.  **************************************************************************
  124.  
  125.  
  126.  
  127. History:-
  128.     27/ 1/90 1.00    First Release.
  129.      5/ 2/90 1.01    VMK updated to v27.  Stopped title bar flashing.
  130.     12/ 2/90 1.02    Icon. Faster. Smaller. Now uses less memory(5K) if
  131.             destination display is not used.
  132.     15/ 2/90 1.03    Detaches from CLI.  Some Workbench problems fixed.
  133.             A Show bug fixed.
  134.     22/ 2/90 1.04    CD bug fixed.  Volumes button added.  Dir buttons
  135.             and options can be modified and saved.  VMK can
  136.             now automatically be executed every 10 secs.
  137.     14/ 7/90 1.10    Heaps of little improvements. Copy/Delete/Move Dirs.
  138.             Now VERY configurable buttons. Sleep. Window sizing.
  139.             HxType/Type/Search Esc works anytime now. Rename/
  140.             makdir/copy/move/delete add or remove from both
  141.             filelists where appropriate.  So many more changes
  142.             that I am calling it 1.10 !
  143.     30/ 7/90 1.11    Bug fixed when getting dirs with spaces in them.
  144.     17/ 8/90 1.12    Rare problem getting dirs with spaces at end.
  145.     10/ 1/91 1.20    More than 255 files displayed.
  146.             Dirs above files option added.
  147.             And too many other things to mention.
  148.     13/ 1/91 1.21    Sometimes crashed when started from cli,
  149.             bug found in detach routine. Argh!!
  150.             Display .info files option added.
  151.             Window Pos now saved with config.
  152.     16/ 1/91 1.22    Recognition of text files improved. Other little
  153.             things improved.
  154.     10/ 6/91 1.30    Wouldn't save config if started in sleep mode (-s)
  155.             fixed.  Didn't open some windows at same offset as
  156.             window fixed.  Now gets the dirs after sleep.
  157.             Automatically gets info(bytes free) for dirs after
  158.             a copy move or delete. MakeDir can have icon.
  159.             Bootblock checking.  Popkeys.  ScreenBlanking.
  160.             Runs programs with spaces(Dave!).
  161.             Save's path of DW program with save executable.
  162.             Paths other than C: recognized(Thanks Randell).
  163.             Parent/root far left or right of the text gadget
  164.             right mouse button over text gadget gets dir.
  165.             Shells etc now have close gadgets if kick 2.0,
  166.             and the N,x,u commands have been improved.
  167.             Kick 2.0 looks. Heaps of other little things.
  168.     22/ 6/91 1.31    Requester kick 1.2/1.3 freeze bug hopefully gone.
  169.             Crash after RMB instant getdir gone.
  170.             AutoPoint for James.  Screen option.
  171.             Copy/move clone code better and kick 1.2/1.3 date.
  172.             Filenote problem with FSDirs problem fixed.
  173.             Better FileSelection. Requester bigger.
  174.             FileBits/Note writing under Kick 1.2/1.3 fixed.
  175.             Resizing doesn't make slide gadgets go to top.
  176.             Kick 2.0- execute window title shows path.
  177.             Delete didn't request for non-empty dirs fixed.
  178.             Popkey stuff gets added to tools menu in Kick2.0-
  179.             No flashing bottom line.
  180.             And some other little things.
  181.     13/10/91 1.40    Middle mouse button instant actions added.
  182.             Button/Instant Config strings larger & key codes.
  183.             Popkey data larger & with full function defs.
  184.             PopKey/tools now are in DW menu as well now.
  185.             ScreenBlank bug removed. Volumes button improved.
  186.             Right parent/root allows for window width not 640.
  187.             Two characters are now used to show protection.
  188.             Uses paths when started from workbench.
  189.             PlaySS now uses rate in 8SVX files.
  190.             Inbuilt Diskcopy/Format/FormaQuick/Install added.
  191.             Wakeup now brings screen/window to front and
  192.             activates if it is already open.
  193.             Key to go to those letter entries for Michael.
  194.             Bug in IFF Show with strange width pictures fixed.
  195.             and some Overscan support added.
  196.             CAPSLOCK qualifier is now ignored for keys.
  197.             AutoPoint drag bug fixed.  MouseAcceleration added.
  198.             Buffered directories menu added.
  199.             Added option to allow only one DW to be in memory.
  200.     21/10/91 1.41    Qualifier with selected file filebits bug fixed.
  201.             FSDir bug fixed with trying to get a file.
  202.             Double Click file selection update fixed.
  203.     23/10/91 1.42    Swap only refreshed one of the text gadgets.
  204.             Double clicking a file that DW couldn't open bugfix.
  205.             Sleep could cause dir without files to be buffered.
  206.             A few other little things.
  207.     30/10/91 1.43    Fixed certain space filenames causing partial getdir.
  208.             Type would do partial read of powerp file if no lib.
  209.             Right mouse on little buttons sometimes did bufmenu.
  210.             DiskName & BytesFree wasn't shown until after getdir.
  211.             Added keyboard equiv for Type buttons.
  212.             Button colors/looks now more consistent.
  213.      2/ 2/92 1.50    Source and destination DiskOp selection fixed.
  214.             Awake didn't bring WB screen to front fixed.
  215.             FBits  size failed on file with rwed off in (k2.0).
  216.             Copy/move didn't delete partial files if error.
  217.             Copy can copy as
  218.             Functions N,u,a can CD source or destination dir.
  219.             Function x has become obsolete now use u.
  220.             Instant types now can be changed.
  221.             3 more instant types added.
  222.             Pattern select(K2.0-) added to func j and l obsolete.
  223.             Requester should now adjust for massive title.
  224.             Makdir adds drawer to list if appropriate.
  225.             Show does icons, SHAM and some DHIRES.
  226.             DW screen is public(K2.0-) so CON's can open on.
  227.             Function a now does spaces and adds "/*" to dirs.
  228.             Tools menu splits into 2 if too many tools for one.
  229.             Info function does Dir bytes as well.
  230.             Function w make icon added.
  231.             Function L relabel added.
  232.             keyQualCode conversion problems fixed.
  233.             RMB activates window option.
  234.             Parent using buffered dir option added.
  235.             Key activate for left/right text gad added.
  236.             Diskcopy to same drive without the ram crash fixed.
  237.             DiskOp src/des now stored in config.
  238.             DiskOp FFS formatting.
  239.             DiskOp,Show,Type are now run as separate processes!
  240.             Type new keys h,j,j,keypad8,keypad2,keypadhome,
  241.             CtrlUpcursor,keypadend,CtrlDowncursor,q,keypad5.
  242.             Type separate overscan(Kickstart2.0-) screen.
  243.             Type ANSI search and print.
  244.      4/ 2/92 1.51    Some show problems fixed.
  245.  
  246.      1/ 6/92 1.60    Many improvements to show including autoscroll,
  247.             fixed some problems with SHAM & DHIRES pics,
  248.             added keys to allow moving around bitmaps by
  249.             page and extremes, added keys to move the view
  250.             around, added key to toggle interlace.
  251.             Relabel was made 2.0 only as it should have been.
  252.             Will now try to use arp.library for date if 1.2/1.3.
  253.             Can be started in sleep mode with SLEEP tooltype.
  254.             Right/Middle mouse button actions use to work even
  255.             if DW window not visable but active!
  256.             Sorting filenames with numbers improved.
  257.             Filebits always set the read protect bit.
  258.             Made all console windows /AUTO under 2.0
  259.             Made s,d CD options refetch only if not capital.
  260.             Print could keep asking cancel!!!
  261.             Type/HxType would report not enough memory with
  262.             certain filesystems under Kickstart 2.0.
  263.             Type/HxType would leave DW busy even if it was
  264.             displaying the last file to be displayed.
  265.             Type/HxType slider gadget under Kick1.2/1.3 would
  266.             sometimes not allow you to view start of file.
  267.             Type/HxType would only recognize right shift key.
  268.             Prompts would be displayed in certain situations.
  269.             File/Dir size would only display 7 characters.
  270.             Type/HxType/Show under Kickstart 2.0 would centre
  271.             the screen incorrectly for overscan screens.
  272.             Move/Copy/Delete various improvements.
  273.             Workbench library under Kickstart 2.0 only open
  274.             when needed.
  275.      2/ 6/92 1.61    DW was turning the sprites off.
  276. ============================================================================
  277. MANUAL
  278.  
  279.     1. Instructions for the default DirWork
  280.     2. Options in DirWork & Options in DWEdit
  281.     3. Hints/tips
  282. ============================================================================
  283.  
  284. ----------------------------------------------------------------------------
  285.     1. Instructions for the default DirWork
  286. ----------------------------------------------------------------------------
  287.  
  288. The window display
  289.   +--------------------------------------------------------------------+
  290.   |+|  Title Bar - Chip & total memory available                   | | |
  291.   |--------------------------------------------------------------------|
  292.   |  +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++   |
  293.   |  +++ Buttons +++ +++ +++ +++ +++ Buttons +++ +++ +++ +++ +++ +++   |
  294.   |  +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++   |
  295.   /   Left Directory    Al No CD << <> >> CD No Al Right Directory     /
  296.   |--------------------------------------------------------------------|
  297.   | Left File List                | || |        Right File List        |
  298.   |                               |S||S|                               |
  299.   | DirectoryName         ??      |l||l| DirectoryName         ??      |
  300.   |    OR                         |i||i|    OR                         |
  301.   | FileName              ??  size|d||d| FileName              ??  size|
  302.   |                        ^      |e||e|                        ^      |
  303.   |         if undeletable u      | || |         if undeletable u      |
  304.   |        if has filenote f      |G||G|        if has filenote f      |
  305.   |           if is script s      |a||a|           if is script s      |
  306.   |                if pure p      |d||d|                if pure p      |
  307.   |                               |g||g|                               |
  308.   |                               |e||e|                               |
  309.   |                               |t||t|                               |
  310.   |                               | || |                               |
  311.   |--------------------------------------------------------------------|
  312.   |Errors and other messages     Disk Names & Bytes Free as well       |
  313.   +--------------------------------------------------------------------+
  314.  
  315. Actual directory text (Left Directory or Right Directory)
  316.  
  317.     Pressing the Right mouse button when over the text showing the path
  318.     of the dir brings up a menu of previous directories as well as a list
  319.     of volumes.  If you just let go over the text gadget it will read
  320.     that directory into the file list.
  321.     eg If DF0: was in the Left Directory text gadget you could insert
  322.        a new disk into the internal disk drive DF0: and then press the
  323.        right mouse button over the DF0: in the Left directory text to
  324.        read in the new directory.
  325.     If you move down onto one of the previous directory names and let go
  326.     it will be fetched from memory (it won't read the disk to get it)
  327.     since it is buffered from when you recently read that directory.  If
  328.     you let go on of the volumes (these are a list as if you pressed the
  329.     volumes button and are indented one to the right) it will be read in
  330.     from disk.
  331.  
  332.     Pressing the left mouse button over the far left/right of the text
  333.     gadget(see the "/" in window representation above) gets the parent.
  334.     Parent makes DF0:t/r become DF0:t
  335.     Right button gets the root. Root makes DF0:t/r become DF0:
  336.     If the Parent buf option is on (is by default) and the last directory
  337.     you read is the same as the new one the buffered copy of the dir is
  338.     used. ie if you get the dir "DF0:" then "DF0:??" then press parent
  339.     or root buttons "DF0:" will not be re-read from disk, the buffered
  340.     copy will be used instead.
  341.  
  342.     You can press the left mouse button over the left or right directory
  343.     text gadget then edit the directory to the one you want to work with
  344.     and then if you press return the directory will be read in.
  345.     These gadgets can be activated by the keys Del & Help for left &
  346.     right respectively (see DWEdit if you want to change these keys)
  347.     Remember in most string gadgets right Amiga X clears the text in
  348.     the gadget, and you can use shift -> or <- to go to end or start
  349.     of the text.
  350.  
  351.  
  352. FileList(s)
  353.  
  354.     Press the left mouse button to select/deselect a file or directory
  355.     name.
  356.  
  357.     Right mouse button or double click left button on a directory reads
  358.     in that directory.
  359.  
  360.     Left mouse button to the far left or right of a file/dir will
  361.     bring up a requester with information about the file/dir
  362.     the Filename, FileNote and Protection bits which you can edit.  As
  363.     well as the size and date(only if using kickstart 2.0- or you have
  364.     the arp.library).  If you select a file the title bar of this
  365.     information window will tell you what instant type DW would have
  366.     used if you had double clicked this file.  If this instant type is
  367.     ILBM (a IFF picture file) it will also tell you the
  368.     Width*Height*Depth.
  369.  
  370.     Use the slide gadget to see files that are not displayed.  You can
  371.     also put the mouse pointer over the file list and press the key of
  372.     the first letter of the filename you are interested in and the file
  373.     list will move to the files/dirs starting with that letter.
  374.  
  375.     Double Click of left Button on a file will try to recognize the file
  376.     and automatically do something with the file(eg With default settings
  377.     the quickly double clicking the left button on a text file will type
  378.     it & and double clicking on a IFF picture(such as a picture from a
  379.     paint program) file will show it with the internal show).
  380.  
  381.     Right Mouse Button on a file will try to recognize the file and
  382.     automatically do something with the file.
  383.     eg With default settings the Right mouse button on a text file will
  384.        edit it (If you have configured your instant edit to your editor
  385.        or it already is) or pressing the right mouse button on a picture
  386.        file will show it with Mostra(© Sebastino Vigna) if you have that
  387.        program.
  388.  
  389.     Middle Mouse button will also do another selectable action if you
  390.     have one on your mouse and have Kickstart 2.0-.
  391.  
  392. Here is a table of the default instant Operations:-
  393.  
  394.  
  395. File type    Double Clicking            Right Mouse button
  396. ----------------------------------------------------------------------------
  397. MOD.        Intuitracker filename        Run >NIL: Intuitracker file
  398. .ARC        Arc v filename            Arc xw filename
  399. .DMS        DMS Write filename        DMS Write filename
  400. .LZH        LZ l filename            LZ -m -x -r x filename
  401. .LHW        Lhwarp Write 0 filename        Lhwarp Write 0 filename
  402. .PAK        filename            filename
  403. .WRP        UnWarp filename            Run >NIL: UnWarp filename
  404. .ZIP        UnZIP -v filename        UnZIP -xdo filename
  405. .ZOO        Zoo v filename            Zoo xO// filename
  406. .GIF        VirtGIF filename        Run >NIL: VirtGIF filename
  407. .INFO        INTERNAL Show            Run >NIL: IconEdit filename
  408. 8SVX        INTERNAL PlaySS filename    PlaySS filename
  409. ANIM        ShowANIM filename        ShowANIM filename
  410. ILBM        INTERNAL Show filename        Mostra filename
  411. SMUS        PlaySMUS filename        PlaySMUS filename
  412. FTXT
  413. Most        Most filename            Run >NIL: Most filename
  414. PowPk        INTERNAL Type filename        PPShow filename
  415. Exect                        filename
  416. Text        INTERNAL Type filename        Run >NIL: E filename
  417. Binry        INTERNAL HxType filename    Run >NIL: NewZAP filename
  418. .LHA        LZ l filename            LZ -m -x -r x filename
  419. .UUE        INTERNAL Type filename        uudecode filename
  420. .JPG        Run >NIL: JView            Run >NIL: JView
  421.  
  422.  
  423. Buttons
  424.     The main idea is to press the left mouse button if you are referring
  425.     to the source as the file list below the pointer.  So to copy from
  426.     the left file list to the right list, click on the left copy
  427.     button.  And to copy from the right file list to the left file list,
  428.     click on the right copy button.
  429.  
  430.     You can also click on a button with the right mouse button to refer
  431.     to the opposite file list but if this sounds confusing just ignore
  432.     this paragraph.
  433.     (eg Left button on left DF0: will get the directory from DF0:
  434.     and put it in the left file list, but right button on left DF0: will
  435.     get the directory DF0: and put it in the right file list)
  436.  
  437.     Below is a description of what the buttons will do when the default
  438.     setup is used.  You can modify button functions to do something
  439.     completely different if you want.
  440.  
  441.     DF0: DF1: RAM: SYS: etc
  442.         Just press these to get the directory of this name in the
  443.         file list below the pointer.
  444.  
  445.     Sleep    Puts the task to sleep until you press the four left keys
  446.         Ctrl-Shift-Alt-D.  ie The window disappears as if you quit
  447.         but the program is still there waiting until you press the
  448.         keys.  So you don't have to load DirWork all the time.
  449.         DirWork starts in Sleep mode if you type DW -s instead of
  450.         the usual DW when you run it from Shell/CLI, or you add the
  451.         SLEEP & DONOTWAIT tool types to the DW icon and start it
  452.         from workbench.
  453.         So you can have the command DW -s in your startup-sequence
  454.         or DW in your WBStartup drawer then when you actually want
  455.         DirWork later you just have to press the keys
  456.         Ctrl-Shift-Alt-D or if running Kick2.0- just can select DW
  457.         in the Tools menu of workbench.
  458.         Do what you want then press the sleep button to make DirWork
  459.         disappear again.  See PopKeys information for how to change
  460.         the key combination that wakes DirWork up.
  461.  
  462.     Al    Select all files.  See DWEdit to make it select dirs as well.
  463.  
  464.     No    Unselect all files & dirs.  See DWEdit for other options.
  465.  
  466.     PatSe    Requests for a pattern to select matching file(s)/dirs(s).
  467.         This button only works if you are running Kickstart 2.0-.
  468.         You can toggle if you want Files, Dirs or both to be
  469.         selected.  Matching is same as AmigaDOS 2.0:-
  470.  
  471.         ?    Matches any character
  472.         #    Matches the following expression 0 or more times
  473.         (ab|cd)    Matches either item separated by the |.
  474.         ~    Nots the following expression.
  475.         [abc]    Matches any of the characters in the brackets.
  476.         [~ab]    Matches any of the characters not in the brackets.
  477.         %    Matches 0 characters.
  478.  
  479.         Examples:-
  480.  
  481.         ~(#?.info)  All files that don't end in .info.
  482.         #?.dat      All files ending in .dat.
  483.  
  484.  
  485.  
  486.     <>    Swaps the left and right file list displays.
  487.  
  488.     >> & <<    Copies one file list to the other file list.
  489.  
  490.     Info    Updates the info(bytes Free and name). And displays how many
  491.         dirs/files/bytes are selected.  Good to see if you are going
  492.         to be able to fit all the file(s)/dir(s) you want to copy.
  493.  
  494.     Copy    Copies files/dirs from one dir to another.
  495.         BytesFree for the source/destination is updated.
  496.         See the DWEdit documentation if you want it to clone
  497.         the original date/filenote/protection etc.
  498.  
  499.     CpyAs    Copies files/dirs from one dir to another.  Requests you
  500.         for the destination name.
  501.         BytesFree for the source/destination is updated.
  502.         See the DWEdit documentation if you want it to clone
  503.         the original date/filenote/protection etc.
  504.  
  505.  
  506.     Move    Moves files/dirs from one dir to another.
  507.         BytesFree for the source/destination is updated.
  508.         See the DWEdit documentation if you want it to clone
  509.         the original date/filenote/protection etc.
  510.         Please note the DOS 1.2/1.3 bug where you lose directories
  511.         if you move a directory to be a child of itself.  I
  512.         intercept and stop some but not all.
  513.         ie Move ONE ONE/ONE  !!!!IS NOT A GOOD IDEA!!!!
  514.  
  515.     Delet    Delete files/dirs.  You are prompted before non empty dirs
  516.         are deleted for confirmation but see the DWEdit documentation
  517.         section if you don't like this.
  518.         BytesFree for the directory is updated.
  519.  
  520.     Print    Copies selected files text to the printer.
  521.         See DWEdit for other options like Tabs to spaces.
  522.  
  523.     Renam    Rename files/dirs.  Edit names in the requester.
  524.         Please note the DOS 1.2/1.3 bug where you lose directories
  525.         if you move a directory to be a child of itself.  I
  526.         intercept and stop some but not all.
  527.         ie Rename ONE ONE/ONE  !!!!IS NOT A GOOD IDEA!!!!
  528.  
  529.     MakDi    Make a new directory. Enter name in requester.
  530.         See the configuration section if you want it to also create
  531.         a icon for the directory each time.
  532.  
  533.     Prote    Change delete protection of a file/dir.  Lets you toggle
  534.         the delete protection of a file.  A file with delete
  535.         protection on has a u next to the right of the filename.
  536.         See DWEdit for heaps of different configs for this.
  537.  
  538.     CD    Makes the dir the current directory.
  539.  
  540.     Type    Displays a text file to a screen (overscan if kick2.0-).
  541.         Use the slide gadget on right to quickly scan and use buttons
  542.         down below to move through the file or toggle between a hex
  543.         or ASCII display of the file.
  544.         Or use keyboard:-
  545.           Return or CursDown or KeyPad2 or j = NextLine.
  546.           CursUp or Keypad8 or k = PrevLine.
  547.           Space or Shift/CursDown or KeyPad3 = NextPage.
  548.           BackSpace or Shift/CursUp or KeyPad9 = PrevPage.
  549.           Keypad7 or Ctrl/CursUp = Start of file
  550.           Keypad1 or Ctrl/CursDown = End of file
  551.           h to flip between Hex/ASCII.
  552.           s or LeftAmiga/s RightAmiga/s to search.
  553.           f or LeftAmiga/f RightAmiga/f to search.
  554.           Esc or q or Keypad5 = quit.
  555.  
  556.         It runs as a separate process so you can swap screens and
  557.         use DW as normal until you don't what the text display any
  558.         more.
  559.  
  560.         The screen height and mode can be set from DWEdit.
  561.  
  562.         The title bar shows the filename and will say
  563.         "WAS POWERPACKED" if the file was crunched with powerpacker
  564.         and has been decrunched.  It will say "PARTIAL LOAD" if you
  565.         didn't have enough memory for the file so only some of
  566.         it was loaded.
  567.         By default a double click on a text file will call this
  568.         routine.
  569.  
  570.     HxType    Displays a file in hexadecimal to a window.
  571.         Use the slide gadget on right to quickly scan and use buttons
  572.         down below to move through the file or toggle between a hex
  573.         or ASCII display of the file.
  574.         Or use keyboard:-
  575.           Return or CursDown or KeyPad2 or j = NextLine.
  576.           CursUp or Keypad8 or k = PrevLine.
  577.           Space or Shift/CursDown or KeyPad3 = NextPage.
  578.           BackSpace or Shift/CursUp or KeyPad9 = PrevPage.
  579.           Keypad7 or Ctrl/CursUp = Start of file
  580.           Keypad1 or Ctrl/CursDown = End of file
  581.           h to flip between Hex/ASCII.
  582.           s or LeftAmiga/s RightAmiga/s to search.
  583.           f or LeftAmiga/f RightAmiga/f to search.
  584.           Esc or q or Keypad5 = quit.
  585.  
  586.         It runs as a separate process so you can swap screens and
  587.         use DW as normal until you don't what the text display any
  588.         more.
  589.  
  590.         The screen height and mode can be set from DWEdit.
  591.  
  592.         The title bar shows the filename and will say
  593.         "WAS POWERPACKED" if the file was crunched with powerpacker
  594.         and has been decrunched.  It will say "PARTIAL LOAD" if you
  595.         didn't have enough memory for the file so only some of
  596.         it was loaded.
  597.         By default Double click on a binary file will call this
  598.         routine.
  599.  
  600.     Instant    This performs as if you double clicked the left mouse button
  601.         on the selected files.  It will perform a relevant button
  602.         on the file if it finds one otherwise it will assume the
  603.         file is just binary and HxType it.  All these things can
  604.         be changed, see DWEdit documentation.
  605.  
  606.     Show    Shows IFF files.  Loads in the next pic while the last
  607.         is being displayed to save a lot of time.  Move mouse pointer
  608.         to edge to scroll around a picture bigger than the screen.
  609.         Use the left mouse button or press a key to go to next.
  610.         If low on memory select one file at a time to display.
  611.         By default a double click on a IFF picture file will call
  612.         this routine.  Will handle SHAM as well as some DHIRES.
  613.         Can display icons as well.  See DWEdit for more info on this.
  614.  
  615.         Keys:-
  616.         
  617.         Cursors - Move around a large bitmap at 16 pixels each press.
  618.         Shift/Cursors - Move around at a page each press.
  619.         Ctrl/Cursors - Move to extreme each press.
  620.  
  621.         Alt/Cursors - Move the view around a pixel at a time.
  622.  
  623.         l - Toggle INTERLACE.
  624.  
  625.         It runs as a separate process so you can swap screens and
  626.         use DW as normal until you don't what the text display any
  627.         more.
  628.  
  629.     PlaySS    Plays any file as a Sampled sound at 10000 samples/sec.
  630.         Will use the correct rate if the file is a 8SVX.
  631.         By default a double click on a 8SVX sound file will call
  632.         this routine.
  633.  
  634.     Search    Search files for text that you are prompted for.
  635.         The prompt has a UpperCase!=LowerCase option.
  636.         It will tell you at want offsets in the file the text is
  637.         found.
  638.  
  639.     AdIcn    Creates a project, tool, or drawer icon for any file(s)/
  640.         dirs(s) specified this is good for when you have a program
  641.         or a drawer(directory) that doesn't have icon.
  642.  
  643.  
  644.     DskOp    Starts up the internal floppy copy/format/install program.
  645.         During operations the track(0-159) and any ERROR number is
  646.         shown you can stop any operation by pressing the close gadget
  647.         of the window.  During any diskcopy "Non standard boot block"
  648.         is shown under track if disk has a not normal bootblock.
  649.         To Format a floppy:-
  650.         ----------------------
  651.             Enter diskname in text gadget (defaults to "blank")
  652.             Select destination(s) by pressing the drive buttons.
  653.             Press Format or FormatQuick.
  654.             OFS stands for the Old file system(Normal format).
  655.             FFS stands for the Fast file system.
  656.         To Install a floppy:-
  657.         --------------------
  658.             Select destination(s) by pressing the drive buttons.
  659.             Press Install button.
  660.         To copy a floppy(You must have 2 floppies or 1Meg free):-
  661.         ----------------------------------------------------------
  662.         With two or more floppies:-
  663.             Select source by pressing the left drive buttons.
  664.             Select destination(s) by pressing the drive buttons.
  665.             Press the DiskCopy button.
  666.         With one floppy:-
  667.             Insert the source in DF0:
  668.             Select DF0: as only source and destination.
  669.             Press the DiskCopy button.
  670.             Insert the destination in DF0:
  671.             Press the WriteBuf button.
  672.         To check a floppy for disk errors:-
  673.         -----------------------------------
  674.             Select source by pressing the left drive buttons.
  675.             DeSelect all destination(s).
  676.             Press DiskCopy button and see if you get a error.
  677.         Multiple copies:-
  678.         -----------------
  679.         If you select the source as one of the destinations the
  680.         complete disk will be put into ram and the WriteBuf button
  681.         will be turned on.  You can the just keep selecting the
  682.         WriteBuf button with any destination(s).
  683.  
  684.         It runs as a separate process so you can swap screens and
  685.         use DW as normal until you don't what the text display any
  686.         more.
  687.  
  688.  
  689.     VMK    My MEMORY virus detector/killer.
  690.         For a simple check to see that your memory is virus free.
  691.         Does checks of many memory locations etc that are used
  692.         by viruses.  If you get a alert use a good disk virus killer
  693.         to clear up the problem.  See the separate program VMK v1.1
  694.         for docs.
  695.  
  696.  
  697.     The following buttons require you to have a external program and/or
  698.     run in your c: or similar directory.
  699.  
  700.     Edit    Edit selected files. Requires a editor named E in a path
  701.         such as c:.
  702.         If you have no files selected E will be run without a file
  703.         name.
  704.         Pressing the right mouse button on a text file will call
  705.         a similar routine.
  706.  
  707.     NewZP    NewZAP selected files. Requires Newzap in a path such as c:.
  708.         NewZAP is a file editor © John Hodgson.
  709.         If you have no files selected NewZAP will be run without a
  710.         file name.
  711.         By default pressing the right mouse button on a binary file
  712.         will call a similar routine.
  713.  
  714.     Run    Run selected files.  You will be prompted for optional
  715.         arguments. eg if you selected the file Diskcopy you
  716.         might want to enter "DF0: to DF1:".
  717.         If you have no files selected Run will be run so you will be
  718.         requested for the program to run.
  719.         By default pressing the right mouse button on a executable
  720.         file will will call a similar routine.
  721.  
  722.     Commd    Enter commands in the Shell/CLI window then enter endcli to
  723.         return to DW or if using Kick2.0- or later click the close
  724.         gadget.
  725.  
  726.     NewSh    Does the NewShell command.  Requires all shell type files.
  727.  
  728.     EScpt    Allows you to execute any selected script files.
  729.  
  730.     LZ A    Adds file(s)/dir(s) to a LZ archive that you specify in the
  731.         prompt.
  732.  
  733.  
  734. ----------------------------------------------------------------------------
  735.     2. Options in DirWork
  736. ----------------------------------------------------------------------------
  737. Menu Options
  738.  
  739.     Move the mouse pointer up to the left side of the title bar of the
  740.     window and press the right mouse button.
  741.  
  742.  
  743.     You can select if you want the last 8 directories read to be
  744.     kept in memory so that they come up when you press the right mouse
  745.     button over the path text gadget.
  746.     This is defaulted to on.
  747.  
  748.  
  749.     You can select whether you want Fast&SmoothFloppyDirs.
  750.     Shouldn't be needed with Kick 2.0-.
  751.     Note that the DirWork FSDirs does not make use of dos buffers that
  752.     have been added using AddBuffers, but does very well with the two
  753.     commercial diskbuffering programs.
  754.     This is defaulted to off.
  755.  
  756.  
  757.     You can select if you want the directory to be updated when you
  758.     change the floppy disk in one of the drives. ie  If you have DF0:
  759.     as either you source of destination path and insert a new disk the
  760.     new directory will be automatically read in.
  761.     This is defaulted to off.
  762.  
  763.  
  764.     You can select if you want every inserted floppy disk's boot block
  765.     checked to see if it is normal.  Note some bootblocks are not normal
  766.     and are not viruses so when you insert a disk and get the requester
  767.     saying this is not a normal bootblock only install if you know that
  768.     the bootblock does not contain important information.  See the
  769.     DWEdit documentation on how to allow XCopy boot blocks.
  770.     This is defaulted to off.
  771.  
  772.  
  773.     You can select if you want VMK(The virus detector) to be run every
  774.     8 seconds.  You get a requester asking for options(see VMK docs).
  775.     This is defaulted to off.
  776.  
  777.  
  778.     You can select if you want the screen to blank after 8 minutes of
  779.     no activity by the user.  A still image on a monitor is not good for
  780.     it so this blanks the screen.  See the DWEdit documentation on
  781.     how to set the amount of time the machine must be idle.
  782.     This is defaulted to off.
  783.  
  784.  
  785.     You can select if you want Directories displayed above files.
  786.     This is defaulted to off.
  787.  
  788.  
  789.     You can select if you want .info files to be displayed.
  790.     This is defaulted to on.
  791.  
  792.  
  793.     You can select if you want the close gadget box of the window
  794.     to make dirwork sleep instead of quit.
  795.     This is defaulted to off.
  796.  
  797.  
  798.     You can select that DirWork is to have a screen of its own instead
  799.     of using the workbench screen.
  800.     This is defaulted to off.
  801.  
  802. Menu Functions
  803.  
  804.     The SAVE function will modify a DW executable to have the setup
  805.     that you currently have.  You are prompted for the name of the DW
  806.     which would most likely be C:DW.  If you have turned on the external
  807.     config option (see DWEdit documentation) the function will first
  808.     save "s:DW.config" before it prompts you to save it to the
  809.     executable.
  810.     BUTTONS/INSTANTACTIONS/MENUOPTIONS/WINDOWSIZE/WINDOWPOSITION/
  811.     POPKEYS and heaps more are all saved with this command so set up
  812.     DirWork how you like it then use this command.
  813.  
  814.  
  815.     Use external configuration editor will execute the DWEdit program
  816.     (you must have it in a valid path such as c:) and hence allow you
  817.     to change the many configuration options that you can't from DW and
  818.     change many the ones you can in a faster and easier way to
  819.     understand.  Then when you quit DWEdit you can use the SAVE function
  820.     to save all your changes to the DW executable.
  821.     Here are some of the things that can be changed using DWEdit:-
  822.         Screen Mode/Palette/Size
  823.         Window/Size/Position/Colors
  824.         AutoPointOption
  825.         MouseAcceleration/Threshold
  826.         Position Independent Button Selection Mode
  827.         ButtonsBelowOption
  828.         ScreenBlankTime
  829.         Number of Bufferred Dirs
  830.         Task Priority
  831.         XCopyBootBlocks as "standard" option
  832.         AutoActivate of Text Gadget Option
  833.         Type startup ANSI option
  834.         RMB activate option
  835.         Parent buf option
  836.         Left and right text gadget activate keys.
  837.         No Duplicates of DW option
  838.         VMK Time value
  839.         External config file Option
  840.  
  841.     Changing a button:-
  842.     You can change a button to make it do something slightly different
  843.     to something totally different.  Just press on the button then go
  844.     to the menu and select "Change last button pressed".   To change an
  845.     instant action you just do the instant action then select "Change
  846.     last button pressed".  You can also just do a binary edit of DirWork
  847.     and change them that way.  But the most user friendly was is to use
  848.     DWEdit via the "Use external configuration editor" menu item.
  849.     Here is the technical format anyway:-
  850.     "     ,       ,       "
  851.      ||||| |||\__/||
  852.      |     ||| |  |+------------Arguments for operation.
  853.      |     ||| |  |
  854.      |     ||| |  +-- Special Option for some functions
  855.      |     ||| |
  856.      |     ||| +------  Keyboard combination (qualifier/keycode)
  857.      |     |||
  858.      |     |||
  859.      |     |||+-------------- Options for certain routines.
  860.      |     ||
  861.      |     ||
  862.      |     |+--------------- What needs to be selected to operate.
  863.      |     |    F=Selected Files. D=Selected Dirs.
  864.      |     |    B=Selected Files &/or Dirs.
  865.      |     |    A=All files/dirs even if not selected. 
  866.      |     |    f=special mode that allows some files or no files
  867.      |     |    0=irrelevant
  868.      |     |
  869.      |     +--------------- Internal routine the button uses.
  870.      |               A capital letter signifies that the operation does
  871.      |               not require selected files/dirs.  A lower case
  872.      |               hence means the operation should require selected
  873.      |               files/dirs.
  874.      |      
  875.      |
  876.      +----------------------------------------  Button Name of 5 Chars
  877.                          This is the text that is displayed inside the
  878.                          button.
  879.  
  880.  
  881.  
  882.     ChangePopKey allows you to change the keys that bring DirWork
  883.     out of sleep and you can define many other keys to execute other
  884.     programs. If you are running kick2.0- the programs are also added
  885.     to the workbench tools menu.  They are always added to the DW
  886.     tools menu.
  887.     Use the DWEdit program for a more user friendly way of changing
  888.     these entries.  By default there is a couple of entries including
  889.     one to wake DW up (which must always be the first entry) and
  890.     one to start a NewShell by pressing LeftAmiga-ESC.
  891.     Here is the technical format anyway:-
  892.  
  893.          "@       ,       "
  894.            |||\__/||
  895.            ||| |  |+---------Arguments for operation.
  896.            ||| |  |           Also what appears as menu text.
  897.            ||| |  |           Must have something here for PopKey/Tools
  898.            ||| |  +------- Special Option for some functions
  899.            ||| +------  Keyboard combination (qualifier/keycode)
  900.            |||
  901.            |||
  902.            |||+-------------- Options for certain routines.
  903.            ||
  904.            ||
  905.            |+--------------- What needs to be selected to operate.
  906.            |    F=Selected Files. D=Selected Dirs.
  907.            |    B=Selected Files &/or Dirs.
  908.            |    A=All files/dirs even if not selected. 
  909.            |    f=special mode that allows some files or no files
  910.            |    0=irrelevant (This is usually the case for PopKey/Tools
  911.            |
  912.            +--------------- Internal routine the button uses.
  913.                      A capital letter signifies that the operation does
  914.                      not require selected files/dirs.  A lower case
  915.                      hence means the operation should require selected
  916.                      files/dirs.
  917.             
  918.  
  919. ----------------------------------------------------------------------------
  920.     3. Hints/tips
  921. ----------------------------------------------------------------------------
  922.  
  923.     If you are a registered user just describe what sort of button you
  924. would like configured and I will give you the button configuration text for
  925. it, if it is possible.
  926.  
  927.     To have the programs added to the tools menu under kick2.0-
  928. workbench must be loaded.  So you might have to have DW -s after loadwb and
  929. you might have to have a "wait 3" or similar command in between.
  930.  
  931.     If DW is launched from workbench it will have the paths that were
  932. added before the loadwb command so put all your path additions before that
  933. command in your startup-sequence.  If DW is started from a Shell/CLI it will
  934. have all the paths that the Shell/CLI has at that point.
  935.  
  936.     For DW's text/hex viewer to decrunch powerpacked files you must have
  937. the powerpacker.library in your libs: directory.
  938.  
  939.     Since Show, Type, & DiskOp run as separate processes you can quit
  940. DW while they are still going.  But since they are executing from DW's
  941. program memory DW will not really quit.  If there are "child" processes
  942. still running DW goes into a delayed quit until the processes have been
  943. exited from then it really quits.  But if you press the wake up keys or
  944. similar or have no duplicates option set and start another DW while it is
  945. in this delayed quit mode, it will start up and forget that you ever said
  946. quit.  It forgives you for you mental lapse in actually wanting to quit DW !
  947.  
  948.     DW makes its screen public for kickstart 2.0- so you can open other
  949. windows such as consoles on it.  The name of DW's screen is "DW Screen0"
  950. where 0 increases as you run more DW's.
  951.  
  952.     You can stop a multiple file/dirs function (like copying more than
  953. one file or deleting files and dirs) by pressing the left mouse button over
  954. the error display area.  This is the area where the diskname and bytes free
  955. is usually displayed.
  956.  
  957.     If you want to crunch DirWork use PowerPacker V3 or later as it
  958. does the correct things, other crunchers may cause DW to crash when
  959. launched from the Shell/CLI.  If you are using DW crunched you probably
  960. will use the external config option (selectable with DWEdit).  To do this
  961. go to DWEdit before you crunch DW and select the external config file
  962. option then quit(using quit & Save button) DWEdit and SAVE config to
  963. DirWork executable.  Then you can crunch DirWork and the config will always
  964. be fetched/stored in "s:DW.config" file.
  965.  
  966. Bye,
  967.     Chris Hames (Available for Amiga programming work)
  968.  
  969.