xterm

! XTerm configuration
!
! Abandon All Hope, Ye Who Enter Here.
!    -- XTerm README (https://invisible-island.net/xterm/xterm.html#download)
!
! XTerm is a wonderful terminal.  It is, in my experience, the only terminal that combines
! a proper VT220 engine with a UI that's actually nice.  It's such a shame it comes with
! such horrible default settings.
!    -- Paul "LeoNerd" Evans (https://www.leonerd.org.uk/hacks/hints/xterm-sensible.html)
!
! The [xterm FAQ] advocates:
!    As a stylistic convention, the capitalized form is 'XTerm', which corresponds to the
!    X resource class name.
!
! XTerm has a bunch of *widgets* that have their own subresources:
!
!    If your xterm is configured to support the "toolbar", then those patterns need an
!    extra level for the form-widget which holds the toolbar and vt100 widget.  A wildcard
!    between the top-level "XTerm" and the "vt100" widget makes the resource settings work
!    for either, e.g., "XTerm*vt100.NAME".
!       -- xterm(1)
!
! I am specifying resources for the "vt100" widget using its class name "VT100".
!
! [xterm FAQ]: https://invisible-island.net/xterm/xterm.faq.html

! Specify that the TERM environment variable should be "xterm-256color".
XTerm.termName: xterm-256color

! Taken from <https://wiki.archlinux.org/title/Xterm>:
! This will "enable UTF-8 mode" (xterm(1)).
XTerm*VT100.locale:    true
XTerm*VT100.saveLines: 16384

! See <https://www.leonerd.org.uk/hacks/hints/xterm-8bit.html>.  The values for `utf8`,
! `eightBitControl`, and `eightBitOutput` should be the defaults already.
XTerm*VT100.utf8:            1
XTerm*VT100.eightBitInput:   false
XTerm*VT100.eightBitControl: false
XTerm*VT100.eightBitOutput:  true

! Do not use "UTF-8 fonts specified via resource patterns such as '*vt100.utf8Fonts.font',
! use "normal (ISO-8859-1) fonts via patterns such as '*vt100.font'" [1].  FIXME: this
! does not seem to work and I have to unset '*utf8Fonts.font' etc.
! [1]: https://invisible-island.net/xterm/manpage/xterm.html#VT100-Widget-Resources:utf8Fonts
XTerm*VT100.utf8Fonts: false

! XLFD bitmap font for CJK and other double-width characters.  See
! <https://bbs.archlinux.org/viewtopic.php?id=154512>.
XTerm*VT100.wideFont: -misc-fixed-medium-r-normal-ja-*-*-*-*-*-*-iso10646-1

! Make xterm send ASCII DEL (0x7F) for the backspace key instead of ASCII BS (0x08).
! Sending 0x08 apparently is a [de facto standard][1] but is not the default on my system.
! There are also the backarrowKeyIsErase and ptyInitialErase resources; look them up in
! xterm(1) if you want to be confused.  Note: make sure there are [accordingly modified
! terminfo files][2].
! [1]: https://github.com/neovim/neovim/issues/2048#issuecomment-78539223
! [2]: https://github.com/neovim/neovim/issues/2048#issuecomment-78045837
XTerm*VT100.backarrowKey: false

! Translations (key bindings / mappings).
! 1.  XTerm sends the same byte for the Tab key and Control+I, so they cannot be mapped to
!     different actions in (e.g.) Vim.  To work around this, make xterm send ÿ for
!     Control+I instead (ÿ is just a random character that I don't enter directly; it's
!     also part of latin1 in addition to Unicode in case that makes it less likely that
!     this breaks with some setups).  See <https://stackoverflow.com/q/2686766> and
!     xterm(1).
! 2.  Use Control+Shift+C and Control+Shift+V to copy and paste to and from the
!     `CLIPBOARD` selection, like in GNOME Terminal and [termite][1].  See [2] and [3].
! [1]: https://github.com/thestinger/termite
! [2]: https://wiki.archlinux.org/title/Xterm#PRIMARY_and_CLIPBOARD
! [3]: https://unix.stackexchange.com/q/225062
XTerm*VT100.translations: #override \
Ctrl <Key>I: string("ÿ") \n\
Ctrl Shift <Key>C: copy-selection(CLIPBOARD) \n\
Ctrl Shift <Key>V: insert-selection(CLIPBOARD)

! Disable the Alt+Return keybinding for toggling fullscreen mode; it's the window
! manager's job to provide one.
XTerm.fullscreen: never

! See xterm(1) and <https://unix.stackexchange.com/q/45925>.
XTerm*VT100.cutNewline: false
XTerm*VT100.cutToBeginningOfLine: false

! Assume the font does not contain line-drawing characters, and draw them directly (see
! xterm(1)).  This seems to be required for the Dina font.
XTerm*VT100.forceBoxChars: true

! These resources seem to do exactly the same on my system and are added to get the actual
! border width.  xterm(1) suggests that borderWidth is probably a legacy resource.
XTerm.borderWidth:          0
XTerm*VT100.internalBorder: 3

newsboat*VT100.internalBorder: 0
borderless floating xterm*VT100.internalBorder: 0

XTerm*VT100.renderFont: false

XTerm*VT100.faceName: Cascadia Code
XTerm*VT100.faceSize: 6.8
XTerm*VT100.faceSize1: 7.5
XTerm*VT100.faceSize2: 8.2
XTerm*VT100.faceSize3: 9.1
XTerm*VT100.faceSize4: 10
XTerm*VT100.faceSize5: 11
XTerm*VT100.faceSize6: 12
XTerm*VT100.faceSize7: 13.3

! TrueType fallback font for CJK and other double-width characters from the [Noto Sans
! CJK][1] font family.  "Noto Sans CJK is a rebadged version of Source Han Sans, a
! typeface developed by Adobe and Google" [2].  It looks better than "Droid Sans Fallback"
! or "Droid Sans Japanese" (suggested [here][3]), which it replaced as "the default
! fallback font for [...] Android" [4].  Also see [5].
! [1]: https://www.archlinux.org/packages/extra/any/noto-fonts-cjk/
! [2]: https://en.wikipedia.org/wiki/Noto_fonts
! [3]: https://bbs.archlinux.org/viewtopic.php?id=154512
!      "Unicode support in xterm - Arch Linux Forums"
! [4]: https://en.wikipedia.org/wiki/Droid_fonts
! [5]: https://wiki.archlinux.org/title/Fonts#Chinese.2C_Japanese.2C_Korean.2C_Vietnamese
XTerm*VT100.faceNameDoublesize: Noto Sans Mono CJK TC

XTerm*fontMenu.fontdefault.Label: Dina 20
XTerm*VT100.font: -*-dina-medium-r-*-*-20-*-*-*-*-*-iso8859-*
XTerm*fontMenu.font1.Label: Terminus Medium 24
XTerm*VT100.font1: -*-terminus-medium-*-*-*-24-*-*-*-*-*-iso10646-1
XTerm*fontMenu.font2.Label: Terminus Bold 24
XTerm*VT100.font2: -*-terminus-bold-*-*-*-24-*-*-*-*-*-iso10646-1
XTerm*fontMenu.font3.Label: Terminus Medium 28
XTerm*VT100.font3: -*-terminus-medium-*-*-*-28-*-*-*-*-*-iso10646-1
XTerm*fontMenu.font4.Label: Terminus Bold 28
XTerm*VT100.font4: -*-terminus-bold-*-*-*-28-*-*-*-*-*-iso10646-1
XTerm*fontMenu.font5.Label: Dina 10
XTerm*VT100.font5: -*-dina-medium-r-*-*-10-*-*-*-*-*-iso8859-*
XTerm*fontMenu.font6.Label: TODO
XTerm*VT100.font6: -*-fixed-*-*-*-*-20-*-*-*-*-*-iso8859-1
XTerm*fontMenu.font7.Label: TODO

! Unset the resources for specifying UTF-8 fonts to force xterm to use the ISO-8859-1
! fonts.  FIXME: the "utf8Fonts" resource should take care of this.
XTerm*VT100.utf8Fonts.font:
XTerm*VT100.utf8Fonts.font1:
XTerm*VT100.utf8Fonts.font2:
XTerm*VT100.utf8Fonts.font3:
XTerm*VT100.utf8Fonts.font4:
XTerm*VT100.utf8Fonts.font5:
XTerm*VT100.utf8Fonts.font6:

! Specify resources for the "mainMenu" and "fontMenu", which both have the "SimpleMenu"
! class.  See <https://invisible-island.net/xterm/manpage/xterm.html#h3-Menu-Resources>,
! <https://www.x.org/releases/X11R7.6/doc/libXaw/libXaw.html#smebsb_resources>, and
! <https://www.x.org/releases/X11R7.6/doc/libXaw/libXaw.html#Common_Resources>.
XTerm.SimpleMenu.background:   #444444
XTerm.SimpleMenu.?.foreground: #dfdfdf
XTerm.SimpleMenu.borderColor:  #3c3c3c
XTerm.SimpleMenu.borderWidth:  2
XTerm.SimpleMenu.leftMargin:   8
XTerm.SimpleMenu.rightMargin:  8
XTerm.SimpleMenu.topMargin:    8
XTerm.SimpleMenu.bottomMargin: 8

! Color 188; used by jellybeans for the "Normal" highlighting group (`:hi Normal`).
XTerm*VT100.foreground:  #dfdfdf
! Completely black terminal background.  This differs from jellybeans.vim.
XTerm*VT100.background:  #000000
XTerm*VT100.cursorColor: #dfdfdf

! vim: ft=xdefaults tw=90 sts=-1 sw=3 et cms=!\ %s