OS/2 Shareware BBS: SysTools/SysTools.zip/donkey.zip/donkey.HLP

OS/2 Help File | 1995-06-19 | 24KB | 570 lines

ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ

DonKey is (c) Martin Lafaix 1994, 1995.

Author: Martin Lafaix
Address:

    16, rue de Dijon
    06000 Nice
    France

    email: [e-mail]


ΓòÉΓòÉΓòÉ 2. Disclaimer ΓòÉΓòÉΓòÉ

 Since this program is free, it is supplied with no warranty, either expressed
or implied.  I am not responsible for any damage caused directly or indirectly
by DonKey or any of the tools.  I did my best to avoid errors and bugs, but I
do not claim to have an error free program.  All software is supplied AS IS.
You may use these programs only at your own risk.


ΓòÉΓòÉΓòÉ 3. Donkey Daemon ΓòÉΓòÉΓòÉ

 This is the Donkey Daemon.  It has been installed by the Donkey package.

 This daemon is used to set the initial keyboard state, and to install the
 required hook.  If the daemon does not have to install a hook, it removes
 itself from memory, so that it does not take any system resources.

 A hook is required if you use any of the following features:

 o ShiftLock
 o Sticky modifiers
 o Sounds

 If you want to change the daemon settings, use the Donkey object in your
 System Setup folder.


ΓòÉΓòÉΓòÉ 4. Keyboard Layout ΓòÉΓòÉΓòÉ

This file is a keyboard layout.  If you want to make it the current keyboard
layout, you first have to drag it over the Current Active Layout container on
the Layout page of the Donkey Settings notebook.

The Donkey object is normally located in your System Setup folder.

See also:

 o Donkey Daemon
 o Donkey object
 o Direct Manipulation


ΓòÉΓòÉΓòÉ 5. Drop Help ΓòÉΓòÉΓòÉ

Drop a layout over the Current Active Layout container to add a new keyboard
layout in the system.  To make this layout the default one, select it.

You cannot drop a file over this container unless it has the Keyboard Layout
style.  If you're sure one of your file is a keyboard layout but it hasn't the
required style, open its Settings notebook, and assign the correct style/type.


ΓòÉΓòÉΓòÉ 6. New Layout Name ΓòÉΓòÉΓòÉ

Use this action window to enter a new name for the dropped layout. A valid name
must have at least two, but no more than six characters.

Select OK to accept the new name.  Select Cancel to cancel the drop operation.


ΓòÉΓòÉΓòÉ 7. DonKey ΓòÉΓòÉΓòÉ

 Use this notebook to specify the keyboard behavior/layout. Double-click on one
 of the following to receive additional help on the pages of the notebook.

 o Keyboard Behavior Settings (page 1)
 o Keyboard Behavior Settings (page 2)
 o Layout Settings
 o Hot Keys Settings
 o Sounds Settings


ΓòÉΓòÉΓòÉ 8. Keyboard Behavior Settings ΓòÉΓòÉΓòÉ

 Use this page of the Donkey settings notebook to specify the settings related
 to the keyboard behavior.  The CapsLock key behavior will have an immediate
 effect, while the initial keyboard state will only takes effect on next
 startup.

 For a detailed explanation of each field, select from the list below:

 o Toggle Caps State
 o Set Caps On
 o CapsLock On/Off
 o NumLock On/Off
 o ScrollLock On/Off
 o Undo
 o Default


ΓòÉΓòÉΓòÉ 8.1. Toggle Caps State ΓòÉΓòÉΓòÉ

 Select this radio button if you want your CapsLock key to act as a switch
 between Caps On and Caps Off.  Pressing the CapsLock key once sets Caps On
 (new text is interpreted as Uppercase, and the Shift keys temporarily reverse
 the Caps state).  Pressing it once more sets Caps Off again (new text is
 interpreted as Lowercase, and the Shift key temporarily sets Caps On while
 active).  Compare with Set Caps.

 This CapsLock key behavior is the default one for almost all countries with
 the notable exception of Belgium, France and Germany.

 See also:

 o Set Caps On


ΓòÉΓòÉΓòÉ 8.2. Set Caps On ΓòÉΓòÉΓòÉ

 Select this radio button if you want your CapsLock key to act as a Shift Lock.
 Pressing the CapsLock key is equivalent as holding down a Shift key.  To
 unlock it, press a Shift key (pressing the CapsLock key more than once does
 nothing - it does not unlock the Shift state).  Compare with Toggle Caps
 State.

 This CapsLock key behavior is the default one for Belgium, France and Germany.

 Note:  There's a bug regarding this key's behavior in Warp (all version).  The
 Donkey Daemon, if running, takes care of it.

 When Sticky modifiers are enabled, you have to press the Shift key twice to
 unlock the Shift State.  If you prefer the alternative of pressing it only
 once, please drop me a note saying so.  Thank you!

 See also:

 o Toggle Caps State


