home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / tcpcsd2.zip / BASECSD2.EXE / DOC / PMANT.DOC < prev    next >
Text File  |  1993-04-15  |  6KB  |  157 lines
  1. Notes for PMANT beta (93/3/18)
  2. ------------------------------
  3.  
  4. Changes:
  5.  
  6. - improved keyboard mapping
  7. - support for extended highlighting (blink, underscore and reverse video)
  8. - added command line options to turn off cursor blink (-ncb), use block
  9.     cursor (-bc), to specify port to connect to (-p port)
  10. - allow binding mouse events to enter
  11. - remembers it's position and size
  12.  
  13. New Keyboard Binding for PMANT
  14. ------------------------------
  15.  
  16. A new scheme for binding keys has been implemented in PMANT, allowing
  17. for a greater flexibility.  PMANT now allows you to bind a 3270
  18. function to the following keys:
  19.  
  20. function keys
  21. cursor keys
  22. editing keys (Insert, Home, Page Up, etc)
  23. escape
  24. tab
  25. backspace
  26. print screen
  27. left control key
  28. right control key
  29.  
  30. and control, alt, and shift combinations of these keys.  PMANT also
  31. allows you to bind 3270 functions to control-letter combinations and
  32. alt-letter combinations as well as the individual control and alt
  33. keys.
  34.  
  35. The following accelerator keys for OS/2 windowing cannot be mapped:
  36.  
  37.        Alt-F4      close
  38.        Alt-F5      restore
  39.        Alt-F7      move
  40.        Alt-F8      size
  41.        Alt-F9      minimize
  42.        Alt-F10     maximize
  43.        Shift-ESC   menu bar
  44.        Control-ESC window list
  45.        Alt-Tab     previous session
  46.        Alt-Escape  next session
  47.  
  48. The key bindings are stored in a flat ASCII file named PMANT.KEY.
  49. When loading the key bindings, PMANT first tries to open PMANT.KEY in
  50. the current directory.  If this fails, PMANT tries to open PMANT.KEY
  51. in the directory defined in the ETC environment variable.
  52.  
  53. If the PMANT.KEY file is opened successfully, PMANT reads the file
  54. line-by-line, parsing the bindings, and binding a 3270 datastream
  55. function to an OS/2 key.  Keys may be rebound on the fly by editting
  56. PMANT.KEY and using the "Refresh key mapping" menu option in the
  57. PM-ANT main menu.
  58.  
  59. Since PMANT is initialized with default key bindings, the PMANT.KEY
  60. file need only contain bindings to override the default or provide for
  61. bindings that are not defaults.
  62.  
  63. The PMANT.KEY file is line-oriented.  Each line is either blank,
  64. contains a comment, or contains 1 binding.  The semicolon is used to
  65. delimit comments which may appear anywhere on the line.  A comment
  66. begins with a semicolon and ends at the end of the line.
  67.  
  68. A line containing a binding follows the syntax:
  69.  
  70. <OS/2 Key> <whitespace> <3270 Function> <optional comment>
  71.  
  72. Where <OS/2 Key> is of the form:
  73.  
  74. <function key>
  75. control-<function key>
  76. alt-<function key>
  77. shift-<function key>
  78. control-<unshifted keypress>
  79. alt-<unshifted keypress>
  80.  
  81. <unshifted keypress> is one of the keyboard's white keys identifying
  82. letters, punctuation, numbers, and foreign language accented keys.
  83. This key should be the *unshifted* letter and is surrounded by single
  84. quotes to distinguish the letter from an editing key.  For example, to
  85. bind a function to control-4, the <unshifted keypress> would be:
  86.  
  87. control-'4'
  88.  
  89. It is not possible to bind to control-'$' since '$' is the shifted
  90. state of '4'.
  91.  
  92. The backslash character is used as an escape character within the
  93. single quotes.  This allows a 3270 function to be bound to the single
  94. quote keypress and to the backslash keypress.  For example, to bind to
  95. the single quote and to the backslash, the <unshifted keypress> would
  96. be:
  97.  
  98. control-'\''
  99. control-'\\'
  100.  
  101. Note that 'a' and '\a' are equivalent.
  102.  
  103. <function key> is a keyword identifying an OS/2 function key.
  104. Possible values are BACKSPACE, TAB, NEWLINE, ESCAPE, PAGEUP, PAGEDOWN,
  105. END, HOME, LEFT, UP, RIGHT, DOWN, INSERT, DELETE, ENTER, F1, F2, F3,
  106. F4, F5, F6, F7, F8, F9, F10, F11, F12, LEFT-CONTROL, RIGHT-CONTROL,
  107. LEFT-ALT, RIGHT-ALT.  The keyword ENTER refers to the enter key on the
  108. numeric keypad whereas NEWLINE is the enter key with the alphabet.
  109.  
  110. The <3270 Function> specifies a 3270 function to bind the OS/2
  111. keypress to.  Possible values are UP, DOWN, LEFT, RIGHT, NEWLINE,
  112. HOME, TAB, BACKTAB, END, FORWARD-WORD, BACKWARD-WORD, INSERT, DELETE,
  113. BACKSPACE, KILL-WORD, BACKWARD-KILL-WORD, ERASE-EOF, ERASE-INPUT, PF1,
  114. PF2, PF3, PF4, PF5, PF6, PF7, PF8, PF9, PF10, PF11, PF12, PF13, PF14,
  115. PF15, PF16, PF17, PF18, PF19, PF20, PF21, PF22, PF23, PF24, CLEAR,
  116. ENTER, PA1, PA2, PA3, SYSREQ, RESET, CENT, ATTN.
  117.  
  118. A sample PMANT.KEY file looks like:
  119.  
  120. ; this is a sample PMANT.KEY file.  It should be in either
  121. ; the current directory or in the directory pointed by the environment
  122. ; variable ETC.
  123.  
  124. escape           clear  ; bind escape to clear (the default anyway)
  125. control-'a'      home
  126. newline          newline; make the keyboard enter just do a newline
  127. right-control    enter  ; make the right control key execute commands
  128. enter            enter  ; make the numeric keypad enter key execute cmds
  129. shift-backspace  pf3    ; shift backspace invokes the pf3 function key
  130. shift-tab        tab    ; make shift-tab go to the next field
  131.  
  132. Default key bindings
  133. --------------------
  134. NEWLINE                      ENTER
  135. ESCAPE                       CLEAR
  136. PAGEUP                       PF7
  137. PAGEDOWN                     PF8
  138. SHIFT-END                    ERASE-EOF
  139. CONTROL-LEFT                 BACKWARD-WORD
  140. CONTROL-RIGHT                FORWARD-WORD
  141. CONTROL-DELETE               KILL-WORD
  142. ENTER                        ENTER
  143. CONTROL-F1                   PA1
  144. CONTROL-F2                   PA2
  145. CONTROL-F3                   PA3
  146. SHIFT-F1 - SHIFT F13         PF13 - PF24
  147. RIGHT-CONTROL                ENTER
  148. ALT-'1'                      PA1
  149. ALT-'2'                      PA2
  150. ALT-'3'                      PA3
  151.  
  152. Notes:
  153. ------
  154. - even if no cursor blink flag (-ncb) is used, cursor blinks on screens
  155.     where there is a blinking field
  156.  
  157.