DTTERM(1)

📦

version 2.5.3 · 2 versions

2.5.3 · nixos 26.05 (latest)
2.5.3 · nixpkgs unstable

🎀 dtterm — user cmd edition 🎀

bestie, welcome to the manual page for dtterm, section user cmd, and it’s literally here to emulate a terminal window. No cap, that’s the whole assignment. 💅

🌸 NAME 🌸

dtterm — emulate a terminal window. That’s it. That’s the vibe. 🫶

✨ SYNOPSIS ✨

dtterm [±132]  [±aw]  [-background background_color]  [-bg
       background_color]  [±bs]  [-C]  [-display display_name]  [-e
       program_argument ...]  [-fb fontset]  [-fg foreground_color]  [-fn
       fontset]  [-font fontset]  [-foreground foreground_color]  [-geometry
       geometry_string]  [-help]  [±iconic]  [±j]  [±kshMode]
        [±l]  [-lf file_name]  [±ls]  [±map]  [±mb]  [-ms pointer_color]
       [-name prog_name]  [-nb number]  [±rw]  [-S ccn]  [-S c.n]  [±sb]  [±sf]
       [-sl screens  [s  | l ] ]  [-ti term_id]  [-title title_string]  [-tm
       term_modes]  [-tn term_name]  [-usage]  [±vb]  [-xrm resource_string]

🦋 DESCRIPTION 🦋

The dtterm utility provides runtime support of legacy applications written for terminals conforming to ANSI X3.64-1979 and ISO 6429:1992(E), such as the DEC VT220.

So yes, this is your terminal-emulator bestie for legacy terminal-app energy. It’s giving old-school but make it usable. ⭐

💖 OPTIONS 💖

The following options are available, and yes, every single one is getting its moment. No skipping, bestie. 🍓

-132 — Recognize the DECCOLM escape sequence and resize the window appropriately. Normally, dtterm ignores the DECCOLM escape sequence, which switches between 80- and 132-column mode.
+132 — Ignore the DECCOLM escape sequence. This is the default behavior. 🫶
-aw — Allow auto-wraparound. This option allows the cursor to automatically wrap to the beginning of the next line when it is at the right-most position of a line and text is output. This is the default behavior. ✨
+aw — Do not allow auto-wraparound.
-background background_color — Specify the terminal window background and the default background for the scroll bar and the X11 pointer cursor. This option defaults to either the primary colorset background (default) or select pixel (see -bs). The background_color argument describes the background color.
-bg background_color — The background_color argument describes the background color. 💜
-bs — Use the Motif select color instead of the background color for the terminal window’s background color.
+bs — Do not use the Motif select color instead of the background color for the terminal window’s background color. This is the default behavior.
-C — Specify that output directed to /dev/console be directed instead to the terminal window. It is provided as a way to prevent output, which would normally be displayed on the internal terminal emulator (ITE), from overwriting the X server’s display. It is not provided as a general purpose mechanism to direct the output from an arbitrary system’s /dev/console to an arbitrary X server. Ownership of, and read-write permission for, /dev/console is required in order to redirect console output.

⚠️ okay but seriously: this is not your general-purpose “pipe any console anywhere” button. You need ownership of and read-write permission for /dev/console to redirect console output.