ΓòÉΓòÉΓòÉ 8.3. CapsLock On/Off ΓòÉΓòÉΓòÉ

 Select the On radio button if you want the CapsLock key to be activated on
 bootup (it's equivalent as pressing it once after IPL).

 Select the Off radio button if you don't want that (it's the default action).

 See also:

 o NumLock On/Off
 o ScrollLock On/Off


ΓòÉΓòÉΓòÉ 8.4. NumLock On/Off ΓòÉΓòÉΓòÉ

 Select the On radio button if you want the NumLock key to be activated on
 bootup (it's equivalent as pressing it once after IPL).

 Select the Off radio button if you don't want that (it's the default action).

 See also:

 o CapsLock On/Off
 o ScrollLock On/Off


ΓòÉΓòÉΓòÉ 8.5. ScrollLock On/Off ΓòÉΓòÉΓòÉ

 Select the On radio button if you want the ScrollLock key to be activated on
 bootup (it's equivalent as pressing it once after IPL).

 Select the Off radio button if you don't want that (it's the default action).

 See also:

 o CapsLock On/Off
 o NumLock On/Off


ΓòÉΓòÉΓòÉ 9. Layout Settings ΓòÉΓòÉΓòÉ

Use this page of the Donkey settings notebook to specify the keyboard layout to
use.

Selecting a new keyboard layout will immediately change the layout used in all
sessions, and the change will be preserved over shutdown.

For a detailed explanation of each field, select from the list below:

 o Keyboard Type
 o Keyboard Model
 o Current Active Layout
 o Undo


ΓòÉΓòÉΓòÉ 9.1. Keyboard Type ΓòÉΓòÉΓòÉ

 This field displays the current keyboard type, which is one of the following:

 o PC AT Keyboard
 o Enhanced Keyboard
 o Unknown Keyboard Type (xxxx)

 Note:  If your keyboard type is unknown, it would be great if you could send
 me a description of it, along with the value of the Keyboard Type and Keyboard
 Model fields.

 See also:

 o Keyboard Model
 o Current Active Layout


ΓòÉΓòÉΓòÉ 9.2. Keyboard Model ΓòÉΓòÉΓòÉ

 This field displays the current keyboard model, which is one of the following:

 o PC AT Standard Keyboard
 o 101/102 Key Enhanced Keyboard
 o 88/89 Key Enhanced Keyboard
 o 122 Key Mainframe Interactive (MFI) Keyboard
 o Unknown Keyboard ID (yyyy)

 Note:  If your keyboard model is unknown, it would be great if you could send
 me a description of it, along with the value of the Keyboard Type and Keyboard
 Model fields.

 See also:

 o Keyboard Type
 o Current Active Layout


ΓòÉΓòÉΓòÉ 9.3. Current Active Layout ΓòÉΓòÉΓòÉ

 Use this container to specify the keyboard layout to use for this and all
 upcoming sessions.

 You can do any of the following:

 o Make a keyboard layout the default one, by selecting it;
 o Add a keyboard layout to the system database, by dropping a keyboard layout
   object in this container;
 o Copy a keyboard layout to your desktop, by dragging the keyboard layout
   object to your desktop;
 o Delete a keyboard layout, by either selecting Delete from the object's popup
   menu or dragging it into the shredder (but you cannot delete the current
   keyboard layout object, which has the selected emphasis);
 o Edit a keyboard layout, by either selecting Settings from the object's popup
   menu or opening it;
 o Rename a keyboard layout, by using either Alt+Left click or Shift+F9.

 For a detailed explanation of each parts of the Current Active Layout
 Container, select it in the picture below:

 See also:

 o Keyboard Type
 o Keyboard Model
 o Keyboard Layout Object
 o Limited Keyboard Layout Object
 o Keyboard Layout Container


ΓòÉΓòÉΓòÉ 9.3.1. Keyboard Layout Object ΓòÉΓòÉΓòÉ

 This object represents a keyboard layout - something that maps all physical
 keys with a logical value.  Like all objects, it can be moved, renamed,
 deleted, etc.

 Select this object to make it the default active layout.

 You can open it to view/edit its contents, or you can use standard techniques
 to move/rename/delete/etc. it.  The object's own popup menu allows you to open
 its settings view, or to delete it.

 See also:

 o Limited Keyboard Layout Object


