home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / kbdredef.zip / README.ENG < prev    next >
Text File  |  1996-03-10  |  8KB  |  190 lines
  1.  
  2.                       Keyboard Redefiner 2.00 for OS/2
  3.                             (c) Ferenc Pal, 1996.
  4.  
  5.  
  6.  
  7. Introduction:
  8. ──────────────
  9.   KBDREDEF redefines the standard 101/102 keyboard to a customizable
  10.   layout.  The keyboard will be redefined in the PM sessions, OS2 and DOS
  11.   fullscreen and windowed sessions at the same time.  In other words, the
  12.   keyboard will be redefined in every session except WIN-OS/2 sessions.
  13.  
  14.  
  15.   KBDREDEF runs under OS/2 Warp 3.  It's possible to run under OS/2 2.x,
  16.   but I didn't test it.
  17.  
  18.  
  19.   KBDREDEF may be invoked from either an OS/2 command line or as program
  20.   object on the desktop.  Invoking the program without any options will
  21.   load the default layout file (which is the KBDREDEF.KBD file), and
  22.   redefine the keyboard. The original keyboard layout (which is active
  23.   when you started KBDREDEF) will be saved, and you can switch by a
  24.   "hotkey" between two layouts.
  25.  
  26.  
  27.   You can define your own keyboard layout as you like to use it with the
  28.   built-in Layout Editor.  You can define so much layouts as much you want.
  29.   Different layouts will be saved in different files, which have a .KBD
  30.   extension.
  31.   I included some example keyboard layout in the release archive:
  32.       KBDREDEF.KBD  -  This is my own Hungarian keyboard layout. OS/2
  33.                        includes Hungarian support, but I don't like that.
  34.       DVORAK.KBD    -  Standard ANSI Dvorak keyboard layout.
  35.       DVORAKLH.KBD  -  Left Hand Dvorak keyboard layout.
  36.       DVORAKRH.KBD  -  Right Hand Dvorak keyboard layout.
  37.       US.KBD        -  This is the standard US keyboard layout. It doesn't
  38.                        matter, but I think it will be useful for starting
  39.                        to define your own keyboard layout.
  40.  
  41.  
  42.   You can define up to four characters at one key in the keyboard:
  43.         1. Normal   - this character is your lower character
  44.         2. Upper    - this character is normal upper character, when SHIFT
  45.                       or CAPSLOCK is active.
  46.         3. AltLower - this character appears when you press the key with
  47.                       ALT.
  48.         4. AltUpper - this character appears when you press the key with
  49.                       ALT+SHIFT or ALT+CTRL. You can define in Layout
  50.                       Editor which method you want to use.
  51.  
  52.    The following sheet may help you to understand the above:
  53.                      ┌────┐
  54.             Upper -->│É : │<-- AltUpper   (with ALT+SHIFT or ALT+CTRL)
  55.             Lower -->│é ; │<-- AltLower   (with ALT)
  56.                      └────┘
  57.  
  58.   To switch between redefined layout and the original layout, press the
  59.   SWITCHKEY in the PM screen group.  The SwitchKey is Ctrl+Alt+F12 by
  60.   default but you can redefine this in the Layout Editor.
  61.   Switching by SWITCHKEY is disabled in full screen mode.  You can also
  62.   switch between layouts with the /Toggle command line parameter.  When
  63.   you switch between layouts, you will hear a short beep from computer.
  64.  
  65.  
  66. Usage:
  67. ──────
  68.  
  69.   KBDREDEF.EXE [options] | [kbdfile]
  70.  
  71.   If you start KBDREDEF.EXE without any parameter, it will load the default
  72.   layout file which is the KBDREDEF.KBD, and redefine the keyboard. You
  73.   can also specify a filename with a new layout.  This is very useful, if
  74.   you are using more than one layout, and you want to switch to another
  75.   layout.
  76.  
  77.   When you started the KBDREDEF.EXE once, it will be "resident" until you
  78.   unload it with the /Kill parameter.
  79.   You needn't unload KBDREDEF if you want to load another layout file.
  80.  
  81.   For example:
  82.      KBDREDEF.EXE
  83.         loads the KBDREDEF.KBD (default), and redefines the keyboard.
  84.      KBDREDEF.EXE DVORAK.KBD
  85.         loads the DVORAK.KBD layout, and redefines the keyboard for Dvorak.
  86.  
  87.  
  88.   Command line parameters are:
  89.     /Kill           -  Unloads KBDREDEF and restores original
  90.                        keyboard layout.
  91.  
  92.     /View           -  Shows the current active layout. This option only
  93.                        works when KBDREDEF is active.
  94.                        This option will show you the loaded layout.
  95.  
  96.     /Edit [kbdfile] -  Activies the Layout Editor. If you specify
  97.                        a filename, then load the starting layout
  98.                        from that file.
  99.                        With this option you can make different layouts.
  100.  
  101.     /Status         -  Display status information about KBDREDEF.
  102.  
  103.     /Toggle         -  Toggle between new and original layout.
  104.  
  105.     /Help           -  Shows an online help.
  106.  
  107.  
  108.  
  109. Layout Editor:
  110. ───────────────
  111.   You can start the Layout Editor with the /Edit option as command line
  112.   parameter.
  113.   You can specify a file after /Edit option, and you will edit that file.
  114.   If you don't specify any filename, the Layout Editor will load the
  115.   KBDREDEF.KBD file.
  116.  
  117.  
  118.   My advices are for defining your own keyboard layout:
  119.      1. Make a copy from US.KBD and rename it anything what you want, for
  120.         example MYLAYOUT.KBD.
  121.      2. Start the Layout Editor with this file:
  122.           KBDREDEF.EXE /Edit MYLAYOUT.KBD
  123.      3. Define your keyboard layout. Read the bottom lines how you can
  124.         define the keys.
  125.      4. Select the key combination what you want to use as SwitchKey by
  126.         pressing F1. Default SwitchKey is Ctrl+Alt+F12.
  127.      5. Select the AltUpper key by pressing F2. You can switch between
  128.         Alt+Ctrl or Alt+Shift. Default AltUpper key is Alt+Shift. This
  129.         is comfortable but some programs use this combination its own
  130.         function and it doesn't work with that programs. For this reason,
  131.         you can use Alt+Ctrl instead.
  132.      6. Exit from Layout Editor by ESC and save the changes.
  133.  
  134.   With the above steps you created your own keyboard layout. You start the
  135.   KBDREDEF with MYLAYOUT.KBD file as parameter, and try it:
  136.       KBDREDEF.EXE MYLAYOUT.KBD
  137.  
  138.   Or you can rename the MYLAYOUT.KBD to KBDREDEF.KBD, and you can start
  139.   KBDREDEF without any file as parameter, because the KBDREDEF.KBD the
  140.   default layout which will be loaded by KBDREDEF.
  141.  
  142.  
  143.   The Layout Editor is an ugly one. I'm sorry ;)
  144.   But I believe, you don't need to use it many times.
  145.  
  146.  
  147.  
  148. Notes:
  149. ───────
  150.   1.  You can use OS/2's any keyboard layout, and you can switch between
  151.       the orginal layout and the redefined layout.  That's the original
  152.       layout, which was active when you started the KBDREDEF.
  153.  
  154.   2.  If you change the layout with OS/2's KEYB.COM while the KBDREDEF is
  155.       active, the KBDREDEF will handle this action, and will switch its
  156.       state to "Not Redefined".  At this time you will hear a short beep
  157.       from computer, it's same beep what you hear when you're switching
  158.       between layouts.  From this point you can switch between this
  159.       layout and the redefined layout.
  160.  
  161.  
  162.  
  163. After all:
  164. ───────────
  165.   First, I hope you will find this utility useful at your everyday work.
  166.  
  167.   This program was a hard work, indeed. The sources are very little, about
  168.   2000 lines, but the OS/2 API's and programming informations are not fully
  169.   documented to help me in developing KBDREDEF.
  170.   I used as information the VisualAge C++, DevCon 9 and all information
  171.   what I found at my BBS, but these informations didn't help me enough. I
  172.   needed to debug some part of OS/2 to let me able to do my utility. For
  173.   example, I lost a week, because I didn't know how I can make my DLL
  174.   "resident", when I want to quit from EXE. But when I got the hang of
  175.   this trick, I did my work with much more enthusiasm.
  176.  
  177.   So, I don't want to make my program to shareware or commercial product.
  178.   It's absolutly free. But if you find this utility useful at your everday
  179.   work, please send me about 10 USD if you have, for let me see that my
  180.   work wasn't useless.
  181.   Thank you very much.
  182.  
  183.  
  184.  
  185. Pal, Ferenc                            Vertigo OS/2 BBS
  186. Miskolc,
  187. Irinyi J. ut 13. 2/1                   Fidonet: 2:370/25
  188. 3534                                   OS2NET:  81:436/1
  189. HUNGARY                                E-mail:  gofpal@gold.uni-miskolc.hu
  190.