home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / keybusbr.zip / ReadMe.TXT < prev   
Text File  |  1999-07-20  |  4KB  |  80 lines

  1. KEYBOARD US/BR274
  2.  
  3.  
  4. WHAT DOES IT DO?
  5.  
  6. Keyboard US/BR274 is a simple REXX program that switches between US and BR274 keyboard settings and alters its own program object icon to reflect the new state of the keyboard.
  7.  
  8. The BR274 keyboard definition implements a number of "dead" keys on a standard US keyboard to facilitate the creation of diacritics. For example, 
  9.  
  10. [`],[a] will produce à ,
  11. ['],[e] will produce é ,
  12. ["],[i] will produce i ,
  13. [^],[o] will produce ô ,
  14. ['],[c] will produce ç ,
  15. [~],[n] will produce ñ , etc.
  16.  
  17. The left and right single quote keys and the double quote key function as grave, acute and diaeresis, respectively. To obtain a quote character, type the quote key followed by a space:
  18.  
  19. [`],[ ] will produce ` ,
  20. ['],[ ] will produce ' , and
  21. ["],[ ] will produce " .
  22.  
  23. Any invalid combination (e.g. ['],[p]) will result in a warning beep.
  24.  
  25.  
  26. GROUNDWORK
  27.  
  28. To enable full use of all (Latin) diacritics in OS/2, code page 850 should be loaded at boot time. For this to work, the "CODEPAGE" entry in the CONFIG.SYS file should read:
  29.  
  30.   CODEPAGE=850,437
  31.  
  32. or, if you want to be able to use the ISO 8859-1 (Windows) code page,
  33.  
  34.   CODEPAGE=850,1004
  35.  
  36. You will then be able to use the "CHCP 1004" command to switch to the ISO code page, and "CHCP 850" to change back to the standard OS/2 code page.
  37.  
  38. To load the Brazilian 274 keyboard definition at boot time, edit the "DEVINFO=KBD,..." entry in the CONFIG.SYS file to read:
  39.  
  40.   DEVINFO=KBD,BR274,C:\OS2\KEYBOARD.DCP
  41.  
  42. That's all!
  43.  
  44.  
  45. INSTALLATION
  46.  
  47. To install the Keyboard US/BR274 program, unzip the KeybUSBR.ZIP file in a (temporary) directory and launch KeybInst.CMD.
  48.  
  49. The installation program will ask for a target directory name (new or existing) to which it will copy the program files.
  50.  
  51. In addition, a program object ("Keyboard US/BR274") will be created on the desktop. Launching the Keyboard US/BR274 program will change the keyboard definition from US to BR274 and vice versa. The program object icon will change to match the current keyboard definition. Each change of keyboard setting affects all instances of OS/2 programs, including VIOs and VDMs.
  52.  
  53. A handy place to put (a shadow of) the program object is on the OS/2 Taskbar (or Launchpad).
  54.  
  55. Once the installation has been completed you can delete the source files.
  56.  
  57.  
  58. BUGS
  59.  
  60. Some earlier versions of 4OS/2 3.xx (up to and including version 3.02 revision A [build 129]) contain a bug that breaks RXQUEUE, and so prevents the KeybUSBR program from processing the KEYB command. This bug has been addressed in 4OS2 version 3.02 revision B (build 130), so the best solution is to upgrade to the latest version of 4OS2 (e.g. by simply applying the patch made available by JP Software, see <http://www.jpsoft.com>).
  61.  
  62. A workaround is to alter the settings of the KeybUSBR program object to use CMD.EXE rather than 4OS2.EXE (assuming you have defined 4OS2.EXE as your default command processor). To do so, proceed as follows:
  63.  
  64. - Open the properties notebook of the KeybUSBR program object;
  65.  
  66. - Copy the contents of the "Path and file name" entry to the clipboard;
  67.  
  68. - Change the "Parameters" entry to "/C " (without the quotes, but with the trailing space) followed by the clipboard contents;
  69.  
  70. - Change the "Path and file name" entry to "CMD.EXE" (without the quotes);
  71.  
  72. - Close the properties notebook.
  73.  
  74. The KeybUSBR program object should now work, changing the keyboard state and updating its own icon.
  75.  
  76.  
  77. Marcus de Geus
  78. marcus@degeus.com
  79. http://www.degeus.com
  80.