home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / mag_discs / 14 / programs / appdock2 / !AppDock2 / !Help < prev    next >
Text File  |  1994-07-18  |  13KB  |  273 lines
  1. > !AppDock2.!Help          Version 2.41     (18-Jul-94)
  2.  
  3. New feature of version 2.41:
  4.   Adjust clicking on the dock window toggles the shortcut bar status
  5.   (i.e. removes/redisplays it).
  6.  
  7. New feature of version 2.40:
  8.  
  9.   Pressing Alt+Ctrl+Shift brings the dock to the front, pressing the same
  10.   key combination again puts it to the back. While the dock is at the front,
  11.   it has a red border.
  12.   This feature can be disabled by choosing the menu item Prefs.Front.Never
  13.   (see below: 'RISC OS3' and 'Changes' for further details)
  14.   Clicking on the arrow icons of the dock or of the shortcut bar with Menu
  15.   instead of Select or Adjust switches to the very end (down/right arrow)
  16.   or to the very beginning (up/left arrow) of the dock or shortcut bar.
  17.  
  18. What is AppDock ?
  19. -----------------
  20.  
  21. This is an application dock program which is similar to backdrop utilities,
  22. in that it allows application icons to be arranged in a nice way and the
  23. applications to be started without having to deal with directory windows.
  24. The design is similar to the Application Dock that forms part of the NeXT
  25. Step system on NeXT computers.
  26.  
  27. A totally new feature is the ShortCut bar. It works similar to the
  28. application dock, but it stores ShortCuts for applications.
  29. You may define shortcuts for up to 20 applications. AppDock detects
  30. which application has the input focus and displays the shortcut
  31. definitions for the corresponding application. By clicking on one of
  32. the ShortCut buttons, the appropriate key combination is 'pressed' by
  33. the Application Dock.
  34.  You may edit the ShortCut definitions for each application. So, you
  35. may assign the ShortCut 'Find' and the key combination Ctrl-F4 to a
  36. button of the ShortCuts belonging to !Edit and if you click on the
  37. button while !Edit has the caret, the Find box is displayed.
  38.  
  39. How to use it:
  40.  
  41. 1.) the application dock
  42.  
  43. Simply drag an application or a directory on one of the square buttons on
  44. the vertical bar on the left (or right) side of the desktop.
  45.  
  46. If you dragged an application:
  47. * its icon is show on the button
  48. * double-clicking on it starts the application
  49. * dragging a file to it starts the application with the file given as
  50.   parameter
  51. * double-clicking with shift held down opens its directory
  52.  
  53. If you dragged a directory:
  54. (the same applies to a DOSDisc file or another image file if you are running
  55. RISC OS 3):
  56. * the name is shown on the button. 
  57. * as most names are to long to fit in one row, the application dock tries to
  58.   split the names at a sensible position, e.g. directory names as NewFiles
  59.   are split into 'New' and 'Files'.
  60. * double-clicking on it opens the directory
  61.  
  62. If you dragged a file to an application on the dock:
  63. * the application is started and the filename is given as parameter
  64.   (e.g. if you drag a file to the !Edit icon on the dock, !Edit is started
  65.   and the file is loaded).
  66.  
  67. You may define keyboard shortcuts for each entry in the dock, so that you
  68. are able to start them by one keystroke (if no other application intercepts
  69. the shortcut). Simply follow the submenu arrow of the second option of the
  70. main menu. The item is ticked if there is already a shortcut for the
  71. corresponding application/directory. Now select the key and the state of the
  72. control keys (none, Shift, Ctrl or Ctrl-Shift) and confirm the selection by
  73. clicking OK. You may cancel an existing shortcut by clicking on Off.
  74. Note that these shortcuts are not at all related to the shortcuts in
  75. the ShortCut bar.
  76.  
  77. Choosing 'Insert' causes one free button to be inserted before the button
  78. over which Menu was clicked.
  79.  
  80. Choosing 'Delete' causes the button over which Menu was clicked to be
  81. deleted.
  82.  
  83. Choosing 'Save all' from the menu saves the dock and the shortcuts defined
  84. in the ShortCut bar permanently (also save the preferences).
  85.  
  86. Note that if you have many applications in the dock, loading may take some
  87. time, as the dock utility executes the !Boot file (or loads the !Sprites
  88. file if there is no !Boot file) of the applications in the dock (if they
  89. have not already be seen by the filer).
  90.  
  91.  
  92. 2.) The ShortCut bar
  93.  
  94. If the horizontal ShortCut bar is not on the screen, you may switch it on
  95. by obtaining the main menu of the apllication dock and choosing
  96. Prefs.ShortCuts.On
  97.  
  98. You may switch to edit mode by clicking Menu over the ShortCut bar and
  99. choosing Edit ... In the 'Edit shortcuts' window, you may browse
  100. through the defined applications by clicking the up/down arrow icons
  101. or you may define a new application by entering its name (the name
  102. shown in the Task Manager display, case sensitive !!) in the 'New
  103. application:' field and clicking the OK button next to it. Defined
  104. applications may be deleted by clicking the 'Delete' button.
  105.   Note that the ShortCut bar displays the shortcuts of the currently
  106. selected application.
  107.   By clicking Menu over one of the rectangular buttons of the ShortCut bar
  108. and following the submenu "ShortCut" you may edit the corresponding shortcut
  109. definition. This can also be achieved by Select-clicking on a shortcut
  110. button.
  111.   You may define the description of the ShortCut to be displayed on the bar
  112. by specifying it next to the text "Action:". Note that the maximum length
  113. for the description is 2 lines of 7 characters. You should leave a space
  114. where you want the lines to be split (e.g. 'Save file'). You may give the
  115. keystroke itself by positioning the caret in the small icon at the right of
  116. the text "ShortCut" and typing the corresponding key combination. You will
  117. hear the system bell and the key code will appear. Clicking on OK defines
  118. the shortcut.
  119.  
  120. Keystrokes which may be used:
  121.   
  122. Accepted keystrokes are generally all which have a RISC OS code:
  123.  * the function keys alone, with Ctrl, with Shift or with Ctrl-Shift
  124.  * all 'normal characters' from the keyboard
  125.  * Ctrl-A to Ctrl-Z (except Ctrl-U), Ctrl-[, Ctrl-], Ctrl-^, Ctrl-~
  126.  * arrow up/down, Ctrl + any of the arrow keys, Shift + arrow up/down
  127.  * some of the codes Alt+letter (not especially useful)
  128.  
  129. Additional keystrokes under RISC OS 3:
  130.  * Ctrl-U
  131.  * Delete, Copy, Shift-Copy, Ctrl-Copy
  132.  * arrow left/right (alone and + Shift)
  133.  
  134. Note that other keystrokes e.g. Ctrl-Shift-letter are not accepted, as
  135. they have no own character code. This is a pity as some programs (e.g.
  136. Impression and DeskEdit) make extensive use of Ctrl-Shift-letter
  137. combinations. However, to "send" such keystrokes to an application, much
  138. more efforts are necessary. This is likely to be added in later versions,
  139. now that the AppDockSpt module is part of the application anyway.
  140.  
  141. The shortcut definition are saved by choosing 'Save all' from one of
  142. the menues.
  143.  
  144.  
  145. 3.) RISC OS 3
  146.  
  147. Former versions of AppDock disappeared if the RISC OS3 pinboard was
  148. switched on. This bug is fixed now. In some intermediate versions the dock
  149. used to come to the front when Shift-F12 was pressed (like the icon bar).
  150. Unfortunately, this caused some problems, so this feature has been removed.
  151.  
  152. Version 2.40 and above offers the following feature instead:
  153. The dock can be toggled between front and back by pressing Alt+Ctrl+Shift.
  154. This feature only works if it is enabled by selecting the corresponding
  155. menu item (Prefs.Front.Alt+Ctrl+Shift). The setting is saved together with
  156. the other options.
  157.  
  158.  
  159. 4.) Upgrading from Version 1 to Version 2
  160.  
  161. Simply copy your old !Dock file to the !AppDock2 directory and it
  162. should work. In the !ShortCuts file there is a basic sets of shortcuts
  163. for !Draw, !Edit !DeskEdit, !Impression and !ArtWorks. You may extend
  164. these, of course.
  165.  
  166.  
  167. 5.) Giving the application away
  168.  
  169. You are strongly advised to distribute AppDock and to give it to any
  170. Archimedes owners you know !
  171.   If you give the application away, it is best to delete the !Dock file,
  172. as the one who receives it will probably have his applications stored in
  173. different places on his hard disc, so if you start the dock containing
  174. your old !Dock file, the dock will complain as it won't find the apps
  175. mentioned in the file.
  176.  
  177. (It is no problem to maintain the shortcuts, as AppDock is not concerned
  178. whether or not you have the applications mentioned in the ShortCuts file).
  179.  
  180.  
  181. This application is FREEWARE, i.e. it may be copied freely, provided that
  182. no part of it is deleted or changed and that it is not sold for profit.
  183.  
  184. Author:
  185.  
  186. Martin Wuerthner
  187. Jahnstrasse 18
  188. D-71116 Gaertringen
  189. Germany
  190.  
  191. Phone:+049-7034-29262
  192. Fax:  +049-7034-21286
  193.  
  194. e-mail: wuerthne@minnie.informatik.uni-stuttgart.de
  195.  
  196.  
  197. Changes: Version 1.04: some bugs fixed
  198.          Version 1.05: now added Mode 20 icons
  199.          Version 1.06: o if a file is dragged to an application on the dock,
  200.                          the application is started with the filename as
  201.                          parameter
  202.                        o should now work better with RO3 as the window is
  203.                          re-opened if Ctrl-F11 is pressed
  204.          Version 1.10: o should now really work better with RO3 as the
  205.                          dock window doesn't disappear after returning
  206.                          from the command line
  207.                        o the dock comes to the front (like the icon bar)
  208.                          if Shift-F12 is pressed
  209.          Version 2.01: o ShortCut bar (automatic detection which app.
  210.                          has the input focus, editing facilities etc.)
  211.                        o new format (still reads version 1 !Dock files)
  212.                        
  213.          (Credits to Graham Hobson for his suggestion of the ShortCut bar)
  214.                          
  215.          Version 2.03: o Now accepts image files (e.g. DOSDisc files) and
  216.                          treats them as directories
  217.          Version 2.10: o Shift-F12-feature removed, as it interferes with
  218.                          the Pinboard (windows vanish if the Desktop is left
  219.                          using F12 while the dock is at the front).
  220.          Version 2.20: o Final version 2, posted to Newcastle
  221.          Version 2.21: o Small bug fix, posted to Newcastle
  222.          Version 2.30: o Wimp_Poll replaced by Wimp_PollIdle to reduce
  223.                          background processing time
  224.                        o Sorry for RISC OS 2 users who were confused because
  225.                          the RO2 sprite pool does not contain the 'up' and
  226.                          'down' arrow sprites which are used in the Edit
  227.                          Shortcuts window. They are now contained in the
  228.                          application's private sprite area
  229.          Version 2.31: o And I wondered why this new feature of RISC OS 3
  230.                          never worked ... I used the validation string N
  231.                          instead of KN, so you could not enter eg Ctrl-U as
  232.                          shortcut. This is now fixed, so under RISC OS 3
  233.                          you have some additional shortcuts (see above)
  234.          Version 2.32: o Now starts the !Run files of applications directly
  235.                          (starting the application itself does not work if
  236.                          it is within an image filing system like SparkFS)
  237.          Version 2.33: o If running under RO3, Filer_Boot is used instead of
  238.                          running the !Boot file of an application
  239.          Version 2.40: o Now detects whether it runs under RO2 or RO3 and
  240.                          uses the RO3 messages list if possible
  241.                        o Dock comes to front if Alt+Ctrl+Shift is pressed
  242.                          and if the feature is enabled. Can be put back by
  243.                          pressing the same combination again.
  244.                          The key press is detected by the AppDockSupport
  245.                          module. Under RO3 this is done via the poll-word
  246.                          feature, i.e. no extra null events are needed.
  247.                          Under RO2 the key status is checked using null
  248.                          events.
  249.                        o bug fixed: if shortcuts were switched off and the
  250.                          settings saved, the shortcuts could not be turned
  251.                          on again after re-loading the dock (gave error)
  252.                        o Clicking on the arrow icons with Menu switches to
  253.                          the very beginning or end of the dock/shortcut bar
  254.                        o In shortcut edit mode, clicking on a shortcut
  255.                          button with Select/Adjust no longer gives an error
  256.                          as it was the case with older versions. Instead,
  257.                          the corresponding 'Edit Shortcut' window is opened.
  258.          Version 2.41: o Adjust click on the dock toggles the shortcut bar
  259.                          status                         
  260.  
  261. Features to add:       o Using outline fonts instead of system font
  262.                        o Supply RISC OS 3 templates
  263.                        o better user interface for shortcut bar edit operation
  264.                        o Dealing with Ctrl-Shift-letter shortcuts
  265.                          (e.g. Ctrl-Shift-I)
  266.                        o re-write everything in C (BASIC is ugly!)
  267.                        o allow files to be placed on the dock and allow them
  268.                          to be dragged to applications
  269.                        o allow dock entries to be dragged to a filer window
  270.                        o many more ...
  271.                        
  272.                          send me suggestions for any additional features !
  273.