Hex Artifact Content

Artifact df3741810202b5c6e0e6f87352efc9d48afbe508:


0000: 52 45 41 44 4d 45 2e 54 45 52 4d 0a 09 09 20 20  README.TERM...  
0010: 20 20 54 65 72 6d 69 6e 66 6f 20 4e 6f 74 65 73    Terminfo Notes
0020: 20 66 6f 72 20 74 68 65 20 43 54 6b 20 54 6f 6f   for the CTk Too
0030: 6c 6b 69 74 0a 0a 54 68 69 73 20 66 69 6c 65 20  lkit..This file 
0040: 63 6f 6e 74 61 69 6e 73 20 68 69 6e 74 73 20 66  contains hints f
0050: 6f 72 20 73 65 74 74 69 6e 67 20 75 70 20 74 65  or setting up te
0060: 72 6d 69 6e 66 6f 20 65 6e 74 72 69 65 73 20 66  rminfo entries f
0070: 6f 72 20 75 73 65 20 77 69 74 68 20 43 54 6b 2e  or use with CTk.
0080: 0a 49 74 20 61 73 73 75 6d 65 73 20 74 68 65 20  .It assumes the 
0090: 72 65 61 64 65 72 20 61 6c 72 65 61 64 79 20 75  reader already u
00a0: 6e 64 65 72 73 74 61 6e 64 73 20 68 6f 77 20 74  nderstands how t
00b0: 6f 20 77 72 69 74 65 20 74 65 72 6d 69 6e 66 6f  o write terminfo
00c0: 20 65 6e 74 72 69 65 73 0a 28 61 73 20 6d 75 63   entries.(as muc
00d0: 68 20 61 73 20 61 6e 79 6f 6e 65 20 72 65 61 6c  h as anyone real
00e0: 6c 79 20 75 6e 64 65 72 73 74 61 6e 64 73 20 74  ly understands t
00f0: 68 69 73 20 62 6c 61 63 6b 20 61 72 74 29 2e 20  his black art). 
0100: 20 53 65 65 20 74 68 65 20 6d 61 6e 75 61 6c 0a   See the manual.
0110: 70 61 67 65 2c 20 74 65 72 6d 69 6e 66 6f 28 34  page, terminfo(4
0120: 29 2c 20 66 6f 72 20 67 65 6e 65 72 61 6c 20 69  ), for general i
0130: 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 65  nformation on te
0140: 72 6d 69 6e 66 6f 2e 0a 0a 40 28 23 29 20 24 49  rminfo...@(#) $I
0150: 64 3a 20 63 74 6b 2e 73 68 61 72 2c 76 20 31 2e  d: ctk.shar,v 1.
0160: 35 30 20 31 39 39 36 2f 30 31 2f 31 35 20 31 34  50 1996/01/15 14
0170: 3a 34 37 3a 31 36 20 61 6e 64 72 65 77 6d 20 45  :47:16 andrewm E
0180: 78 70 20 61 6e 64 72 65 77 6d 20 24 0a 0a 53 70  xp andrewm $..Sp
0190: 65 63 69 61 6c 20 4b 65 79 73 0a 2d 2d 2d 2d 2d  ecial Keys.-----
01a0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 54 6b 20 74 72 69  -------..CTk tri
01b0: 65 73 20 74 6f 20 6d 61 70 20 74 68 65 20 63 75  es to map the cu
01c0: 72 73 65 73 20 6b 65 79 20 63 6f 64 65 73 20 74  rses key codes t
01d0: 6f 20 58 2d 31 31 20 6b 65 79 63 6f 64 65 73 20  o X-11 keycodes 
01e0: 61 6e 64 20 68 65 6e 63 65 20 74 6f 0a 54 6b 20  and hence to.Tk 
01f0: 6b 65 79 20 6e 61 6d 65 73 2e 20 20 54 68 69 73  key names.  This
0200: 20 6d 61 70 70 69 6e 67 20 28 69 6e 20 72 65 76   mapping (in rev
0210: 65 72 73 65 29 20 69 73 20 73 68 6f 77 6e 20 62  erse) is shown b
0220: 65 6c 6f 77 3a 0a 0a 09 54 6b 20 4e 61 6d 65 09  elow:...Tk Name.
0230: 09 43 61 70 6e 61 6d 65 0a 09 2d 2d 2d 2d 2d 2d  .Capname..------
0240: 2d 09 09 2d 2d 2d 2d 2d 2d 2d 0a 09 42 61 63 6b  -..-------..Back
0250: 53 70 61 63 65 09 6b 62 73 0a 09 42 65 67 69 6e  Space.kbs..Begin
0260: 09 09 6b 62 65 67 0a 09 43 61 6e 63 65 6c 09 09  ..kbeg..Cancel..
0270: 6b 63 61 6e 0a 09 43 6c 65 61 72 09 09 6b 63 6c  kcan..Clear..kcl
0280: 72 0a 09 44 65 6c 65 74 65 09 09 6b 64 63 68 31  r..Delete..kdch1
0290: 0a 09 53 68 69 66 74 2d 44 65 6c 65 74 65 09 6b  ..Shift-Delete.k
02a0: 64 6c 31 0a 09 44 6f 77 6e 09 09 6b 63 75 64 31  dl1..Down..kcud1
02b0: 0a 09 45 6e 64 09 09 6b 65 6e 64 0a 09 45 6e 64  ..End..kend..End
02c0: 09 09 6b 66 6e 64 0a 09 43 6f 6e 74 72 6f 6c 2d  ..kfnd..Control-
02d0: 45 6e 64 09 6b 6c 6c 0a 09 45 78 65 63 75 74 65  End.kll..Execute
02e0: 09 09 6b 63 6d 64 0a 09 46 31 09 09 6b 66 31 0a  ..kcmd..F1..kf1.
02f0: 09 46 31 30 09 09 6b 66 31 30 0a 09 46 32 09 09  .F10..kf10..F2..
0300: 6b 66 32 0a 09 46 33 09 09 6b 66 33 0a 09 46 34  kf2..F3..kf3..F4
0310: 09 09 6b 66 34 0a 09 46 35 09 09 6b 66 35 0a 09  ..kf4..F5..kf5..
0320: 46 36 09 09 6b 66 36 0a 09 46 37 09 09 6b 66 37  F6..kf6..F7..kf7
0330: 0a 09 46 38 09 09 6b 66 38 0a 09 46 39 09 09 6b  ..F8..kf8..F9..k
0340: 66 39 0a 09 48 65 6c 70 09 09 6b 68 6c 70 0a 09  f9..Help..khlp..
0350: 48 6f 6d 65 09 09 6b 68 6f 6d 65 0a 09 49 6e 73  Home..khome..Ins
0360: 65 72 74 09 09 6b 69 63 68 31 0a 09 49 6e 73 65  ert..kich1..Inse
0370: 72 74 09 09 6b 6d 69 72 0a 09 53 68 69 66 74 2d  rt..kmir..Shift-
0380: 49 6e 73 65 72 74 09 6b 69 6c 31 0a 09 4c 65 66  Insert.kil1..Lef
0390: 74 09 09 6b 63 75 62 31 0a 09 4d 65 6e 75 09 09  t..kcub1..Menu..
03a0: 6b 6f 70 74 0a 09 4e 65 78 74 09 09 6b 6e 70 0a  kopt..Next..knp.
03b0: 09 50 61 75 73 65 09 09 6b 73 70 64 0a 09 50 72  .Pause..kspd..Pr
03c0: 69 6e 74 09 09 6b 70 72 74 0a 09 50 72 69 6f 72  int..kprt..Prior
03d0: 09 09 6b 70 70 0a 09 52 65 64 6f 09 09 6b 72 64  ..kpp..Redo..krd
03e0: 6f 0a 09 52 65 74 75 72 6e 09 09 6b 65 6e 74 0a  o..Return..kent.
03f0: 09 52 69 67 68 74 09 09 6b 63 75 66 31 0a 09 53  .Right..kcuf1..S
0400: 65 6c 65 63 74 09 09 6b 73 6c 74 0a 09 54 61 62  elect..kslt..Tab
0410: 09 09 6b 6e 78 74 0a 09 53 68 69 66 74 2d 54 61  ..knxt..Shift-Ta
0420: 62 09 6b 63 62 74 0a 09 53 68 69 66 74 2d 54 61  b.kcbt..Shift-Ta
0430: 62 09 6b 70 72 76 0a 09 55 6e 64 6f 09 09 6b 75  b.kprv..Undo..ku
0440: 6e 64 0a 09 55 70 09 09 6b 63 75 75 31 0a 0a 49  nd..Up..kcuu1..I
0450: 6e 20 61 64 64 69 74 69 6f 6e 20 74 68 65 20 66  n addition the f
0460: 6f 6c 6c 6f 77 69 6e 67 20 73 70 65 63 69 61 6c  ollowing special
0470: 20 6b 65 79 73 20 63 61 6e 20 62 65 20 67 65 6e   keys can be gen
0480: 65 72 61 74 65 64 20 62 79 20 63 6f 6e 74 72 6f  erated by contro
0490: 6c 0a 6b 65 79 73 20 28 74 68 65 72 65 66 6f 72  l.keys (therefor
04a0: 65 2c 20 79 6f 75 20 63 61 6e 6e 6f 74 20 72 65  e, you cannot re
04b0: 63 65 69 76 65 20 61 20 3c 43 6f 6e 74 72 6f 6c  ceive a <Control
04c0: 2d 68 3e 20 65 76 65 6e 74 29 3a 0a 0a 09 54 6b  -h> event):...Tk
04d0: 20 4e 61 6d 65 09 09 43 6f 6e 74 72 6f 6c 20 4b   Name..Control K
04e0: 65 79 0a 09 2d 2d 2d 2d 2d 2d 2d 09 09 2d 2d 2d  ey..-------..---
04f0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 09 42 61 63 6b 73 70  --------..Backsp
0500: 61 63 65 09 3c 43 6f 6e 74 72 6f 6c 2d 48 3e 0a  ace.<Control-H>.
0510: 09 54 61 62 09 09 3c 43 6f 6e 74 72 6f 6c 2d 49  .Tab..<Control-I
0520: 3e 0a 09 52 65 74 75 72 6e 09 09 3c 43 6f 6e 74  >..Return..<Cont
0530: 72 6f 6c 2d 4d 3e 0a 0a 4f 74 68 65 72 20 63 6f  rol-M>..Other co
0540: 6e 74 72 6f 6c 20 6b 65 79 73 20 61 72 65 20 70  ntrol keys are p
0550: 61 73 73 65 64 20 61 73 20 74 68 65 20 61 70 70  assed as the app
0560: 72 6f 70 72 69 61 74 65 20 6b 65 79 20 70 72 65  ropriate key pre
0570: 73 73 20 77 69 74 68 20 74 68 65 0a 43 6f 6e 74  ss with the.Cont
0580: 72 6f 6c 20 4d 6f 64 69 66 69 65 72 20 73 65 74  rol Modifier set
0590: 2e 0a 0a 0a 44 69 73 70 6c 61 79 20 41 74 74 72  ....Display Attr
05a0: 69 62 75 74 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d  ibutes.---------
05b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 54 6b 20 75  ---------..CTk u
05c0: 73 65 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  ses the followin
05d0: 67 20 74 65 72 6d 69 6e 66 6f 20 64 69 73 70 6c  g terminfo displ
05e0: 61 79 20 61 74 74 72 69 62 75 74 65 73 3a 20 73  ay attributes: s
05f0: 74 61 6e 64 6f 75 74 20 28 74 68 65 20 66 6f 63  tandout (the foc
0600: 75 73 29 2c 0a 72 65 76 65 72 73 65 20 28 73 65  us),.reverse (se
0610: 6c 65 63 74 65 64 29 2c 20 75 6e 64 65 72 6c 69  lected), underli
0620: 6e 65 20 28 65 6e 74 72 79 20 77 69 64 67 65 74  ne (entry widget
0630: 73 29 2c 20 62 6f 6c 64 20 28 62 75 74 74 6f 6e  s), bold (button
0640: 20 77 69 64 67 65 74 73 29 2c 0a 61 6e 64 20 64   widgets),.and d
0650: 69 6d 20 28 69 6e 61 63 74 69 76 65 20 77 69 64  im (inactive wid
0660: 67 65 74 73 29 2e 20 20 43 54 6b 20 64 6f 65 73  gets).  CTk does
0670: 20 6e 6f 74 20 74 72 79 20 74 6f 20 75 73 65 20   not try to use 
0680: 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 6f 66 0a  combinations of.
0690: 61 74 74 72 69 62 75 74 65 73 20 28 66 6f 72 20  attributes (for 
06a0: 65 78 61 6d 70 6c 65 3a 20 62 6f 6c 64 2d 75 6e  example: bold-un
06b0: 64 65 72 6c 69 6e 65 29 20 73 6f 20 79 6f 75 20  derline) so you 
06c0: 64 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 0a 64  do not need to.d
06d0: 65 66 69 6e 65 20 74 68 65 20 22 73 67 72 22 20  efine the "sgr" 
06e0: 63 61 70 61 62 69 6c 69 74 79 2e 20 20 49 66 20  capability.  If 
06f0: 61 6e 20 61 74 74 72 69 62 75 74 65 20 69 73 20  an attribute is 
0700: 6e 6f 74 20 64 65 66 69 6e 65 64 20 74 68 65 20  not defined the 
0710: 69 74 65 6d 0a 69 73 20 64 69 73 70 6c 61 79 65  item.is displaye
0720: 64 20 61 73 20 70 6c 61 69 6e 20 74 65 78 74 2e  d as plain text.
0730: 0a 0a 49 66 20 70 6f 73 73 69 62 6c 65 2c 20 65  ..If possible, e
0740: 61 63 68 20 6f 66 20 74 68 65 20 61 74 74 72 69  ach of the attri
0750: 62 75 74 65 73 20 73 68 6f 75 6c 64 20 68 61 76  butes should hav
0760: 65 20 61 20 75 6e 69 71 75 65 20 61 70 70 65 61  e a unique appea
0770: 72 61 6e 63 65 0a 28 73 74 61 6e 64 6f 75 74 20  rance.(standout 
0780: 3d 20 62 6f 6c 64 20 69 73 20 76 65 72 79 20 62  = bold is very b
0790: 61 64 2c 20 62 65 63 61 75 73 65 20 61 20 62 75  ad, because a bu
07a0: 74 74 6f 6e 20 77 69 6c 6c 20 6e 6f 74 20 63 68  tton will not ch
07b0: 61 6e 67 65 20 61 70 70 65 61 72 61 6e 63 65 0a  ange appearance.
07c0: 77 68 65 6e 20 69 74 20 68 61 73 20 74 68 65 20  when it has the 
07d0: 66 6f 63 75 73 29 2e 20 20 46 6f 6c 6c 6f 77 69  focus).  Followi
07e0: 6e 67 20 74 68 65 20 6e 63 75 72 73 65 73 20 72  ng the ncurses r
07f0: 65 63 6f 6d 6d 65 6e 64 61 74 69 6f 6e 20 74 68  ecommendation th
0800: 61 74 0a 73 74 61 6e 64 6f 75 74 20 73 68 6f 75  at.standout shou
0810: 6c 64 20 22 72 65 70 72 65 73 65 6e 74 20 61 20  ld "represent a 
0820: 67 6f 6f 64 2c 20 68 69 67 68 20 63 6f 6e 74 72  good, high contr
0830: 61 73 74 2c 20 65 61 73 79 2d 6f 6e 2d 74 68 65  ast, easy-on-the
0840: 2d 65 79 65 73 2c 0a 66 6f 72 6d 61 74 22 20 49  -eyes,.format" I
0850: 20 64 65 66 69 6e 65 20 73 74 61 6e 64 6f 75 74   define standout
0860: 20 61 73 20 72 65 76 65 72 73 65 2d 64 69 6d 2e   as reverse-dim.
0870: 0a 0a 0a 43 75 73 74 6f 6d 20 43 54 6b 20 54 65  ...Custom CTk Te
0880: 72 6d 69 6e 66 6f 20 45 6e 74 72 69 65 73 0a 2d  rminfo Entries.-
0890: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
08a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 66 20 79  ----------..If y
08b0: 6f 75 20 66 69 6e 64 20 74 68 61 74 20 74 68 65  ou find that the
08c0: 20 74 65 72 6d 69 6e 61 6c 20 64 65 66 69 6e 69   terminal defini
08d0: 74 69 6f 6e 20 79 6f 75 20 77 61 6e 74 20 66 6f  tion you want fo
08e0: 72 20 43 54 6b 20 63 6f 6e 66 6c 69 63 74 73 20  r CTk conflicts 
08f0: 77 69 74 68 0a 77 68 61 74 20 79 6f 75 20 77 61  with.what you wa
0900: 6e 74 20 6e 6f 72 6d 61 6c 6c 79 2e 20 20 59 6f  nt normally.  Yo
0910: 75 20 63 61 6e 20 63 72 65 61 74 65 20 74 68 65  u can create the
0920: 20 43 54 6b 20 65 6e 74 72 79 20 77 69 74 68 20   CTk entry with 
0930: 61 6e 20 61 6c 74 65 72 6e 61 74 65 0a 6e 61 6d  an alternate.nam
0940: 65 20 28 6c 69 6b 65 20 76 74 31 30 30 2d 74 6b  e (like vt100-tk
0950: 29 20 61 6e 64 20 74 68 65 6e 20 73 65 74 20 74  ) and then set t
0960: 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76  he environment v
0970: 61 72 69 61 62 6c 65 20 43 54 4b 5f 54 45 52 4d  ariable CTK_TERM
0980: 0a 74 6f 20 74 68 69 73 20 61 6c 74 65 72 6e 61  .to this alterna
0990: 74 65 20 65 6e 74 72 79 2e 20 20 43 54 4b 5f 54  te entry.  CTK_T
09a0: 45 52 4d 20 69 73 20 62 79 20 43 54 6b 20 69 6e  ERM is by CTk in
09b0: 20 70 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74   preference to t
09c0: 68 65 20 54 45 52 4d 0a 65 6e 76 69 72 6f 6e 6d  he TERM.environm
09d0: 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 0a        ent variable..