ΓòÉΓòÉΓòÉ 9.3.2. Limited Keyboard Layout Object ΓòÉΓòÉΓòÉ

 This object represents a keyboard layout - something that maps all physical
 keys with a logical value.  Like all objects, it can be moved, renamed,
 deleted, etc.

 Select this object to make it the default active layout.

 You can open it to view/edit its contents, or you can use standard techniques
 to move/rename/delete/etc. it.  The object's own popup menu allows you to open
 its settings view, or to delete it.

 Note:     This layout may give unexpected results with one or both of your
           currently prepared codepages.  It is in that sense it is a "Limited"
           keyboard object.  Making it the current layout does not guarantees
           to map each physical key to a meaningful value.

           When you select such a layout, an audible clue is emitted (but it
           nonetheless becomes the current layout).

 See also:

 o Keyboard Layout Object


ΓòÉΓòÉΓòÉ 9.3.3. Current Active Layout Container ΓòÉΓòÉΓòÉ

This container contains the keyboard layouts currently available in the system.

Drag a layout object to this container to add a new layout in the system
database.  You have to select it to make it active.


ΓòÉΓòÉΓòÉ 9.3.4. Scroll Bar ΓòÉΓòÉΓòÉ

Use this Scroll Bar to quickly move through the container.


ΓòÉΓòÉΓòÉ 9.3.5. Keyboard Layout Name ΓòÉΓòÉΓòÉ

This is the name (and codepage) of the keyboard layout object.  You can edit it
by using the standard CUA manipulation ; namely, Alt+Left Click or Shift+F9 if
you don't have redefine them via the Keyboard object in the System Setup
folder.

Keyboard Layouts objects are maintained in the alphabetical order within the
Keyboard Layout Container.

A Keyboard Layout Name cannot have more than six symbols (letter or digit).
All letters must be in upper case.

If it's the name of a Limited keyboard Layout object, the codepage tells you
which codepage will be assumed for the layout.  If it differs from the current
one, you may have unexpected results when entering diacritics chars.


ΓòÉΓòÉΓòÉ 10. Keyboard Behavior Settings ΓòÉΓòÉΓòÉ

 Use this page of the Donkey settings notebook to specify the modifier's keys
 behavior.  A modifier key is a key which temporarily alter the state of the
 keyboard.  Such keys are Shift and Ctrl.  By default theses keys only have
 their effect while holded down, but this may be inadequate for physically
 challenged people, so, this page allows one to define a "sticky" behavior.

 When the "sticky modifier" behavior is enabled, the alteration caused by the
 modifier is maintained until another key is pressed (or until a certain amount
 of time elapses).  If a modifier key has been mistakenly activated, pressing
 it again will cancel its effect.

 A somewhat different behavior can be assigned to modifiers keys via the
 "Special Needs" page of the Keyboard object.

 Warning: It does not work in fullscreen sessions.

 For a detailed explanation of each field, select from the list below:

 o Sticky Modifiers
 o Delay before inactivation
 o Audible Clue
 o Undo
 o Default


ΓòÉΓòÉΓòÉ 10.1. Sticky Modifiers ΓòÉΓòÉΓòÉ

 Select the On radio button to enable sticky modifiers.  If special settings
 were previously specified, they are reactivated.

 Select the Off radio button to disable sticky modifiers.  Special settings are
 deactivated, but their values are preserved.

 See also:

 o Delay before inactivation
 o Audible clue


ΓòÉΓòÉΓòÉ 10.2. Delay before inactivation ΓòÉΓòÉΓòÉ

 Move the slider arm to specify the inactivation delay duration, in seconds.
 If a modifier key is pressed, and no other keys are pressed during the
 inactivation delay, the alteration caused by the modifier is canceled.

 Specifying a null inactivation delay (ie, 0 seconds) means in fact an infinite
 inactivation delay.  In other words, doing so disables the inactivation delay
 feature.

 See also:

 o Sticky modifiers
 o Audible clue


ΓòÉΓòÉΓòÉ 10.3. Audible Clue ΓòÉΓòÉΓòÉ

 Select this check box to have tune being emitted each time a modifier key is
 used.  A high-frequency tune is emitted when the modifier key is activated,
 and a low-frequency tune is emitted if you press the modifier key again to
 deactivate it.

 See also:

 o Sticky modifiers
 o Delay before inactivation


ΓòÉΓòÉΓòÉ 11. Typewriter Layout ΓòÉΓòÉΓòÉ

 Use this page of the Layout settings notebook to view/edit the typewriter
 layout.  When typing data in the Test area, the pressed keys will be
 highlighted, and the layout display will reflect the corresponding values.
 That is, if you press the Shift key, the layout display will show the
 uppercase layout (or lowercase, if CapsLock is On).

 For a detailed explanation of each field, select from the list below:

 o Test
 o Undo
 o Default


