home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1997 December / VPR9712A.ISO / OLS / WIN16 / ARCHIVE / TTERMV13.ZIP / keycode.txt < prev    next >
Text File  |  1996-06-07  |  6KB  |  196 lines
  1.     KEYCODE.EXE for Tera Term
  2.     T. Teranishi
  3.     
  4.     Copyright (C) 1994-1996 T. Teranishi
  5.     All Rights Reserved.
  6.  
  7. KEYCODE.EXE is a utility which displays the key codes used in the
  8. Tera Term's keyboard setup file.
  9.  
  10. -------------------------------------------------------------------------------
  11. 1. INSTALLATION
  12.  
  13. 1) Copy KEYCODE.EXE to a directory (folder) of your choice.
  14.  
  15. 2) If you are using Windows 3.1 or Windows NT, install KEYCODE.EXE
  16. in Program Manager with its icon. If you are using Windows 95,
  17. create a shortcut for KEYCODE.EXE in a folder of your choice,
  18. or in the Start menu, or on the desktop.
  19.  
  20. -------------------------------------------------------------------------------
  21. 2. USAGE
  22.  
  23. When you run KEYCODE.EXE, the message "Push any key" will be displayed
  24. in the window.  When you press a key or a combination of keys (such as
  25. Ctrl+key), the message "Key code is XXXX." will be displayed. XXXX is a
  26. decimal number.
  27.  
  28. -------------------------------------------------------------------------------
  29. 3. ABOUT THE KEYBOARD SETUP FILE
  30.  
  31. In the keyboard setup file, you can define certain keys on your keyboard as
  32. VT terminal keys.  You can also define user keys, which will send character
  33. strings of your choice.
  34.  
  35. The file name of the keyboard setup file can be specified as a command line
  36. parameter of Tera Term (see CMNDLINE.TXT). If you omit the file name extension,
  37. the default extension ".CNF" is used. If you omit the file name, the default
  38. file name "KEYBOARD.CNF" is used. If the specified keyboard setup file does
  39. not exist, the default setup is used.
  40.  
  41. The default setup is intended for the IBM-PC/AT 101-key keyboard. If you are
  42. using such keyboard and have no need to customize key definitions, you don't
  43. need to make a keyboard setup file.  Otherwise, copy IBMKEYB.CNF to
  44. KEYBOARD.CNF, and edit it.
  45.  
  46. ...............................................................................
  47. 3.1 FORMAT OF THE KEYBOARD SETUP FILE
  48.  
  49. Each key or key combination has a unique key code, which is called
  50. "PC key code". 
  51.  
  52. The keyboard setup file has five sections:  [VT editor keypad],
  53. [VT numeric keypad], [VT function keys], [Shortcut keys], and [User keys].
  54.  
  55. 1) [VT editor keypad] section
  56. In this section, VT editor keys are assigned to PC keys.
  57.  
  58.     Format:
  59.         <VT editor key name>=<PC key code>
  60.  
  61.     where:
  62.  
  63.     <VT editor key name>
  64.         Up, Down, Right, Left, Find, Insert, Remove, Select,
  65.         Prev, Next
  66.  
  67.       <PC key code>
  68.         PC key code (decimal number)
  69.  
  70.     Example:
  71.         Up=328
  72.  
  73. 2) [VT numeric keypad] section
  74. In this section, VT numeric keys are assigned to PC keys.
  75.  
  76.     Format:
  77.         <VT numeric key name>=<PC key code>
  78.  
  79.     where:
  80.  
  81.       <VT numeric key name>
  82.         Num0, Num1, Num2, Num3, Num4, Num5, Num6, Num7, Num8,
  83.         Num9, NumMinus, NumComma, NumPeriod, NumEnter, PF1,
  84.         PF2, PF3, PF4
  85.  
  86.       <PC key code>
  87.         PC key code (decimal number)
  88.  
  89.     Example:
  90.         Num0=82
  91.  
  92. 3) [VT function keys] section
  93. In this section, VT function keys are assigned to PC keys.
  94.  
  95.     Format:
  96.         <VT function key name>=<PC key code>
  97.  
  98.     where:
  99.  
  100.       <VT function key name>
  101.         F6, F7, F8, F9, F10, F11, F12, F13, F14, Help, Do,
  102.         F17, F18, F19, F20
  103.  
  104.       <PC key code>
  105.         PC key code (decimal number)
  106.  
  107.     Example:
  108.         F6=64
  109.  
  110. 4) [Shortcut keys] section
  111. In this section, shortcut keys of Tera Term are assigned to PC keys.
  112.  
  113.     Format:
  114.         <Shortcut key name>=<PC key code>
  115.  
  116.     where:
  117.       <Shortcut key name>    Function
  118.       --------------------------------------------
  119.       EditCopy        [Edit] Copy command
  120.       EditPaste        [Edit] Paste comannd
  121.       EditPasteCR        [Edit] Paste<CR> command
  122.       LineUp        Scroll up 1 line
  123.       LineDown        Scroll down 1 line
  124.       PageUp        Scroll up 1 page
  125.       PageDown        Scroll down 1 page
  126.       BuffTop        Scroll to buffer top
  127.       BuffBottom        Scroll to buffer bottom
  128.       SendBreak        [Control] Send break command
  129.  
  130.       <PC key code>
  131.         PC key code (decimal number)
  132.  
  133.     Example:
  134.         LineUp=1352
  135.  
  136. 5) [User keys] section
  137. This section defines user keys and character strings which are sent by
  138. pressing the user keys.
  139.  
  140.     Format:
  141.         <User key name>=<PC key code>,<Conversion flag>,
  142.                 <Character string>
  143.  
  144.     where:
  145.  
  146.       <User key name>
  147.         User1, User2, User3,...., User99
  148.         Maximum number of the user keys is 99. 
  149.         For example, if you want to define ten user keys,
  150.         you must use the first ten names, from "User1" to "User10".
  151.  
  152.       <PC key code>
  153.         PC key code (decimal number)
  154.  
  155.       <Conversion flag>
  156.         New-line code conversion (CR -> CR/CR+LF) flag
  157.             0    No conversion
  158.             1    New-line codes in the character string
  159.                 are converted by Tera Term.
  160.  
  161.       <Character string>
  162.         Character string to be sent by pressing the user key.
  163.         Each non-printable character (control character) in
  164.         the string can be expressed as a "$" and ASCII code
  165.         in two-character hex number. For example, CR character
  166.         is expressed as "$0D". "$" itself is expressed as "$24".
  167.  
  168.     Example:
  169.         User1=59,0,telnet myhost
  170.         User2=60,0,$0D$0A
  171.         User3=61,1,$0D
  172.  
  173. ...............................................................................
  174. 3.2 HOW TO DEASSIGN KEYS 
  175.  
  176. If you don't want to assign a certain VT key or shortcut key to any PC key,
  177. use the word "off" instead of PC key code.
  178.  
  179. Example:
  180.     EditCopy=off
  181.  
  182. ...............................................................................
  183. 3.3 KEY COMBINATIONS
  184.  
  185. The following key combinations are acceptable to Tera Term and KEYCODE.EXE:
  186.  
  187.     Shift+key
  188.     Ctrl+key
  189.     Shift+Ctrl+key
  190.     Shift+Alt+key
  191.     Ctrl+Alt+key
  192.     Shift+Ctrl+Alt+key
  193.  
  194. Since some combinations (such as Alt+key) are used as shortcut keys of
  195. Tera Term and Windows, they don't have PC key codes and can't be specified
  196. in the keyboard setup file.