1980988aeSmrg! $XTermId: XTerm.ad,v 1.106 2021/02/03 01:02:03 tom Exp $
2cd3331d0Smrg! -----------------------------------------------------------------------------
3cd3331d0Smrg! this file is part of xterm
4cd3331d0Smrg!
5d4fba8b9Smrg! Copyright 1996-2020,2021 by Thomas E. Dickey
6cd3331d0Smrg! 
7cd3331d0Smrg!                         All Rights Reserved
8cd3331d0Smrg! 
9cd3331d0Smrg! Permission is hereby granted, free of charge, to any person obtaining a
10cd3331d0Smrg! copy of this software and associated documentation files (the
11cd3331d0Smrg! "Software"), to deal in the Software without restriction, including
12cd3331d0Smrg! without limitation the rights to use, copy, modify, merge, publish,
13cd3331d0Smrg! distribute, sublicense, and/or sell copies of the Software, and to
14cd3331d0Smrg! permit persons to whom the Software is furnished to do so, subject to
15cd3331d0Smrg! the following conditions:
16cd3331d0Smrg! 
17cd3331d0Smrg! The above copyright notice and this permission notice shall be included
18cd3331d0Smrg! in all copies or substantial portions of the Software.
19cd3331d0Smrg! 
20cd3331d0Smrg! THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
21cd3331d0Smrg! OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22cd3331d0Smrg! MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
23cd3331d0Smrg! IN NO EVENT SHALL THE ABOVE LISTED COPYRIGHT HOLDER(S) BE LIABLE FOR ANY
24cd3331d0Smrg! CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
25cd3331d0Smrg! TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
26cd3331d0Smrg! SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27cd3331d0Smrg! 
28cd3331d0Smrg! Except as contained in this notice, the name(s) of the above copyright
29cd3331d0Smrg! holders shall not be used in advertising or otherwise to promote the
30cd3331d0Smrg! sale, use or other dealings in this Software without prior written
31cd3331d0Smrg! authorization.
32cd3331d0Smrg! -----------------------------------------------------------------------------
33d522f475Smrg
34d522f475Smrg*saveLines: 1024
35d522f475Smrg
36d522f475Smrg*SimpleMenu*BackingStore: NotUseful
37d522f475Smrg*SimpleMenu*menuLabel.font: -adobe-helvetica-bold-r-normal--*-120-*-*-*-*-iso8859-*
38d522f475Smrg*SimpleMenu*menuLabel.vertSpace: 	100
39d522f475Smrg*SimpleMenu*HorizontalMargins: 16
40d522f475Smrg*SimpleMenu*Sme.height:	16
41d522f475Smrg
42d522f475Smrg*SimpleMenu*Cursor: left_ptr
43d522f475Smrg
44d522f475Smrg*mainMenu.Label:  Main Options
45d522f475Smrg*mainMenu*toolbar*Label:  Toolbar
46c219fbebSmrg*mainMenu*fullscreen*Label: Full Screen
47d522f475Smrg*mainMenu*securekbd*Label:  Secure Keyboard
48d522f475Smrg*mainMenu*allowsends*Label:  Allow SendEvents
49d522f475Smrg*mainMenu*redraw*Label:  Redraw Window
50d522f475Smrg*mainMenu*logging*Label:  Log to File
51712a7ff4Smrg*mainMenu*print-immediate*Label:  Print-All Immediately
52712a7ff4Smrg*mainMenu*print-on-error*Label:  Print-All on Error
53d522f475Smrg*mainMenu*print*Label:  Print Window
54d522f475Smrg*mainMenu*print-redir*Label:  Redirect to Printer
55037a25ddSmrg*mainMenu*dump-html*Label:  XHTML Screen Dump
56037a25ddSmrg*mainMenu*dump-svg*Label:  SVG Screen Dump
57d522f475Smrg*mainMenu*8-bit control*Label: 8-Bit Controls
58d522f475Smrg*mainMenu*backarrow key*Label: Backarrow Key (BS/DEL)
59d522f475Smrg*mainMenu*num-lock*Label: Alt/NumLock Modifiers
60d522f475Smrg*mainMenu*alt-esc*Label: Alt Sends Escape
61d522f475Smrg*mainMenu*meta-esc*Label: Meta Sends Escape
62d522f475Smrg*mainMenu*delete-is-del*Label: Delete is DEL
63d522f475Smrg*mainMenu*oldFunctionKeys*Label: Old Function-Keys
64d522f475Smrg*mainMenu*sunFunctionKeys*Label: Sun Function-Keys
65d522f475Smrg*mainMenu*sunKeyboard*Label: VT220 Keyboard
66d522f475Smrg*mainMenu*hpFunctionKeys*Label: HP Function-Keys
67d522f475Smrg*mainMenu*scoFunctionKeys*Label: SCO Function-Keys
68d522f475Smrg*mainMenu*tcapFunctionKeys*Label: Termcap Function-Keys
69d522f475Smrg*mainMenu*suspend*Label:  Send STOP Signal
70d522f475Smrg*mainMenu*continue*Label:  Send CONT Signal
71d522f475Smrg*mainMenu*interrupt*Label:  Send INT Signal
72d522f475Smrg*mainMenu*hangup*Label:  Send HUP Signal
73d522f475Smrg*mainMenu*terminate*Label:  Send TERM Signal
74d522f475Smrg*mainMenu*kill*Label:  Send KILL Signal
75d522f475Smrg*mainMenu*quit*Label:  Quit
76d522f475Smrg
77d522f475Smrg*vtMenu.Label:  VT Options
78d522f475Smrg*vtMenu*scrollbar*Label:  Enable Scrollbar
79d522f475Smrg*vtMenu*jumpscroll*Label:  Enable Jump Scroll
80d522f475Smrg*vtMenu*reversevideo*Label:  Enable Reverse Video
81d522f475Smrg*vtMenu*autowrap*Label:  Enable Auto Wraparound
82d522f475Smrg*vtMenu*reversewrap*Label:  Enable Reverse Wraparound
83d522f475Smrg*vtMenu*autolinefeed*Label:  Enable Auto Linefeed
84d522f475Smrg*vtMenu*appcursor*Label:  Enable Application Cursor Keys
85d522f475Smrg*vtMenu*appkeypad*Label:  Enable Application Keypad
86d522f475Smrg*vtMenu*scrollkey*Label:  Scroll to Bottom on Key Press
87d522f475Smrg*vtMenu*scrollttyoutput*Label:  Scroll to Bottom on Tty Output
88d522f475Smrg*vtMenu*allow132*Label: Allow 80/132 Column Switching
89d522f475Smrg*vtMenu*keepSelection*Label: Keep Selection
90d4fba8b9Smrg*vtMenu*keepClipboard*Label: Keep Clipboard
91d522f475Smrg*vtMenu*selectToClipboard*Label: Select to Clipboard
92d522f475Smrg*vtMenu*cursesemul*Label:  Enable Curses Emulation
93d522f475Smrg*vtMenu*visualbell*Label:  Enable Visual Bell
94d522f475Smrg*vtMenu*bellIsUrgent*Label:  Enable Bell Urgency
95d522f475Smrg*vtMenu*poponbell*Label:  Enable Pop on Bell
96d522f475Smrg*vtMenu*cursorblink*Label: Enable Blinking Cursor
97d522f475Smrg*vtMenu*titeInhibit*Label:  Enable Alternate Screen Switching
98d522f475Smrg*vtMenu*activeicon*Label: Enable Active Icon
99d522f475Smrg*vtMenu*softreset*Label:  Do Soft Reset
100d522f475Smrg*vtMenu*hardreset*Label:  Do Full Reset
101d522f475Smrg*vtMenu*clearsavedlines*Label:  Reset and Clear Saved Lines
102d522f475Smrg*vtMenu*tekshow*Label:  Show Tek Window
103d522f475Smrg*vtMenu*tekmode*Label:  Switch to Tek Mode
104d522f475Smrg*vtMenu*vthide*Label:  Hide VT Window
105d522f475Smrg*vtMenu*altscreen*Label:  Show Alternate Screen
106fa3f02f3Smrg*vtMenu*sixelScrolling*Label:  Sixel Scrolling
107fa3f02f3Smrg*vtMenu*privateColorRegisters*Label:  Private Color Registers
108d522f475Smrg
109d522f475Smrg*fontMenu.Label:  VT Fonts
110d522f475Smrg*fontMenu*fontdefault*Label:	Default
111d522f475Smrg*fontMenu*font1*Label:	Unreadable
112d522f475Smrg*VT100.font1:		nil2
113d522f475Smrg*IconFont:		nil2
114d522f475Smrg*fontMenu*font2*Label:	Tiny
115d522f475Smrg*VT100.font2:		5x7
116d522f475Smrg*fontMenu*font3*Label:	Small
117d522f475Smrg*VT100.font3:		6x10
118d522f475Smrg*fontMenu*font4*Label:	Medium
119d522f475Smrg*VT100.font4:		7x13
120d522f475Smrg*fontMenu*font5*Label:	Large
121d522f475Smrg*VT100.font5:		9x15
122d522f475Smrg*fontMenu*font6*Label:	Huge
123d522f475Smrg*VT100.font6:		10x20
124d4fba8b9Smrg*fontMenu*font7*Label:	Enormous
125d4fba8b9Smrg!*VT100.font7:		12x24
126d4fba8b9Smrg*VT100.font7:		-adobe-courier-medium-r-normal--24-240-75-75-m-150-iso10646-1
127d522f475Smrg*fontMenu*fontescape*Label:	Escape Sequence
128d522f475Smrg*fontMenu*fontsel*Label:	Selection
129d522f475Smrg!fontescape and fontsel overridden by application
130712a7ff4Smrg*fontMenu*allow-bold-fonts*Label:  Bold Fonts
131712a7ff4Smrg*fontMenu*font-linedrawing*Label:  Line-Drawing Characters
132d522f475Smrg*fontMenu*font-doublesize*Label: Doublesized Characters
133d522f475Smrg*fontMenu*font-loadable*Label:	VT220 Soft Fonts
134cd3331d0Smrg*fontMenu*font-packed*Label:	Packed Font
135d522f475Smrg*fontMenu*render-font*Label:	TrueType Fonts
136712a7ff4Smrg*fontMenu*utf8-mode*Label:	UTF-8 Encoding
137712a7ff4Smrg*fontMenu*utf8-fonts*Label:	UTF-8 Fonts
138d522f475Smrg*fontMenu*utf8-title*Label:	UTF-8 Titles
139d522f475Smrg
140cd3331d0Smrg*fontMenu*allow-color-ops*Label:	Allow Color Ops
141b7c89284Ssnj*fontMenu*allow-font-ops*Label:	Allow Font Ops
142dfb07bc7Smrg*fontMenu*allow-mouse-ops*Label:	Allow Mouse Ops
143cd3331d0Smrg*fontMenu*allow-tcap-ops*Label:	Allow Termcap Ops
144b7c89284Ssnj*fontMenu*allow-title-ops*Label:	Allow Title Ops
145b7c89284Ssnj*fontMenu*allow-window-ops*Label:	Allow Window Ops
146b7c89284Ssnj
147d522f475Smrg*VT100.utf8Fonts.font2:	-misc-fixed-medium-r-normal--8-80-75-75-c-50-iso10646-1
148d522f475Smrg*VT100.utf8Fonts.font:	-misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso10646-1
149d522f475Smrg*VT100.utf8Fonts.font3:	-misc-fixed-medium-r-normal--14-130-75-75-c-70-iso10646-1
150d522f475Smrg*VT100.utf8Fonts.font4:	-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso10646-1
151d522f475Smrg*VT100.utf8Fonts.font5:	-misc-fixed-medium-r-normal--18-120-100-100-c-90-iso10646-1
152d522f475Smrg*VT100.utf8Fonts.font6:	-misc-fixed-medium-r-normal--20-200-75-75-c-100-iso10646-1
153d522f475Smrg
154d4fba8b9Smrg! The default fixed font and font2-font6 are commonly aliased to iso106461 (Unicode)
155d4fba8b9Smrg! with XXX glyphs, but 12x24 is usually just iso8859-1 (about 200 glyphs).
156d4fba8b9Smrg! The adobe-courier is more commonly available than the b&h font.
157d4fba8b9Smrg!*VT100.utf8Fonts.font7: -sony-fixed-medium-r-normal--24-170-100-100-c-120-iso8859-1
158d4fba8b9Smrg*VT100.utf8Fonts.font7: -adobe-courier-medium-r-normal--24-240-75-75-m-150-iso10646-1
159d4fba8b9Smrg!*VT100.utf8Fonts.font7: -b&h-lucidatypewriter-medium-r-normal-sans-24-240-75-75-m-140-iso10646-1
160d4fba8b9Smrg
161d522f475Smrg*tekMenu.Label:  Tek Options
162d522f475Smrg*tekMenu*tektextlarge*Label:  Large Characters
163d522f475Smrg*tekMenu*tektext2*Label:  #2 Size Characters
164d522f475Smrg*tekMenu*tektext3*Label:  #3 Size Characters
165d522f475Smrg*tekMenu*tektextsmall*Label:  Small Characters
166d522f475Smrg*tekMenu*tekpage*Label:  PAGE
167d522f475Smrg*tekMenu*tekreset*Label:  RESET
168d522f475Smrg*tekMenu*tekcopy*Label:  COPY
169d522f475Smrg*tekMenu*vtshow*Label:  Show VT Window
170d522f475Smrg*tekMenu*vtmode*Label:  Switch to VT Mode
171d522f475Smrg*tekMenu*tekhide*Label:  Hide Tek Window
172d522f475Smrg
173d522f475Smrg*tek4014*fontLarge: 9x15
174d522f475Smrg*tek4014*font2: 8x13
175d522f475Smrg*tek4014*font3: 6x13
176d522f475Smrg*tek4014*fontSmall: 6x10
177d522f475Smrg
178d522f475Smrg! If xterm is built with a toolbar, the widget hierarchy looks like this,
179d522f475Smrg! showing widget name / class names.  The complete menu hierarchy is built
180d522f475Smrg! at startup because it is needed to make the layout work for the menubar:
181d522f475Smrg!
182d522f475Smrg!	xterm/XTerm
183d522f475Smrg!		form/Form
184d522f475Smrg!			menubar/Box
185d522f475Smrg!				mainMenuButton/MenuButton
186d522f475Smrg!					mainMenu/SimpleMenu
187d522f475Smrg!						menuLabel/SmeBSB
188d522f475Smrg!						toolbar/SmeBSB
189d522f475Smrg!						...
190d522f475Smrg!					vtMenu/SimpleMenu
191d522f475Smrg!						menuLabel/SmeBSB
192d522f475Smrg!						scrollbar/SmeBSB
193d522f475Smrg!						...
194d522f475Smrg!					fontMenu/SimpleMenu
195d522f475Smrg!						menuLabel/SmeBSB
196d522f475Smrg!						fontdefault/SmeBSB
197d522f475Smrg!						...
198d522f475Smrg!					tekMenu/SimpleMenu
199d522f475Smrg!						menuLabel/SmeBSB
200d522f475Smrg!						fontdefault/SmeBSB
201d522f475Smrg!						...
202d522f475Smrg!			vt100/VT100
203d522f475Smrg!			tektronix/TopLevelShell
204d522f475Smrg!				shellext/VendorShellExt
205b7c89284Ssnj!					tek4014/Tek4014
206d522f475Smrg!
207d522f475Smrg! If built without a toolbar, the widget hierarchy is simpler, because there
208d522f475Smrg! is no form, and the popup menu widgets are created only when they are first
209d522f475Smrg! used.
210d522f475Smrg!
211d522f475Smrg!	xterm/XTerm
212d522f475Smrg!		shellext/VendorShellExt
213d522f475Smrg!			mainMenu/SimpleMenu
214d522f475Smrg!				menuLabel/SmeBSB
215d522f475Smrg!				...
216d522f475Smrg!			...
217d522f475Smrg!		vt100/VT100
218d522f475Smrg!		tektronix/TopLevelShell
219d522f475Smrg!			shellext/VendorShellExt
220b7c89284Ssnj!				tek4014/Tek4014
221d522f475Smrg!
222d522f475Smrg! A more complete list of the widget/class names can be obtained using editres
223d522f475Smrg! to dump a file.  Some widget names are not available until the corresponding
224d522f475Smrg! menu has been created.
225d522f475Smrg
226d522f475Smrg! These resources reduce space around the menubar, by eliminating padding in
227d522f475Smrg! the enclosing form (Thickness) and the border of the Box which represents
228d522f475Smrg! the menubar widget.
229d522f475Smrg*form.Thickness: 0
230d522f475Smrg*menubar.borderWidth: 0
231d522f475Smrg
232d522f475Smrg! If we wanted to eliminate the border of the popup menus, we could do this
233d522f475Smrg! instead, since they are children of the menubar:
234d522f475Smrg!*menubar*borderWidth: 0
235d522f475Smrg
236d522f475Smrg! Eliminate the border of the buttons in the menubar, so the only line around
237d522f475Smrg! the text is for the highlighted button:
238d522f475Smrg*MenuButton*borderWidth: 0
239d522f475Smrg
240d522f475Smrg! Set a border for the menus to make them simpler to distinguish against the
241d522f475Smrg! vt100 widget:
242d522f475Smrg*SimpleMenu*borderWidth: 2
243d522f475Smrg
244cd3331d0Smrg! xterm can switch at runtime between bitmap (default) and TrueType fonts.
245cd3331d0Smrg! The "faceSize" resource controls the size of the latter.  However, it was
246cd3331d0Smrg! originally given with a size that makes the two types of fonts different
247cd3331d0Smrg! sizes.  Uncomment this line to use the same size as "fixed".
248cd3331d0Smrg!*faceSize: 8
249cd3331d0Smrg
250d522f475Smrg! Here is a pattern that is useful for double-clicking on a URL:
251d522f475Smrg!*charClass: 33:48,35:48,37-38:48,43-47:48,58:48,61:48,63-64:48,95:48,126:48
252d522f475Smrg!
253d522f475Smrg! Alternatively,
254d522f475Smrg!*on2Clicks: regex [[:alpha:]]+://([[:alnum:]!#+,./=?@_~-]|(%[[:xdigit:]][[:xdigit:]]))+
255bcf4e684Schristos
256bcf4e684Schristos*allowWindowOps: false
2578a3bdf72Schristos*pointerMode: 0
258b7c89284Ssnj
259b7c89284Ssnj! VT100s and similar terminals recognize escape sequences and control
260b7c89284Ssnj! characters to which they reply to the host with other escape sequences,
261b7c89284Ssnj! to provide information.  The "resize" program uses this feature.
262b7c89284Ssnj!
263b7c89284Ssnj! In addition, xterm recognizes several escape sequences which can be used to
264b7c89284Ssnj! set fonts, window properties, return settings via escape sequences.  Some
265b7c89284Ssnj! find these useful; others are concerned with the possibility of unexpected
266b7c89284Ssnj! inputs.
267b7c89284Ssnj!
268b7c89284Ssnj! All of these features can be enabled or disabled via menus.
269b7c89284Ssnj!
270b7c89284Ssnj! Depending on your environment, you may wish to disable those by default by
271b7c89284Ssnj! uncommenting one or more of the resource settings below:
272b7c89284Ssnj!*allowFontOps: false
273b7c89284Ssnj!*allowTcapOps: false
274b7c89284Ssnj!*allowTitleOps: false
275b7c89284Ssnj!*allowWindowOps: false
276