XTerm.ad revision dfb07bc7
1dfb07bc7Smrg! $XTermId: XTerm.ad,v 1.102 2016/12/22 02:07:39 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 138dfb07bc7Smrg*fontMenu*allow-mouse-ops*Label: Allow Mouse Ops 139cd3331d0Smrg*fontMenu*allow-tcap-ops*Label: Allow Termcap Ops 140b7c89284Ssnj*fontMenu*allow-title-ops*Label: Allow Title Ops 141b7c89284Ssnj*fontMenu*allow-window-ops*Label: Allow Window Ops 142b7c89284Ssnj 143d522f475Smrg*VT100.utf8Fonts.font2: -misc-fixed-medium-r-normal--8-80-75-75-c-50-iso10646-1 144d522f475Smrg*VT100.utf8Fonts.font: -misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso10646-1 145d522f475Smrg*VT100.utf8Fonts.font3: -misc-fixed-medium-r-normal--14-130-75-75-c-70-iso10646-1 146d522f475Smrg*VT100.utf8Fonts.font4: -misc-fixed-medium-r-normal--13-120-75-75-c-80-iso10646-1 147d522f475Smrg*VT100.utf8Fonts.font5: -misc-fixed-medium-r-normal--18-120-100-100-c-90-iso10646-1 148d522f475Smrg*VT100.utf8Fonts.font6: -misc-fixed-medium-r-normal--20-200-75-75-c-100-iso10646-1 149d522f475Smrg 150d522f475Smrg*tekMenu.Label: Tek Options 151d522f475Smrg*tekMenu*tektextlarge*Label: Large Characters 152d522f475Smrg*tekMenu*tektext2*Label: #2 Size Characters 153d522f475Smrg*tekMenu*tektext3*Label: #3 Size Characters 154d522f475Smrg*tekMenu*tektextsmall*Label: Small Characters 155d522f475Smrg*tekMenu*tekpage*Label: PAGE 156d522f475Smrg*tekMenu*tekreset*Label: RESET 157d522f475Smrg*tekMenu*tekcopy*Label: COPY 158d522f475Smrg*tekMenu*vtshow*Label: Show VT Window 159d522f475Smrg*tekMenu*vtmode*Label: Switch to VT Mode 160d522f475Smrg*tekMenu*tekhide*Label: Hide Tek Window 161d522f475Smrg 162d522f475Smrg*tek4014*fontLarge: 9x15 163d522f475Smrg*tek4014*font2: 8x13 164d522f475Smrg*tek4014*font3: 6x13 165d522f475Smrg*tek4014*fontSmall: 6x10 166d522f475Smrg 167d522f475Smrg! If xterm is built with a toolbar, the widget hierarchy looks like this, 168d522f475Smrg! showing widget name / class names. The complete menu hierarchy is built 169d522f475Smrg! at startup because it is needed to make the layout work for the menubar: 170d522f475Smrg! 171d522f475Smrg! xterm/XTerm 172d522f475Smrg! form/Form 173d522f475Smrg! menubar/Box 174d522f475Smrg! mainMenuButton/MenuButton 175d522f475Smrg! mainMenu/SimpleMenu 176d522f475Smrg! menuLabel/SmeBSB 177d522f475Smrg! toolbar/SmeBSB 178d522f475Smrg! ... 179d522f475Smrg! vtMenu/SimpleMenu 180d522f475Smrg! menuLabel/SmeBSB 181d522f475Smrg! scrollbar/SmeBSB 182d522f475Smrg! ... 183d522f475Smrg! fontMenu/SimpleMenu 184d522f475Smrg! menuLabel/SmeBSB 185d522f475Smrg! fontdefault/SmeBSB 186d522f475Smrg! ... 187d522f475Smrg! tekMenu/SimpleMenu 188d522f475Smrg! menuLabel/SmeBSB 189d522f475Smrg! fontdefault/SmeBSB 190d522f475Smrg! ... 191d522f475Smrg! vt100/VT100 192d522f475Smrg! tektronix/TopLevelShell 193d522f475Smrg! shellext/VendorShellExt 194b7c89284Ssnj! tek4014/Tek4014 195d522f475Smrg! 196d522f475Smrg! If built without a toolbar, the widget hierarchy is simpler, because there 197d522f475Smrg! is no form, and the popup menu widgets are created only when they are first 198d522f475Smrg! used. 199d522f475Smrg! 200d522f475Smrg! xterm/XTerm 201d522f475Smrg! shellext/VendorShellExt 202d522f475Smrg! mainMenu/SimpleMenu 203d522f475Smrg! menuLabel/SmeBSB 204d522f475Smrg! ... 205d522f475Smrg! ... 206d522f475Smrg! vt100/VT100 207d522f475Smrg! tektronix/TopLevelShell 208d522f475Smrg! shellext/VendorShellExt 209b7c89284Ssnj! tek4014/Tek4014 210d522f475Smrg! 211d522f475Smrg! A more complete list of the widget/class names can be obtained using editres 212d522f475Smrg! to dump a file. Some widget names are not available until the corresponding 213d522f475Smrg! menu has been created. 214d522f475Smrg 215d522f475Smrg! These resources reduce space around the menubar, by eliminating padding in 216d522f475Smrg! the enclosing form (Thickness) and the border of the Box which represents 217d522f475Smrg! the menubar widget. 218d522f475Smrg*form.Thickness: 0 219d522f475Smrg*menubar.borderWidth: 0 220d522f475Smrg 221d522f475Smrg! If we wanted to eliminate the border of the popup menus, we could do this 222d522f475Smrg! instead, since they are children of the menubar: 223d522f475Smrg!*menubar*borderWidth: 0 224d522f475Smrg 225d522f475Smrg! Eliminate the border of the buttons in the menubar, so the only line around 226d522f475Smrg! the text is for the highlighted button: 227d522f475Smrg*MenuButton*borderWidth: 0 228d522f475Smrg 229d522f475Smrg! Set a border for the menus to make them simpler to distinguish against the 230d522f475Smrg! vt100 widget: 231d522f475Smrg*SimpleMenu*borderWidth: 2 232d522f475Smrg 233cd3331d0Smrg! xterm can switch at runtime between bitmap (default) and TrueType fonts. 234cd3331d0Smrg! The "faceSize" resource controls the size of the latter. However, it was 235cd3331d0Smrg! originally given with a size that makes the two types of fonts different 236cd3331d0Smrg! sizes. Uncomment this line to use the same size as "fixed". 237cd3331d0Smrg!*faceSize: 8 238cd3331d0Smrg 239d522f475Smrg! Here is a pattern that is useful for double-clicking on a URL: 240d522f475Smrg!*charClass: 33:48,35:48,37-38:48,43-47:48,58:48,61:48,63-64:48,95:48,126:48 241d522f475Smrg! 242d522f475Smrg! Alternatively, 243d522f475Smrg!*on2Clicks: regex [[:alpha:]]+://([[:alnum:]!#+,./=?@_~-]|(%[[:xdigit:]][[:xdigit:]]))+ 244bcf4e684Schristos 245bcf4e684Schristos*allowWindowOps: false 2468a3bdf72Schristos*pointerMode: 0 247b7c89284Ssnj 248b7c89284Ssnj! VT100s and similar terminals recognize escape sequences and control 249b7c89284Ssnj! characters to which they reply to the host with other escape sequences, 250b7c89284Ssnj! to provide information. The "resize" program uses this feature. 251b7c89284Ssnj! 252b7c89284Ssnj! In addition, xterm recognizes several escape sequences which can be used to 253b7c89284Ssnj! set fonts, window properties, return settings via escape sequences. Some 254b7c89284Ssnj! find these useful; others are concerned with the possibility of unexpected 255b7c89284Ssnj! inputs. 256b7c89284Ssnj! 257b7c89284Ssnj! All of these features can be enabled or disabled via menus. 258b7c89284Ssnj! 259b7c89284Ssnj! Depending on your environment, you may wish to disable those by default by 260b7c89284Ssnj! uncommenting one or more of the resource settings below: 261b7c89284Ssnj!*allowFontOps: false 262b7c89284Ssnj!*allowTcapOps: false 263b7c89284Ssnj!*allowTitleOps: false 264b7c89284Ssnj!*allowWindowOps: false 265