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