home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / donkey.zip / donkey.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-06-19  |  24KB  |  570 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ
  3.  
  4. DonKey is (c) Martin Lafaix 1994, 1995. 
  5.  
  6. Author: Martin Lafaix 
  7. Address: 
  8.  
  9.     16, rue de Dijon
  10.     06000 Nice
  11.     France
  12.  
  13.     email: lafaix@mimosa.unice.fr
  14.  
  15.  
  16. ΓòÉΓòÉΓòÉ 2. Disclaimer ΓòÉΓòÉΓòÉ
  17.  
  18.  Since this program is free, it is supplied with no warranty, either expressed 
  19. or implied.  I am not responsible for any damage caused directly or indirectly 
  20. by DonKey or any of the tools.  I did my best to avoid errors and bugs, but I 
  21. do not claim to have an error free program.  All software is supplied AS IS. 
  22. You may use these programs only at your own risk. 
  23.  
  24.  
  25. ΓòÉΓòÉΓòÉ 3. Donkey Daemon ΓòÉΓòÉΓòÉ
  26.  
  27.  This is the Donkey Daemon.  It has been installed by the Donkey package. 
  28.  
  29.  This daemon is used to set the initial keyboard state, and to install the 
  30.  required hook.  If the daemon does not have to install a hook, it removes 
  31.  itself from memory, so that it does not take any system resources. 
  32.  
  33.  A hook is required if you use any of the following features: 
  34.  
  35.  o ShiftLock 
  36.  o Sticky modifiers 
  37.  o Sounds 
  38.  
  39.  If you want to change the daemon settings, use the Donkey object in your 
  40.  System Setup folder. 
  41.  
  42.  
  43. ΓòÉΓòÉΓòÉ 4. Keyboard Layout ΓòÉΓòÉΓòÉ
  44.  
  45. This file is a keyboard layout.  If you want to make it the current keyboard 
  46. layout, you first have to drag it over the Current Active Layout container on 
  47. the Layout page of the Donkey Settings notebook. 
  48.  
  49. The Donkey object is normally located in your System Setup folder. 
  50.  
  51. See also: 
  52.  
  53.  o Donkey Daemon 
  54.  o Donkey object 
  55.  o Direct Manipulation 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 5. Drop Help ΓòÉΓòÉΓòÉ
  59.  
  60. Drop a layout over the Current Active Layout container to add a new keyboard 
  61. layout in the system.  To make this layout the default one, select it. 
  62.  
  63. You cannot drop a file over this container unless it has the Keyboard Layout 
  64. style.  If you're sure one of your file is a keyboard layout but it hasn't the 
  65. required style, open its Settings notebook, and assign the correct style/type. 
  66.  
  67.  
  68. ΓòÉΓòÉΓòÉ 6. New Layout Name ΓòÉΓòÉΓòÉ
  69.  
  70. Use this action window to enter a new name for the dropped layout. A valid name 
  71. must have at least two, but no more than six characters. 
  72.  
  73. Select OK to accept the new name.  Select Cancel to cancel the drop operation. 
  74.  
  75.  
  76. ΓòÉΓòÉΓòÉ 7. DonKey ΓòÉΓòÉΓòÉ
  77.  
  78.  Use this notebook to specify the keyboard behavior/layout. Double-click on one 
  79.  of the following to receive additional help on the pages of the notebook. 
  80.  
  81.  o Keyboard Behavior Settings (page 1) 
  82.  o Keyboard Behavior Settings (page 2) 
  83.  o Layout Settings 
  84.  o Hot Keys Settings 
  85.  o Sounds Settings 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 8. Keyboard Behavior Settings ΓòÉΓòÉΓòÉ
  89.  
  90.  Use this page of the Donkey settings notebook to specify the settings related 
  91.  to the keyboard behavior.  The CapsLock key behavior will have an immediate 
  92.  effect, while the initial keyboard state will only takes effect on next 
  93.  startup. 
  94.  
  95.  For a detailed explanation of each field, select from the list below: 
  96.  
  97.  o Toggle Caps State 
  98.  o Set Caps On 
  99.  o CapsLock On/Off 
  100.  o NumLock On/Off 
  101.  o ScrollLock On/Off 
  102.  o Undo 
  103.  o Default 
  104.  
  105.  
  106. ΓòÉΓòÉΓòÉ 8.1. Toggle Caps State ΓòÉΓòÉΓòÉ
  107.  
  108.  Select this radio button if you want your CapsLock key to act as a switch 
  109.  between Caps On and Caps Off.  Pressing the CapsLock key once sets Caps On 
  110.  (new text is interpreted as Uppercase, and the Shift keys temporarily reverse 
  111.  the Caps state).  Pressing it once more sets Caps Off again (new text is 
  112.  interpreted as Lowercase, and the Shift key temporarily sets Caps On while 
  113.  active).  Compare with Set Caps. 
  114.  
  115.  This CapsLock key behavior is the default one for almost all countries with 
  116.  the notable exception of Belgium, France and Germany. 
  117.  
  118.  See also: 
  119.  
  120.  o Set Caps On 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 8.2. Set Caps On ΓòÉΓòÉΓòÉ
  124.  
  125.  Select this radio button if you want your CapsLock key to act as a Shift Lock. 
  126.  Pressing the CapsLock key is equivalent as holding down a Shift key.  To 
  127.  unlock it, press a Shift key (pressing the CapsLock key more than once does 
  128.  nothing - it does not unlock the Shift state).  Compare with Toggle Caps 
  129.  State. 
  130.  
  131.  This CapsLock key behavior is the default one for Belgium, France and Germany. 
  132.  
  133.  Note:  There's a bug regarding this key's behavior in Warp (all version).  The 
  134.  Donkey Daemon, if running, takes care of it. 
  135.  
  136.  When Sticky modifiers are enabled, you have to press the Shift key twice to 
  137.  unlock the Shift State.  If you prefer the alternative of pressing it only 
  138.  once, please drop me a note saying so.  Thank you! 
  139.  
  140.  See also: 
  141.  
  142.  o Toggle Caps State 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ 8.3. CapsLock On/Off ΓòÉΓòÉΓòÉ
  146.  
  147.  Select the On radio button if you want the CapsLock key to be activated on 
  148.  bootup (it's equivalent as pressing it once after IPL). 
  149.  
  150.  Select the Off radio button if you don't want that (it's the default action). 
  151.  
  152.  See also: 
  153.  
  154.  o NumLock On/Off 
  155.  o ScrollLock On/Off 
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 8.4. NumLock On/Off ΓòÉΓòÉΓòÉ
  159.  
  160.  Select the On radio button if you want the NumLock key to be activated on 
  161.  bootup (it's equivalent as pressing it once after IPL). 
  162.  
  163.  Select the Off radio button if you don't want that (it's the default action). 
  164.  
  165.  See also: 
  166.  
  167.  o CapsLock On/Off 
  168.  o ScrollLock On/Off 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ 8.5. ScrollLock On/Off ΓòÉΓòÉΓòÉ
  172.  
  173.  Select the On radio button if you want the ScrollLock key to be activated on 
  174.  bootup (it's equivalent as pressing it once after IPL). 
  175.  
  176.  Select the Off radio button if you don't want that (it's the default action). 
  177.  
  178.  See also: 
  179.  
  180.  o CapsLock On/Off 
  181.  o NumLock On/Off 
  182.  
  183.  
  184. ΓòÉΓòÉΓòÉ 9. Layout Settings ΓòÉΓòÉΓòÉ
  185.  
  186. Use this page of the Donkey settings notebook to specify the keyboard layout to 
  187. use. 
  188.  
  189. Selecting a new keyboard layout will immediately change the layout used in all 
  190. sessions, and the change will be preserved over shutdown. 
  191.  
  192. For a detailed explanation of each field, select from the list below: 
  193.  
  194.  o Keyboard Type 
  195.  o Keyboard Model 
  196.  o Current Active Layout 
  197.  o Undo 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 9.1. Keyboard Type ΓòÉΓòÉΓòÉ
  201.  
  202.  This field displays the current keyboard type, which is one of the following: 
  203.  
  204.  o PC AT Keyboard 
  205.  o Enhanced Keyboard 
  206.  o Unknown Keyboard Type (xxxx) 
  207.  
  208.  Note:  If your keyboard type is unknown, it would be great if you could send 
  209.  me a description of it, along with the value of the Keyboard Type and Keyboard 
  210.  Model fields. 
  211.  
  212.  See also: 
  213.  
  214.  o Keyboard Model 
  215.  o Current Active Layout 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 9.2. Keyboard Model ΓòÉΓòÉΓòÉ
  219.  
  220.  This field displays the current keyboard model, which is one of the following: 
  221.  
  222.  o PC AT Standard Keyboard 
  223.  o 101/102 Key Enhanced Keyboard 
  224.  o 88/89 Key Enhanced Keyboard 
  225.  o 122 Key Mainframe Interactive (MFI) Keyboard 
  226.  o Unknown Keyboard ID (yyyy) 
  227.  
  228.  Note:  If your keyboard model is unknown, it would be great if you could send 
  229.  me a description of it, along with the value of the Keyboard Type and Keyboard 
  230.  Model fields. 
  231.  
  232.  See also: 
  233.  
  234.  o Keyboard Type 
  235.  o Current Active Layout 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 9.3. Current Active Layout ΓòÉΓòÉΓòÉ
  239.  
  240.  Use this container to specify the keyboard layout to use for this and all 
  241.  upcoming sessions. 
  242.  
  243.  You can do any of the following: 
  244.  
  245.  o Make a keyboard layout the default one, by selecting it; 
  246.  o Add a keyboard layout to the system database, by dropping a keyboard layout 
  247.    object in this container; 
  248.  o Copy a keyboard layout to your desktop, by dragging the keyboard layout 
  249.    object to your desktop; 
  250.  o Delete a keyboard layout, by either selecting Delete from the object's popup 
  251.    menu or dragging it into the shredder (but you cannot delete the current 
  252.    keyboard layout object, which has the selected emphasis); 
  253.  o Edit a keyboard layout, by either selecting Settings from the object's popup 
  254.    menu or opening it; 
  255.  o Rename a keyboard layout, by using either Alt+Left click or Shift+F9. 
  256.  
  257.  For a detailed explanation of each parts of the Current Active Layout 
  258.  Container, select it in the picture below: 
  259.  
  260.  See also: 
  261.  
  262.  o Keyboard Type 
  263.  o Keyboard Model 
  264.  o Keyboard Layout Object 
  265.  o Limited Keyboard Layout Object 
  266.  o Keyboard Layout Container 
  267.  
  268.  
  269. ΓòÉΓòÉΓòÉ 9.3.1. Keyboard Layout Object ΓòÉΓòÉΓòÉ
  270.  
  271.  This object represents a keyboard layout - something that maps all physical 
  272.  keys with a logical value.  Like all objects, it can be moved, renamed, 
  273.  deleted, etc. 
  274.  
  275.  Select this object to make it the default active layout. 
  276.  
  277.  You can open it to view/edit its contents, or you can use standard techniques 
  278.  to move/rename/delete/etc. it.  The object's own popup menu allows you to open 
  279.  its settings view, or to delete it. 
  280.  
  281.  See also: 
  282.  
  283.  o Limited Keyboard Layout Object 
  284.  
  285.  
  286. ΓòÉΓòÉΓòÉ 9.3.2. Limited Keyboard Layout Object ΓòÉΓòÉΓòÉ
  287.  
  288.  This object represents a keyboard layout - something that maps all physical 
  289.  keys with a logical value.  Like all objects, it can be moved, renamed, 
  290.  deleted, etc. 
  291.  
  292.  Select this object to make it the default active layout. 
  293.  
  294.  You can open it to view/edit its contents, or you can use standard techniques 
  295.  to move/rename/delete/etc. it.  The object's own popup menu allows you to open 
  296.  its settings view, or to delete it. 
  297.  
  298.  Note:     This layout may give unexpected results with one or both of your 
  299.            currently prepared codepages.  It is in that sense it is a "Limited" 
  300.            keyboard object.  Making it the current layout does not guarantees 
  301.            to map each physical key to a meaningful value. 
  302.  
  303.            When you select such a layout, an audible clue is emitted (but it 
  304.            nonetheless becomes the current layout). 
  305.  
  306.  See also: 
  307.  
  308.  o Keyboard Layout Object 
  309.  
  310.  
  311. ΓòÉΓòÉΓòÉ 9.3.3. Current Active Layout Container ΓòÉΓòÉΓòÉ
  312.  
  313. This container contains the keyboard layouts currently available in the system. 
  314.  
  315. Drag a layout object to this container to add a new layout in the system 
  316. database.  You have to select it to make it active. 
  317.  
  318.  
  319. ΓòÉΓòÉΓòÉ 9.3.4. Scroll Bar ΓòÉΓòÉΓòÉ
  320.  
  321. Use this Scroll Bar to quickly move through the container. 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 9.3.5. Keyboard Layout Name ΓòÉΓòÉΓòÉ
  325.  
  326. This is the name (and codepage) of the keyboard layout object.  You can edit it 
  327. by using the standard CUA manipulation ; namely, Alt+Left Click or Shift+F9 if 
  328. you don't have redefine them via the Keyboard object in the System Setup 
  329. folder. 
  330.  
  331. Keyboard Layouts objects are maintained in the alphabetical order within the 
  332. Keyboard Layout Container. 
  333.  
  334. A Keyboard Layout Name cannot have more than six symbols (letter or digit). 
  335. All letters must be in upper case. 
  336.  
  337. If it's the name of a Limited keyboard Layout object, the codepage tells you 
  338. which codepage will be assumed for the layout.  If it differs from the current 
  339. one, you may have unexpected results when entering diacritics chars. 
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 10. Keyboard Behavior Settings ΓòÉΓòÉΓòÉ
  343.  
  344.  Use this page of the Donkey settings notebook to specify the modifier's keys 
  345.  behavior.  A modifier key is a key which temporarily alter the state of the 
  346.  keyboard.  Such keys are Shift and Ctrl.  By default theses keys only have 
  347.  their effect while holded down, but this may be inadequate for physically 
  348.  challenged people, so, this page allows one to define a "sticky" behavior. 
  349.  
  350.  When the "sticky modifier" behavior is enabled, the alteration caused by the 
  351.  modifier is maintained until another key is pressed (or until a certain amount 
  352.  of time elapses).  If a modifier key has been mistakenly activated, pressing 
  353.  it again will cancel its effect. 
  354.  
  355.  A somewhat different behavior can be assigned to modifiers keys via the 
  356.  "Special Needs" page of the Keyboard object. 
  357.  
  358.  Warning: It does not work in fullscreen sessions. 
  359.  
  360.  For a detailed explanation of each field, select from the list below: 
  361.  
  362.  o Sticky Modifiers 
  363.  o Delay before inactivation 
  364.  o Audible Clue 
  365.  o Undo 
  366.  o Default 
  367.  
  368.  
  369. ΓòÉΓòÉΓòÉ 10.1. Sticky Modifiers ΓòÉΓòÉΓòÉ
  370.  
  371.  Select the On radio button to enable sticky modifiers.  If special settings 
  372.  were previously specified, they are reactivated. 
  373.  
  374.  Select the Off radio button to disable sticky modifiers.  Special settings are 
  375.  deactivated, but their values are preserved. 
  376.  
  377.  See also: 
  378.  
  379.  o Delay before inactivation 
  380.  o Audible clue 
  381.  
  382.  
  383. ΓòÉΓòÉΓòÉ 10.2. Delay before inactivation ΓòÉΓòÉΓòÉ
  384.  
  385.  Move the slider arm to specify the inactivation delay duration, in seconds. 
  386.  If a modifier key is pressed, and no other keys are pressed during the 
  387.  inactivation delay, the alteration caused by the modifier is canceled. 
  388.  
  389.  Specifying a null inactivation delay (ie, 0 seconds) means in fact an infinite 
  390.  inactivation delay.  In other words, doing so disables the inactivation delay 
  391.  feature. 
  392.  
  393.  See also: 
  394.  
  395.  o Sticky modifiers 
  396.  o Audible clue 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 10.3. Audible Clue ΓòÉΓòÉΓòÉ
  400.  
  401.  Select this check box to have tune being emitted each time a modifier key is 
  402.  used.  A high-frequency tune is emitted when the modifier key is activated, 
  403.  and a low-frequency tune is emitted if you press the modifier key again to 
  404.  deactivate it. 
  405.  
  406.  See also: 
  407.  
  408.  o Sticky modifiers 
  409.  o Delay before inactivation 
  410.  
  411.  
  412. ΓòÉΓòÉΓòÉ 11. Typewriter Layout ΓòÉΓòÉΓòÉ
  413.  
  414.  Use this page of the Layout settings notebook to view/edit the typewriter 
  415.  layout.  When typing data in the Test area, the pressed keys will be 
  416.  highlighted, and the layout display will reflect the corresponding values. 
  417.  That is, if you press the Shift key, the layout display will show the 
  418.  uppercase layout (or lowercase, if CapsLock is On). 
  419.  
  420.  For a detailed explanation of each field, select from the list below: 
  421.  
  422.  o Test 
  423.  o Undo 
  424.  o Default 
  425.  
  426.  
  427. ΓòÉΓòÉΓòÉ 12. Cursor and Numpad Layout ΓòÉΓòÉΓòÉ
  428.  
  429.  Use this page of the Layout settings notebook to view/edit the cursor and 
  430.  numpad layout.  When typing data in the Test area, the pressed keys will be 
  431.  highlighted, and the layout display will reflect the corresponding values. 
  432.  That is, if you press the Shift key, the layout display will show the 
  433.  uppercase layout (or lowercase, if CapsLock is On). 
  434.  
  435.  For a detailed explanation of each field, select from the list below: 
  436.  
  437.  o Test 
  438.  o Undo 
  439.  o Default 
  440.  
  441.  
  442. ΓòÉΓòÉΓòÉ 13. Miscellaneous Layout Flags ΓòÉΓòÉΓòÉ
  443.  
  444.  Use this page of the Layout settings notebook to set the layout's flags.  It 
  445.  allows you to specify which Alt keys to use as the AltGr one, if accent keys 
  446.  are allowed, and other such miscellaneous flags. 
  447.  
  448.  For a detailed explanation of each field, select from the list below: 
  449.  
  450.  o ShiftAlt 
  451.  o AltGrL 
  452.  o AltGrR 
  453.  o DefaultTable 
  454.  o AccentPass 
  455.  o CapsShift 
  456.  o MachDep 
  457.  o RTL 
  458.  o LangSel 
  459.  o DefaultLayout 
  460.  o ShiftLock 
  461.  o ShiftToggle 
  462.  o Undo 
  463.  o Default 
  464.  
  465.  
  466. ΓòÉΓòÉΓòÉ 14. Hot Keys Settings ΓòÉΓòÉΓòÉ
  467.  
  468.  Use this page of the Donkey settings notebook to specify the recognized 
  469.  hotkeys. 
  470.  
  471.  For a detailed explanation of each field, select from the list below: 
  472.  
  473.  o Session Manager Hot Keys 
  474.  o Add 
  475.  o Edit 
  476.  o Remove 
  477.  o Undo 
  478.  o Default 
  479.  
  480.  
  481. ΓòÉΓòÉΓòÉ 15. Sounds Settings ΓòÉΓòÉΓòÉ
  482.  
  483.  Use this page of the Donkey settings notebook to specify the sound to produce 
  484.  upon key presses.  No sound is produced in fullscreen sessions. 
  485.  
  486.  For a detailed explanation of each field, select from the list below: 
  487.  
  488.  o Key Down 
  489.  o Key Up 
  490.  o Auto repeat 
  491.  o Keyboard Sounds 
  492.  o Undo 
  493.  o Default 
  494.  
  495.  
  496. ΓòÉΓòÉΓòÉ 15.1. Key Down ΓòÉΓòÉΓòÉ
  497.  
  498. If Keyboard Sounds is set to On, the specified sound is emitted each time a key 
  499. is pressed. 
  500.  
  501. Setting the duration to 0ms will prevent the sound to be emitted when a key is 
  502. pressed. 
  503.  
  504. The frequency is given in Hertz and must be between 37 and 32767hz, while the 
  505. duration is given in milli-seconds. 
  506.  
  507.  
  508. ΓòÉΓòÉΓòÉ 15.2. Key Up ΓòÉΓòÉΓòÉ
  509.  
  510. If Keyboard Sounds is set to On, the specified sound is emitted each time a key 
  511. is released. 
  512.  
  513. Setting the duration to 0ms will prevent the sound to be emitted when a key is 
  514. released. 
  515.  
  516. The frequency is given in Hertz and must be between 37 and 32767hz, while the 
  517. duration is given in milli-seconds. 
  518.  
  519.  
  520. ΓòÉΓòÉΓòÉ 15.3. Auto repeat ΓòÉΓòÉΓòÉ
  521.  
  522. If Keyboard Sounds is set to On, the specified sound is emitted each time a key 
  523. is auto repeated. 
  524.  
  525. Setting the duration to 0ms will prevent the sound to be emitted when a key is 
  526. auto repeated. 
  527.  
  528. The frequency is given in Hertz and must be between 37 and 32767hz, while the 
  529. duration is given in milli-seconds. 
  530.  
  531.  
  532. ΓòÉΓòÉΓòÉ 15.4. Keyboard Sounds ΓòÉΓòÉΓòÉ
  533.  
  534. Enable or Disable sounds for all key-events.  If sets to Off, no sound is 
  535. produced when a key event occurs.  Otherwise, a sound is produced for events 
  536. with an non-null sound duration. 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ 16. Undo button ΓòÉΓòÉΓòÉ
  540.  
  541. Select Undo to return the settings to those that were active before this window 
  542. was displayed. 
  543.  
  544.  
  545. ΓòÉΓòÉΓòÉ 17. Default button ΓòÉΓòÉΓòÉ
  546.  
  547. Press this button to configure the settings on this window to their default 
  548. value. 
  549.  
  550.  
  551. ΓòÉΓòÉΓòÉ <hidden> Secret screen ΓòÉΓòÉΓòÉ
  552.  
  553. This program is NOT dedicated to the guy who introduces the ShiftLock bug in 
  554. Warp. 
  555.  
  556. This program is NOT dedicated to the guy who is responsible of the fact that 
  557. this bug has not been fixed in Warp Fullpack and in Warp Connect. 
  558.  
  559. This program is NOT dedicated to the guy who wrote the EA part of the Control 
  560. Program Guide and Reference. 
  561.  
  562. OK, enough said on that :-) 
  563.  
  564. And now, I'll have to find a nice thing to put here.  Mmm, maybe a picture or 
  565. something like that... 
  566.  
  567. BTW, has anyone notice the fact that the CITY.PCX picture (included with the 
  568. Multimedia Viewer) represents the Gordon Biersh (sp?) restaurant?  Their 
  569. "unfiltered beer", as well as their food, is excellent, IMHO.  But I digress 
  570. :-)