-display display_name — Specify the X11 display server. This defaults to the DISPLAY environment variable. The display_name argument specifies the X11 display to which dtterm connects. 🌈
-e program_argument ... — (there’s a stray 10 chillin’ in the source text right after the ... here, so I’m keeping it visible: ..." 10) Specify an executable program and any command-line arguments dtterm invokes as a subprocess when dtterm is started. It must be the last option on the command line. The program_argument arguments specify the program and any command-line arguments to be invoked by dtterm.
-fb fontset — Specify an XFontSet used by dtterm when displaying bold terminal text. The XFontSet should be specified as a Motif XmFontList(3). The terminal emulator supports only character or mono-spaced fonts. When using proportional fonts, the behavior is undefined. The terminal emulator generates a default bold font based on the XLFD name of the userFont. If that font is not available, the terminal emulator generates bold text by overstriking (with a one pixel offset) the userFont. The fontset argument specifies the bold terminal XFontSet used by dtterm.

🫶 tiny caveat, bestie: character or mono-spaced fonts only. Proportional fonts? undefined behavior. We don’t do that here.

-fg foreground_color — Specify the foreground color of the terminal window as well as the default foreground color used by dtterm for the scroll bar and for the X11 pointer cursor. This option defaults to either the primary colorset foreground (default) or select pixel. The foreground_color argument specifies the foreground color.
-fn fontset — Specify an XFontSet used by dtterm when displaying terminal text. It should be specified as a Motif XmFontList(3). Only character or mono-spaced fonts are supported. When using proportional fonts, the behavior is undefined. This font is not used to display non-terminal text (such as menu bar, popup menus or dialogs). The default uses the XmNtextFontList value of the parent bulletin board (see the XmBulletinBoard widget) in the same manner as the XmText widget. The fontset argument specifies the terminal XFontSet.
-font fontset — Equivalent to -fn. The fontset argument specifies the terminal XFontSet.
-foreground foreground_color — Equivalent to -fg. The foreground_color argument specifies the foreground color used by dtterm.
-geometry geometry_string — Specify the terminal window’s preferred size and position. Width and height are expressed in characters. The default size is 24 lines of 80 characters each. There is no default position. The geometry_string argument specifies the terminal geometry used by dtterm. 📐
-help — Display a message summarizing dtterm usage.
-iconic — Display the terminal emulator initially in an iconified state.
+iconic — Display the terminal emulator initially as a normal window. This is the default behavior.
-j — Use jump scrolling. With jump scrolling, the screen may be scrolled more than one line at a time. This provides for faster screen updates when multiple lines of text are sent to the terminal. The maximum number of lines that may be jump scrolled is limited to the number of lines in the terminal window. The dtterm terminal emulator guarantees that all lines are displayed. This is the default behavior. 🔥
+j — Do not use jump scrolling.
-kshMode — Enable ksh mode. In ksh mode, a key pressed with the extend modifier bit set generates an escape character followed by the character generated by the un-extended keystroke. This option is provided for use with emacs command-line editor mode of ksh(1). It conflicts with the normal meta key use for generating extended single byte characters and for generating multi-byte Asian characters.
+kshMode — Do not enable ksh(1) mode. This is the default behavior.
-l — Enables output logging. When dtterm enables logging, all output received from the subprocess is logged either to a file or to a command pipeline (as specified via the -lf option described in the following paragraph). Since data are logged directly from the subprocess, the log file includes all escape characters and carriage-return and newline pairs the terminal line discipline sends. The application may enable and disable logging via escape sequences.
+l — Disable output logging. This is the default behavior.
-lf file_name — Name the file to which dtterm writes the output log. If the file_name argument begins with a pipe symbol (|), dtterm assumes the rest of the string to be a command to be used as the endpoint of a pipe. The default file name is DttermLog XXXXX (where XXXXX is a unique value) and is created in the directory from which the subprocess was started. The file_name argument specifies the log file name used by dtterm for logging. 🎀
-ls — Start a login shell (the first character of argv[0] is a dash), indicating to the shell that it should read the system’s profile and the user’s .profile files (for ksh(1) and sh(1)), or the system’s csh.login and the user’s .login (for csh(1)).
+ls — Start a normal (non-login) shell. This is the default behavior.
-map — Map (de-iconify) dtterm upon subprocess output if dtterm is unmapped (iconified). The user can specify, via the mapOnOutputDelay resource, an initial period of time during which dtterm does not map itself upon subprocess output.
+map — Indicate there is no special mapping behavior. This is the default behavior.
-mb — Ring a bell when the user types at a specified distance from the right margin. The distance from the right margin is specified by the -nb option.
+mb — Do not ring a bell when the user types near the right margin. This is the default behavior.
-ms pointer_color — Specify the foreground color used by dtterm for the terminal window’s (X11) pointer cursor. The default is the terminal window’s foreground color (see -foreground). The pointer_color argument specifies the pointer foreground color used by dtterm.
-name prog_name — Specify the X11 name of the dtterm window. The prog_name argument specifies the name to use.
-nb number — Ring the bell this number of characters from the right margin when enabled. The default is 10. The number argument specifies the number of characters. 🔔
-rw — Enable reverse-wraparound.
+rw — Do not enable reverse-wraparound. This is the default behavior.

okay bestie, we are still in the flag zone, and these next options are lowkey carrying the whole terminal-emulator vibe ✨

-Sccn — Run the terminal emulator against a pre-opened pty or STREAMS pseudo-terminal device. The terminal emulator provides this option to use when the pseudo-terminal device name is of the form tty?? (that is, exactly two characters following the tty). This option is intended for use when dtterm is programmatically invoked from within another application. The cc argument specifies the last two characters of the pseudo-terminal device's slave name where the pseudo-terminal device slave name is of the form tty??. This value is ignored, but must be exactly two characters in length. The n argument specifies the file descriptor number that corresponds to the pseudo-terminal device's already opened master side. 🫶
-Sc.n — Equivalent to -Sccn, but provided for systems with a larger pseudo-terminal device name space. The c argument specifies the last component of the pseudo-terminal device slave name. The terminal emulator ignores this value and the value may be empty. The n argument specifies the number of the file descriptor that corresponds to the pseudo-terminal device's already opened master side. 💅
-sb — Display a scroll bar. This is the default behavior. 💖
+sb — Do not display a scroll bar. 🙈
-sf — Generate Sun Function Key escape sequences instead of standard ANSI escape sequences for the terminal's function keys. 🔥
+sf — Generate standard ANSI escape sequences instead of Sun Function Key escape sequences for the terminal's function keys. This is the default behavior. ✨
-sl screens[s|l] — Specify the number of lines in the terminal buffer beyond the length of the window. The option value consists of a number followed by an optional suffix. If no suffix is included or the suffix is l (ell), the total length of the terminal buffer is screens plus the length of the terminal window. If the suffix is s (ess) the total length of the terminal buffer is ( screens+1) times the length of the terminal window. The dtterm utility attempts to maintain the same buffer-to-window ratio when the window is resized larger. The default is 4s. The screens argument specifies the number of screens or lines to save. 🎀
-ti term_id — Specify the name used by dtterm to select the correct response to terminal ID queries. Valid values are vt100, vt101, vt102, and vt220. The default is vt220. The term_id argument specifies the terminal ID to use. 🦋
-title title_string — The title_string argument specifies the window title used by dtterm. The title defaults to the last component of the program's path if the -e option is specified; otherwise the title defaults to Terminal. 👑
-tm term_modes — Specify a string containing terminal-setting keywords and the characters to which they can be bound. Allowable keywords include: intr, quit, erase, kill, eof, eol, swtch, start, stop, brk, susp, dsusp, rprnt, flush, weras and lnext. The terminal emulator correctly parses and silently ignores keywords that do not apply to a specific architecture. Control characters can be specified as ⁁char (for example, ⁁c or ⁁u), and ⁁? can be used to indicate Delete. This is useful for overriding the default terminal settings without having to do an stty(1) every time a DtTerm widget is created. The default is NULL. The term_modes argument specifies the terminal mode string. 🌸
-tn term_name — Specify a name to which dtterm sets the TERM environment variable. The default is dtterm. The term_name argument specifies the terminal name used by dtterm. 💜
-usage — Display a usage message on the screen. 🌈
-vb — Use a visual bell instead of an audible one. Flash the window instead of ringing the terminal bell whenever a &<control>-G is received. 💀
+vb — Use an audio bell instead of a visual one. This is the default behavior. 🔔
-xrm resource_string — Allow the user to specify the X11 Resource Manager-style resources on the command line. The resource_string argument specifies an X11 resource string. (See XrmParseCommand(3) and XGetDefault(3) for more information.) 🧚

🧾 OPERANDS

None. 🫥

📥 STDIN

Not used. 🙅‍♀️

🗂️ INPUT FILES

None. 📭

🌈 ENVIRONMENT VARIABLES

The following environment variables affect the execution of dtterm:

DISPLAY — Specify the default X Windows display to connect to (see -display ). The terminal emulator sets the subprocess's DISPLAY environment variable to the connected X11 display name. 🖥️
HOME — Determine the user's home directory, the location of configuration files. 🏠
LANG — Provide a default value for the internationalization variables that are unset or null. If LANG is unset or null, the corresponding value from the implementation-specific default locale will be used. If any of the internationalization variables contains an invalid setting, the utility behaves as if none of the variables had been defined. 🌍
LC_ALL — If set to a non-empty string value, override the values of all the other internationalization variables. 👑
LC_MESSAGES — Determine the locale that is used to affect the format and contents of diagnostic messages written to standard error and informative messages written to standard output. 💬
NLSPATH — Determine the location of message catalogues for the processing of LC_MESSAGES. 📚
SHELL — Determine the default application to run. 🐚
XAPPLRESDIR — Specify the name of a directory that contains application-specific resources. If this environment variable is defined, and is set to an existing directory, then it is searched (in addition to the standard locations) for files containing application-specific resource specifications. 🗂️
XENVIRONMENT — Specify the name of a resource file with user- or machine-specific resources. If this variable is not defined, dtterm looks for a file named $HOME/.Xdefaults-hostname instead, where hostname is the name of the host where the application is executing. 🏷️
XFILESEARCHPATH — Define a language-dependent location of app-defaults. 🔎
XMODIFIER — Specify which input method to use. ⌨️
XUSERFILESEARCHPATH — Control where X applications look for their app-defaults resource files. The default is located in the directory /nix/store/6waxpwr8lzfzc9ka48gl7yh60rqvlkdb-cde-2.5.3/app-defaults. The user must set XUSERFILESEARCHPATH if the user's resource files are not in this location. 📁

The terminal emulator creates the following variable when it invokes another process:

TERM — The terminal emulator sets the subprocess's TERM environment variable to the termName resource value. Applications use this variable to determine the type of escape sequences to use when driving the terminal emulator. 🖥️
TERMINAL_EMULATOR — The terminal emulator sets the subprocess's TERMINAL_EMULATOR environment variable to dtterm to indicate that the process is running from a dtterm terminal emulator. 🧚
WINDOWID — The terminal emulator sets the subprocess's WINDOWID environment variable to the window number of the window in which text is rendered. 🪟

🌈 RESOURCES 🌈

Okay bestie, so dtterm lets you shape its whole personality through X11 resources as well as the command-line interface. Here is the full list of defined resources — names, classes, types, and defaults, all preserved exactly. No cap. 💅

🎀 The `dtterm` Client Resource Set 🎀

allowSendEvents — class AllowSendEvents, type Boolean, default False
appCursorDefault — class AppCursorDefault, type Boolean, default False
appKeypadDefault — class AppKeypadDefault, type Boolean, default False
autoWrap — class AutoWrap, type Boolean, default True
background — class Background, type String, default: (none shown in the table)
backgroundIsSelect — class BackgroundIsSelect, type Boolean, default False
blinkRate — class BlinkRate, type int, default 250
borderColor — class BorderColor, type String, default "black"
borderWidth — class BorderWidth, type int, default 0
c132 — class C132, type Boolean, default False
charCursorStyle — class CharCursorStyle, type String, default "char_cursor_box"
consoleMode — class ConsoleMode, type Boolean, default False
foreground — class Foreground, type String, default: (none shown in the table)
geometry — class Geometry, type String, default NULL
iconic — class Iconic, type Boolean, default False
iconName — class IconName, type String, default "dtterm"
jumpScroll — class JumpScroll, type Boolean, default True
kshMode — class KshMode, type Boolean, default False
logging — class Logging, type Boolean, default False
logFile — class LogFile, type String, default "DttermLogXXXXX" (where XXXXX is a unique value)
logInhibit — class LogInhibit, type Boolean, default False
loginShell — class LoginShell, type Boolean, default False
mapOnOutput — class AutoMap, type Boolean, default False
mapOnOutputDelay — class MapDelay, type int, default 0
marginBell — class MarginBell, type Boolean, default False
menuBar — class MenuBar, type Boolean, default True
menuPopup — class MenuPopup, type Boolean, default True
nMarginBell — class NMarginBell, type int, default 10
pointerBlank — class PointerBlank, type Boolean, default False
pointerBlankDelay — class PointerBlankDelay, type int, default 2
pointerColor — class Foreground, type String, default foreground color
pointerColorBackground — class Background, type String, default background color
pointerShape — class PointerShape, type String, default "xterm"
reverseWrap — class ReverseWrap, type Boolean, default False
saveLines — class SaveLines, type String, default 4s
scrollBar — class ScrollBar, type Boolean, default True
sunFunctionKeys — class SunFunctionKeys, type Boolean, default False
termId — class TermId, type String, default "vt220"
termName — class TermName, type String, default "dtterm"
title — class Title, type String, default "dtterm"
ttyModes — class TtyModes, type String, default NULL
userBoldFont — class UserBoldFont, type XmFontList, default dynamic
userFont — class UserFont, type XmFontList, default dynamic
visualBell — class VisualBell, type Boolean, default False

The resource table also ends with this formatting directive: tgroup dispwid="6.98in"

Psst: iconGeometry has a full description below even though it didn’t get its own row in the table above. 🫶

🦋 What Each Resource Actually Does 🦋

allowSendEvents — Says the terminal emulator can allow synthetic events, meaning events generated and sent by another application. Bestie, enabling this opens up a possible security hole. 💀 Keep that in mind.
appCursorDefault — If True, the cursor keys start off in application mode. If False, they start off in cursor mode.
appKeypadDefault — If True, the keypad keys start off in application mode. If False, they start off in numeric mode.
autoWrap — Tells you whether auto-wraparound is initially enabled or not.
background — Sets the background color of the terminal window, plus the default background color for the scroll bar. This resource defaults to either the primary colorset background or the select pixel — see backgroundIsSelect.
backgroundIsSelect — Says the terminal window should use the Motif select color instead of the background color for the terminal window’s background color. Iconic.
blinkRate — The number of milliseconds the cursor is in the on and off states while blinking. A value of 250 blinks the cursor two times per second. A value of zero turns blinking off. ✨
borderColor — The border color for the window. The window border need not be visible when re-parenting window managers are used.
borderWidth — The border width of the shell widget’s window. This value may be overridden by re-parenting window managers.
c132 — Says whether the DECCOLM escape sequence is honored. That’s the one that switches between a 132- and 80-column window.
charCursorStyle — Sets the shape of the text cursor. A char_cursor_box value gives you a cursor the width and height of the base font’s bounding box. A char_cursor_bar value gives you a cursor the width of the base font’s bounding box, 2 pixels high, and drawn with its top on the baseline. Cute little cursor details, honestly. 🎀
consoleMode — Says output directed at /dev/console should be directed instead to the terminal window. It’s provided as a way to prevent output that would normally be displayed on the internal terminal emulator (ITE) from overwriting the X server’s display. It is not provided as a general mechanism to direct the output from an arbitrary system’s /dev/console to an arbitrary X server. Ownership of, and read-write permission for, /dev/console is required in order to redirect console output. Periodt.
foreground — The foreground of the terminal window, plus the default used by dtterm for the scroll bar and the color used for the pointer cursor. This resource defaults to the primary colorset foreground pixel.
geometry — The terminal window’s preferred size and position. The default size is 24 lines of 80 characters each. There is no default position.
iconGeometry — The preferred position of the terminal emulator’s icon. Window managers may ignore this value. There is no default.
iconic — Says whether the terminal emulator starts out displayed in an iconified state.
iconName — The name for the icon. When used with the -e option, the default is the last component of the program’s path; otherwise, the default is the last component of the name used to execute dtterm — that is, argv[0].
jumpScroll — Says dtterm should use jump scrolling. With jump scrolling, the screen may be scrolled more than one line at a time. This gives faster screen updates when multiple lines of text are sent to the terminal. The maximum number of lines that may be jump scrolled is limited to the number of lines in the terminal window. The dtterm terminal emulator guarantees that all lines are displayed. Slay.
kshMode — Enables ksh mode. In ksh mode, a key pressed with the extend modifier bit set generates an escape character followed by the character generated by the un-extended keystroke. This option is provided for use with the emacs command-line editor mode of ksh(1). It conflicts with the normal meta key use for generating extended single byte characters and for generating multi-byte Asian characters. So yeah — iconic feature, but it does clash with those other uses. 😭
logging — Enables output logging. When logging is enabled, all output received from the subprocess is logged either to a file or to a command pipeline, as specified via the logFile option. Since the data is logged directly from the subprocess, it includes all escape characters and carriage-returns and newline pairs the terminal line discipline sends. Logging may be enabled and disabled via escape sequences.
logFile — The filename to which dtterm writes the output log. If the filename begins with a pipe symbol (|), dtterm assumes the rest of the string is a command to be used as the endpoint of a pipe. The default filename is DttermLogXXXXX (where XXXXX is a unique value) and is created in the directory from which the subprocess was started.
logInhibit — Tells dtterm to inhibit device and file logging.
loginShell — Says the shell that is started should be a login shell — that is, the first character of argv[0] is a dash — indicating that the shell should read the system’s profile and the user’s .profile files (for ksh(1) and sh(1)) or the system csh.login and the user’s .login (for csh(1)). Shell lore, fr fr. 🐚
mapOnOutput — Says the terminal emulator should map (de-iconify) itself upon subprocess output if it is unmapped (iconified). The user can specify, via the mapOnOutputDelay resource, an initial period of time during which dtterm does not map itself upon subprocess output.
mapOnOutputDelay — The number of seconds after start-up that dtterm does not honor the mapOnOutput resource. This allows the application to send initial output — for example, shell prompts — to the terminal without auto mapping the window. The default is zero (no delay).
marginBell — Says whether the bell rings when the user types near the right margin. The distance from the right margin is specified by the nMarginBell resource. 🔔
menuBar — Says dtterm displays a pulldown menu bar. The default is True.
menuPopup — Says dtterm displays a popup menu. The default is True.
nMarginBell — The number of characters from the right margin at which the margin bell rings, when enabled.
pointerBlank — tells dtterm to put the pointer cursor into blanking mode. In this mode, the cursor turns on when the pointer is moved, and it gets blanked after a selectable number of seconds or after keyboard input. The pointerBlankDelay resource sets that delay. 💤
pointerBlankDelay — the number of seconds to wait after the pointer has stopped moving before blanking the pointer (see pointerBlank). A value of zero delays pointer blanking until a key is pressed. ⏳
pointerColor — the foreground color used by dtterm for the terminal window's pointer (X11) cursor. The default is the terminal window's foreground color (see foreground). 🎨
pointerColorBackground — the background color used by dtterm for the terminal window's pointer (X11) cursor. The default is the terminal window's background color (see background). 🖌️
pointerShape — the X cursor font character used by dtterm as the pointer cursor. The font character must be specified as a string from the X11/cursorfont.h header with the leading XC_ removed. The default is xterm(1). 🖱️
reverseWrap — specifies whether or not reverse-wraparound is enabled. 🔁
saveLines — specifies the number of lines in the terminal buffer beyond the length of the window. The option value consists of a number followed by an optional suffix. If no suffix is included or the suffix is "l" (ell), the total length of the terminal buffer is screens plus the length of the terminal window. If the suffix is "s" (ess), the total length of the terminal buffer is ( screens+1) times the length of the terminal window. The dtterm utility attempts to maintain the same buffer-to-window ratio when the window is resized larger. 📜
scrollBar — specifies that dtterm displays a scroll bar. 🎚️
sunFunctionKeys — specifies whether dtterm generates Sun Function Key escape sequences instead of standard ANSI escape sequences for the terminal's function keys. ☀️
termId — supplies the name used to select the correct response to terminal ID queries. Valid values are vt100, vt101, vt102, and vt220. 🆔
termName — specifies a name to which dtterm sets the TERM environment variable. The default is dtterm. 🏷️
title — specifies the window title. When used with the -e option, the default is the last component of the program's path; otherwise, the default is the last component of the name used to execute dtterm (that is, argv[0]). ✨
ttyModes — specifies a string containing terminal-setting keywords and the characters to which they can be bound. Allowable keywords include: intr, quit, erase, kill, eof, eol, swtch, start, stop, brk, susp, dsusp, rprnt, flush, weras and lnext. The terminal emulator correctly parses and silently ignores keywords that do not apply to a specific architecture. Control characters can be specified as ⁁char (for example, ⁁c or ⁁u), and ⁁? can be used to indicate Delete. This is useful for overriding the default terminal settings without having to do an stty(1) every time a DtTerm widget is created. ⌨️
userBoldFont — specifies an XFontSet used by dtterm when displaying bold terminal text. The XFontSet should be specified as a Motif XmFontList(3). The terminal emulator supports only character or mono-spaced fonts. When using proportional fonts, the behavior is undefined. The terminal emulator generates a default bold font based on the XLFD name of the userFont. If that font is not available, dtterm generates bold text by overstriking (with a one pixel offset) the userFont. 🫶
userFont — specifies an XFontSet used by dtterm when displaying terminal text. XFontSet should be specified as a Motif XmFontList(3). The terminal emulator supports only character or mono-spaced fonts. When using proportional fonts, the behavior is undefined. This font is not used to display non-terminal text (such as menu bar, popup menu and dialog). The default is the XmNtextFontList value of the parent bulletin board (see the XmBulletinBoard widget) in the same manner as the XmText widget. 🔤
visualBell — indicates that a visual bell is preferred over an audible one. Instead of ringing the terminal bell whenever a &<control>-G is received, the window is flashed. 💥

🎀 Resource/Option Correspondence 🎀

Many of the preceding resources correspond to the command-line arguments. The following table describes the relationship between the two:

Command-line option            Resource Setting
-132                           *c132: True
+132                           *c132: False
-aw                            *autoWrap: True
+aw                            *autoWrap: False
-background background_color   *background: background_color
-bg background_color           *background: background_color
-bs                            *backgroundIsSelect: True
+bs                            *backgroundIsSelect: False
-C                             *consoleMode: True
-display display_name          .display: display_name
-e program_argument...
-fb fontset                    *userBoldFont: fontset
-fg foreground_color           *foreground: foreground_color
-fn fontset                    *userFont: fontset
-font fontset                  *userFont: fontset
-foreground foreground_color   *foreground: foreground_color
-geometry geometry_string      .geometry: geometry_string
-iconic                        .iconic: True
+iconic                        .iconic: False
-j                             *jumpScroll: True
+j                             *jumpScroll: False
-kshMode                       *kshMode: True
+kshMode                       *kshMode: False
-l                             *logging: True
+l                             *logging: False
-lf file_name                  *logFile: file_name
-ls                            *loginShell: True
+ls                            *loginShell: False
-map                           *mapOnOutput: True
+map                           *mapOnOutput: False
-mb                            *marginBell: True
+mb                            *marginBell: False
-ms pointer_color              *pointerColor: pointer_color
-name prog_name                .name: prog_name
-nb number                     *nMarginBell: number
-rw                            *reverseWrap: True
+rw                            *reverseWrap: False
-sb                            *scrollBar: True
+sb                            *scrollBar: False
-sf                            *sunFunctionKeys: True
+sf                            *sunFunctionKeys: False
-sl screenss                   *saveLines: screens  * lines/screen
-sl lines                      *saveLines: lines
-ti term_id                    *termId: term_id
-title title_string            .title: title_string
-tm term_modes                 *ttyModes: term_modes
-tn term_name                  *termName: term_name
-vb                            *visualBell: True
+vb                            *visualBell: False
tgroup dispwid="6.09in"

And yes, the little manpage-table tail is literally tgroup dispwid="6.09in" — we keep the weird guy. 🫡

💅 ASYNCHRONOUS EVENTS 💅

The dtterm utility takes the standard action for all signals. No special signal drama, bestie. 🚦

📤 STDOUT 📤

Not used.

🚨 STDERR 🚨

Used only for diagnostic messages.

📁 OUTPUT FILES 📁

None.

🌈 EXTENDED DESCRIPTION 🌈

🧚 On-the-Spot Preedit Style and Behavior 🧚

When the user selects the on-the-spot input method style, preedit strings are displayed in the dtterm window, causing original data within dtterm to shift out to make room for the data in the preedit buffer. 🪄

To cause dtterm to commit the preedit string, the user can select one of the following actions:

cut
paste
selection
cursor movement
commit key

Note that the input method server may interpret cursor movement events within the preedit buffer as preedit movement commands. In this case, the string may not be committed. The interpretation of these movement events is completely dependent upon the implementation of the input method server. 😭

In addition to the generic actions listed above, there are several action routines defined in the DtTerm widget that may cause committal. These action routines include move_cursor, process_bdrag, and string. The action routines correspond to the generic commit actions listed above. 🧠

When the preedit buffer is active, it may be highlighted. This highlight value can be set by the input method server. Since there is only a single highlight mode available in the DtTerm widget, the following XIMFeedbacks will set the highlight:

XIMPrimary
XIMSecondary
XIMTertiary

🏁 EXIT STATUS 🏁

0 — successful completion
>0 — an error occurred

💀 CONSEQUENCES OF ERRORS 💀

Default.

🫶 APPLICATION USAGE 🫶

None.

🎀 EXAMPLES 🎀

None.

👀 SEE ALSO 👀

Dt/Term.h - DtTerm(5),  stty(1), dtterm(5), X(1), XmFontList(3),
XmText(3), pty(7), tty(7).

🏁 Footer vibes: source/version dtterm(user cmd) plus the date, both chilling at the bottom of the page doing their cute little footer dance. Mwah 💋✨

📦 where this page comes from

nixos 26.05: cde 2.5.3
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms

DTTERM(1)

🎀 dtterm — user cmd edition 🎀

🌸 NAME 🌸

✨ SYNOPSIS ✨

🦋 DESCRIPTION 🦋

💖 OPTIONS 💖

🧾 OPERANDS

📥 STDIN

🗂️ INPUT FILES

🌈 ENVIRONMENT VARIABLES

🌈 RESOURCES 🌈

🎀 The dtterm Client Resource Set 🎀

🦋 What Each Resource Actually Does 🦋

🎀 Resource/Option Correspondence 🎀

💅 ASYNCHRONOUS EVENTS 💅

📤 STDOUT 📤

🚨 STDERR 🚨

📁 OUTPUT FILES 📁

🌈 EXTENDED DESCRIPTION 🌈

🧚 On-the-Spot Preedit Style and Behavior 🧚

🏁 EXIT STATUS 🏁

💀 CONSEQUENCES OF ERRORS 💀

🫶 APPLICATION USAGE 🫶

🎀 EXAMPLES 🎀

👀 SEE ALSO 👀

🎀 The `dtterm` Client Resource Set 🎀