home *** CD-ROM | disk | FTP | other *** search
/ Amiga GigaPD 3 / Amiga_GigaPD_v3_1of3.iso / dirwork / dwedit.doc < prev    next >
Text File  |  1994-03-30  |  30KB  |  789 lines

  1. DWEdit V1.51a (39664 bytes)   The configuration editor for DirWork 1.51
  2. -----------------------------------------------------------------------
  3.  
  4. This program may be copied as long as it is accompanied by this doc file
  5. both unaltered & no money is charged(except for a reasonable copying fee
  6. such as what Fred Fish charges).  All use of this program is at your own
  7. risk & I assume no responsibility or liability for any problems that occur.
  8.  
  9.  
  10.     Well you can change most options/buttons etc from DirWork but
  11. DWEdit allows you to edit some others as well as making the configuration
  12. process a lot easier.  To start DWEdit(assuming DWEdit is in a valid path
  13. eg c:):-
  14.  
  15. Select the "Use external configuration Editor" menu item from in DirWork
  16. (Best way!).  Note if you do this and select Quit & Use, most changes appear
  17. in DW immediately, but if you want those changes always you must select the
  18. "SAVE Current Setup to a DW" menu item.
  19.  
  20. From a Shell/CLI type "DWEdit DWFileName".
  21.  
  22. From a Shell/CLI type "DWEdit s:DW.config".
  23.  
  24.     For DirWork 1.31, 1.40 - 1.50 users you can load in the previous
  25. Button/Instant Actions and PopKey/Tool data.  Menu type Options aren't
  26. loaded.  Things change so some coverting is done but new options might be
  27. better so have a look.
  28. From a Shell/CLI type "DWEdit DWFileName OldDWFileName".
  29.  
  30.  
  31.     Then if everything is ok you will be presented with a screen with
  32. all the DirWork Buttons as well as buttons for the left/middle/right mouse
  33. button instant actions.  You can select one of the main buttons:-
  34.  
  35. Quit        - Quit without keeping any changes made.
  36. Quit & Use    - Quit and keep changes(this appears if you run from DW).
  37. Quit & Save    - Quit and save changes to disk(when not run from DW).
  38. Options        - Takes you to a screen of options.
  39. Ed PopTools    - Takes you to the PopKey/Tools screen.
  40. Print Config    - Prints your Button/InstantAction & PopTool to PRT:.
  41.  
  42.     When the mouse is over a Button/Instant Action the current config
  43. for that button is shown at the bottom of the display.  Pressing the button
  44. takes you to a Button/Instant Action  editing screen.
  45.  
  46.     There are three toggle buttons on the main screen as well.  You can
  47. select SwapButton then press buttons to swap them then select swap button
  48. again to turn it off.  Same goes for SwapRow.  CopyBut is like swap button
  49. but the button is copied.
  50.  
  51. ----------------------------------------------------------------------------
  52.         The Options screen
  53. ----------------------------------------------------------------------------
  54.  
  55.     Here you can change many options that you couldn't from DirWork
  56. itself:-
  57.  
  58. OPTIONS THAT TOGGLE ON/OFF
  59.  
  60. AutoPoint    Automatically select windows the mouse is over.
  61.         Often called SunMouse.
  62.  
  63. XCopyBootBlocks    The Boot block checker will treat Xcopy Boot blocks as if
  64.         they are standard boot blocks.
  65.         (ie won't warn you when you insert a disk with one)
  66.  
  67. ActivateTextGad    After getting a directory DirWork will activate the text
  68.         gadget.
  69.  
  70. NoDWDuplicates    When you have one DW running and try to start another it
  71.         will just bring the one running to the front.
  72.  
  73. ExternalConfig    This makes DirWork use "S:DW.config" and its
  74.         configuration file instead of using the DW executable.
  75.         Maybe you would like to crunch DirWork and keep changing
  76.         your config.
  77.  
  78. ButtonsBelow    If your one of those upsidedown people this will put the
  79.         buttons etc below the file list for you.
  80.  
  81. PositionIndepen    This make the button position irrelevent to what file list
  82.         it refers to.  You have to press the right mouse button
  83.         on the button to refer to the right list as the source.
  84.         Plenty of people use DW this way as you don't have to
  85.         have duplicates of each button.
  86.  
  87. MouseAccelerat    Accelerates your mouse based on values given in Accel and
  88.         threshold.
  89.  
  90. NoWBenchTools    Stops DW from adding tools to the workbench screen in
  91.         Kickstart 2.0-.
  92.  
  93. More ANSI    The text viewer can display ANSI files so if you want it
  94.         to start in ANSI mode(its slower) select this option.
  95.  
  96. BusyPointer    A little Busy clock comes up when DW is already doing
  97.         something.  This is on by default.
  98.  
  99. RMB Activate    This causes right mouse button presses to activate the
  100.         DW window so you don't have to activate DW then use
  101.         the right mouse button.
  102.  
  103. Parent Buf    If you have Buffered directories on this will
  104.         automatically use the buffered copy of a dir if you use
  105.         the parent/root functions on the far sides of the dir
  106.         path gadgets.  Eg if you got the directory DF0:c then
  107.         pressed the parent/root button it would use the buffered
  108.         copy instead of re-reading the DF0: dir.  It will only
  109.         use the buffered copy if you have not read other dirs
  110.         in between.
  111.  
  112. Interlace    Screen is interlaced for DW.
  113.         And for the text viewer.
  114.  
  115. Productivity    Screen is non interlaced.  Requires ECS chips in your
  116.         machine and a VGA or better monitor.
  117.         And for the text viewer.
  118.  
  119.  
  120.  
  121. OPTIONS YOU SET THE VALUE OF
  122.  
  123.  
  124. TaskPriority    The priority relative to other prgrams running of DW.
  125.         1 is usually a good value as it give DW more processor
  126.         time than most other programs.
  127.         Recommended range -5 to 5.
  128.  
  129. MouseAccel    The factor by which mouse movement will be multiplied by.
  130.         You must turn the mouse acceleration option on as well.
  131.         Recommended range 2 to 10.
  132.  
  133. MouseThreshhold    This is the smallest movement required before the mouse
  134.         acceleration factor is used.  So when you do small
  135.         movements no acceleration occurs and hence you have fine
  136.         control. A value of 1 means always multiply be MouseAccel.
  137.         You must turn the mouse acceleration option on as well.
  138.         Recommended range 1 to 20.
  139.  
  140. ScreenBlankTim    Amount of time the machine must be idle before the screen
  141.         blanks.  Assuming you have the ScreenBlank option on.
  142.         In tenths of a second so 4800=8 minutes.
  143.         Recommened range 2400 to 9600.
  144.  
  145. BufferedNumber    Number of directories keep in memory when you have the
  146.         buffered directory option turned on.
  147.         Recommened range 4 to 20.
  148.  
  149. VMKTime        Amount of time between VMK checks.  Assuming you have the
  150.         Periodic VMK check option on.
  151.         In tenths of a second so 80=8 seconds.
  152.         Recommened range 10 to 180.
  153.  
  154. LeftActivate    This is the Qualifier/Keycode of the key combination that
  155.         will activate(like you pressed the left button on gadget)
  156.         the left directory path text gadget.  By default this is
  157.         the Del key.
  158.  
  159. RightActivate    This is the Qualifier/Keycode of the key combination that
  160.         will activate(like you pressed the left button on gadget)
  161.         the right directory path text gadget.  By default this is
  162.         the Help key.
  163.  
  164.  
  165. WindowLeftEdge    The x coordinate of the top/left corner of windows DW opens
  166.         on the workbench screen and output windows.
  167.  
  168. WindowTopEdge    The y coordinate of the top/left corner of windows DW opens
  169.         on the workbench screen and output windows.
  170.  
  171. WindowWidth    The width of windows DW opens on the workbench screen and
  172.         output windows.
  173.  
  174. WindowHeight    The height of windows DW opens on the workbench screen
  175.         output windows.
  176.  
  177. ScreenWidth    The width of the screen DW opens.
  178.  
  179. ScreenHeight    The height of the screen DW opens.
  180.         And for the text viewer.
  181.  
  182. Colors13    These are the color numbers DW uses for a window Kick 1.3.
  183.         (0=Blue 1=White 2=Black 3=Orange by default colors)
  184. Colors20    These are the color numbers DW uses for a window Kick 2.0.
  185.         (0=Grey 1=Black 2=White 3=LiBlue by default colors)
  186. ColorsSc    These are the color numbers DW uses for screen.
  187.         They have the following sequence:-
  188.            First three for File lists (Background/Files/Dirs)
  189.            Next two for title bar (Text/Background)
  190.            Next two for button text (Text/Background)
  191.            Next one for menu/slider color
  192.            Next two for button border
  193.  
  194.         For example Colors13 by default is:
  195.            2133132100
  196.         File list is  213=BlackBack/WhiteFiles/OrangeDirs
  197.         Title bar is 31=Orange on White
  198.         Buttons text is 32=OrangeText/Black
  199.         Button Border is 00=No border shown
  200.  
  201. SLIDE GADGETS AT BOTTOM
  202.  
  203.     The three slide gadgets are Red/Green/Blue modifiers for the screen
  204. palette for DW.  Just select a color button under the sliders then use the
  205. slide movement to adjust the colors.
  206.  
  207. ----------------------------------------------------------------------------
  208.         The Button/Instant Action editing screen
  209. ----------------------------------------------------------------------------
  210.  
  211.     This screen displays the function currently selected for that
  212. button with the main config string down the bottom and the various sections
  213. of this config above it.  The sections that are irrelevent for the current
  214. function are ghosted(dots across them and unselectable).  Above the config
  215. string gadgets is information text which can be selected from three buttons
  216. on the right hand side.
  217.  
  218.     GeneralInfo - Describes the various parts of a config string.
  219.  
  220.     SelectionInfo - Describes how selection affects a function.
  221.  
  222.     FunctionInfo - Describes the current function of the config.
  223.                    This is selected by default.
  224.  
  225.     As well on the right hand side is a change function button which
  226. allows you to change the button/instant action to another function.  As
  227. with the PopTool screen a Qualifier/Keycode box is on the right.  You can
  228. see what values a reuired for a button to be activated by a certain key
  229. combination by clicking on this box and presing the keys you want.
  230.  
  231.  
  232. The button configuration is a single string consisting of:-        
  233. ------------------------------------------------------------------ 
  234. 'BName,FSOQuCo,Arguments'                                          
  235.  ||||| |||\__/||                                                   
  236.  |     ||| |  |+- Arguments for operation.                         
  237.  |     ||| |  +--- Special option for certain routines             
  238.  |     ||| +------- Keyboard combination (qualifier/keycode)       
  239.  |     ||+----------- Options for certain routines.                
  240.  |     |+--------------- What needs to be selected to operate.     
  241.  |     +----------------- Internal function the button uses.       
  242.  +-Button Name of 5 Chars
  243.    In the case of instant actions this text can describe filetype.
  244. ------------------------------------------------------------------ 
  245.  
  246.     Selection is only relevent to lower case functions as these are the
  247. only ones which deal with files(s)/dir(s) in the file lists.  For the lower
  248. case functions 'F' means apply function on all selected files, 'D' all
  249. selected dirs and 'B' all selected files and all selected dirs.  'A' all
  250. files and dirs even if they are not selected.  Another option is 'f' which
  251. will apply the function to all selected files but if there are no files
  252. seleted it will apply the function with no filename.  'f' is great for
  253. creating buttons like Edit so that you can edit a selected file and if you
  254. want to create a new file just hit the Edit button with no files selected.
  255.  
  256. NOTE: Press return after any change in any text gadgets on this screen
  257.       otherwise your changes may not be registered.
  258.  
  259.     Ok so say you wanted to change the "DH0:  " button to "DF2:  " you
  260. would select that button from the main DWEdit screen then you would see
  261. that in the arguments is "DH0:" so click in that text gadget change it to
  262. "DF2:" then press return.  Now that button will read "DF2:" but you will
  263. also want to change the button text so click in that text gadget and change
  264. it to "DF2:  " note that it must be 5 characters no more no less.  Press
  265. Quit & USe or Quit & Save and you will see the button now has a new Button
  266. text and when you pres it reads the new directory("DF2").
  267.  
  268.     Plenty of functions have options which a described in the Function
  269. Info text.  If you wanted the show button to show icons as well all you
  270. would do is go to DWEdit's main screen select the show button.  Then you
  271. will see the text saying that you must change the option to i to get the
  272. show function to display icons as well as IFF pictures.  So click in the
  273. Option gadget change the 0 to i and it is done.
  274.  
  275.     Maybe you want a button to relabel disks.  In DWEdit's main screen
  276. just click on the button that you want to be relabel.  Then the current
  277. config for that button comes up.  Ignore that and press the change function
  278. button on the right hand side of the screen.  Now you get a display of all
  279. the available functions in DW, press the L function button which says
  280. relabels disks or simialr.  Now you are back to the config screen and the
  281. default config function has been entered in the button config.
  282.  
  283.     Ok say you want to change the instant action for double clicking on
  284. a text file to use a external viewer.  In DWEdit's main screen click on the
  285. Text button for left mouse instant actions.  Now the button is using
  286. function t (inbuilt text viewer function) but you want to use an external
  287. program so select change function button on right hand side of display and
  288. you will see the many available functions, you will see the function u with
  289. a description that it runs external programs so select it.  Then its back
  290. to the button config screen in which you must change the Buttontext back to
  291. what it was as instant actions need the Button text to remain the same and
  292. all you have to do is change the arguments to run you external program
  293. which could be something like "Run >NIL:  MuchMore" or similar.  Note it
  294. might have been quicker if you knew u was the function you where after as
  295. you would have skipped the change function button stuff and manually
  296. entered the u into the function text gadget and avoided having to change
  297. the Buttontext back to what it was.
  298.     
  299.  
  300.     Well they are simple examples of changes you can do very powerful
  301. changes to run external programs cd directorys open windows and flip
  302. between screens.  See the SAMPLE CHANGES section for other examples.
  303.  
  304.  
  305.     If you want to create a new instant action type say you have
  306. certain files that end in ".pcd".  You must replace one of the current ones
  307. and change all three Button text's (Left, Middle & Right) to ".pcd ".  But
  308. do NOT change ILBM, 8SVX, ANIM, SMUS, FTXT, Most, PP, Exec, Text, .GIF as
  309. they are not only recognised by filename.
  310.  
  311. SAMPLE CHANGES FOR BUTTONS/INSTANT ACTIONS:-
  312.  
  313. ---------------------------------------------------------------------------
  314. Routine| Example changes and Information
  315. letter | Remember upper case routine letter means selected file(s) related.
  316. ---------------------------------------------------------------------------
  317. D    A simple change would be changing DH1: to DF2: and make the F1 key
  318.     get that directory.  Just select the DH1: button, go up to change
  319.     last button pressed and change
  320.     " DH1:,D00----,DH1:" to " DF2:,D000050,DF2:".
  321.  
  322.     To make a button that gets the directory already in the text gadget
  323.     (instead of just pressing the right mouse button over the gadget)
  324.     "GetDr,D0c----,"
  325.  
  326. N    Executes commands. Use this function if you want to execute a program
  327.     and don't want the selected files to be added to the command.
  328.     You must add CTRL-J EndCLI to your command if you use a option
  329.     that opens a window(w,W,p,P) and you want it to automatically close.
  330.  
  331.     Options(w,W,p,P,f,F,t,T,R,0):-
  332.  
  333.        Uppercase of any of these letters means a requester first.
  334.  
  335.        w if you want a window to open for the output.
  336.        p if you want a window to open for the output and waits for you
  337.          to press a key before it closes.
  338.        f bring default public screen(usually workbench) to the front.
  339.        t bring default public screen(usually workbench) to front for 
  340.          command then DW screen.
  341.  
  342.        R if you want a requester so you can edit the command before
  343.          it is executed.
  344.        0 means no window or requester or bringing screens to the front.
  345.  
  346.     SpecialOp(s,d,',')
  347.  
  348.        s CD source directory before command then refetch that dir
  349.          after.
  350.        d CD destination directory before command then refetch that
  351.          dir after.
  352.        , as normal do no CD'ing.
  353.  
  354.     Examples:-
  355.  
  356.     "Prefs,N00----,Preferences"  Bring up 1.2/1.3 preferences.
  357.                              No output window is opened.
  358.  
  359.     "Paint,N00----,Run >NIL: Paint"  Start a paint program but
  360.                                      allow DW to continue.
  361.  
  362.     "Avail,N0p----,AvailJEndCLI"   Show available memory in a window.
  363.                                Then automatically close that window
  364.                                after the user presses a key (or clicks
  365.                                on the close gadget with Kick2.0+).
  366.                                    Note the J is CTRL-J
  367.  
  368.     "Avail,N0w----,List"   List a directory in a output window that stays
  369.                        open until the user enters EndCLI (or clicks
  370.                        on the close gadget with Kick2.0+).
  371.  
  372.     "DiskC,N0w----,DiskCopy DF0: TO DF0:JEndCLI"  Diskcopy DF0: to DF0:
  373.                                               opening a window for
  374.                                               the output that auto
  375.                                               closes when the Diskcopy
  376.                                               is finished.
  377.                                                   Note the J is CTRL-J
  378.  
  379. M    The Makedir function can be given a filename which it will copy
  380.     to create a icon for the directory.  All you have to do is give
  381.     it the filename of the icon you want it to create.
  382.     "MakDr,M00----,sys:DefaultDraw.info"
  383.  
  384.  
  385. P    To create a parent button if you don't like going to the far
  386.     left/right of the directory text and pressing the left button.
  387.     "Paren,P00----,"
  388.  
  389. R    To create a root button if you don't like going to the far
  390.     left/right of the directory text and pressing the right button.
  391.     "Root ,R00----,"
  392.  
  393.  
  394. t    Is the Type/Hextype function.  Options are
  395.     A=ASCII H=Hex (try to load full file)
  396.     a=ASCII h=Hex (Only load first 32K of file)
  397.  
  398. j    Options(f,F,d,D,b,B,p,P) Uppercase=DeSelect LowerCase=Select
  399.     To make a button select dirs as well as files.
  400.     "All  ,jAb----,"
  401.     To make a button select all dirs.
  402.     "AllDr,jAd----,"
  403.     To make a button deselect all dirs.
  404.     "NoDir,jAD----,"
  405.     To make a button that request you for a pattern that deselects
  406.     "PtDSl,jAP----,"
  407.  
  408. s    To make a show button display icons as well as IFF pictures.
  409.     "Show ,sFi----,"
  410.  
  411. k    Options(c,C,t,T,s,S) Uppercase requester user can edit first
  412.     t=toggle protection s=setprotection c=set comment
  413.     The Protect function inverses the protect bit specified in the
  414.     So "Prote,kBt----,d" will change the delete protection of a file.
  415.  
  416.     "PNorm,kBs----,rwed" would set all files/dirs to normal protection.
  417.  
  418.     "SetCm,kFs----,DW Rules!" would set all files comments to DW Rules!
  419.  
  420.     "ClrCm,kDS----," would request user for comment then set all dirs
  421.                      comments to it.
  422.  
  423.  
  424. d    To make a delete button that doesn't request you when you delete a
  425.     non empty dir.
  426.     Options (d,D,b,B)
  427.     "Delet,dB0----,"
  428.     A delete button that requests you when you delete a file
  429.     or a directory:-
  430.     "Delet,dBB----,"
  431.     The lower case letter option means that if Delete fails it will
  432.     prompt you and if you want will UnProtect each file and try to
  433.     delete again.
  434.  
  435. c    Options (c,D,C)
  436.     To make a copy button clone the file note, protection and date.
  437.     BytesFree for the source/destination is updated after a copy.
  438.     "CCopy,cBc----,"
  439.     To make a CopyAs button that clones
  440.     "CCpAs,cBC----,"
  441.     To make a CopyAs button that doesn't clone
  442.     "CCpAs,cBD----,"
  443.     To make a Copy button that doesn't clone
  444.     "CCpAs,cB0----,"
  445.  
  446. m    To make a move button clone the file note, protection and date.
  447.     "CMove,mBc----,"
  448.  
  449. u    The u internal routine is one of the most usefull it will execute
  450.     the text in the argument part of the button config with any any
  451.     file/dirnames selected.  If you want the button to operate on
  452.     selected files and directories use the B middle letter.  If you
  453.     want it just to operate on selected files use F and if you just
  454.     want it to operate only on selected Dirs use D.  There is another
  455.     selection that is usefull for this function, 'f' will execute the
  456.     command with all selected files but if there are none selected
  457.     it executes the command with no filename.  Note the u command
  458.     automatically adds JEndCLI (where J is CTRL-J) to commands
  459.     that use an option that opens a window(w,W,p,P).
  460.  
  461.     Options(w,W,p,P,f,F,t,T,R):-
  462.  
  463.        Uppercase of any of these letters means a requester first.
  464.  
  465.        w if you want a window to open for the output.
  466.        p if you want a window to open for the output and waits for you
  467.          to press a key before it closes.
  468.        f bring default public screen(usually workbench) to the front.
  469.        t bring default public screen(usually workbench) to front for 
  470.          command then DW screen.
  471.  
  472.        R if you want a requester so you can edit the command before
  473.          it is executed.
  474.        0 means no window or requester or bringing screens to the front.
  475.  
  476.     SpecialOp(s,d,',')
  477.  
  478.        s CD source directory before command then refetch that dir
  479.          after.
  480.        d CD destination directory before command then refetch that
  481.          dir after.
  482.        , as normal do no CD'ing.
  483.  
  484.     An example of using the u routine is the edit button and right mouse
  485.     instant operation on text files:- " Edit,uF0----,Run >NIL: E"
  486.     To change to path for the editor from E to c:Ed just select the edit
  487.     button, go up to change last button pressed and change to
  488.     " Edit,uF0----,Run >NIL: c:Ed"
  489.     Note an output window is not needed hence the 0 as the option.
  490.     But it is even better to use the f selection with a edit button
  491.     as then you you select no files the editor is still executed and
  492.     you can use that method to create a new file for editing.
  493.  
  494.     To change the double click on a text file to use another text viewer
  495.     instead of the default internal type.  After you double click a
  496.     text file & select change last button pressed
  497.         "Text ,uF0,Run >NIL: ViewerName". eg "Text ,uF0,Run >NIL: MuchMore"
  498.  
  499.     To make a button that uses DOS's list command on selected files and
  500.     dirs, and shows the output in a window than stays open until the
  501.     user presses a key (or clicks the close gadget with Kick2.0-).
  502.     "List ,uBp----,List"
  503.  
  504.     To make a button that uses DOS's Execute command to execute script
  505.     files, with an output window open while the command is executing.
  506.     "Execu,uFw----,Execute"
  507.  
  508.     To make a button that uses DOS's FileNote command to change the
  509.     FileNote of a file in a requester.
  510.     "Execu,uFR----,FileNote"
  511.  
  512.     To make a button that extracts files to the same directory then
  513.     gets DW to re-read that directory, displaying the output from
  514.     the program in a window that automatically closes
  515.     ".LZH ,uFw----sLZ x"
  516.  
  517.  
  518. a    The a function is very similar to the u function except that it
  519.     adds "/*" to directory names and has its own output window so
  520.     there is no need to use an option to open one.
  521.  
  522.  
  523. b    Is the routine which displays the FileNote/protection bits so
  524.     "FBits,bB0----," would create a button for it instead of going to the
  525.     far right or left of the file/dir.
  526.  
  527.  
  528.  
  529.  
  530. Here is the default configuration of DW:-
  531.  
  532. "Instn,nF0----,",
  533. "Print,ifP----,",
  534. "Serch,fF0----,",
  535. "LZ A ,aB0----dLZ -r -x a ",
  536. "NewZP,uff----,Run >NIL: NewZAP",
  537. "CpyAs,cBD----,",
  538. "Info ,I00----,",
  539. " Info,I00----,",
  540. "DskOp,K00----,",
  541. "NewZP,uff----,Run >NIL: NewZAP",
  542. "Commd,N0w----,",
  543. "NewSh,N0f----,NewShell",
  544. "AdIcn,wB0----,",
  545. "Sleep,S00----,",
  546.  
  547. "EScpt,uFw----,Execute",
  548. "Prote,kBt----,d",
  549. "PlayS,pF0----,",
  550. "MakDi,M00----,",
  551. "HxTyp,tFH----,",
  552. "Delet,dBd----,",
  553. "Move ,mB0----,",
  554. " Move,mB0----,",
  555. "Delet,dBd----,",
  556. "HxTyp,tFH----,",
  557. "MakDi,M00----,",
  558. "PlayS,pF0----,",
  559. "Prote,kBt----,d",
  560. " VMK ,V00----,",
  561.  
  562. "PatSe,jAp----,",
  563. " Run ,ufR----,Run >NIL:",
  564. "Show ,sF0----,",
  565. "Edit ,uf0----,Run >NIL: E",
  566. "Type ,tFA----,",
  567. "Renam,rB0----,",
  568. "Copy ,cB0----,",
  569. " Copy,cB0----,",
  570. "Renam,rB0----,",
  571. " Type,tFA----,",
  572. " Edit,uf0----,Run >NIL: E",
  573. " Show,sF0----,",
  574. " Run ,ufR----,Run >NIL:",
  575. "PatSe,jAp----,",
  576.  
  577. "WORK:,D00----,WORK:",
  578. "SYS: ,D00----,SYS:",
  579. "DH1: ,D00----,DH1:",
  580. "DH0: ,D00----,DH0:",
  581. "DF1: ,D00----,DF1:",
  582. "DF0: ,D00----,DF0:",
  583. "RAM: ,D00----,RAM:",
  584. " RAM:,D00----,RAM:",
  585. " DF0:,D00----,DF0:",
  586. " DF1:,D00----,DF1:",
  587. " DH0:,D00----,DH0:",
  588. " DH1:,D00----,DH1:",
  589. " SYS:,D00----,SYS:",
  590. "WORK:,D00----,WORK:",
  591.  
  592. Small buttons:-
  593.  
  594. "All  ,jAf----,",
  595. "None ,jBB----,",
  596. "CD   ,C00----,",
  597. "<<   ,E00----,",
  598. "<>SWA,W00----,",
  599. ">>   ,E00----,",
  600. "CD   ,C00----,",
  601. "None ,jBB----,",
  602. "All  ,jAf----,",
  603.  
  604. Left double click instant actions:-
  605.  
  606. "MOD. ,uFf----,Intuitracker",
  607. ".ARC ,uFp----,Arc v",
  608. ".DMS ,uFW----,DMS Write",
  609. ".LZH ,uFp----,LZ l",
  610. ".LHW ,uFW----,Lhwarp Write 0",
  611. ".PAK ,uFw----d",
  612. ".WRP ,uFW----,UnWarp",
  613. ".ZIP ,uFp----,UnZIP -v",
  614. ".ZOO ,uFp----,Zoo v",
  615. ".GIF ,uF0----,VirtGIF",
  616. ".INFO,sFi----,",
  617. ".8SVX,pF0----,",
  618. ".ANIM,uF0----,ShowANIM",
  619. ".ILBM,sF0----,",
  620. ".SMUS,uF0----,PlaySMUS",
  621. ".FTXT,uF0----,",
  622. ".Most,uFt----,Most",
  623. ".PP  ,tFA----,",
  624. ".Exec,000----,",
  625. ".Text,tFA----,",
  626. "Binry,tFH----,",
  627. ".LHA ,uFp----,LZ l",
  628. ".uue ,tFA----,",
  629. ".jpg ,uF0----,Run >NIL: JView",
  630.  
  631. Middle click instant actions:-
  632.  
  633. "MOD. ,uFf----,Run >NIL: Intuitracker",
  634. ".ARC ,uF0----dRun >NIL: Arc xw",
  635. ".DMS ,uF0----,Run >NIL: DMS Write",
  636. ".LZH ,uF0----dRun >NIL: LZ -m -x -r x",
  637. ".LHW ,uF0----,Run >NIL: Lhwarp Write 0",
  638. ".PAK ,uF0----dRun >NIL:",
  639. ".WRP ,uF0----,Run >NIL: UnWarp",
  640. ".ZIP ,uF0----dRun >NIL: UnZIP -xdo",
  641. ".ZOO ,uF0----dRun >NIL: Zoo xO//",
  642. ".GIF ,uF0----,Run >NIL: VirtGIF",
  643. ".INFO,sFi----,",
  644. ".8SVX,uF0----,Run >NIL: PlaySS",
  645. ".ANIM,uF0----,Run >NIL: ShowANIM",
  646. ".ILBM,uF0----,Run >NIL: Dpaint",
  647. ".SMUS,uF0----,Run >NIL: PlaySMUS",
  648. ".FTXT,uF0----,",
  649. ".Most,uFf----,Run >NIL: Most",
  650. ".PP  ,uF0----,Run >NIL: PowerPacker",
  651. ".Exec,uF0----,Run >NIL: ReSource",
  652. ".Text,uF0----,Run >NIL: E",
  653. "Binry,uFf----,Run >NIL: NewZAP",
  654. ".LHA ,uFw----dRun >NIL: LZ -m -x -r x",
  655. ".uue ,uF0----dRun >NIL: uudecode",
  656. ".jpg ,uF0----,Run >NIL: JView",
  657.  
  658. Right click instant actions:-
  659.  
  660. "MOD. ,uFf----,Run >NIL: Intuitracker",
  661. ".ARC ,uFw----dArc xw",
  662. ".DMS ,uFW----,DMS Write",
  663. ".LZH ,uFw----dLZ -m -x -r x",
  664. ".LHW ,uFW----,Lhwarp Write 0",
  665. ".PAK ,uFw----d",
  666. ".WRP ,uFR----,Run >NIL: UnWarp",
  667. ".ZIP ,uFw----dUnZIP -xdo",
  668. ".ZOO ,uFw----dZoo xO//",
  669. ".GIF ,uF0----,Run >NIL: VirtGIF",
  670. ".INFO,uFf----,Run >NIL: IconEdit",
  671. ".8SVX,uF0----,PlaySS",
  672. ".ANIM,uF0----,ShowANIM",
  673. ".ILBM,uF0----,Mostra",
  674. ".SMUS,uF0----,PlaySMUS",
  675. ".FTXT,uF0----,",
  676. ".Most,uFf----,Run >NIL: Most",
  677. ".PP  ,uF0----,PPShow",
  678. ".Exec,uFR----,",
  679. ".Text,uF0----,Run >NIL: E",
  680. "Binry,uFf----,Run >NIL: NewZAP",
  681. ".LHA ,uFw----dLZ -m -x -r x",
  682. ".uue ,uFw----duudecode",
  683. ".jpg ,uF0----,Run >NIL: JView",
  684.  
  685.  
  686. ----------------------------------------------------------------------------
  687.         The PopKey/Tools editing screen
  688. ----------------------------------------------------------------------------
  689.  
  690.     There is a slight difference between Button/Instant Actions and the
  691. PopKey/Tool configuration as the PopKey entry has no button name part and
  692. has @ at the start of each entry other wise they are the same.
  693.  
  694.          "@       ,       "
  695.            |||\__/||
  696.            ||| |  |+---------Arguments for operation.
  697.            ||| |  |          Also what appears as menu text.
  698.            ||| |  |          Must have something here for PopKey/Tools
  699.            ||| |  +-------------Special options
  700.            ||| +------  Keyboard combination (qualifier/keycode)
  701.            |||
  702.            |||
  703.            |||+-------------- Options for certain routines.
  704.            ||
  705.            ||
  706.            |+--------------- What needs to be selected to operate.
  707.            |    F=Selected Files. D=Selected Dirs.
  708.            |    B=Selected Files &/or Dirs.
  709.            |    A=All files/dirs even if not selected. 
  710.            |    f=special mode that allows some files or no files
  711.            |    0=irrelevent (This is usually the case for PopKey/Tools
  712.            |
  713.            +--------------- Internal routine the button uses.
  714.                      A capital letter signifies that the operation does
  715.                      not require selected files/dirs.  A lower case
  716.                      hence means the operation should require selected
  717.                      files/dirs.
  718.  
  719.  
  720.     So say you wanted to change the PopKey to wake up DirWork all you
  721. have to do is edit the Qualifier/KeyCode of the first entry.  First click
  722. out of the text gadget the press the key combination you want DirWork to
  723. wake up with.  The values for this key combination is shown on the right
  724. hand side of the display.  Just substitue those values for the one
  725. currently in the PopKey/Tool text gadget.
  726.  
  727. By pressing the * on the keypad you would have got Qual=00 & Key=5D :-
  728.  
  729. So "@A001922,DW in Memory" becomes "@A00005D,DW in Memory"
  730.      \_/\/\/
  731.       |  \ + The D KeyCode
  732.       |   + The CTRL SHIFT ALT Qualifier
  733.       + Remember this is the function part A just happes to be awake function
  734.  
  735.  
  736.     The most common thing you will add to you tools/popkey data are
  737. commands to execute external programs so an example is to make it so if we
  738. select "Paint" from the Tools menu or press Amiga-F2
  739.  
  740. So add to the PopKey/ToolData "@N004051,Run >NIL: Paint".
  741.  
  742. The N means execute external program, the first 0 means nothing needs to be
  743. selected in the file lists and the second means no options.  Then the next
  744. 4 numbers are the Quailfier/Keycode for LeftAmiga-F2 key combinations.
  745. Then After the , is the command to execute and this is the text that will
  746. show in the tools menu.
  747.  
  748. For more information on the N function (or any other as you can use all
  749. the functions that you can use to define a button, the captial letter
  750. functions are the ones you might use though) see the Button/Instant Action
  751. section.
  752.  
  753. ----------------------------------------------------------------------------
  754.     General details
  755. ----------------------------------------------------------------------------
  756.  
  757. For each button and PopKeyEntry you can specify a key combination consisting
  758. of special keys (Qualifiers) and the normal key.  Here are some values to
  759. help you.  But in DWEdit on the Button change screen and the PopKey/Tool
  760. screen you can just click out of any text gadget and the press any key
  761. combination and the values are displayed.
  762.  
  763.     Sample Qualifiers:    Sample RawKeys:
  764.        LSHIFT=$01        Esc=$45   F1=$50 to F10=$59
  765.        RSHIFT=$02          `=$00    1=$01 to   \=$0D    BS=$41
  766.        CTRL  =$08        Tab=$42    Q=$10 to   P=$19 to  ]=$1B
  767.        LALT  =$10                   A=$20 to   L=$28 to  '=$2A
  768.        RALT  =$20                   Z=$31 to   M=$37 to  /=$3A
  769.        LAMIGA=$40        Del=$46  Help=$5F  Return=$44 Space=$40
  770.        RAMIGA=$80        Up=$4C Down=$4D Left=$4F Right=$4E
  771.  
  772.                     Keypad RawKeys:
  773.  
  774.                 (=$5A to *=$5D   -=$4A     +=$
  775.                 0=$0F    .=$3C   Enter=$43
  776.  
  777.  
  778. History:    V1.41a    First release
  779.         V1.42a    Now loads the PopKey/Tools from 1.40 DW's
  780.             And some help/example text improvements.
  781.         V1.43a    Added CopyBut and more examples.
  782.         V1.50a    Added options.
  783.             Major improvement to button/instant action editing.
  784.         V1.51a
  785.  
  786. Bye,
  787.     Chris Hames (Available for Amiga programming work)
  788.  
  789.