1493 lines
80 KiB
Plaintext
1493 lines
80 KiB
Plaintext
<!-- $XConsortium: term.sgm /main/16 1996/11/15 15:22:47 cdedoc $ -->
|
|
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
|
|
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
|
|
<!-- (c) Copyright 1995 International Business Machines Corp. -->
|
|
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
|
|
<!-- (c) Copyright 1995 Novell, Inc. -->
|
|
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
|
|
<!-- (c) Copyright 1995 Hitachi. -->
|
|
<![ %CDE.C.CDE; [<refentry id="CDEMX.XCSA.MAN8.rsml.1">]]><![ %CDE.C.XO; [<refentry
|
|
id="XCSA.MAN8.rsml.1">]]><refmeta><refentrytitle>dtterm</refentrytitle><manvolnum>
|
|
user cmd</manvolnum></refmeta><refnamediv><refname><command>dtterm</command></refname>
|
|
<refpurpose>emulate a terminal window</refpurpose></refnamediv>
|
|
<refsynopsisdiv>
|
|
<!-- following kludge because HP man command does not display \(+- correctly-->
|
|
<cmdsynopsis>
|
|
<command>dtterm</command>
|
|
<arg choice="opt">±132</arg>
|
|
<arg choice="opt">±aw</arg>
|
|
<arg choice="opt">−background <replaceable>background_color</replaceable></arg>
|
|
<arg choice="opt">−bg <replaceable>background_color</replaceable></arg>
|
|
<arg choice="opt">±bs</arg>
|
|
<arg choice="opt">−C</arg>
|
|
<arg choice="opt">−display <replaceable>display_name</replaceable></arg>
|
|
<arg choice="opt">−e <replaceable>program_argument ...</replaceable></arg>
|
|
<arg choice="opt">−fb <replaceable>fontset</replaceable></arg>
|
|
<arg choice="opt">−fg <replaceable>foreground_color</replaceable></arg>
|
|
<arg choice="opt">−fn <replaceable>fontset</replaceable></arg>
|
|
<arg choice="opt">−font <replaceable>fontset</replaceable></arg>
|
|
<arg choice="opt">−foreground <replaceable>foreground_color</replaceable></arg>
|
|
<arg choice="opt">−geometry <replaceable>geometry_string</replaceable></arg>
|
|
<arg choice="opt">−help</arg>
|
|
<arg choice="opt">±iconic</arg>
|
|
<arg choice="opt">±j</arg>
|
|
<arg choice="opt">±kshMode</arg>
|
|
<?sml-break><!-- for the sake of tbl after docbook-to-man -->
|
|
<arg choice="opt">±l</arg>
|
|
<arg choice="opt">−lf <replaceable>file_name</replaceable></arg>
|
|
<arg choice="opt">±ls</arg>
|
|
<arg choice="opt">±map</arg>
|
|
<arg choice="opt">±mb</arg>
|
|
<arg choice="opt">−ms <replaceable>pointer_color</replaceable></arg>
|
|
<arg choice="opt">−name <replaceable>prog_name</replaceable></arg>
|
|
<arg choice="opt">−nb <replaceable>number</replaceable></arg>
|
|
<arg choice="opt">±rw</arg>
|
|
<arg choice="opt">−S <replaceable>ccn</replaceable></arg>
|
|
<arg choice="opt">−S <replaceable>c.n</replaceable></arg>
|
|
<arg choice="opt">±sb</arg>
|
|
<arg choice="opt">±sf</arg>
|
|
<group><arg>−sl <replaceable>screens</replaceable></arg>
|
|
<group><arg>s </arg><arg> l</arg></group></group>
|
|
<arg choice="opt">−ti <replaceable>term_id</replaceable></arg>
|
|
<arg choice="opt">−title <replaceable>title_string</replaceable></arg>
|
|
<arg choice="opt">−tm <replaceable>term_modes</replaceable></arg>
|
|
<arg choice="opt">−tn <replaceable>term_name</replaceable></arg>
|
|
<arg choice="opt">−usage</arg>
|
|
<arg choice="opt">±vb</arg>
|
|
<arg choice="opt">−xrm <replaceable>resource_string</replaceable></arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv><refsect1>
|
|
<title>DESCRIPTION</title><![ %CDE.C.CDE; [<para>The <command>dtterm</command>
|
|
utility provides runtime support of legacy applications written for terminals
|
|
conforming to <literal>ANSI X3.64-1979</literal> and <literal>ISO 6429:1992(E)</literal>, such as the DEC VT220.</para>]]><![ %CDE.C.XO; [<para>The <command>dtterm</command> utility provides runtime support of applications written
|
|
for terminals conforming to the &str-Z5; and the &str-Z6;.</para>]]></refsect1><refsect1>
|
|
<title>OPTIONS</title><![ %CDE.C.XO; [<para>The <command>dtterm</command>
|
|
utility does not support the &str-Zu; because it uses the X Window System
|
|
convention of full-word options.</para>]]>
|
|
<para>The following options are available:</para>
|
|
<variablelist>
|
|
<varlistentry><term><literal>−132</literal></term>
|
|
<listitem>
|
|
<para>Recognize the <systemitem class="Constant">DECCOLM</systemitem> escape
|
|
sequence and resize the window appropriately. Normally, <command>dtterm</command>
|
|
ignores the <systemitem class="Constant">DECCOLM</systemitem> escape sequence,
|
|
which switches between 80- and 132-column mode.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+132</literal></term>
|
|
<listitem>
|
|
<para>Ignore the <systemitem class="Constant">DECCOLM</systemitem> escape
|
|
sequence. This is the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−aw</literal></term>
|
|
<listitem>
|
|
<para>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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+aw</literal></term>
|
|
<listitem>
|
|
<para>Do not allow auto-wraparound.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−background</literal> <symbol role="Variable">background_color</symbol></term>
|
|
<listitem>
|
|
<para>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 <literal>−bs</literal> ). <![ %CDE.C.HP; [(When not running under HPVUE,
|
|
it defaults to
|
|
<Literal>*background/*Background</Literal> with an ultimate fallback color of black.)
|
|
]]>The <symbol role="Variable">background_color</symbol> argument describes
|
|
the background color.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry><term><literal>−bg</literal> <symbol role="Variable">background_color</symbol></term>
|
|
<listitem>
|
|
<para>The <symbol role="Variable">background_color</symbol> argument describes the background color.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
|
|
<varlistentry><term><literal>−bs</literal></term>
|
|
<listitem>
|
|
<para>Use the Motif select color instead of the background color for the terminal
|
|
window's background color.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+bs</literal></term>
|
|
<listitem>
|
|
<para>Do not use the Motif select color instead of the background color for
|
|
the terminal window's background color. This is the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry><term><literal>−C</literal></term>
|
|
<listitem>
|
|
<para>Specify that output directed to <Filename>/dev/console</Filename> 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 <Filename>/dev/console</Filename> to an arbitrary X server. Ownership of, and read-write permission
|
|
for, <Filename>/dev/console</Filename> is required in order to redirect console
|
|
output.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−display</literal> <symbol role="variable">display_name</symbol></term>
|
|
<listitem>
|
|
<para>Specify the X11 display server. This defaults to the <systemitem class="EnvironVar">DISPLAY</systemitem> environment variable. The <symbol role="variable">display_name</symbol>
|
|
argument specifies the X11 display to which <command>dtterm</command> connects.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−e</literal> <symbol role="variable">program_argument
|
|
...</symbol></term>
|
|
<listitem>
|
|
<para>Specify an executable program and any command-line arguments <command>dtterm</command> invokes as a subprocess when <command>dtterm</command> is
|
|
started. It must be the last option on the command line. The <symbol role="variable">program_argument</symbol> arguments specify the program and any command-line arguments to
|
|
be invoked by <command>dtterm</command>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−fb</literal> <symbol role="variable">fontset</symbol></term>
|
|
<listitem>
|
|
<para>Specify an <structname role="typedef">XFontSet</structname> used by <command>dtterm</command> when displaying bold terminal text. The <structname role="typedef">XFontSet</structname> should be specified as a Motif <![ %CDE.C.CDE; [&cdeman.XmFontList;. ]]><![ %CDE.C.XO; [ <structname role="typedef">XmFontList</structname>. ]]>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 <literal>userFont</literal>. If that font is not available, the terminal
|
|
emulator generates bold text by overstriking (with a one pixel offset) the <literal>userFont</literal>. The <symbol role="variable">fontset</symbol> argument specifies the
|
|
bold terminal <structname role="typedef">XFontSet</structname> used by <command>dtterm</command>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−fg</literal> <symbol role="Variable">foreground_color</symbol></term>
|
|
<listitem>
|
|
<para>Specify the foreground color of the terminal window as well as the default
|
|
foreground color used by <command>dtterm</command> for the scroll bar and
|
|
the for the X11 pointer cursor. This option defaults to either the primary
|
|
colorset foreground (default) or select pixel. <![ %CDE.C.HP; [(When not running under HPVUE,
|
|
it defaults to
|
|
<Literal>*foreground/*Foreground</Literal> with an ultimate fallback color of white.)
|
|
]]>The <symbol role="Variable">foreground_color</symbol> argument specifies
|
|
the foreground color.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−fn</literal> <symbol role="variable">fontset</symbol></term>
|
|
<listitem>
|
|
<para>Specify an <structname role="typedef">XFontSet</structname> used by <command>dtterm</command> when displaying terminal text. It should be specified as
|
|
a Motif <![ %CDE.C.CDE; [&cdeman.XmFontList;. ]]><![ %CDE.C.XO; [<structname role="typedef">XmFontList</structname>. ]]>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 <systemitem class="Resource">XmNtextFontList</systemitem> value of the parent bulletin board (see the XmBulletinBoard
|
|
widget) in the same manner as the XmText widget. The <symbol role="variable">fontset</symbol>
|
|
argument specifies the terminal <structname role="typedef">XFontSet</structname>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−font</literal> <symbol role="variable">fontset</symbol></term>
|
|
<listitem>
|
|
<para>Equivalent to <literal>−fn</literal>. The <symbol role="variable">fontset</symbol>
|
|
argument specifies the terminal <structname role="typedef">XFontSet</structname>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−foreground</literal> <symbol role="Variable">foreground_color</symbol></term>
|
|
<listitem>
|
|
<para>Equivalent to <literal>−fg</literal>. The <symbol role="Variable">foreground_color</symbol> argument specifies the foreground color used by <command>dtterm</command>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−geometry</literal> <symbol role="variable">geometry_string</symbol></term>
|
|
<listitem>
|
|
<para>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 <symbol role="variable">geometry_string</symbol>
|
|
argument specifies the terminal geometry used by <command>dtterm</command>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−help</literal></term>
|
|
<listitem>
|
|
<para>Display a message summarizing <command>dtterm</command> usage.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−iconic</literal></term>
|
|
<listitem>
|
|
<para>Display the terminal emulator initially in an iconified state.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+iconic</literal></term>
|
|
<listitem>
|
|
<para>Display the terminal emulator initially as a normal window. This is
|
|
the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−j</literal></term>
|
|
<listitem>
|
|
<para>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 <command>dtterm</command> terminal emulator guarantees that all
|
|
lines are displayed. This is the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+j</literal></term>
|
|
<listitem>
|
|
<para>Do not use jump scrolling.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−kshMode</literal></term>
|
|
<listitem>
|
|
<para>Enable <command>ksh</command> mode. In <command>ksh</command> mode,
|
|
a key pressed with the extend modifier bit set generates an escape character
|
|
followed by the character generated by the un-extended keystroke. <![ %CDE.C.HP; [This option is provided for use with
|
|
<Command>emacs</Command>(1) and the emacs
|
|
command-line editor mode of
|
|
&cdeman.ksh; or
|
|
<Command>ied</Command>(1). ]]>This option is provided for use with <command>emacs</command> command-line editor mode of &cdeman.ksh;. It conflicts
|
|
with the normal meta key use for generating extended single byte characters
|
|
and for generating multi-byte Asian characters.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+kshMode</literal></term>
|
|
<listitem>
|
|
<para>Do not enable &cdeman.ksh; mode. This is the default behavior.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−l</literal></term>
|
|
<listitem>
|
|
<para>Enables output logging. When <command>dtterm</command> enables logging,
|
|
all output received from the subprocess is logged either to a file or to a
|
|
command pipeline (as specified via the <literal>−lf</literal> 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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+l</literal></term>
|
|
<listitem>
|
|
<para>Disable output logging. This is the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−lf</literal> <symbol role="Variable">file_name</symbol></term>
|
|
<listitem>
|
|
<para>Name the file to which <command>dtterm</command> writes the output log.
|
|
If the <symbol role="Variable">file_name</symbol> argument begins with a pipe
|
|
symbol ( | ), <command>dtterm</command> assumes the rest of
|
|
the string to be a command to be used as the endpoint of a pipe. The default
|
|
file name is <literal>DttermLog</literal> <symbol role="variable">XXXXX</symbol> (where <symbol role="variable">XXXXX</symbol> is a unique value) and is created
|
|
in the directory from which the subprocess was started. The <symbol role="Variable">file_name</symbol> argument specifies the log file name used by <command>dtterm</command> for logging.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−ls</literal></term>
|
|
<listitem><![ %CDE.C.CDE; [<para>Start a login shell (the first character
|
|
of <symbol role="Variable">argv</symbol>[0] is a dash), indicating to the
|
|
shell that it should read the system's <literal>profile</literal> and the
|
|
user's <Filename>.profile</Filename> files (for &cdeman.ksh; and <command>sh</command>(1)), or the system's <literal>csh.login</literal> and the user's <Filename>.login</Filename> (for <command>csh</command>(1)).</para>]]><![ %CDE.C.XO; [<para>Start a login shell (the first character of <symbol role="Variable">argv</symbol>[0]
|
|
is a dash), indicating to the shell that it should read the system's <literal>profile</literal> and the user's <Filename>.profile</Filename> files (for &cdeman.ksh; and <command>sh</command>(1)).</para>]]></listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+ls</literal></term>
|
|
<listitem>
|
|
<para>Start a normal (non-login) shell. This is the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−map</literal></term>
|
|
<listitem>
|
|
<para>Map (de-iconify) <command>dtterm</command> upon subprocess output if <command>dtterm</command> is unmapped (iconified). The user can specify, via the <literal>mapOnOutputDelay</literal> resource, an initial period of time during which <command>dtterm</command> does not map itself upon subprocess output.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+map</literal></term>
|
|
<listitem>
|
|
<para>Indicate there is no special mapping behavior. This is the default behavior.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−mb</literal></term>
|
|
<listitem>
|
|
<para>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 <literal>−nb</literal> option.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+mb</literal></term>
|
|
<listitem>
|
|
<para>Do not ring a bell when the user types near the right margin. This is
|
|
the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−ms</literal> <symbol role="variable">pointer_color</symbol></term>
|
|
<listitem>
|
|
<para>Specify the foreground color used by <command>dtterm</command> for the
|
|
terminal window's (X11) pointer cursor. The default is the terminal window's
|
|
foreground color (see <literal>−foreground</literal>). The <symbol role="variable">pointer_color</symbol> argument specifies the pointer foreground color used
|
|
by <command>dtterm</command>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−name</literal> <symbol role="variable">prog_name</symbol></term>
|
|
<listitem>
|
|
<para>Specify the X11 name of the <command>dtterm</command> window. The <symbol role="variable">prog_name</symbol> argument specifies the name to use.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−nb</literal> <symbol role="variable">number</symbol></term>
|
|
<listitem>
|
|
<para>Ring the bell this number of characters from the right margin when enabled.
|
|
The default is 10. The <symbol role="variable">number</symbol> argument specifies the
|
|
number of characters.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−rw</literal></term>
|
|
<listitem>
|
|
<para>Enable reverse-wraparound.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+rw</literal></term>
|
|
<listitem>
|
|
<para>Do not enable reverse-wraparound. This is the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−S</literal><symbol role="variable">ccn</symbol></term>
|
|
<listitem>
|
|
<para>Run the terminal emulator against a pre-opened <![ %CDE.C.CDE; [ <literal>pty</literal> or STREAMS ]]>pseudo-terminal device. The terminal emulator
|
|
provides this option to use when the pseudo-terminal device name is of the
|
|
form <literal>tty??</literal> (that is, exactly two characters following the <literal>tty</literal>). This option is intended for use when <command>dtterm</command>
|
|
is programmatically invoked from within another application. The <symbol role="variable">cc</symbol> 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 <literal>tty??</literal>. This value is ignored, but must be exactly
|
|
two characters in length. The <symbol role="Variable">n</symbol> argument
|
|
specifies the file descriptor number that corresponds to the pseudo-terminal
|
|
device's already opened master side.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−S</literal><symbol role="variable">c.n</symbol></term>
|
|
<listitem>
|
|
<para>Equivalent to <literal>−S</literal><symbol role="variable">ccn</symbol>, but
|
|
provided for systems with a larger pseudo-terminal device name space. The <symbol role="variable">c</symbol> 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 <symbol role="Variable">n</symbol> argument specifies the
|
|
number of the file descriptor that corresponds to the pseudo-terminal device's
|
|
already opened master side.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−sb</literal></term>
|
|
<listitem>
|
|
<para>Display a scroll bar. This is the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+sb</literal></term>
|
|
<listitem>
|
|
<para>Do not display a scroll bar.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−sf</literal></term>
|
|
<listitem>
|
|
<para>Generate Sun Function Key escape sequences instead of <![ %CDE.C.CDE; [standard
|
|
ANSI escape sequences ]]><![ %CDE.C.XO; [the escape sequences described in <xref
|
|
role="2" linkend="XCSA.M5DTT.anch.1">]]>for the terminal's function keys. <![ %CDE.C.XO; [See <xref
|
|
role="3" linkend="XCSA.M5DTT.anch.4">for a description of the Sun Function
|
|
Key escape sequences. ]]></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+sf</literal></term>
|
|
<listitem>
|
|
<para>Generate <![ %CDE.C.CDE; [standard ANSI escape sequences ]]><![ %CDE.C.XO; [the
|
|
escape sequences described in <xref role="2" linkend="XCSA.M5DTT.anch.1">]]>instead
|
|
of Sun Function Key escape sequences for the terminal's function keys. This
|
|
is the default behavior.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−sl</literal> <symbol role="Variable">screens</symbol>[<literal>s|l</literal>]</term>
|
|
<listitem>
|
|
<para>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 <symbol role="Variable">screens</symbol> plus the
|
|
length of the terminal window. If the suffix is "s" (ess) the total length
|
|
of the terminal buffer is ( <symbol role="Variable">screens</symbol>+1) times
|
|
the length of the terminal window. The <command>dtterm</command> utility attempts
|
|
to maintain the same buffer-to-window ratio when the window is resized larger.
|
|
The default is <literal>4s</literal>. The <symbol role="Variable">screens</symbol>
|
|
argument specifies the number of screens or lines to save.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−ti</literal> <symbol role="variable">term_id</symbol></term>
|
|
<listitem>
|
|
<para>Specify the name used by <command>dtterm</command> to select the correct
|
|
response to terminal ID queries. Valid values are <literal>vt100</literal>, <literal>vt101</literal>, <literal>vt102</literal>, and <literal>vt220</literal>. The
|
|
default is <literal>vt220</literal>. The <symbol role="variable">term_id</symbol> argument
|
|
specifies the terminal ID to use.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−title</literal> <symbol role="variable">title_string</symbol></term>
|
|
<listitem>
|
|
<para>The <symbol role="variable">title_string</symbol> argument specifies
|
|
the window title used by <command>dtterm</command>. The title
|
|
defaults to the last component of the program's path if the
|
|
<literal>-e</literal> option is specified;
|
|
otherwise the title defaults to <literal>Terminal</literal>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−tm</literal> <symbol role="variable">term_modes</symbol></term>
|
|
<listitem>
|
|
<para>Specify a string containing terminal-setting keywords and the characters
|
|
to which they can be bound. Allowable keywords include: <literal>intr</literal>, <literal>quit</literal>, <literal>erase</literal>, <literal>kill</literal>, <literal>eof</literal>, <literal>eol</literal>, <literal>swtch</literal>, <literal>start</literal>, <literal>stop</literal>, <literal>brk</literal>, <literal>susp</literal>, <literal>dsusp</literal>, <literal>rprnt</literal>, <literal>flush</literal>, <literal>weras</literal> and <literal>lnext</literal>. The
|
|
terminal emulator correctly parses and silently ignores keywords that do not
|
|
apply to a specific architecture. Control characters can be specified as <literal>⁁</literal><symbol role="Variable">char</symbol> (for example, <literal>⁁c</literal> or <literal>⁁u</literal>), and <literal>⁁?</literal> can be used to indicate Delete. <![ %CDE.C.CDE; [This is useful
|
|
for overriding the default terminal settings without having to do an <command>stty</command>(1) every time a DtTerm widget is created. ]]>The default is <systemitem class="Constant">NULL</systemitem>. The <symbol role="variable">term_modes</symbol> argument
|
|
specifies the terminal mode string.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−tn</literal> <symbol role="variable">term_name</symbol></term>
|
|
<listitem>
|
|
<para>Specify a name to which <command>dtterm</command> sets the <systemitem class="environvar">TERM</systemitem> environment variable. The default is <command>dtterm</command>.
|
|
The <symbol role="variable">term_name</symbol> argument specifies the terminal name used
|
|
by <command>dtterm</command>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−usage</literal></term>
|
|
<listitem>
|
|
<para>Display a usage message on the screen.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−vb</literal></term>
|
|
<listitem>
|
|
<para>Use a visual bell instead of an audible one. Flash the window instead
|
|
of ringing the terminal bell whenever a <control>-G is received.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>+vb</literal></term>
|
|
<listitem>
|
|
<para>Use an audio bell instead of a visual one. This is the default behavior.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><literal>−xrm</literal> <symbol role="variable">resource_string</symbol></term>
|
|
<listitem>
|
|
<para>Allow the user to specify the X11 Resource Manager-style resources on
|
|
the command line. The <symbol role="variable">resource_string</symbol> argument specifies
|
|
an X11 resource string. (See <function>XrmParseCommand</function>(3) and <function>XGetDefault</function>(3) for more information.)</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1><refsect1>
|
|
<title>OPERANDS</title>
|
|
<para>None.</para>
|
|
</refsect1><refsect1>
|
|
<title>STDIN</title>
|
|
<para>Not used.</para>
|
|
</refsect1><refsect1>
|
|
<title>INPUT FILES</title>
|
|
<para>None.</para>
|
|
</refsect1><refsect1>
|
|
<title>ENVIRONMENT VARIABLES</title>
|
|
<para>The following environment variables affect the execution of <command>dtterm</command>:</para>
|
|
<variablelist>
|
|
<varlistentry><term><systemitem class="EnvironVar">DISPLAY</systemitem></term>
|
|
<listitem>
|
|
<para>Specify the default X Windows display to connect to (see <literal>−display</literal> ). The terminal emulator sets the subprocess's <systemitem class="EnvironVar">DISPLAY</systemitem> environment variable to the connected X11 display name.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="EnvironVar">HOME</systemitem></term>
|
|
<listitem>
|
|
<para>Determine the user's home directory, the location of configuration files.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="EnvironVar">LANG</systemitem></term>
|
|
<listitem>
|
|
<para>Provide a default value for the internationalization variables that
|
|
are unset or null. If <systemitem class="EnvironVar">LANG</systemitem> 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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">LC_ALL</systemitem></term>
|
|
<listitem>
|
|
<para>If set to a non-empty string value, override the values of all the other
|
|
internationalization variables.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">LC_MESSAGES</systemitem></term>
|
|
<listitem>
|
|
<para>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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="EnvironVar">NLSPATH</systemitem></term>
|
|
<listitem>
|
|
<para>Determine the location of message catalogues for the processing of <systemitem class="environvar">LC_MESSAGES</systemitem>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="EnvironVar">SHELL</systemitem></term>
|
|
<listitem>
|
|
<para>Determine the default application to run.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="EnvironVar">XAPPLRESDIR</systemitem></term>
|
|
<listitem>
|
|
<para>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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="EnvironVar">XENVIRONMENT</systemitem></term>
|
|
<listitem>
|
|
<para>Specify the name of a resource file with user- or machine-specific resources.
|
|
If this variable is not defined, <command>dtterm</command> looks for a file
|
|
named <filename>$HOME/.Xdefaults-</filename> <symbol role="variable">hostname</symbol>
|
|
instead, where <symbol role="variable">hostname</symbol> is the name of the host where
|
|
the application is executing.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="EnvironVar">XFILESEARCHPATH</systemitem></term>
|
|
<listitem>
|
|
<para>Define a language-dependent location of <literal>app-defaults</literal>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">XMODIFIER</systemitem></term>
|
|
<listitem>
|
|
<para>Specify which input method to use.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="EnvironVar">XUSERFILESEARCHPATH</systemitem></term>
|
|
<listitem>
|
|
<para>Control where X applications look for their <literal>app-defaults</literal>
|
|
resource files. The default is located in the directory <Filename>/usr/dt/app-defaults</Filename>. <![ %CDE.C.HP; [(Under Motif without CDE, the default is
|
|
<Filename>/usr/lib/X11/app-defaults</Filename>). ]]>The user must set <systemitem class="EnvironVar">XUSERFILESEARCHPATH</systemitem> if the user's resource
|
|
files are not in this location.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para>The terminal emulator creates the following variable when it invokes
|
|
another process:</para>
|
|
<variablelist><![ %CDE.C.HP; [<VarListEntry>
|
|
<Term><SystemItem Class="EnvironVar">COLUMNS</SystemItem></Term>
|
|
<ListItem>
|
|
<Para>The terminal emulator sets the subprocess's
|
|
<SystemItem Class="EnvironVar">COLUMNS</SystemItem> environment variable to the number of columns present in the terminal
|
|
window at creation.
|
|
If the size of the terminal window is subsequently
|
|
changed the terminal emulator uses the
|
|
<systemitem class="environvar">TIOCSWINSZ</systemitem> <Function>ioctl</Function> to inform the applications running against it of the new column count.
|
|
Under normal use, the user's shell updates
|
|
<SystemItem Class="EnvironVar">COLUMNS</SystemItem> with the updated value.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<VarListEntry>
|
|
<Term><SystemItem Class="EnvironVar">LINES</SystemItem></Term>
|
|
<ListItem>
|
|
<Para>The terminal emulator sets the subprocess's
|
|
<SystemItem Class="EnvironVar">LINES</SystemItem> environment variable to the number of lines present in the terminal
|
|
window at creation.
|
|
If the size of the terminal window is subsequently
|
|
changed, the terminal emulator uses the
|
|
<SystemItem Class="Constant">TIOCSWINSZ</SystemItem> <Function>ioctl</Function>(2) to inform the applications running against it of the newline count.
|
|
Under normal use, the user's shell updates
|
|
<SystemItem Class="EnvironVar">LINES</SystemItem> with the updated value.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
]]>
|
|
<varlistentry><term><systemitem class="environvar">TERM</systemitem></term>
|
|
<listitem>
|
|
<para>The terminal emulator sets the subprocess's <systemitem class="environvar">TERM</systemitem>
|
|
environment variable to the <literal>termName</literal> resource value. Applications
|
|
use this variable to determine the type of escape sequences to use when driving
|
|
the terminal emulator.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">TERMINAL_EMULATOR</systemitem></term>
|
|
<listitem>
|
|
<para>The terminal emulator sets the subprocess's <systemitem class="environvar">TERMINAL_EMULATOR</systemitem> environment variable to <command>dtterm</command> to indicate
|
|
that the process is running from a <command>dtterm</command> terminal emulator.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">WINDOWID</systemitem></term>
|
|
<listitem>
|
|
<para>The terminal emulator sets the subprocess's <systemitem class="environvar">WINDOWID</systemitem>
|
|
environment variable to the window number of the window in which text is rendered.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1><refsect1>
|
|
<title>RESOURCES</title>
|
|
<para>The <command>dtterm</command> utility allows the user to specify behavior
|
|
through X11 resources as well as the command-line interface. The following
|
|
is a list of the defined resources:</para>
|
|
<informaltable remap="center" orient="port">
|
|
<tgroup cols="4" colsep="0" rowsep="0">
|
|
<?PubTbl tgroup dispwid="6.98in">
|
|
<colspec align="left" colname="col1" colwidth="215*">
|
|
<colspec align="left" colname="col2" colwidth="173*">
|
|
<colspec align="left" colwidth="79*">
|
|
<colspec align="left" colwidth="109*">
|
|
<spanspec nameend="col2" namest="col1" spanname="1to2">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" spanname="1to2" valign="top"><literal>The dtterm Client
|
|
Resource Set</literal></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><literal>Name</literal></entry>
|
|
<entry align="left" valign="top"><literal>Class</literal></entry>
|
|
<entry align="left" valign="top"><literal>Type</literal></entry>
|
|
<entry align="left" valign="top"><literal>Default</literal></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">allowSendEvents</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>AllowSendEvents</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">appCursorDefault</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>AppCursorDefault</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">appKeypadDefault</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>AppKeypadDefault</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">autoWrap</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>AutoWrap</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">True</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">background</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>Background</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">backgroundIsSelect</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>BackgroundIsSelect</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<!-- !!!! normal VUE string:-->
|
|
<!-- backgroundIsSelect@BackgroundIsSelect@Boolean@True-->
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">blinkRate</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>BlinkRate</classname></entry>
|
|
<entry align="left" valign="top"><StructName Role="typedef">int</StructName></entry>
|
|
<entry align="left" valign="top">250</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">borderColor</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>BorderColor</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">"black"</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">borderWidth</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>BorderWidth</classname></entry>
|
|
<entry align="left" valign="top"><StructName Role="typedef">int</StructName></entry>
|
|
<entry align="left" valign="top">0</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">c132</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>C132</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">charCursorStyle</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>CharCursorStyle</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">"char_cursor_box"</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">consoleMode</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>ConsoleMode</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">foreground</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>Foreground</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">geometry</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>Geometry</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">NULL</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">iconic</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>Iconic</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">iconName</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>IconName</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">"dtterm"</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">jumpScroll</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>JumpScroll</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">True</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">kshMode</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>KshMode</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">logging</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>Logging</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">logFile</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>LogFile</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">"DttermLog<symbol role="variable">XXXXX</symbol>" (where
|
|
<symbol role="variable">XXXXX</symbol> is a unique value)</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">logInhibit</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>LogInhibit</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">loginShell</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>LoginShell</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">mapOnOutput</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>AutoMap</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">mapOnOutputDelay</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>MapDelay</classname></entry>
|
|
<entry align="left" valign="top"><StructName Role="typedef">int</StructName></entry>
|
|
<entry align="left" valign="top">0</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">marginBell</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>MarginBell</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">menuBar</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>MenuBar</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">True</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">menuPopup</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>MenuPopup</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">True</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">nMarginBell</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>NMarginBell</classname></entry>
|
|
<entry align="left" valign="top"><StructName Role="typedef">int</StructName></entry>
|
|
<entry align="left" valign="top">10</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">pointerBlank</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>PointerBlank</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">pointerBlankDelay</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>PointerBlankDelay</classname></entry>
|
|
<entry align="left" valign="top"><StructName Role="typedef">int</StructName></entry>
|
|
<entry align="left" valign="top">2</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">pointerColor</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>Foreground</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">foreground color</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">pointerColorBackground</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>Background</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">background color</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">pointerShape</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>PointerShape</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">"xterm"</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">reverseWrap</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>ReverseWrap</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">saveLines</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>SaveLines</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">4s</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">scrollBar</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>ScrollBar</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">True</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">sunFunctionKeys</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>SunFunctionKeys</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">termId</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>TermId</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">"vt220"</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">termName</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>TermName</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">"dtterm"</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">title</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>Title</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">"dtterm"</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">ttyModes</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>TtyModes</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
|
|
<entry align="left" valign="top">NULL</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">userBoldFont</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>UserBoldFont</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">XmFontList</structname></entry>
|
|
<entry align="left" valign="top">dynamic</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">userFont</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>UserFont</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">XmFontList</structname></entry>
|
|
<entry align="left" valign="top">dynamic</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><systemitem class="environvar">visualBell</systemitem></entry>
|
|
<entry align="left" valign="top"><classname>VisualBell</classname></entry>
|
|
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
|
|
<entry align="left" valign="top">False</entry></row></tbody></tgroup></informaltable>
|
|
<variablelist>
|
|
<varlistentry><term><systemitem class="environvar">allowSendEvents</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies that the terminal emulator allow synthetic events (generated
|
|
and sent by another application). Enabling this resource opens up a possible
|
|
security hole.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">appCursorDefault</systemitem></term>
|
|
<listitem>
|
|
<para>If True, the cursor keys are initially in application mode. If False,
|
|
the cursor keys are initially in cursor mode.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">appKeypadDefault</systemitem></term>
|
|
<listitem>
|
|
<para>If True, the keypad keys are initially in application mode. If False,
|
|
the keypad keys are initially in numeric mode.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">autoWrap</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies whether or not auto-wraparound is initially enabled.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">background</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the background color of the terminal window as well as the
|
|
default background color for the scroll bar. This resource defaults to either
|
|
the primary colorset background or select pixel (see <systemitem class="environvar">backgroundIsSelect</systemitem> ). <![ %CDE.C.HP; [(When not being run under HPVUE,
|
|
this resource defaults to black.)
|
|
]]></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">backgroundIsSelect</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies that the terminal window should use the Motif select color
|
|
instead of the background color for the terminal window's background color.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">blinkRate</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies 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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">borderColor</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the border color for the window. The window border need not
|
|
be visible when re-parenting window managers are used.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">borderWidth</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the border width of the shell widget's window. This value
|
|
may be overridden by re-parenting window managers.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">c132</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies whether or not the <systemitem class="Constant">DECCOLM</systemitem>
|
|
escape sequence, which switches between a 132- and 80-column window, is honored.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">charCursorStyle</systemitem></term>
|
|
<listitem>
|
|
<para>This resource specifies the shape of the text cursor. A <systemitem class="Constant">char_cursor_box</systemitem> value specifies a cursor the
|
|
width and height of the base font's bounding box. A <systemitem class="Constant">char_cursor_bar</systemitem> value specifies a cursor the width of the base
|
|
font's bounding box, 2 pixels high, and drawn with its top on the baseline.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">consoleMode</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies that output directed at <Filename>/dev/console</Filename> be
|
|
directed instead to the terminal window. It is 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 <Filename>/dev/console</Filename> to an arbitrary X server. Ownership of, and read-write permission
|
|
for, <Filename>/dev/console</Filename> is required in order to redirect console
|
|
output.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">foreground</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the foreground of the terminal window as well as the default
|
|
used by <command>dtterm</command> for the scroll bar and the color used for
|
|
the pointer cursor. This resource defaults to the primary colorset foreground
|
|
pixel. <![ %CDE.C.HP; [(When not running under HPVUE,
|
|
this resource defaults to white.)
|
|
]]></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">geometry</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the terminal window's preferred size and position. The default
|
|
size is 24 lines of 80 characters each. There is no default position.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">iconGeometry</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the preferred position of the terminal emulator's icon. Window
|
|
managers may ignore this value. There is no default.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">iconic</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies whether or not the terminal emulator is initially displayed
|
|
in an iconified state.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">iconName</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the name for the icon. When used with the <literal>−e</literal> 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 <command>dtterm</command> (that is, <symbol role="Variable">argv</symbol>[0]).</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">jumpScroll</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies that <command>dtterm</command> 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 <command>dtterm</command> terminal emulator
|
|
guarantees that all lines are displayed.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">kshMode</systemitem></term>
|
|
<listitem>
|
|
<para>Enables ksh mode. With 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. <![ %CDE.C.HP; [This option is provided for use with
|
|
<Command>emacs</Command>(1) and the emacs
|
|
command-line editor mode of
|
|
&cdeman.ksh; or
|
|
<Command>ied</Command>(1). ]]>This option is provided for use with the <command>emacs</command> command-line editor mode of &cdeman.ksh;. It conflicts
|
|
with the normal meta key use for generating extended single byte characters
|
|
and for generating multi-byte Asian characters.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">logging</systemitem></term>
|
|
<listitem>
|
|
<para>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 <literal>logFile</literal> 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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">logFile</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the filename to which <command>dtterm</command> writes the
|
|
output log. If the filename begins with a pipe symbol ( | ), <command>dtterm</command> assumes the rest of the string is a command to be used as
|
|
the endpoint of a pipe. The default filename is
|
|
<filename>DttermLog</filename><symbol role="variable">XXXXX</symbol>
|
|
(where <symbol role="variable">XXXXX</symbol> is a unique value) and
|
|
is created in the directory from which the subprocess was started.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">logInhibit</systemitem></term>
|
|
<listitem>
|
|
<para>Indicates that <command>dtterm</command> inhibit device and file logging.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">loginShell</systemitem></term>
|
|
<listitem><![ %CDE.C.CDE; [<para>Indicates that the shell that is started
|
|
be a login shell (that is, the first character of <symbol role="Variable">argv</symbol>[0] is a dash), indicating that the shell should read the system's <classname>profile</classname> and the user's <Filename>.profile</Filename> files (for &cdeman.ksh; and <command>sh</command>(1)) or the system <classname>csh.login</classname> and the user's <Filename>.login</Filename> (for <command>csh</command>(1)).
|
|
</para>]]><![ %CDE.C.XO; [<para>Indicates that the shell that is started be
|
|
a login shell (that is, the first character of
|
|
<symbol role="Variable">argv</symbol>[0] is a dash), indicating that the shell should read the system's <classname>profile</classname> and the user's <Filename>.profile</Filename> files (for &cdeman.ksh; and <command>sh</command>(1)).</para>]]></listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">mapOnOutput</systemitem></term>
|
|
<listitem>
|
|
<para>Indicates that the terminal emulator map (de-iconify) itself upon subprocess
|
|
output if it is unmapped (iconified). The user can specify, via the <systemitem class="environvar">mapOnOutputDelay</systemitem> resource, an initial period of time during which <command>dtterm</command> does not map itself upon subprocess output.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">mapOnOutputDelay</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the number of seconds after start-up that <command>dtterm</command> does not honor the <systemitem class="environvar">mapOnOutput</systemitem>
|
|
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).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">marginBell</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies whether or not the bell rings when the user types near the
|
|
right margin. The distance from the right margin is specified by the <systemitem class="environvar">nMarginBell</systemitem> resource.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">menuBar</systemitem></term>
|
|
<listitem>
|
|
<para>Indicates that <command>dtterm</command> displays a pulldown menu bar.
|
|
The default is True.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">menuPopup</systemitem></term>
|
|
<listitem>
|
|
<para>Indicates that <command>dtterm</command> displays a popup menu. The
|
|
default is True.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">nMarginBell</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the number of characters from the right margin at which the
|
|
margin bell rings, when enabled.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">pointerBlank</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies that <command>dtterm</command> puts the pointer cursor into
|
|
blanking mode. In this mode, the cursor turns on when the pointer is moved,
|
|
and is blanked after a selectable number of seconds or after keyboard input.
|
|
The <systemitem class="environvar">pointerBlankDelay</systemitem> resource sets the delay.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">pointerBlankDelay</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the number of seconds to wait after the pointer has stopped
|
|
moving before blanking the pointer (see <systemitem class="environvar">pointerBlank</systemitem>).
|
|
A value of zero delays pointer blanking until a key is pressed.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">pointerColor</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the foreground color used by <command>dtterm</command> for
|
|
the terminal window's pointer (X11) cursor. The default is the terminal window's
|
|
foreground color (see <systemitem class="environvar">foreground</systemitem>).</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">pointerColorBackground</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the background color used by <command>dtterm</command> for
|
|
the terminal window's pointer (X11) cursor. The default is the terminal window's
|
|
background color (see <systemitem class="environvar">background</systemitem>).</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">pointerShape</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the X cursor font character used by <command>dtterm</command>
|
|
as the pointer cursor. The font character must be specified as a string from
|
|
the <filename role="Header">X11/cursorfont.h</filename> header with the leading <Symbol>XC_</Symbol> removed. The default is <command>xterm</command>(1).</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">reverseWrap</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies whether or not reverse-wraparound is enabled.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">saveLines</systemitem></term>
|
|
<listitem>
|
|
<para>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 <symbol role="Variable">screens</symbol> plus the
|
|
length of the terminal window. If the suffix is "s" (ess) the total length
|
|
of the terminal buffer is ( <symbol role="Variable">screens</symbol>+1) times
|
|
the length of the terminal window. The <command>dtterm</command> utility attempts
|
|
to maintain the same buffer-to-window ratio when the window is resized larger.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">scrollBar</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies that <command>dtterm</command> displays a scroll bar.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">sunFunctionKeys</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies whether <command>dtterm</command> generates Sun Function Key
|
|
escape sequences instead of <![ %CDE.C.CDE; [standard ANSI escape sequences ]]><![ %CDE.C.XO; [the
|
|
escape sequences described in <xref role="2" linkend="XCSA.M5DTT.anch.1">]]>for
|
|
the terminal's function keys. <![ %CDE.C.XO; [See <xref role="3" linkend="XCSA.M5DTT.anch.4">for
|
|
a description of the Sun Function Key escape sequences. ]]></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">termId</systemitem></term>
|
|
<listitem>
|
|
<para>Supplies the name used to select the correct response to terminal ID
|
|
queries. Valid values are <literal>vt100</literal>, <literal>vt101</literal>, <literal>vt102</literal>, and <literal>vt220</literal>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">termName</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies a name to which <command>dtterm</command> sets the <systemitem class="environvar">TERM</systemitem> environment variable. The default is <command>dtterm</command>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">title</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies the window title. When used with the <literal>−e</literal>
|
|
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 <command>dtterm</command> (that is, <symbol role="Variable">argv</symbol>[0]).</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">ttyModes</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies a string containing terminal-setting keywords and the characters
|
|
to which they can be bound. Allowable keywords include: <literal>intr</literal>, <literal>quit</literal>, <literal>erase</literal>, <literal>kill</literal>, <literal>eof</literal>, <literal>eol</literal>, <literal>swtch</literal>, <literal>start</literal>, <literal>stop</literal>, <literal>brk</literal>, <literal>susp</literal>, <literal>dsusp</literal>, <literal>rprnt</literal>, <literal>flush</literal>, <literal>weras</literal> and <literal>lnext</literal>. The
|
|
terminal emulator correctly parses and silently ignores keywords that do not
|
|
apply to a specific architecture. Control characters can be specified as <literal>⁁</literal><symbol role="Variable">char</symbol> (for example, <literal>⁁c</literal> or <literal>⁁u</literal>), and <literal>⁁?</literal> can be used to indicate Delete. <![ %CDE.C.CDE; [This is useful
|
|
for overriding the default terminal settings without having to do an <command>stty</command>(1) every time a DtTerm widget is created. ]]></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">userBoldFont</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies an <structname role="typedef">XFontSet</structname> used by <command>dtterm</command> when displaying bold terminal text. The <structname role="typedef">XFontSet</structname> should be specified as a Motif <![ %CDE.C.CDE; [&cdeman.XmFontList;. ]]><![ %CDE.C.XO; [ <structname role="typedef">XmFontList</structname>. ]]>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 <Symbol>XLFD</Symbol> name of the <classname>userFont</classname>. If that font is not
|
|
available, <command>dtterm</command> generates bold text by overstriking (with
|
|
a one pixel offset) the <systemitem class="environvar">userFont</systemitem>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">userFont</systemitem></term>
|
|
<listitem>
|
|
<para>Specifies an <structname role="typedef">XFontSet</structname> used by <command>dtterm</command> when displaying terminal text. <structname role="typedef">XFontSet</structname> should be specified as a Motif <![ %CDE.C.CDE; [&cdeman.XmFontList;. ]]><![ %CDE.C.XO; [ <structname role="typedef">XmFontList</structname>. ]]>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 <systemitem class="Resource">XmNtextFontList</systemitem> value of the parent bulletin board (see the XmBulletinBoard
|
|
widget) in the same manner as the XmText widget.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><systemitem class="environvar">visualBell</systemitem></term>
|
|
<listitem>
|
|
<para>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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<refsect2>
|
|
<title>Resource/Option Correspondence</title>
|
|
<para>Many of the preceding resources correspond to the command-line arguments.
|
|
The following table describes the relationship between the two:</para>
|
|
<informaltable remap="center" orient="port">
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<?PubTbl tgroup dispwid="6.09in">
|
|
<colspec align="left" colwidth="221*">
|
|
<colspec align="left" colwidth="281*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>Command-line option</classname></entry>
|
|
<entry align="left" valign="top"><classname>Resource Setting</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−132</classname></entry>
|
|
<entry align="left" valign="top"><classname>*c132: True</classname></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+132</classname></entry>
|
|
<entry align="left" valign="top"><classname>*c132: False</classname></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−aw</classname></entry>
|
|
<entry align="left" valign="top"><classname>*autoWrap: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+aw</classname></entry>
|
|
<entry align="left" valign="top"><classname>*autoWrap: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−background</classname> <symbol role="Variable">background_color</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*background:</classname> <symbol role="Variable">background_color</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−bg</classname> <symbol role="Variable">background_color</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*background:</classname> <symbol role="Variable">background_color</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−bs</classname></entry>
|
|
<entry align="left" valign="top"><classname>*backgroundIsSelect: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+bs</classname></entry>
|
|
<entry align="left" valign="top"><classname>*backgroundIsSelect: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−C</classname></entry>
|
|
<entry align="left" valign="top"><classname>*consoleMode: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−display</classname> <symbol role="variable">display_name</symbol></entry>
|
|
<entry align="left" valign="top"><classname>.display:</classname> <symbol role="variable">display_name</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−e</classname> <symbol role="variable">program_argument...</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−fb</classname> <symbol role="variable">fontset</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*userBoldFont:</classname> <symbol role="variable">fontset</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−fg</classname> <symbol role="Variable">foreground_color</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*foreground:</classname> <symbol role="Variable">foreground_color</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−fn</classname> <symbol role="variable">fontset</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*userFont:</classname> <symbol role="variable">fontset</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−font</classname> <symbol role="variable">fontset</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*userFont:</classname> <symbol role="variable">fontset</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−foreground</classname> <symbol role="Variable">foreground_color</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*foreground:</classname> <symbol role="Variable">foreground_color</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−geometry</classname> <symbol role="variable">geometry_string</symbol></entry>
|
|
<entry align="left" valign="top"><classname>.geometry:</classname> <symbol role="variable">geometry_string</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−iconic</classname></entry>
|
|
<entry align="left" valign="top"><classname>.iconic: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+iconic</classname></entry>
|
|
<entry align="left" valign="top"><classname>.iconic: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−j</classname></entry>
|
|
<entry align="left" valign="top"><classname>*jumpScroll: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+j</classname></entry>
|
|
<entry align="left" valign="top"><classname>*jumpScroll: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−kshMode</classname></entry>
|
|
<entry align="left" valign="top"><classname>*kshMode: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+kshMode</classname></entry>
|
|
<entry align="left" valign="top"><classname>*kshMode: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−l</classname></entry>
|
|
<entry align="left" valign="top"><classname>*logging: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+l</classname></entry>
|
|
<entry align="left" valign="top"><classname>*logging: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−lf</classname> <symbol role="Variable">file_name</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*logFile:</classname> <symbol role="Variable">file_name</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−ls</classname></entry>
|
|
<entry align="left" valign="top"><classname>*loginShell: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+ls</classname></entry>
|
|
<entry align="left" valign="top"><classname>*loginShell: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−map</classname></entry>
|
|
<entry align="left" valign="top"><classname>*mapOnOutput: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+map</classname></entry>
|
|
<entry align="left" valign="top"><classname>*mapOnOutput: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−mb</classname></entry>
|
|
<entry align="left" valign="top"><classname>*marginBell: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+mb</classname></entry>
|
|
<entry align="left" valign="top"><classname>*marginBell: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−ms</classname> <symbol role="variable">pointer_color</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*pointerColor:</classname> <symbol role="variable">pointer_color</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−name</classname> <symbol role="variable">prog_name</symbol></entry>
|
|
<entry align="left" valign="top"><classname>.name:</classname> <symbol role="variable">prog_name</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−nb</classname> <symbol role="variable">number</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*nMarginBell:</classname> <symbol role="variable">number</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−rw</classname></entry>
|
|
<entry align="left" valign="top"><classname>*reverseWrap: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+rw</classname></entry>
|
|
<entry align="left" valign="top"><classname>*reverseWrap: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−sb</classname></entry>
|
|
<entry align="left" valign="top"><classname>*scrollBar: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+sb</classname></entry>
|
|
<entry align="left" valign="top"><classname>*scrollBar: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−sf</classname></entry>
|
|
<entry align="left" valign="top"><classname>*sunFunctionKeys: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+sf</classname></entry>
|
|
<entry align="left" valign="top"><classname>*sunFunctionKeys: False</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−sl</classname> <symbol role="Variable">screens</symbol>s</entry>
|
|
<entry align="left" valign="top"><classname>*saveLines:</classname> <symbol role="Variable">screens * lines/screen</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−sl</classname> <symbol role="Variable">lines</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*saveLines:</classname> <symbol role="Variable">lines</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−ti</classname> <symbol role="variable">term_id</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*termId:</classname> <symbol role="variable">term_id</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−title</classname> <symbol role="variable">title_string</symbol></entry>
|
|
<entry align="left" valign="top"><classname>.title:</classname> <symbol role="variable">title_string</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−tm</classname> <symbol role="variable">term_modes</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*ttyModes:</classname> <symbol role="variable">term_modes</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−tn</classname> <symbol role="variable">term_name</symbol></entry>
|
|
<entry align="left" valign="top"><classname>*termName:</classname> <symbol role="variable">term_name</symbol></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>−vb</classname></entry>
|
|
<entry align="left" valign="top"><classname>*visualBell: True</classname></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><classname>+vb</classname></entry>
|
|
<entry align="left" valign="top"><classname>*visualBell: False</classname></entry>
|
|
</row>
|
|
</tbody></tgroup></informaltable>
|
|
</refsect2>
|
|
</refsect1><refsect1>
|
|
<title>ASYNCHRONOUS EVENTS</title><![ %CDE.C.XO; [<para>Default.</para>]]><![ %CDE.C.CDE; [<para>The <command>dtterm</command> utility takes the
|
|
standard action for all signals.</para>]]></refsect1><refsect1>
|
|
<title>STDOUT</title>
|
|
<para>Not used.</para>
|
|
</refsect1><refsect1>
|
|
<title>STDERR</title>
|
|
<para>Used only for diagnostic messages.</para>
|
|
</refsect1><refsect1>
|
|
<title>OUTPUT FILES</title>
|
|
<para>None.</para>
|
|
</refsect1><refsect1>
|
|
<title>EXTENDED DESCRIPTION</title>
|
|
<refsect2>
|
|
<title>On-the-Spot Preedit Style and Behavior</title>
|
|
<para>When the user selects the on-the-spot input method style, preedit
|
|
strings are displayed in the <command>dtterm</command> window, causing
|
|
original data within <command>dtterm</command> to shift out to make room
|
|
for the data in the preedit buffer.
|
|
</para>
|
|
<para>To cause <command>dtterm</command> to commit the preedit string,
|
|
the user can select one of the following actions:
|
|
</para>
|
|
<simplelist>
|
|
<member>
|
|
<classname>cut</classname>
|
|
</member>
|
|
<member>
|
|
<classname>paste</classname>
|
|
</member>
|
|
<member>
|
|
<classname>selection</classname>
|
|
</member>
|
|
<member>
|
|
<classname>cursor movement</classname>
|
|
</member>
|
|
<member>
|
|
<classname>commit key</classname>
|
|
</member>
|
|
</simplelist>
|
|
<para>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.
|
|
</para>
|
|
<para>In addition to the generic actions listed above, there are several
|
|
action routines defined in the <classname>DtTerm</classname> widget that
|
|
may cause committal. These action routines include
|
|
<classname>move_cursor</classname>, <classname>process_bdrag</classname>,
|
|
and <classname>string</classname>. The action routines correspond
|
|
to the generic commit actions listed above.
|
|
</para>
|
|
<para>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 <classname>DtTerm</classname> widget,
|
|
the following <Symbol>XIMFeedback</Symbol>s will set the highlight:
|
|
</para>
|
|
<simplelist>
|
|
<member>
|
|
<Symbol>XIMPrimary</Symbol>
|
|
</member>
|
|
<member>
|
|
<Symbol>XIMSecondary</Symbol>
|
|
</member>
|
|
<member>
|
|
<Symbol>XIMTertiary</Symbol>
|
|
</member>
|
|
</simplelist>
|
|
</refsect2>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>EXIT STATUS</title>
|
|
<variablelist remap="tight">
|
|
<varlistentry><term>0</term>
|
|
<listitem>
|
|
<para>successful completion</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>>0</term>
|
|
<listitem>
|
|
<para>an error occurred</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1><refsect1>
|
|
<title>CONSEQUENCES OF ERRORS</title>
|
|
<para>Default.</para>
|
|
</refsect1><refsect1>
|
|
<title>APPLICATION USAGE</title>
|
|
<para>None.</para>
|
|
</refsect1><refsect1>
|
|
<title>EXAMPLES</title>
|
|
<para>None.</para>
|
|
</refsect1><refsect1>
|
|
<title>SEE ALSO</title>
|
|
<para>&cdeman.Dt.Term.h;, <![ %CDE.C.CDE; [ <command>stty</command>(1), &cdeman.dttermesc;, <command>X</command>(1), &cdeman.XmFontList;, &cdeman.XmText;, <command>pty</command>(7), <command>tty</command>(7). ]]><![ %CDE.C.XO; [<classname>XmBulletinBoard</classname>, <classname>XmText</classname> in the &str-ZM;; <function>XrmParseCommand</function>(3), <function>XGetDefault</function>(3) in the &str-Zl;. ]]></para>
|
|
</refsect1></refentry>
|
|
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:40:24-->
|
|
|