XTerm.ad revision 037a25dd
1037a25ddSmrg! $XTermId: XTerm.ad,v 1.101 2016/01/28 02:15:29 tom Exp $
2cd3331d0Smrg! -----------------------------------------------------------------------------
3cd3331d0Smrg! this file is part of xterm
4cd3331d0Smrg!
5037a25ddSmrg! Copyright 1996-2011,2016 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
90d522f475Smrg*vtMenu*selectToClipboard*Label: Select to Clipboard
91d522f475Smrg*vtMenu*cursesemul*Label:  Enable Curses Emulation
92d522f475Smrg*vtMenu*visualbell*Label:  Enable Visual Bell
93d522f475Smrg*vtMenu*bellIsUrgent*Label:  Enable Bell Urgency
94d522f475Smrg*vtMenu*poponbell*Label:  Enable Pop on Bell
95d522f475Smrg*vtMenu*cursorblink*Label: Enable Blinking Cursor
96d522f475Smrg*vtMenu*titeInhibit*Label:  Enable Alternate Screen Switching
97d522f475Smrg*vtMenu*activeicon*Label: Enable Active Icon
98d522f475Smrg*vtMenu*softreset*Label:  Do Soft Reset
99d522f475Smrg*vtMenu*hardreset*Label:  Do Full Reset
100d522f475Smrg*vtMenu*clearsavedlines*Label:  Reset and Clear Saved Lines
101d522f475Smrg*vtMenu*tekshow*Label:  Show Tek Window
102d522f475Smrg*vtMenu*tekmode*Label:  Switch to Tek Mode
103d522f475Smrg*vtMenu*vthide*Label:  Hide VT Window
104d522f475Smrg*vtMenu*altscreen*Label:  Show Alternate Screen
105fa3f02f3Smrg*vtMenu*sixelScrolling*Label:  Sixel Scrolling
106fa3f02f3Smrg*vtMenu*privateColorRegisters*Label:  Private Color Registers
107d522f475Smrg
108d522f475Smrg*fontMenu.Label:  VT Fonts
109d522f475Smrg*fontMenu*fontdefault*Label:	Default
110d522f475Smrg*fontMenu*font1*Label:	Unreadable
111d522f475Smrg*VT100.font1:		nil2
112d522f475Smrg*IconFont:		nil2
113d522f475Smrg*fontMenu*font2*Label:	Tiny
114d522f475Smrg*VT100.font2:		5x7
115d522f475Smrg*fontMenu*font3*Label:	Small
116d522f475Smrg*VT100.font3:		6x10
117d522f475Smrg*fontMenu*font4*Label:	Medium
118d522f475Smrg*VT100.font4:		7x13
119d522f475Smrg*fontMenu*font5*Label:	Large
120d522f475Smrg*VT100.font5:		9x15
121d522f475Smrg*fontMenu*font6*Label:	Huge
122d522f475Smrg*VT100.font6:		10x20
123d522f475Smrg*fontMenu*fontescape*Label:	Escape Sequence
124d522f475Smrg*fontMenu*fontsel*Label:	Selection
125d522f475Smrg!fontescape and fontsel overridden by application
126712a7ff4Smrg*fontMenu*allow-bold-fonts*Label:  Bold Fonts
127712a7ff4Smrg*fontMenu*font-linedrawing*Label:  Line-Drawing Characters
128d522f475Smrg*fontMenu*font-doublesize*Label: Doublesized Characters
129d522f475Smrg*fontMenu*font-loadable*Label:	VT220 Soft Fonts
130cd3331d0Smrg*fontMenu*font-packed*Label:	Packed Font
131d522f475Smrg*fontMenu*render-font*Label:	TrueType Fonts
132712a7ff4Smrg*fontMenu*utf8-mode*Label:	UTF-8 Encoding
133712a7ff4Smrg*fontMenu*utf8-fonts*Label:	UTF-8 Fonts
134d522f475Smrg*fontMenu*utf8-title*Label:	UTF-8 Titles
135d522f475Smrg
136cd3331d0Smrg*fontMenu*allow-color-ops*Label:	Allow Color Ops
137b7c89284Ssnj*fontMenu*allow-font-ops*Label:	Allow Font Ops
138cd3331d0Smrg*fontMenu*allow-tcap-ops*Label:	Allow Termcap Ops
139b7c89284Ssnj*fontMenu*allow-title-ops*Label:	Allow Title Ops
140b7c89284Ssnj*fontMenu*allow-window-ops*Label:	Allow Window Ops
141b7c89284Ssnj
142d522f475Smrg*VT100.utf8Fonts.font2:	-misc-fixed-medium-r-normal--8-80-75-75-c-50-iso10646-1
143d522f475Smrg*VT100.utf8Fonts.font:	-misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso10646-1
144d522f475Smrg*VT100.utf8Fonts.font3:	-misc-fixed-medium-r-normal--14-130-75-75-c-70-iso10646-1
145d522f475Smrg*VT100.utf8Fonts.font4:	-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso10646-1
146d522f475Smrg*VT100.utf8Fonts.font5:	-misc-fixed-medium-r-normal--18-120-100-100-c-90-iso10646-1
147d522f475Smrg*VT100.utf8Fonts.font6:	-misc-fixed-medium-r-normal--20-200-75-75-c-100-iso10646-1
148d522f475Smrg
149d522f475Smrg*tekMenu.Label:  Tek Options
150d522f475Smrg*tekMenu*tektextlarge*Label:  Large Characters
151d522f475Smrg*tekMenu*tektext2*Label:  #2 Size Characters
152d522f475Smrg*tekMenu*tektext3*Label:  #3 Size Characters
153d522f475Smrg*tekMenu*tektextsmall*Label:  Small Characters
154d522f475Smrg*tekMenu*tekpage*Label:  PAGE
155d522f475Smrg*tekMenu*tekreset*Label:  RESET
156d522f475Smrg*tekMenu*tekcopy*Label:  COPY
157d522f475Smrg*tekMenu*vtshow*Label:  Show VT Window
158d522f475Smrg*tekMenu*vtmode*Label:  Switch to VT Mode
159d522f475Smrg*tekMenu*tekhide*Label:  Hide Tek Window
160d522f475Smrg
161d522f475Smrg*tek4014*fontLarge: 9x15
162d522f475Smrg*tek4014*font2: 8x13
163d522f475Smrg*tek4014*font3: 6x13
164d522f475Smrg*tek4014*fontSmall: 6x10
165d522f475Smrg
166d522f475Smrg! If xterm is built with a toolbar, the widget hierarchy looks like this,
167d522f475Smrg! showing widget name / class names.  The complete menu hierarchy is built
168d522f475Smrg! at startup because it is needed to make the layout work for the menubar:
169d522f475Smrg!
170d522f475Smrg!	xterm/XTerm
171d522f475Smrg!		form/Form
172d522f475Smrg!			menubar/Box
173d522f475Smrg!				mainMenuButton/MenuButton
174d522f475Smrg!					mainMenu/SimpleMenu
175d522f475Smrg!						menuLabel/SmeBSB
176d522f475Smrg!						toolbar/SmeBSB
177d522f475Smrg!						...
178d522f475Smrg!					vtMenu/SimpleMenu
179d522f475Smrg!						menuLabel/SmeBSB
180d522f475Smrg!						scrollbar/SmeBSB
181d522f475Smrg!						...
182d522f475Smrg!					fontMenu/SimpleMenu
183d522f475Smrg!						menuLabel/SmeBSB
184d522f475Smrg!						fontdefault/SmeBSB
185d522f475Smrg!						...
186d522f475Smrg!					tekMenu/SimpleMenu
187d522f475Smrg!						menuLabel/SmeBSB
188d522f475Smrg!						fontdefault/SmeBSB
189d522f475Smrg!						...
190d522f475Smrg!			vt100/VT100
191d522f475Smrg!			tektronix/TopLevelShell
192d522f475Smrg!				shellext/VendorShellExt
193b7c89284Ssnj!					tek4014/Tek4014
194d522f475Smrg!
195d522f475Smrg! If built without a toolbar, the widget hierarchy is simpler, because there
196d522f475Smrg! is no form, and the popup menu widgets are created only when they are first
197d522f475Smrg! used.
198d522f475Smrg!
199d522f475Smrg!	xterm/XTerm
200d522f475Smrg!		shellext/VendorShellExt
201d522f475Smrg!			mainMenu/SimpleMenu
202d522f475Smrg!				menuLabel/SmeBSB
203d522f475Smrg!				...
204d522f475Smrg!			...
205d522f475Smrg!		vt100/VT100
206d522f475Smrg!		tektronix/TopLevelShell
207d522f475Smrg!			shellext/VendorShellExt
208b7c89284Ssnj!				tek4014/Tek4014
209d522f475Smrg!
210d522f475Smrg! A more complete list of the widget/class names can be obtained using editres
211d522f475Smrg! to dump a file.  Some widget names are not available until the corresponding
212d522f475Smrg! menu has been created.
213d522f475Smrg
214d522f475Smrg! These resources reduce space around the menubar, by eliminating padding in
215d522f475Smrg! the enclosing form (Thickness) and the border of the Box which represents
216d522f475Smrg! the menubar widget.
217d522f475Smrg*form.Thickness: 0
218d522f475Smrg*menubar.borderWidth: 0
219d522f475Smrg
220d522f475Smrg! If we wanted to eliminate the border of the popup menus, we could do this
221d522f475Smrg! instead, since they are children of the menubar:
222d522f475Smrg!*menubar*borderWidth: 0
223d522f475Smrg
224d522f475Smrg! Eliminate the border of the buttons in the menubar, so the only line around
225d522f475Smrg! the text is for the highlighted button:
226d522f475Smrg*MenuButton*borderWidth: 0
227d522f475Smrg
228d522f475Smrg! Set a border for the menus to make them simpler to distinguish against the
229d522f475Smrg! vt100 widget:
230d522f475Smrg*SimpleMenu*borderWidth: 2
231d522f475Smrg
232cd3331d0Smrg! xterm can switch at runtime between bitmap (default) and TrueType fonts.
233cd3331d0Smrg! The "faceSize" resource controls the size of the latter.  However, it was
234cd3331d0Smrg! originally given with a size that makes the two types of fonts different
235cd3331d0Smrg! sizes.  Uncomment this line to use the same size as "fixed".
236cd3331d0Smrg!*faceSize: 8
237cd3331d0Smrg
238d522f475Smrg! Here is a pattern that is useful for double-clicking on a URL:
239d522f475Smrg!*charClass: 33:48,35:48,37-38:48,43-47:48,58:48,61:48,63-64:48,95:48,126:48
240d522f475Smrg!
241d522f475Smrg! Alternatively,
242d522f475Smrg!*on2Clicks: regex [[:alpha:]]+://([[:alnum:]!#+,./=?@_~-]|(%[[:xdigit:]][[:xdigit:]]))+
243bcf4e684Schristos
244bcf4e684Schristos*allowWindowOps: false
2458a3bdf72Schristos*pointerMode: 0
246b7c89284Ssnj
247b7c89284Ssnj! VT100s and similar terminals recognize escape sequences and control
248b7c89284Ssnj! characters to which they reply to the host with other escape sequences,
249b7c89284Ssnj! to provide information.  The "resize" program uses this feature.
250b7c89284Ssnj!
251b7c89284Ssnj! In addition, xterm recognizes several escape sequences which can be used to
252b7c89284Ssnj! set fonts, window properties, return settings via escape sequences.  Some
253b7c89284Ssnj! find these useful; others are concerned with the possibility of unexpected
254b7c89284Ssnj! inputs.
255b7c89284Ssnj!
256b7c89284Ssnj! All of these features can be enabled or disabled via menus.
257b7c89284Ssnj!
258b7c89284Ssnj! Depending on your environment, you may wish to disable those by default by
259b7c89284Ssnj! uncommenting one or more of the resource settings below:
260b7c89284Ssnj!*allowFontOps: false
261b7c89284Ssnj!*allowTcapOps: false
262b7c89284Ssnj!*allowTitleOps: false
263b7c89284Ssnj!*allowWindowOps: false
264