home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / mag_discs / volume_9 / issue_12 / pbook / kbdmap / README.TXT < prev    next >
Text File  |  1996-05-06  |  17KB  |  330 lines
  1.                             KbdMap v. 1.20F
  2.                            KbdEdit v. 1.20F
  3.                              May, 06, 1996
  4.                    Keyboard Layout Driver and Editor
  5.                 Copyright (C) Saliy Konstantin, 1995-96
  6.  
  7.                              Introduction
  8.                              ------------
  9.   Psion Series 3/3a uses code page 850 which contains almost all  Latin
  10. based European letters, but on the  original English or US versions  to
  11. enter a symbol with code>128 user have  to press more than one key.  In
  12. this case fast typing of French, German etc. text is almost impossible.
  13. Of course,  there  are  local  versions  of  Psion  for  most  European
  14. languages, but sometimes people prefer  to buy English one (the  rumour
  15. is they are cheaper).
  16.   Even if you have a Psion with support for your language you may  wish
  17. to re-define keyboard: to simplify typing "pipe" '|' character or  even
  18. to simulate application bar if you have broken one.
  19.   With this  package you  can redefine  any of  42 light  grey keys  in
  20. normal state or in any valid  combination with Shift, Psion or  Control
  21. modifiers and  have  two layouts,  e.g.  standard and  for  quick  text
  22. typing. Ones driver installed, layouts can be switched by pressing  two
  23. Shift keys simultaneously.  Layout editor allows  you to edit  keyboard
  24. maps, save  them  into  files  for future  use  or  to  change  layouts
  25. currently in use by the driver.
  26.   Especially for  non-English  users with  English  Psion there  is  an
  27. ability   to   load    file   with    country   information    (usually
  28. ROM::SYS$CTRY.CFO) from another Psion. If you'll load e.g. French  .CFO
  29. file on the English Psion you'll have keyboard layout exactly as on the
  30. French Psion, all system messages  in French and default language  will
  31. be French too. It means  that any multilingual application (e.g.  Psion
  32. Money) will use French in this case. This ability is also suitable  for
  33. software developers -- to be sure that a program will work properly  on
  34. any Psion.
  35.   Basic features:
  36.    - driver uses <8Kb of memory;
  37.    - it is fast - it substitutes  O/S keyboard maps and only waits  for
  38.      hot keys (2 Shifts);
  39.    - it  is  compatible  with  all  applications  because  it   doesn't
  40.      simulates key presses;
  41.    - keyboard editor is very easy to use - just run it and see!
  42.  
  43.                           Driver Installation
  44.                           -------------------
  45.   There are a number of files in the package:
  46.     KBDMAP.APP              driver front end
  47.     KBDMAP\KBDMAP.BIN       layout switcher for Series 3a
  48.     or
  49.     KBDMAP\KBDMAP.BI3       layout switcher for Series 3
  50.     KBDMAP\KBDMAP.LDD       driver itself
  51.     KBDEDIT.APP             layout editor
  52.     README.WRD              this file
  53.     README.TXT              again this file :)
  54.   You have to copy them (manually - sorry!) into any (\APP  recommended
  55. to simplify installation) directory of any disk. Series 3a users  don't
  56. need KBDMAP.BI3 while  Series 3 users  don't need KBDMAP.BIN.  WARNING:
  57. first 3 files must be in the same directory of the same disk!
  58.   Then use Apps/Install from System screen to install two  applications
  59. - KbdMap and KbdEdit.
  60.   Select KbdMap and press Enter. You will be asked whether you want  to
  61. install driver - press Enter to answer Yes. Answer No (Esc) to question
  62. about custom .CFO file  (see section below if  you need this  feature).
  63. Driver will be loaded into memory.
  64.   To remove  driver from  memory select  KbdMap application  and  press
  65. Enter. You will  be asked  whether you want  to remove  driver -  press
  66. Enter again to answer Yes. Driver will be unloaded from memory.
  67.   To check whether driver was loaded or not just try to press left  and
  68. right Shift keys  simultaneously. If beeps  are allowed  (Control/Sound
  69. from System screen)  you'll hear  beeps as  a signal  that layouts  are
  70. switched.
  71.   If later you'll  create layout  files with KbdEdit  their names  will
  72. appear under KbdMap icon. You can select one of them to load driver and
  73. use selected layout.
  74.   Once driver is  loaded into  memory you don't  need to  keep first  3
  75. files on your Psion unless you want to unload it.
  76.  
  77. For version 1.0 users
  78. ---------------------
  79.   Before install new version you should uninstall driver from  previous
  80. version and  delete old  files  to avoid  potential mixing  files  from
  81. previous and new versions. Your  keyboard layouts are fully  compatible
  82. with new version.
  83.   Please, pay  attention to  that  some files  was moved  into  \KBDMAP
  84. subdirectory.
  85.  
  86. Series 3 users
  87. --------------
  88.   KbdEdit.APP is fully compatible with Psion Series 3 and ready to  use
  89. right now.
  90.   Keyboard driver is also  was written to be  compatible with Series  3
  91. and even was tested.
  92.   KBDMAP.BIN file  (layout switcher)  was designed  for Series  3a  and
  93. Workabout only. You need KBDMAP.BI3 (do not rename it!) but it has  O/S
  94. version dependent code (detection of 2  Shifts) and was tested only  on
  95. v. 1.75F, 1.77F, 1.80F, 1.91F. Even if you have another version in some
  96. cases driver may work correctly - I check against ROM context, not  O/S
  97. version. Try to run KBDMAP.APP. You will see incompatibility message if
  98. KBDMAP.BI3 couldn't be  run on your  computer -- try  to contact me  in
  99. this case.
  100.   If your Series 3 version not listed above but you'll found that it is
  101. fully compatible please, let me know your version.
  102.  
  103. Workabout users
  104. ---------------
  105.   This version is  fully compatible with  Workabout. To switch  layouts
  106. you should press Control and Psion keys because Workabout has no second
  107. Shift.
  108.   Workabout  has  built-in  ability  to  switch  between  two   layouts
  109. (standard and special). When KbdMap starts, it inherits current  layout
  110. or totally replaces it  with new one. If  you then switch to  alternate
  111. layout using Shell or command  processor menu, KbdMap will be  disabled
  112. temporary. To enable it again just switch layouts using KbdMap hot keys
  113. (Control+Psion). To avoid potential  problems it is  better not to  use
  114. KbdMap and Workabout switchers at the same time.
  115.   Keyboard layout editor will show you S3/S3a QWERTY keyboard.
  116.   Workabout has no Diamond key so you have to use menu to select map to
  117. edit.
  118.   Workabout has additional keyboard map -- for Psion+Shift combination.
  119. KbdEdit doesn't support it.
  120.  
  121. Psion emulators
  122. ---------------
  123.   Keyboard driver is incompatible with emulators -- emulator will crash
  124. if you'll try to run it.
  125.   You can run keyboard layout editor under emulator and then use  these
  126. layouts on your Psion.
  127.  
  128. Custom .CFO file
  129. ----------------
  130.   There are a number of .CFO file format versions. For instance,  Psion
  131. S3/S3a and Workabout use different formats. This version supports  only
  132. .CFO files from S3a ROM.
  133.   Each .CFO  file has  3 parts:  country/language info,  keyboard  map,
  134. system messages. Before to load your .CFO file you will be asked  which
  135. parts you want to use. Do not  try to load keyboard map from .CFO  file
  136. on the S3  or Workabout! Even  Control+Psion+Del will not  work on  the
  137. Workabout in this case.
  138.   Keyboard map from .CFO file will be primary map and your standard map
  139. will become secondary.
  140.   If you  need KbdMap  only  to load  .CFO file  and  want not  to  use
  141. secondary keyboard layout  you may  prevent switcher  from loading  and
  142. save 1Kb of memory.
  143.   If  you  rename  your  .CFO  file  to  KBDMAP.CFO  and  put  it  into
  144. \APP\KBDMAP directory it will  be loaded automatically without  prompt.
  145. On the S3a the whole file will be loaded, on the S3 and Workabout  only
  146. country info and messages.
  147.   I have .CFO  files for  English (US), English  (UK), French,  German,
  148. Swedish,  Hungarian,  Italian,   Spain,  Dutch,   Belgian  and   Danish
  149. languages. Just ask if you need one of them
  150.  
  151.                         Layout editor (KbdEdit)
  152.                         -----------------------
  153.   The very  first time  you run  driver both  layouts are  the same  as
  154. standard. You need to create and  edit new layout with KbdEdit.  Layout
  155. editor is a standalone application and doesn't require any other  files
  156. from package. However some functions will be disabled if the driver was
  157. not loaded into memory.  It requires 40Kb of  RAM available to run  (in
  158. first 512K, of  course, for  1Mb and  2Mb users).  By default  keyboard
  159. layout files are kept in \KBD\ directory and have extension .KBD.
  160.   Keyboard layout editor window  is a picture  of your Psion  keyboard.
  161. Use arrow keys to select a key to edit (it is drawn in pressed  state).
  162. On the Space  key you  can see both  decimal and  hexadecimal value  of
  163. current key. Control, Psion and left Shift states show you current  map
  164. and right Shift  state shows current  layout. To change  a value  enter
  165. either Control+3 digit combination (see User Guide) or just press a key
  166. combination. To enter  Psion+key combination code  you have to  disable
  167. Hot  keys  handling  first.  To   enter  special  codes  (Unused   key,
  168. Contrast+/-, Application bar keys) use Edit/Special key menu item.
  169.   You can edit  10 maps: normal,  Shift, Control, Control+Shift,  Psion
  170. for both primary and secondary layouts. To select map press Diamond key
  171. (not available for Workabout) or chose from Edit/Choose map menu.
  172.   There are two special  "flags" that may be  assigned to any key  (but
  173. usually from numeric row on the Control map):
  174.   "dead" key -- this key itself will not produce a  value but  modifies
  175.      meaning of the next key(s) press (e.g. for Control+3digits code or
  176.      for accented keys). This "flag" is marked as lock sign.
  177.   special Shift/Caps mode -- usually  Caps  converts a value  from  the
  178.      current map to upper/lower case  (it depends on Shift state).  For
  179.      keys that are marked  with arrow down just  alternate map is  used
  180.      (normal when Shift is  pressed and Shift when  not). This flag  is
  181.      used e.g. for French AZERTY keyboard with reversed numeric row.
  182.   Remember that you always edit only a file, not current layout. To use
  183. layout you must explicitly pass it to the driver.
  184.   Don't worry if your keyboard will hang because of your errors. Driver
  185. newer changes values for  Esc, Enter, Menu,  Tab, Space, cursor  arrows
  186. and application bar -- it's enough to even install a driver's icon  and
  187. run it to unload it from memory thus to restore original keyboard maps.
  188.  
  189. Menu commands:
  190. --------------
  191.   Please,  remember  that  you  can  use  hot  keys  (i.  e.  Psion+key
  192. combination) instead of menu only if hot keys are enabled.
  193.    File/Open Psion+O - opens a layout file to edit.
  194.    File/Save Psion+S - saves current file.
  195.    File/Save As Psion+A - saves current layout into another file.
  196.    Edit/Choose map Psion+M - choose map/layout to edit.
  197.    Edit/Special key Psion+P - insert special key code (Unused key, OFF,
  198.      Contrast +/-, A1-A8 for application keys).
  199.    Edit/Hot keys off(on) Psion+H - switches between two choices: either
  200.      ability to enter Psion+key codes or  use hot keys instead of  menu
  201.      browsing.
  202.    Edit/Toggle SHIFT Psion+T -  toggle flag (shown  as arrow down)  for
  203.      special Shift/Caps mode.
  204.    Edit/Toggle LOCK Psion+K  - toggle  "dead" key flag  (shown as  lock
  205.      symbol).
  206.    Special/Get from  driver Psion+G  - load  layout currently  used  by
  207.      driver.
  208.    Special/Send to driver Psion+D - makes layout in the editor used  by
  209.      driver immediately.
  210.    Special/Help Psion+B or Help - About dialog.
  211.    Special/Legend Psion+L or Help - shows editor's legend.
  212.    Special/Exit Psion+X - exit from editor, changes will be lost.
  213.    Diamond/Setup Diamond  list  -  select layout  parts  which  can  be
  214.      selected by Diamond key.
  215.   Unlike other  document-related Psion  applications KbdEdit  will  not
  216. save files automatically: to  save your layout you  have to use one  of
  217. the File/Save,  File/Save  As,  Special/Send  to  driver  menu  options
  218. explicitly.
  219.  
  220. Making Application bar
  221. ----------------------
  222.   To make full functionable  application bar from a  set of other  keys
  223. you should assign the same value to a given key on the all maps of  the
  224. selected layout.
  225.   Workabout doesn't recognise application keys.
  226.  
  227.                         Shareware Registration
  228.                         ----------------------
  229. Non-Russian users
  230. -----------------
  231.   I'd like to make this program shareware with reasonable (IMHO)  price
  232. of 15 UK pounds.  My experience shows that  it is almost impossible  to
  233. send me money directly. Now I have two registration fee collectors. You
  234. can send cheque or cash to
  235.      Philippe Lebreton
  236.      5 rue Au Metre
  237.      F-78290 Croissy Sur Seine
  238.      France
  239.    (ether 15UKP or 100 Fr. fr.)
  240.      e-mail: lebreton.p@cgi.fr
  241.   or
  242.      Felix Grant
  243.      14 Severn Avenue
  244.      Weston-s-Mare
  245.      BSA23 4DQ, United Kingdom
  246.      e-mail: felixg@cix.compulink.co.uk,
  247.              fgrant@sbristol.ac.uk,
  248.              101676.2371@compuserve.com
  249.   Please, make your cheque payable to a person you send to.
  250.   In both cases please,  inform me when and  which way you'd made  your
  251. payment.
  252.   If you'll find this price too expensive (e.g. you are a student)  but
  253. still need this program and want to have support and receive all future
  254. versions just mail me.
  255.   Anyway this version neither encoded nor crippled. Why you might  like
  256. to be a registered user in this case? For a number of reasons:
  257.    - to encourage me to support this product and write another programs
  258.    - you will receive all new versions (bug fixes, addition features if
  259.      any) directly from me by e-mail
  260.    - money are still valid  in our world  and I need  them at least  to
  261.      register shareware I need.
  262.   Please, send  me e-mails  about registration  to <kis@ipmce.ru>  with
  263. subject "KbdMap registration"  to let  my mailer put  them to  separate
  264. folder.
  265.  
  266. Russian and ex-USSR users
  267. -------------------------
  268.   Especially for Russian users I have a package with:
  269.    - keyboard driver and layout editor like this
  270.    - full set of ROM fonts (front end will install them for you)
  271.    - additional ability  to  perform  correct case  conversion  in  all
  272.      applications (e.g. find in Word or Data)
  273.    - printer  drivers  for  Generic  and  Epson-compatible  dot  matrix
  274.      printers with built-in Russian fonts
  275.    - two different keyboard layouts ready to use
  276.    - printed or  in  Word  for  Windows  6.0  format  user  manual  (in
  277.      Russian). It contains instruction how  to exchange RTF files  with
  278.      Russian text between Psion and PC
  279.   Full package is copy protected and costs today $39 (you need a  Flash
  280. SSD) or $89 on the 128K Flash.
  281.   Optional:
  282.    - application (MS Windows) which makes it possible to convert  files
  283.      with Russian text from inside PsiWin
  284.    - full set of fonts and FAX.WDR to send Russian faxes with 3Fax
  285.   Call for prices.
  286.   Use KbdMap  with  your  own  fonts  to  type  Russian  characters  is
  287. prohibited. See How to reach me and call me to give more info on how to
  288. buy full Russian package.
  289.  
  290. Support and future versions
  291. ---------------------------
  292.   This program was tested as a part of Russian driver during more  than
  293. half a year. Version with all  maps support was tested too. Major  bugs
  294. was fixed. Of course, every program  has at least 2 bugs  (programmer's
  295. axiom). If you find any -- please, e-mail me regardless of whether  you
  296. registered user or not. If it will be real bug you will receive updated
  297. version (maybe with new features and new bugs).
  298.   If you have  any suggestions please,  feel free to  send me them.  If
  299. you'll decide that some features would be useful  and you'll not be the
  300. only who need it - I'll try to implement them.
  301.   If your language is not supported by Psion
  302.   If your language
  303.    - have not more 128 letters and
  304.    - they are not in cp850 and
  305.    - you read and write from left to right
  306.   it is  possible to  create a  package like  Russian driver  for  your
  307. language. Because this is a big job  it will be done only if you'll  be
  308. not only  person interested  in. It  is better  to contact  your  local
  309. official Psion distributors to tell them about me.
  310.   If you  already have  fonts for  your language  we can  arrange  this
  311. question.
  312.  
  313. How to reach me
  314. ---------------
  315.   E-mail <kis@ipmce.ru>. Please, use  subject "KbdMap registration"  if
  316. you want to be registered user or use word "KbdMap" in your subject  in
  317. all other cases.
  318.   Phone at Moscow, Russia (095)132-9277
  319.  
  320.                                 History
  321.                                 -------
  322. Version 1.00F -- first public release. Support only for 2 maps. Doesn't
  323.      work  correctly  on  multilingual  Psions  (Swedish,  Spain   etc.
  324.      versions).
  325. Version 1.10F -- support for  all maps,  custom .CFO  files. Was  never
  326.      released.
  327. Version 1.20F -- Workabout  support  was  added.  Should  work  on  the
  328.      multilingual Psions too.
  329.  
  330.