home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / lists / gem / l_0799 / 582 < prev    next >
Encoding:
Internet Message Format  |  1994-08-27  |  10.4 KB
  1. Subject: A Proposal For Everyone
  2. Date: Sun, 19 Jun 94 20:01:34 CDT
  3. From: ekl@sdf.lonestar.org
  4. Precedence: bulk
  5.  
  6. In addition to keyboard short-cuts we need standardized panels (dialogs),
  7. standard menu positions, and other such guidelines, like how a block
  8. should be selected, how to select discontinous blocks, application data
  9. linkage (no GEM app currently supports this I believe), and what happens
  10. when you type and a block already exists.  The only way to satify everyone
  11. is to make a standard that can easily be changed.  The NeXT guide specifies
  12. that short-cuts can be changed.  I submit the following based on 3 standards,
  13. in order - Atari Compendium, NeXT Guidelines (an extension of apples), and
  14. finally this list.  You do NOT have to implement everything in here, and
  15. the guideline also specfifies how to NOT use the guideline!   Also, the
  16. APP_DEFS.SYS file mentioned here and options such as the block=big-cursor
  17. and other weirdness, or country-specific options and such should be
  18. supplied in here.  The user should be able to configure everything globally
  19. and should be be able to configure each app separately if he/she so desires.
  20. We also need to discuss mouse pointers and cursor types, and it is possible
  21. that these would be in the APP_DEFS.SYS too!
  22.  
  23. Function Keys are app-dependant, normally used for macros or execution of
  24. external programs.  Possible are normal, shift, control, alt, shift/control,
  25. shift/alt, but NOT any combination of with alt and control at once.
  26.  
  27. ===========================================================================
  28.  
  29. The following is based on the NeXTStep User Interface Guidelines 3.2
  30. Chapter 3: User Actions: The Keyboard and Mouse.  It assumes that user
  31. preferences are stored in the APP_DEFS.SYS file which is searched for
  32. in the following directories, in order, "U:\etc", "C:\multitos", "C:\mint",
  33. "C:\system", "C:\", and finally the current working directory.  "A:"
  34. should be substituted for "C:" if the user booted from floppy.  Also, the
  35. current working directory will be searched even if the file is already
  36. found in another directory and these settings will over-ride settings
  37. previously found.
  38.  
  39. Choosing Keyboard Alternatives
  40.  
  41. Initially, until the user specifies a different preference, applications
  42. should follow the guidelines for keyboard alternatives described in this
  43. section.  Users can use the Preferences application to alter the keyboard
  44. alternatives for every application at once.  You're also encouraged to let
  45. the user choose and change keyboard alternatives using your application's
  46. Preferences panel.
  47.  
  48. Some sort of "Preferences" application should be generated by the gem-list.
  49. To change the global preferences, run the app, and to change the preferences
  50. of a specific application, pass that application's name on the command line.
  51. This can be run from another GEM application, concurrently if your AES allows
  52. it to provide a consistent interface for editing the APP-DEFS.SYS file.
  53. A global usage "Install" application could also set paths and options in
  54. this file as well as copy the files to the proper destination, make
  55. directories, install icons in the desktop RSC file, and also de-install
  56. all these options and icons and delete the proper files when needed.
  57. By allowing the user to change keys globally he can conform best to the
  58. application/standards that he uses most, so if he want to have ^U close
  59. a window the user can change it himself (although he will have to find
  60. a new key for underline!)
  61.  
  62. Code will also be provided (possibly a whole library) for parsing the file
  63. and for utilizing the information contained within.
  64.  
  65. The guidelines place keyboard alternatives into three groups--reserved,
  66. required, and recommended.  These groups are listed in the tables that fol-
  67. low along with the commands they perform and the menus where the commands
  68. are located.
  69.  
  70. Note that "Command" is normally CONTROL, but the user may choose to use
  71. ALT instead by specifying such in the APP_DEFS.SYS file.  Terminal programs
  72. should over-ride these settings in an application specific line so that
  73. ALT is used as the Command key by default.  Capital letters denote holding
  74. SHIFT, the space in a menu is limited, and using an up-arrow is redundant.
  75. In menus, the caret "^" denotes CONTROL and the window closer should be used
  76. for ALT, and an equivalence character (ascii 240) in a boxchar object should
  77. be used for drop-down lists.  The use of the word "panel" refers to a
  78. a standardized dialog which the gem-list should provide code and RSCs for.
  79. The right arrow shows a cascading menu, the delete character (the delta) is
  80. for the iconify/miniturize gadget and buttons that show >> expand the dialog
  81. while << shortens a dialog (for advanced and novice user options).
  82.  
  83.  
  84. Reserved Keyboard Alternatives
  85.  
  86. Reserved keyboard alternatives must be used for the commands that follow,
  87. and cannot be used for any others.  If your application implements the
  88. functionality that a command represents, it must provide both the command
  89. and the keyboard alternative.
  90.  
  91. For example, if your application opens files, it must have an Open command
  92. with Command-o as the keyboard alternative.  If your application doesn't
  93. allow the user to open files, it won't have an Open command and must not
  94. use Command-o as a keyboard alternative.
  95.  
  96. Keyboard             Command              Menu
  97. ------------------------------------------------------
  98. help             Access Help              Help
  99. HELP             Context-senstive Help    Help
  100. undo             Undo last command        Edit
  101. UNDO             Redo last command        Edit
  102. Command-undo     Multi-level undo         Edit
  103. Command-UNDO     Step-wise undo           Edit
  104. Command-a        Select All               Edit
  105. Command-A        De-select All            Edit
  106. Command-c        Copy                     Edit
  107. Command-h        Hide                     File
  108. Command-n        New                      File
  109. Command-o        Open                     File
  110. Command-p        Print                    File
  111. Command-q        Quit                     File
  112. Command-s        Save                     File
  113. Command-v        Paste                    Edit
  114. Command-w        Close                    File
  115. Command-W        Abandon + Reload         File
  116. Command-x        Cut                      Edit
  117. ALT-tab          Cycle Apps               <<reserved in MultiTOS>>
  118. ^ tab            Cycle Object Selection   <<no menu>>
  119. SHIFT-tab        Cycle Windows            Window
  120. tab              type-writer style tab    <<no menu>>
  121. ^ ALT \          Emergeny Kill App!       <<reserved in MiNT/MultiTOS>>
  122.  
  123. << note multi-level undo will undo each command in the buffer for each
  124.    press of the hot-key.  step-wise undo will let you undo a specific
  125.    command in the buffer.                                              >>
  126.  
  127. Required Keyboard Alternatives
  128.  
  129. These keyboard alternatives must be used if the application implements the
  130. command.  For example, if your application has a Find panel, you must pro-
  131. vide Command-f as a way of bringing the panel up.
  132.  
  133. However, if an application doesn't implement the particular functionality
  134. of an item (if it doesn't have a Find panel, for example), it can use the
  135. keyboard alternative (Command-f) for something else.  Nevertheless, to pre-
  136. serve interapplication consistency, it's strongly recommended that you
  137. first try to use characters that don't overlap with those on this list.
  138.  
  139.  
  140. Keyboard             Command              Menu
  141. ------------------------------------------------------
  142. Command-=        Define in Dictionary     Text
  143. Command-;        Check Spelling           Text
  144. Command-b        Bold (Unbold)            Style
  145. Command-d        Find Previous            Edit
  146. Command-e        Enter Selection          Edit
  147. Command-f        Find Panel               Edit
  148. Command-g        Find Next                Edit
  149. Command-i        Italic (Unitalic)        Style
  150. Command-t        Font Panel               Style
  151. Command-u        Underline (un-underline) Style
  152. Command-C        Append to Clipboard      Edit
  153. Command-I        Show Info                File
  154. Command-V        Insert File              Edit
  155. Command-K        Colors                   Style
  156. Command-F        Find & Replace           Edit
  157. Command-bksp     Delete word to left      <<none>>
  158. Command-del      Delete word to right     <<none>>
  159. ^ arrow          Move left/right one word <<none>>
  160. ^ clrhome        Move to start of doc.    <<none>>
  161. SHIFT-left       Move to begin. of line   <<none>>
  162. SHIFT-right      Move to end of line      <<none>>
  163. SHIFT-up         Move up one page         <<none>>
  164. SHIFT-down       Move down one page       <<none>>
  165. SHIFT-del        Delete line              <<none>>
  166. SHIFT-clrhome    Move to end of document  <none>>
  167. arrow            Move one char left/right <<none>>
  168. clrhome          Move to top of window    <<none>>
  169. bksp             Delete to left of cursor <<none>>
  170. del              Delete right of cursor   <<none>>
  171. insert           Toggle insert/overwrite  <<none>>
  172.  
  173. << note find next and find previous are also replace next and replace
  174.    previous if you used find & replace instead of find.               >>
  175.  
  176. Recommended Keyboard Alternatives
  177.  
  178. These keyboard alternatives must be used for a command if the command has a
  179. keyboard alternative.  If not, the key can be used for some other command.
  180. For example, if the Copy Ruler command has no keyboard alternative, Com-
  181. mand-1 can be used as a keyboard alternative for another command.
  182.  
  183.  
  184. Keyboard             Command              Menu
  185. ------------------------------------------------------
  186. Command-1        Copy  Ruler              Text
  187. Command-2        Paste Ruler              Text
  188. Command-3        Copy Font                Style
  189. Command-4        Paste Font               Style
  190. Command-j        Jump to Selection        Edit
  191. Command-l        Redraw Screen            Window
  192. Command-m        Miniaturize Window       Window
  193. Command-r        Show Ruler               Text
  194. Command-B        Set Block-Start          Edit
  195. Command-E        Set Block-End            Edit
  196. Command-P        Page Layout              File
  197. Command-S        Save As                  File
  198. Command-L        Paste and Link           Link
  199. Command-M        Miniturize All Windows   Window
  200.  
  201. <<note if redraw screen is supported, just turn on and off your menu with
  202.        the menu bar command and then call form_dial for the whole screen
  203.        and the AES will send all the proper redraw messages               >>
  204.  
  205.  
  206.  
  207. In Dialog Boxes
  208. ---------------
  209. Return -                OK, Yes, etc...
  210. Undo -                  Cancel, Abort, etc...
  211.  
  212. Other buttons should be available via ALT+<x> as in Let 'em Fly. Editable
  213. text fields should follow the standard as above.
  214.  
  215.  
  216.  
  217.