1 .\" $XConsortium: dtterm.1 /main/4 1996/10/29 15:40:28 drk $
4 .\" simulate -mm .LIs by turning them into .TPs
8 .TH dtterm 1 "21 Apr 1994"
10 .\" CDE Common Source Format, Version 1.0.0
11 .\" *************************************************************************
12 .\" ** (c) Copyright 1993, 1994 Hewlett-Packard Company
13 .\" ** (c) Copyright 1993, 1994 International Business Machines Corp.
14 .\" ** (c) Copyright 1993, 1994 Sun Microsystems, Inc.
15 .\" ** (c) Copyright 1993, 1994 Novell, Inc.
16 .\" *************************************************************************
18 dtterm \(mi emulate a terminal window
26 [\(mibackground\0\f2background_color\fP]
27 [\(mibd\0\f2border_color\fP]
28 [\(mibg\0\f2background_color\fP]
29 [\(mibordercolor\0\f2border_color\fP]
30 [\(miborderwidth\0\f2border_width\fP]
32 [\(mibw\0\f2border_width\fP]
34 [\(midisplay\0\f2display_name\fP]
35 [\(mie\0\f2program_argument\0...\fP]
36 [\(mifb\0\f2fontset\fP]
37 [\(mifg\0\f2foreground_color\fP]
38 [\(mifn\0\f2fontset\fP]
39 [\(mifont\0\f2fontset\fP]
40 [\(miforeground\0\f2foreground_color\fP]
41 [\(migeometry\0\f2geometry_string\fP]
47 [\(milf\0\f2file_name\fP]
51 [\(mims\0\f2pointer_color\fP]
52 [\(miname\0\f2prog_name\fP]
53 [\(minb\0\f2number\fP]
59 [\(misl\0\f2screens\fP[s\|\|\(bv\|\|l]]
60 [\(miti\0\f2term_id\fP]
61 [\(mititle\0\f2title_string\fP]
62 [\(mitm\0\f2term_modes\fP]
63 [\(mitn\0\f2term_name\fP]
66 [\(miw\0\f2border_width\fP]
67 [\(mixrm\0\f2resource_string\fP]
73 utility provides runtime support of legacy applications
74 written for terminals conforming to \f3ANSI X3.64-1979\fP and
75 \f3ISO 6429:1992(E)\fP, such as the DEC VT220.
77 The following options are available:
84 escape sequence and resize the window appropriately.
89 escape sequence, which
90 switches between 80- and 132-column mode.
95 This is the default behavior.
97 Allow auto-wraparound.
98 This option allows the cursor to automatically wrap to the beginning of the next
99 line when it is at the right-most position of a line and text is output.
100 This is the default behavior.
102 Do not allow auto-wraparound.
103 .LI "\f3\(mibackground\fP\0\f2background_color\fP"
105 Specify the terminal window background
106 and the default background for the
107 scroll bar and the X11 pointer cursor.
108 This option defaults to either the primary colorset
109 background or select (default) pixel (see
111 (When not running under HPVUE,
113 .B *background/*Background
114 with an ultimate fallback color of black.)
117 argument describes the background color.
118 .LI "\f3\(mibd\fP\0\f2border_color\fP"
120 Specify the border color for all windows.
121 The shell widget's window border need not be visible
122 when re-parenting window managers, such as
127 The default is the color black.
130 argument describes the border color.
131 .LI "\f3\(mibg\fP\0\f2background_color\fP"
137 argument describes the background color.
138 .LI "\f3\(mibordercolor\fP\0\f2border_color\fP"
144 argument describes the border color.
145 .LI "\f3\(miborderwidth\fP\0\f2border_width\fP"
147 Specify the border width of the shell widget's window.
148 This value may be overridden by re-parenting window managers.
152 argument specifies the width of the window border in pixels.
155 select color instead of the background color for the terminal window's
157 This is the default behavior.
160 select color instead of the background color for the terminal window's
162 .LI "\f3\(mibw\fP\0\f2border_width\fP"
165 .BR \(miborderwidth .
168 argument specifies the width of the window border in pixels.
170 Specify that output directed to
172 be directed instead to the terminal window.
173 It is provided as a way to prevent output,
174 which would normally be displayed on the
175 internal terminal emulator (ITE), from overwriting the X server's display.
176 It is not provided as a general purpose mechanism to direct the output from
177 an arbitrary system's
179 to an arbitrary X server.
180 Ownership of, and read-write permission for,
182 is required in order to redirect console output.
183 .LI "\f3\(midisplay\fP\0\f2display_name\fP"
185 Specify the X11 display server.
188 environment variable.
191 argument specifies the X11 display to which
194 .LI "\f3\(mie\fP\0\f2program_argument ...\fP"
196 Specify an executable program and any command-line arguments
198 invokes as a subprocess when
201 It must be the last option on the command line.
204 arguments specify the program
205 and any command-line arguments
208 .LI "\f3\(mifb\fP\0\f2fontset\fP"
214 when displaying bold terminal text.
217 should be specified as a Motif
219 The terminal emulator supports only character or mono-spaced fonts.
220 When using proportional fonts, the behavior is undefined.
221 The terminal emulator generates a default bold font based on the
225 If that font is not available,
226 the terminal emulator
228 by overstriking (with a one pixel offset) the
232 argument specifies the bold terminal
236 .LI "\f3\(mifg\fP\0\f2foreground_color\fP"
238 Specify the foreground color of the terminal window as
239 well as the default foreground color
242 for the scroll bar and the
243 for the X11 pointer cursor.
244 This option defaults to either the primary colorset
245 foreground (default) or select pixel.
246 (When not running under HPVUE,
248 .B *foreground/*Foreground
249 with an ultimate fallback color of white.)
252 argument specifies the foreground color.
253 .LI "\f3\(mifn\fP\0\f2fontset\fP"
259 when displaying terminal text.
260 It should be specified as a Motif
262 Only character or mono-spaced fonts are supported.
263 When using proportional fonts, the behavior is undefined.
264 This font is not used to display non-terminal text (such as menu bar, popup
268 value of the parent bulletin
269 board (see the XmBulletinBoard widget)
270 in the same manner as the XmText widget.
273 argument specifies the terminal
275 .LI "\f3\(mifont\fP\0\f2fontset\fP"
281 argument specifies the terminal
283 .LI "\f3\(miforeground\fP\0\f2foreground_color\fP"
289 argument specifies the foreground color
292 .LI "\f3\(migeometry\fP\0\f2geometry_string\fP"
294 Specify the terminal window's preferred size and position.
295 Width and height are expressed in characters.
296 The default size is 24 lines of 80 characters each.
297 There is no default position.
300 argument specifies the terminal geometry
305 Display a message summarizing
310 Display the terminal emulator initially in an iconified state.
313 Display the terminal emulator initially as a normal window.
314 This is the default behavior.
317 With jump scrolling, the screen may be scrolled more than one line at a time.
318 This provides for faster screen updates when multiple lines of text are sent
320 The maximum number of lines that may be
321 jump scrolled is limited to the number of lines in the terminal window.
324 terminal emulator guarantees that all lines are displayed.
325 This is the default behavior.
327 Do not use jump scrolling.
328 .LI \f3\(mikshMode\fP
335 mode, a key pressed with the extend modifier bit set generates an
336 escape character followed by the character generated by the un-extended
338 This option is provided for use with
341 command-line editor mode of
345 This option is provided for use with
347 command-line editor mode of
349 It conflicts with the
350 normal meta key use for generating extended single byte
351 characters and for generating multi-byte Asian characters.
357 This is the default behavior.
359 Enables output logging.
362 enables logging, all output received from the subprocess is
363 logged either to a file or to a command pipeline (as specified via the
365 option described in the following paragraph).
366 Since data are logged directly from the subprocess, the log file includes
367 all escape characters and carriage-return and newline pairs the terminal
368 line discipline sends.
369 The application may enable and disable logging via escape sequences.
371 Disable output logging.
372 This is the default behavior.
373 .LI "\f3\(milf\fP\0\f2file_name\fP"
375 Name the file to which
377 writes the output log.
380 argument begins with a pipe symbol
383 assumes the rest of the string to be a command
384 to be used as the endpoint of a pipe.
389 the last five characters are replaced with
392 The default file name is
394 and is created in the directory
395 from which the subprocess was started.
398 argument specifies the log file name
403 Start a login shell (the first character of
405 is a dash), indicating
406 to the shell that it should read the system's
422 Start a normal (non-login) shell.
423 This is the default behavior.
427 upon subprocess output if
429 is unmapped (iconified).
430 The user can specify, via the
433 an initial period of time during which
435 does not map itself upon
438 Indicate there is no special mapping behavior.
439 This is the default behavior.
442 the user types at a specified distance from the right margin.
443 The distance from the
444 right margin is specified by the
448 Do not ring a bell when the user types near the right margin.
449 This is the default behavior.
450 .LI "\f3\(mims\fP\0\f2pointer_color\fP"
452 Specify the foreground color
456 window's (X11) pointer cursor.
457 The default is the terminal
458 window's foreground color (see
459 .BR \(miforeground ).
462 argument specifies the pointer foreground color
465 .LI "\f3\(miname\fP\0\f2prog_name\fP"
467 Specify the X11 name of the
472 argument specifies the name to use.
473 .LI "\f3\(minb\fP\0\f2number\fP"
475 Ring the bell this number of characters from the right
480 argument specifies the number of characters.
482 Enable reverse-wraparound.
484 Do not enable reverse-wraparound.
485 This is the default behavior.
486 .LI \f3\(miS\fP\f2ccn\fP
488 Run the terminal emulator against a pre-opened
491 pseudo-terminal device.
492 The terminal emulator provides this option to use when the
493 pseudo-terminal device name is of the form
495 (that is, exactly two characters following the
497 This option is intended for use when
499 is programmatically invoked from within another application.
502 argument specifies the last two characters of the
503 pseudo-terminal device's slave name where the
504 pseudo-terminal device slave name is of the form
506 This value is ignored, but must be exactly two characters in length.
509 argument specifies the file descriptor number that corresponds to the
510 pseudo-terminal device's already opened master side.
511 .LI \f3\(miS\fP\f2c.n\fP
513 Equivalent to \f3\(miS\fP\f2ccn\fP,
514 but provided for systems with a larger
515 pseudo-terminal device name space.
518 argument specifies the last component of the
519 pseudo-terminal device slave name.
520 The terminal emulator ignores this value and the value may be empty.
523 argument specifies the number of the file descriptor that corresponds to the
524 pseudo-terminal device's already opened master side.
526 Display a scroll bar.
527 This is the default behavior.
529 Do not display a scroll bar.
531 Generate Sun Function Key escape sequences instead of
532 standard ANSI escape sequences
533 for the terminal's function keys.
536 standard ANSI escape sequences
537 instead of Sun Function Key escape sequences for the terminal's function keys.
538 This is the default behavior.
539 .LI "\f3\(misl\fP\0\f2screens\fP[\f3s|l\fP]"
541 Specify the number of lines in the terminal buffer beyond the
542 length of the window.
543 The option value consists of a number followed by
545 If no suffix is included or the suffix is ``l'' (ell), the
546 total length of the terminal buffer is
550 If the suffix is ``s'' (ess) the total length of the
551 terminal buffer is (\c
553 times the length of the terminal window.
556 utility attempts to maintain the same buffer-to-window
557 ratio when the window is resized larger.
562 argument specifies the number of screens or lines to save.
563 .LI "\f3\(miti\fP\0\f2term_id\fP"
565 Specify the name used by
567 to select the correct response to terminal ID queries.
578 argument specifies the terminal ID to use.
579 .LI "\f3\(mititle\fP\0\f2title_string\fP"
581 Specify the window title.
584 option, the default is the last component of the program's path;
585 otherwise, the default is the last
586 component of the name used to execute
592 argument specifies the title
595 .LI "\f3\(mitm\fP\0\f2term_modes\fP"
597 Specify a string containing terminal-setting keywords
598 and the characters to which they can be bound.
599 Allowable keywords include:
617 The terminal emulator
618 correctly parses and silently ignores keywords that do not apply
619 to a specific architecture.
620 Control characters can be specified as
628 can be used to indicate Delete.
629 This is useful for overriding the default
630 terminal settings without having to do an
632 every time a DtTerm widget is created.
637 argument specifies the terminal mode string.
638 .LI "\f3\(mitn\fP\0\f2term_name\fP"
640 Specify a name to which
644 environment variable.
649 argument specifies the terminal name
654 Display a usage message on the screen.
656 Use a visual bell instead of an audible one.
657 Flash the window instead of ringing the
658 terminal bell whenever a <control>\(hyG is received.
660 Use an audio bell instead of a visual one.
661 This is the default behavior.
662 .LI "\f3\(miw\fP\0\f2border_width\fP"
665 .BR \(miborderwidth .
668 argument specifies the width of the window border in pixels.
669 .LI "\f3\(mixrm\fP\0\f2resource_string\fP"
671 Allow the user to specify the X11 Resource Manager-style
672 resources on the command line.
675 argument specifies an X11 resource string.
677 .BR XrmParseCommand (3X)
680 for more information.)
690 .SH "ENVIRONMENT VARIABLES"
691 The following environment variables affect the execution of
697 Specify the default X Windows display to connect to (see
699 The terminal emulator sets the subprocess's
701 environment variable to the connected X11 display name.
703 Determine the user's home directory,
704 the location of configuration files.
706 Provide a default value for the internationalization variables
707 that are unset or null.
710 is unset or null, the corresponding value from the
711 implementation-specific default locale will be used.
712 If any of the internationalization variables contains an invalid setting, the
713 utility behaves as if none of the variables had been defined.
715 If set to a non-empty string value,
716 override the values of all the other internationalization variables.
717 .LI \f2LC_MESSAGES\fP
718 Determine the locale that is used to affect
719 the format and contents of diagnostic
720 messages written to standard error
721 and informative messages written to standard output.
723 Determine the location of message catalogues
724 for the processing of
727 Determine the default application to run.
728 .LI \f2XAPPLRESDIR\fP
729 Specify the name of a directory that contains application-specific resources.
730 If this environment variable
731 is defined, and is set to an existing directory, then it is searched (in
732 addition to the standard locations) for files containing
733 application-specific resource specifications.
734 .LI \f2XENVIRONMENT\fP
736 Specify the name of a resource file with
737 user- or machine-specific resources.
738 If this variable is not defined,
740 looks for a file named
741 .BR $HOME/.Xdefaults- \c
746 is the name of the host where the application is executing.
747 .LI \f2XFILESEARCHPATH\fP
749 Define a language-dependent location of
752 Specify which input method to use.
753 .LI \f2XUSERFILESEARCHPATH\fP
755 Control where X applications look for their
758 The default is located in the directory
759 .BR /usr/dt/app-defaults .
760 (Under Motif without CDE, the default is
761 .BR /usr/lib/X11/app-defaults ).
763 .I XUSERFILESEARCHPATH
764 if the user's resource
765 files are not in this location.
770 The terminal emulator
771 creates the following variable when it invokes another process:
777 The terminal emulator sets the subprocess's
779 environment variable to the number of columns present in the terminal
781 If the size of the terminal window is subsequently
782 changed the terminal emulator uses the
785 to inform the applications running against it of the new column count.
786 Under normal use, the user's shell updates
788 with the updated value.
791 The terminal emulator sets the subprocess's
793 environment variable to the number of lines present in the terminal
795 If the size of the terminal window is subsequently
796 changed, the terminal emulator uses the
797 .BR \s-1TIOCSWINSZ\s+1
799 to inform the applications running against it of the newline count.
800 Under normal use, the user's shell updates
802 with the updated value.
804 The terminal emulator sets the subprocess's
806 environment variable to the
809 Applications use this variable to determine the type of escape sequences to use
810 when driving the terminal emulator.
811 .LI \f2TERMINAL_EMULATOR\fP
813 The terminal emulator sets the subprocess's
815 environment variable to
817 to indicate that the process is running from a
821 The terminal emulator sets the subprocess's
823 environment variable to the window number of the window in which text
831 utility allows the user to specify behavior through X11 resources
832 as well as the command-line interface.
833 The following is a list of the defined resources:
841 lf3 1 lf3 1 lf3 1 lf3 1
842 lf3 1 lf3 1 lf3 1 l 1 .
843 The dtterm Client Resource Set
845 Name@Class@Type@Default
847 allowSendEvents@AllowSendEvents@Boolean@False
848 appCursorDefault@AppCursorDefault@Boolean@False
849 appKeypadDefault@AppKeypadDefault@Boolean@False
850 autoWrap@AutoWrap@Boolean@True
851 background@Background@String
852 .\" !!!! version/config dependent string
853 .\" !!!! normal CDE string:
854 .\" backgroundIsSelect@BackgroundIsSelect@Boolean@False
855 .\" !!!! normal VUE string:
856 backgroundIsSelect@BackgroundIsSelect@Boolean@True
857 blinkRate@BlinkRate@int@250
858 borderColor@BorderColor@String@``black''
859 borderWidth@BorderWidth@int@0
860 c132@C132@Boolean@False
861 charCursorStyle@CharCursorStyle@String@``char_cursor_box''
862 consoleMode@ConsoleMode@Boolean@False
863 foreground@Foreground@String
864 geometry@Geometry@String@NULL
865 iconic@Iconic@Boolean@False
866 iconName@IconName@String@``dtterm''
867 jumpScroll@JumpScroll@Boolean@True
868 kshMode@KshMode@Boolean@False
869 logging@Logging@Boolean@False
870 logFile@LogFile@String@``DttermLogXXXXX''
871 logInhibit@LogInhibit@Boolean@False
872 loginShell@LoginShell@Boolean@False
873 mapOnOutput@AutoMap@Boolean@False
874 mapOnOutputDelay@MapDelay@int@0
875 marginBell@MarginBell@Boolean@False
876 menuBar@MenuBar@Boolean@True
877 menuPopup@MenuPopup@Boolean@True
878 nMarginBell@NMarginBell@int@10
879 pointerBlank@PointerBlank@Boolean@False
880 pointerBlankDelay@PointerBlankDelay@int@2
881 pointerColor@Foreground@String@foreground color
882 pointerColorBackground@Background@String@background color
883 pointerShape@PointerShape@String@``xterm''
884 reverseWrap@ReverseWrap@Boolean@False
885 saveLines@SaveLines@String@4s
886 scrollBar@ScrollBar@Boolean@True
887 sunFunctionKeys@SunFunctionKeys@Boolean@False
888 termId@TermId@String@``vt220''
889 termName@TermName@String@``dtterm''
890 title@Title@String@``dtterm''
891 ttyModes@TtyModes@String@NULL
892 userBoldFont@UserBoldFont@XmFontList@dynamic
893 userFont@UserFont@XmFontList@dynamic
894 visualBell@VisualBell@Boolean@False
902 .LI \f3allowSendEvents\fP
904 Specifies that the terminal emulator allow
905 synthetic events (generated and sent by another application).
906 Enabling this resource opens up a possible security hole.
907 .LI \f3appCursorDefault\fP
910 the cursor keys are initially in application mode.
912 the cursor keys are initially in cursor mode.
913 .LI \f3appKeypadDefault\fP
916 the keypad keys are initially in application mode.
918 the keypad keys are initially in numeric mode.
921 Specifies whether or not auto-wraparound is initially
926 background color of the terminal window as well as the default background
929 This resource defaults to either the primary
933 .BR backgroundIsSelect ).
934 (When not being run under HPVUE,
935 this resource defaults to black.)
936 .LI \f3backgroundIsSelect\fP
938 Specifies that the terminal window should use the Motif
939 select color instead of the background color for the terminal window's
943 Specifies the number of milliseconds the cursor is in the
944 on and off states while blinking.
945 A value of 250 blinks the cursor two times per second.
946 A value of zero turns blinking off.
947 .LI \f3borderColor\fP
949 Specifies the border color for the window.
951 need not be visible when re-parenting window managers are used.
952 .LI \f3borderWidth\fP
954 Specifies the border width of the shell widget's window.
955 This value may be overridden by re-parenting window managers.
957 Specifies whether or not the
959 escape sequence, which
960 switches between a 132- and 80-column window, is honored.
961 .LI \f3charCursorStyle\fP
963 This resource specifies the shape of the text cursor.
966 value specifies a cursor the width and height of the base
970 value specifies a cursor the
971 width of the base font's bounding box, 2 pixels high, and drawn with its
973 .LI \f3consoleMode\fP
975 Specifies that output directed at
977 be directed instead to the terminal window.
978 It is provided as a way to
979 prevent output, that would normally be displayed on the internal terminal emulator
980 (ITE), from overwriting the X server's display.
981 It is not provided as a general mechanism to
982 direct the output from an arbitrary system's
984 to an arbitrary X server.
985 Ownership of, and read-write permission for,
987 is required in order to redirect console output.
990 Specifies the foreground of the terminal window as well as
994 for the scroll bar and the color used for the pointer cursor.
995 This resource defaults to the primary
996 colorset foreground pixel.
997 (When not running under HPVUE,
998 this resource defaults to white.)
1001 Specifies the terminal window's preferred size and position.
1002 The default size is 24 lines of 80 characters each.
1003 There is no default position.
1004 .LI \f3iconGeometry\fP
1006 Specifies the preferred position of the terminal emulator's icon.
1007 Window managers may ignore this value.
1008 There is no default.
1011 Specifies whether or not the terminal emulator is initially
1012 displayed in an iconified state.
1015 Specifies the name for the icon.
1019 is the last component of the program's path;
1021 the default is the last component of the name used to execute
1025 .LI \f3jumpScroll\fP
1031 scrolling, the screen may be scrolled more than one line at a time.
1032 This provides for faster screen updates when multiple lines of text are
1033 sent to the terminal.
1034 The maximum number of lines that may be
1035 jump scrolled is limited to the number of lines in the terminal window.
1038 terminal emulator guarantees that all lines are displayed.
1043 mode, a key pressed with the extend modifier bit set generates an
1044 escape character followed by the character generated by the un-extended
1046 This option is provided for use with
1049 command-line editor mode of
1053 This option is provided for use with the
1055 command-line editor mode of
1057 It conflicts with the
1058 normal meta key use for generating extended single byte
1059 characters and for generating multi-byte Asian characters.
1062 Enables output logging.
1063 When logging is enabled, all
1064 output received from the subprocess is logged either to a file or to a
1065 command pipeline (as specified via the
1068 Since the data is logged directly from the subprocess, it includes all
1069 escape characters and
1070 carriage-returns and newline pairs
1071 the terminal line discipline sends.
1072 Logging may be enabled and disabled via escape sequences.
1075 Specifies the filename to which
1077 writes the output log.
1078 If the filename begins with a pipe symbol
1082 the rest of the string is a command to be used as the
1084 If the filename ends in
1086 the last five characters are replaced with
1089 The default filename is
1091 and is created in the directory from which the subprocess
1093 .LI \f3logInhibit\fP
1097 inhibit device and file logging.
1098 .LI \f3loginShell\fP
1100 Indicates that the shell that is started be a login
1101 shell (that is, the first character of
1103 is a dash), indicating
1104 that the shell should read the system's
1119 .LI \f3mapOnOutput\fP
1121 Indicates that the terminal emulator map
1122 (de-iconify) itself upon subprocess output if it is unmapped (iconified).
1123 The user can specify, via the
1126 an initial period of time during which
1129 upon subprocess output.
1130 .LI \f3mapOnOutputDelay\fP
1132 Specifies the number of seconds after start-up that
1137 This allows the application to send
1138 initial output (for example, shell prompts) to the terminal without
1139 auto mapping the window.
1140 The default is zero (no delay).
1141 .LI \f3marginBell\fP
1143 Specifies whether or not the bell rings when the user types near
1145 The distance from the right margin is specified by
1153 displays a pulldown menu bar.
1160 displays a popup menu.
1163 .LI \f3nMarginBell\fP
1165 Specifies the number of characters from the right margin at which the
1166 margin bell rings, when enabled.
1167 .LI \f3pointerBlank\fP
1171 puts the pointer cursor into blanking mode.
1172 In this mode, the cursor turns on when the pointer
1173 is moved, and is blanked after a selectable number of
1174 seconds or after keyboard input.
1176 .B pointerBlankDelay
1177 resource sets the delay.
1178 .LI \f3pointerBlankDelay\fP
1180 Specifies the number of seconds to wait after the pointer
1181 has stopped moving before blanking the pointer (see
1183 A value of zero delays pointer blanking until a key is pressed.
1184 .LI \f3pointerColor\fP
1186 Specifies the foreground color
1190 window's pointer (X11) cursor.
1191 The default is the terminal window's foreground color (see
1193 .LI \f3pointerColorBackground\fP
1195 Specifies the background color
1199 window's pointer (X11) cursor.
1200 The default is the terminal window's background color (see
1202 .LI \f3pointerShape\fP
1204 Specifies the X cursor font character
1209 The font character must be specified as a string from the
1210 .BR <X11/cursorfont.h>
1211 header with the leading
1216 .LI \f3reverseWrap\fP
1218 Specifies whether or not reverse-wraparound is
1222 Specifies the number of lines in the terminal buffer beyond the
1223 length of the window.
1224 The option value consists of a number followed by
1226 If no suffix is included or the suffix is ``l'' (ell), the
1227 total length of the terminal buffer is
1230 the terminal window.
1231 If the suffix is ``s'' (ess) the total length of the
1232 terminal buffer is (\c
1234 times the length of the terminal window.
1237 utility attempts to maintain the same buffer-to-window
1238 ratio when the window is resized larger.
1243 displays a scroll bar.
1244 .LI \f3sunFunctionKeys\fP
1248 generates Sun Function Key escape sequences instead of
1249 standard ANSI escape sequences
1250 for the terminal's function keys.
1253 Supplies the name used to select the correct response to
1254 terminal ID queries.
1263 Specifies a name to which
1267 environment variable.
1272 Specifies the window title.
1276 is the last component of the program's path;
1278 the default is the last component of the name
1285 Specifies a string containing terminal-setting keywords
1286 and the characters to which they can be bound.
1287 Allowable keywords include:
1305 The terminal emulator
1306 correctly parses and silently ignores keywords that do not apply
1307 to a specific architecture.
1308 Control characters can be specified as
1316 can be used to indicate Delete.
1317 This is useful for overriding the default
1318 terminal settings without having to do an
1320 every time a DtTerm widget is created.
1321 .LI \f3userBoldFont\fP
1327 when displaying bold
1331 should be specified as a Motif
1332 .BR XmFontList (3X).
1333 The terminal emulator supports only character or mono-spaced fonts.
1334 When using proportional fonts, the behavior is undefined.
1335 The terminal emulator generates a default bold font based on the
1339 If that font is not available,
1342 by overstriking (with a one pixel offset) the
1350 when displaying terminal text.
1352 should be specified as a Motif
1353 .BR XmFontList (3X).
1354 The terminal emulator supports only character or mono-spaced fonts.
1355 When using proportional fonts, the behavior is undefined.
1356 This font is not used
1357 to display non-terminal text (such as menu bar, popup menu and dialog).
1360 value of the parent bulletin board
1361 (see the XmBulletinBoard widget)
1362 in the same manner as the XmText widget.
1363 .LI \f3visualBell\fP
1365 Indicates that a visual bell is preferred over an audible one.
1366 Instead of ringing the terminal bell whenever a <control>\(hyG is
1367 received, the window is flashed.
1371 .SS "Resource/Option Correspondence"
1372 Many of the preceding resources correspond to the command-line arguments.
1373 The following table describes the relationship between the two:
1378 Command-line option Resource Setting
1382 \(miaw *autoWrap: True
1383 \+aw *autoWrap: False
1384 \(mibackground \f2background_color\fP *background: \f2background_color\fP
1385 \(mibd \f2border_color\fP *borderColor: \f2border_color\fP
1386 \(mibg \f2background_color\fP *background: \f2background_color\fP
1387 \(mibordercolor \f2border_color\fP *borderColor: \f2border_color\fP
1388 \(miborderwidth \f2border_width\fP .borderWidth: \f2border_width\fP
1389 \(mibs *backgroundIsSelect: True
1390 \+bs *backgroundIsSelect: False
1391 \(mibw \f2border_width\fP .borderWidth: \f2border_width\fP
1392 \(miC *consoleMode: True
1393 \(midisplay \f2display_name\fP .display: \f2display_name\fP
1394 \(mie \f2program_argument...\fP
1395 \(mifb \f2fontset\fP *userBoldFont: \f2fontset\fP
1396 \(mifg \f2foreground_color\fP *foreground: \f2foreground_color\fP
1397 \(mifn \f2fontset\fP *userFont: \f2fontset\fP
1398 \(mifont \f2fontset\fP *userFont: \f2fontset\fP
1399 \(miforeground \f2foreground_color\fP *foreground: \f2foreground_color\fP
1400 \(migeometry \f2geometry_string\fP .geometry: \f2geometry_string\fP
1401 \(miiconic .iconic: True
1402 \+iconic .iconic: False
1403 \(mij *jumpScroll: True
1404 \+j *jumpScroll: False
1405 \(mikshMode *kshMode: True
1406 \+kshMode *kshMode: False
1407 \(mil *logging: True
1409 \(milf \f2file_name\fP *logFile: \f2file_name\fP
1410 \(mils *loginShell: True
1411 \+ls *loginShell: False
1412 \(mimap *mapOnOutput: True
1413 \+map *mapOnOutput: False
1414 \(mimb *marginBell: True
1415 \+mb *marginBell: False
1416 \(mims \f2pointer_color\fP *pointerColor: \f2pointer_color\fP
1417 \(miname \f2prog_name\fP .name: \f2prog_name\fP
1418 \(minb \f2number\fP *nMarginBell: \f2number\fP
1419 \(mirw *reverseWrap: True
1420 \+rw *reverseWrap: False
1421 \(misb *scrollBar: True
1422 \+sb *scrollBar: False
1423 \(misf *sunFunctionKeys: True
1424 \+sf *sunFunctionKeys: False
1425 \(misl \f2screens\fPs *saveLines: \f2screens\fP * lines/screen
1426 \(misl \f2lines\fP *saveLines: \f2lines\fP
1427 \(miti \f2term_id\fP *termId: \f2term_id\fP
1428 \(mititle \f2title_string\fP .title: \f2title_string\fP
1429 \(mitm \f2term_modes\fP *ttyModes: \f2term_modes\fP
1430 \(mitn \f2term_name\fP *termName: \f2term_name\fP
1431 \(mivb *visualBell: True
1432 \+vb *visualBell: False
1433 \(miw \f2border_width\fP .borderWidth: \f2border_width\fP
1435 .SH "ASYNCHRONOUS EVENTS"
1438 utility takes the standard action for all signals.
1442 Used only for diagnostic messages.
1445 .SH "EXTENDED DESCRIPTION"
1452 successful completion
1458 .SH "CONSEQUENCES OF ERRORS"
1460 .SH "APPLICATION USAGE"
1468 .BR XmFontList (3X),