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