ΓòÉΓòÉΓòÉ 12. Cursor and Numpad Layout ΓòÉΓòÉΓòÉ

 Use this page of the Layout settings notebook to view/edit the cursor and
 numpad layout.  When typing data in the Test area, the pressed keys will be
 highlighted, and the layout display will reflect the corresponding values.
 That is, if you press the Shift key, the layout display will show the
 uppercase layout (or lowercase, if CapsLock is On).

 For a detailed explanation of each field, select from the list below:

 o Test
 o Undo
 o Default


ΓòÉΓòÉΓòÉ 13. Miscellaneous Layout Flags ΓòÉΓòÉΓòÉ

 Use this page of the Layout settings notebook to set the layout's flags.  It
 allows you to specify which Alt keys to use as the AltGr one, if accent keys
 are allowed, and other such miscellaneous flags.

 For a detailed explanation of each field, select from the list below:

 o ShiftAlt
 o AltGrL
 o AltGrR
 o DefaultTable
 o AccentPass
 o CapsShift
 o MachDep
 o RTL
 o LangSel
 o DefaultLayout
 o ShiftLock
 o ShiftToggle
 o Undo
 o Default


ΓòÉΓòÉΓòÉ 14. Hot Keys Settings ΓòÉΓòÉΓòÉ

 Use this page of the Donkey settings notebook to specify the recognized
 hotkeys.

 For a detailed explanation of each field, select from the list below:

 o Session Manager Hot Keys
 o Add
 o Edit
 o Remove
 o Undo
 o Default


ΓòÉΓòÉΓòÉ 15. Sounds Settings ΓòÉΓòÉΓòÉ

 Use this page of the Donkey settings notebook to specify the sound to produce
 upon key presses.  No sound is produced in fullscreen sessions.

 For a detailed explanation of each field, select from the list below:

 o Key Down
 o Key Up
 o Auto repeat
 o Keyboard Sounds
 o Undo
 o Default


ΓòÉΓòÉΓòÉ 15.1. Key Down ΓòÉΓòÉΓòÉ

If Keyboard Sounds is set to On, the specified sound is emitted each time a key
is pressed.

Setting the duration to 0ms will prevent the sound to be emitted when a key is
pressed.

The frequency is given in Hertz and must be between 37 and 32767hz, while the
duration is given in milli-seconds.


ΓòÉΓòÉΓòÉ 15.2. Key Up ΓòÉΓòÉΓòÉ

If Keyboard Sounds is set to On, the specified sound is emitted each time a key
is released.

Setting the duration to 0ms will prevent the sound to be emitted when a key is
released.

The frequency is given in Hertz and must be between 37 and 32767hz, while the
duration is given in milli-seconds.


ΓòÉΓòÉΓòÉ 15.3. Auto repeat ΓòÉΓòÉΓòÉ

If Keyboard Sounds is set to On, the specified sound is emitted each time a key
is auto repeated.

Setting the duration to 0ms will prevent the sound to be emitted when a key is
auto repeated.

The frequency is given in Hertz and must be between 37 and 32767hz, while the
duration is given in milli-seconds.


ΓòÉΓòÉΓòÉ 15.4. Keyboard Sounds ΓòÉΓòÉΓòÉ

Enable or Disable sounds for all key-events.  If sets to Off, no sound is
produced when a key event occurs.  Otherwise, a sound is produced for events
with an non-null sound duration.


ΓòÉΓòÉΓòÉ 16. Undo button ΓòÉΓòÉΓòÉ

Select Undo to return the settings to those that were active before this window
was displayed.


ΓòÉΓòÉΓòÉ 17. Default button ΓòÉΓòÉΓòÉ

Press this button to configure the settings on this window to their default
value.


ΓòÉΓòÉΓòÉ <hidden> Secret screen ΓòÉΓòÉΓòÉ

This program is NOT dedicated to the guy who introduces the ShiftLock bug in
Warp.

This program is NOT dedicated to the guy who is responsible of the fact that
this bug has not been fixed in Warp Fullpack and in Warp Connect.

This program is NOT dedicated to the guy who wrote the EA part of the Control
Program Guide and Reference.

OK, enough said on that :-)

And now, I'll have to find a nice thing to put here.  Mmm, maybe a picture or
something like that...

BTW, has anyone notice the fact that the CITY.PCX picture (included with the
Multimedia Viewer) represents the Gordon Biersh (sp?) restaurant?  Their
"unfiltered beer", as well as their food, is excellent, IMHO.  But I digress
:-)