HPTERM(1X)HPTERM(1X)NAME
hpterm - X window system Hewlett-Packard terminal emulator.
SYNOPSIS
hpterm [-toolkitoption] [-option]
DESCRIPTION
The hpterm program is a terminal emulator for the X Window system. It
provides a Term0 compatible terminal for programs that can't use the
window system directly. It also emulates many of the block mode fea‐
tures of HP terminals. Refer to the WARNINGS section below for addi‐
tional information about running block mode applications.
OPTIONS
The hpterm terminal emulator accepts all of the standard X Toolkit com‐
mand line options along with additional options all of which are listed
below (if the option begins with a `+' instead of a `-', the option is
restored to its default value):
-b number
This option specifies the size of the inner border (the dis‐
tance between the outer edge of the character and the window
border) in pixels. Associated resource: *borderWidth.
-background color
This option specifies the color to use for the background of
the window. Associated resource: *background.
-bd color
This option specifies the color to use for the border of the
window. Associated resource: *borderColor.
-bg color
This option specifies the color to use for the background of
the window. Associated resource: *background.
-borderwidth number
This option specifies the width in pixels of the border sur‐
rounding the window. Associated resource: *borderWidth.
-bs This option indicates that the "background" of the term0 text
entry window should be the select color that corresponds to the
specified background color. Associated resource: *back‐
groundIsSelect.
+bs This option indicates that the "background" of the term0 text
entry window should be the specified background. Associated
resource: *backgroundIsSelect.
-bw number
This option specifies the width in pixels of the border sur‐
rounding the window. Associated resource: *borderWidth.
-cr color
This option specifies the color to use for the text cursor.
Associated resource: *cursorColor.
-display display
This option specifies the X server to contact; see X(1). Asso‐
ciated resource: none.
-e command
This option specifies the command (and its command line argu‐
ments) to be run in the hpterm window. The default is to start
the user's shell. This must be the last option on the command
line. Associated resource: none.
-fb fontset
This option specifies a font to be used when displaying bold
(alternate) text. This font must be the same height and width
as the normal (primary) font. If only one of the normal (pri‐
mary) or bold (alternate) fonts is specified, it will be used
for both fonts. The fontset should be specified as a Motif
XmFontList(3X). Associated resource: *userBoldFont.
-fg color
This option specifies the color to use for displaying text.
Associated resource: *foreground.
-fn fontset
This option specifies a font to be used when displaying normal
(primary) text. If only one of the normal (primary) or bold
(alternate) fonts is specified, it will be used for both fonts.
The fontset should be specified as a Motif XmFontList(3X).
Associated resource: *userFont.
-font fontset
This option specifies a font to be used when displaying normal
(primary) text. If only one of the normal (primary) or bold
(alternate) fonts is specified, it will be used for both fonts.
The fontset should be specified as a Motif XmFontList(3X).
This option is provided for backwards compatability only and
will be removed in the next major release of HP-UX; use the -fn
option instead. Associated resource: *userFont.
-foreground color
This option specifies the color to use for displaying text.
Associated resource: *foreground.
-geometry geometry
This option specifies the preferred size and position of the
hpterm window; see X(1). Associated resource: hpterm*geometry.
-help This option will display a help message. Associated resource:
none.
-i This option indicates that hpterm should supply the window man‐
ager with a bitmapped icon. Associated resource: bitmapIcon.
+i This option indicates that the window manager should generate
its own icon for hpterm. Associated resource: bitmapIcon.
-iconic This option indicates that hpterm should be placed on the dis‐
play in icon form. Associated resource: *term0.iconic.
+iconic This option indicates that hpterm should not be placed on the
display in icon form. Associated resource: *term0.iconic.
-kshmode
This option indicates that hpterm should convert characters
entered with the extend key pressed into a two character
sequence consisting of an ASCII escape followed by the un-
extended character. Associated resource: *kshMode.
-l This option indicates that hpterm should send all terminal out‐
put to a log file as well as to the screen. Associated
resource: *logging.
+l This option indicates that hpterm should not do logging. Asso‐
ciated resource: *logging.
-lf file
This option specifies the name of the file to which the output
log described above is written. If file begins with a pipe
symbol (|), the rest of the string is assumed to be a command
to be used as the endpoint of a pipe. The default filename is
HptermLogXXXXX (where XXXXX is the process id of hpterm) and is
created in the directory from which hpterm was started. Asso‐
ciated resource: *logFile.
-ls This option indicates that the shell that is started in the
hpterm window should be a login shell (i.e. the first character
of argv[0] will be a dash, indicating to the shell that it
should read the user's /etc/profile and .profile (for ksh and
sh) or /etc/csh.login and .login (for csh). This option is
ignored when the -e option is also used. Associated resource:
*loginShell.
+ls This option indicates that the shell that is started should not
be a login shell (i.e. it will be a normal ``subshell'').
Associated resource: *loginShell.
-map This option indicates that hpterm should map (de-iconify)
itself upon pty output if it is unmapped (iconified). An ini‐
tial period of time during which hpterm will not map itself
upon pty output may be specified via the mapOnOutputDelay
resource. Associated resource: *mapOnOutput.
+map This option indicates that hpterm should not map (de-iconify)
itself upon pty output if it is unmapped (iconified). Associ‐
ated resource: *mapOnOutput.
-mb This option indicates that the pointer cursor should be put
into blanking mode. In this mode, the cursor will turn on when
the pointer is moved, and will be blanked either after a
selectable number of seconds or after keyboard input has
occurred. The delay is set via the pointerBlankDelay resource.
Associated resource: *pointerBlank.
+mb This option indicates that the pointer cursor should remain on.
Associated resource: *pointerBlank.
-mc mode
This option determines how hpterm will generate the foreground
color, shadow colors, and shadow tiles of the scrollbar and
softkey widgets. Valid modes are ``all'', ``shadow'', and
``none.'' Associated resource: *makeColors.
-ms color
This option specifies the color to be used for the pointer cur‐
sor. Associated resource: *pointerColor.
-name name
This option specifies the application name under which
resources are to be obtained, rather than the default exe‐
cutable file name (``hpterm''). Associated resource: .name.
-reverse
This option indicates that reverse video should be simulated by
swapping the foreground and background colors. Associated
resource: *reverseVideo.
-rv This option indicates that reverse video should be simulated by
swapping the foreground and background colors. Associated
resource: *reverseVideo.
+rv This option indicates that reverse video should not be simu‐
lated. Associated resource: *reverseVideo.
-sb This option indicates that a scrollbar should be displayed.
Associated resource: *scrollBar.
+sb This option indicates that a scrollbar should not be displayed.
Associated resource: *scrollBar.
-sbbg color
This option specifies the color to use for the background of
the scrollbar window. Associated resource: *scrollBar.back‐
ground.
-sbfg color
This option specifies the color to use for the foreground of
the scrollbar window. This value will be ignored if the make‐
Colors resource is set to all. Associated resource: *scroll‐
Bar.foreground.
-skbg color
This option specifies the color to use for the background of
the softkey window. Associated resource: *softkey.background.
-skfg color
This option specifies the color to use for displaying softkey
text. This value will be ignored if the makeColors resource is
set to all. Associated resource: *softkey.foreground.
-skfn fontset
This option specifies a font to be used when displaying softkey
text. The fontset should be specified as a Motif
XmFontList(3X). Associated resource: *softkey.userFont.
-sl number[suffix]
This option indicates the number of off screen lines to be
saved in the terminal buffer. If no suffix is included or the
suffix is l, the total length of the terminal buffer will be
number plus the length of the terminal window. If the suffix
is s the total length of the terminal buffer will be (number
plus one) times the length of the terminal window. Associated
resource: *saveLines.
-ti name
This option specifies a name for hpterm to use when identifying
itself to application programs. Refer to the WARNINGS section
for additional information about using hpterm with block mode
applications. Associated resource: *termId.
-title name
This option specifies a window title for hpterm. This string
may be used by the window manager when displaying the applica‐
tion. Associated resource: *title.
-tm string
This option specifies a string containing terminal-setting key‐
words and the characters to which they may be bound. Associ‐
ated resource: *ttyModes.
-tn name
This option specifies a name for hpterm to set the $TERM envi‐
ronment variable to. Associated resource: *termName.
-vb This option 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 will be flashed. Associated
resource: *visualBell.
+vb This option indicates that a visual bell should not be used.
Associated resource: *visualBell.
-xrm resourcestring
This option specifies a resource string to be used. This is
especially useful for setting resources that do not have sepa‐
rate command line options. Associated resource: none.
-C This option indicates that the window should receive console
output. The server must be authorized to receive console out‐
put. See ``XConsoles'' below for additional information.
Associated resource: none.
-Sccn This option specifies the last two letters of the name of a
pseudoterminal to use in slave mode, and the file descriptor of
the pseudoterminal's master. This allows hpterm to be used as
an input and output channel for an existing program and is
sometimes used in specialized applications such as pam(1).
This option will only work with pty names of the form
``ttyxx.'' For example, ``-S p01'' specifies ``ttyp0'' on file
descriptor 1. Associated resource: none.
-Spty.fd
This option specifies the unique portion of the name of a pseu‐
doterminal to use in slave mode, and the file descriptor of the
pseudoterminal's master. This allows hpterm to be used as an
input and output channel for an existing program and is some‐
times used in specialized applications such as pam(1). This
option will work for all pty names. For example, ``-S p0.1''
specifies ``ttyp0'' on file descriptor 1 and ``-S p02.13''
specifies ``ttyp02'' on file descriptor 13. Associated
resource: none.
The following command line arguments are provided for compati‐
bility with
older versions. They may not be supported in future releases as
the X Toolkit provides standard options that accomplish the same
task.
Thisoptionspecifiesthepreferredpositionoftheiconwindow.
It is shorthand for specifying the *iconGeometry resource.
Associated resource: .iconGeometry.
-T string
This option specifies the title for hpterm's window. It is
equivalent to -title string. Associated resource: *title.
-n string
This option specifies the icon name for hpterm's windows. It
is shorthand for specifying the *iconName resource. Associated
resource: *iconName.
-r This option indicates that reverse video should be simulated by
swapping the foreground and background colors. It is equiva‐
lent to -reversevideo or -rv. Associated resource: *reverseV‐
ideo.
+r This option indicates that reverse video should not be simu‐
lated. It is equivalent to +rv. Associated resource: *rever‐
seVideo.
-w number
This option specifies the width in pixels of the border sur‐
rounding the window. It is equivalent to -borderwidth number
or -bw number. Associated resource: *borderWidth.
RESOURCES
The hpterm window consists of a Motif shell widget which contains a
form widget. The form widget contains a term0 widget, scrollbar wid‐
get, and softkey widget. Resources specific to the shell widget are:
hpterm Resource Set
Name Class Type Default
─────────────────────────────────────────────────────────
borderColor BorderColor Pixel black
borderWidth BorderWidth int 2
geometry Geometry string
iconGeometry IconGeometry string
name Name string hpterm
title Title string Terminal emulator
borderColor
This resource defines the border color of the hpterm window.
borderWidth
This resource specifies the width of the hpterm window border.
This value may be modified by the window manager.
geometry
This resource specifies the preferred size and position of the
hpterm window.
iconGeometry
This resource specifies the preferred size and position of
hpterm when iconified. It is not necessarily obeyed by all win‐
dow managers.
name This resource specifies the name of the instance of the program.
It is used when extracting resources from the resource database.
title This resource specifies the window title for hpterm. This
string may be used by the window manager when displaying this
application.
term0 Resource Set
Name Class Type Default
────────────────────────────────────────────────────────────────────────────────
allowSendEvents AllowSendEvents Boolean FALSE
background Background Pixel ``white''
backgroundIsSelect BackgroundIsSelect string FALSE
bitmap Bitmap string
bitmapIcon BitmapIcon Boolean FALSE
boldFont UserBoldFont XmFontList dynamic
copyLine CopyLine string ``right''
cursorColor Foreground Pixel ``black''
cut Cut string ``left''
dc1Handshake Dc1Handshake DC1Handshake ``auto''
flashBorder FlashBorder Boolean FALSE
foreground Foreground Pixel ``black''
fnAttribute SoftkeyAttribute int 2
fnLabel SoftkeyLabel string see below
fnString SoftkeyString string see below
halfBrightInhibit HalfBrightInhibit Boolean FALSE
iconic Iconic Boolean FALSE
internalBorder BorderWidth int 2
kshMode KshMode Boolean FALSE
logFile LogFile string ``HptermLogXXXXX''
logging Logging Boolean FALSE
loginShell LoginShell Boolean FALSE
makeColors MakeColors string ``none''
mapOnOutput AutoMap Boolean FALSE
mapOnOutputDelay MapDelay int 0
paste Paste string ``middle''
pointerBlank PointerBlank Boolean FALSE
pointerBlankDelay PointerBlankDelay int 3
pointerColor Foreground Pixel ``black''
pointerShape PointerShape string ``xterm''
reverseVideo ReverseVideo Boolean FALSE
roman8 Roman8 Boolean TRUE
saveLines SaveLines string ``1s''
scrollBar ScrollBar Boolean FALSE
softkeyInitialize16 SoftkeyInitialize16 Boolean FALSE
softkeyInitializeAll SoftkeyInitializeAll Boolean FALSE
softkeyLast SoftkeyLast int 16
softkeySelect SoftkeySelect string ``left''
stickyNextCursor StickyCursor Boolean TRUE
stickyPrevCursor StickyCursor Boolean TRUE
termId TermId string ``hpterm''
termName TermName string ``hpterm''
ttyModes TtyModes string none
userBoldFont UserBoldFont XmFontList dynamic
userFont UserFont XmFontList dynamic
visualBell VisualBell Boolean FALSE
allowSendEvents
This resource defines whether synthetic key and button events
(generated using the X protocol SendEvent request) should be
interpreted or discarded.
background
This resource defines the background color of the text window.
backgroundIsSelect
This resource controls the color used as the "background" of the
term0 text entry window and defaults to False. When False, the
background is the color specified. When True, the background is
the "select color" that corresponds to the background. For vis‐
ual consistency with other Motif-based applications, set this
resource to True.
bitmap This resource defines whether hpterm will override its built in
bitmap icon with a user specified bitmap icon. If the path does
not begin with a ``/'' or ``./'', it will be processed relative
to ``/usr/lib/X11/bitmaps''.
bitmapIcon
This resource defines whether hpterm will supply the window man‐
ager with a bitmapped icon. The supplied bitmap may be ignored
by the window manager.
boldFont
This resource defines the font used for bold (alternate) text.
This resource is provided for backwards compatability only and
will be removed in the next major release of HP-UX; use the
"userBoldFont" resource instead.
copyLine
This resource defines the pointer button/modifier combination to
be used to activate the CopyLine function. See ``POINTER
USAGE'' below.
cursorColor
This resource defines the text cursor color. The pointer cursor
color is defined by the pointerColor resource.
cut This resource defines the pointer button/modifier combination to
be used to activate the Cut function. See ``POINTER USAGE''
below.
dc1Handshake
This resource controls how DC1/DC2 handshaking is enabled for
transferring data between hpterm and the application requesting
the data. This resource can have one of three values: ``auto'',
``enabled'', or ``disabled''. When set to ``disabled'', no
handshaking is required for transferring data from hpterm to the
application; when set to ``enabled'', the handshaking mode is
controlled strictly by the state of the InhHndShk (strap G) and
InhDC2 (strap H) flags. Setting dc1Handshake to ``auto'' causes
hpterm to start out with DC1 handshaking initially disabled, it
is automatically enabled the first time hpterm receives a DC1
character and is once again controlled by the state of the InhH‐
ndShk (strap G) and InhDC2 (strap H) flags.
flashBorder
This resource defines whether hpterm window border will change
color when the pointer cursor enters or leaves the window.
foreground
This resource defines the foreground (text) color of the text
window.
fnAttribute
This resource defines the softkey attribute for softkey n (1 to
softkeyLast). If softkeyInitializeAll is true, all softkey
attributes can be initialized. If it is false, only the first
softkeyLast / 2 softkey attributes can be initialized.
fnLabel
This resource defines the softkey label for softkey n (1 to
softkeyLast). If softkeyInitializeAll is true, all softkey
labels can be initialized. If it is false, only the first soft‐
keyLast / 2 softkey labels can be initialized. The default
labels for softkeys 1 to softkeyLast / 2 are ``f1'' through
``fsoftkeyLast / 2''. The default labels for the remaining
softkeys are empty if softkeyInitializeAll is false, otherwise
they are ``fsoftkeyLast / 2 + 1'' through ``fsoftkeyLast''.
fnString
This resource defines the softkey string for softkey n (1 to
softkeyLast). If softkeyInitializeAll is true, all softkeyLast
softkey strings can be initialized. If it is false, only the
first softkeyLast / 2 softkey strings can be initialized. The
default strings for softkeys 1 to 8 are ``<esc>p'' through
``<esc>w''; the default strings for the remaining softkeys are
empty.
halfBrightInhibit
This resource defines whether half-bright enhancements will be
not be generated. When true, full-bright characters will be
used instead of half-bright characters.
iconic This resource defines whether hpterm will start up in iconic
form.
internalBorder
This resource defines the number of pixels between the charac‐
ters and the window border.
kshMode
This resource defines whether hpterm will operate in ksh mode.
In ksh mode, hpterm converts characters entered with the extend
key pressed into a two-character sequence consisting of an ASCII
escape followed by the un-extended character.
logFile
This resource defines the name of the file to which a terminal
session is logged. The default is ``HptermLogXXXXX'' (where
XXXXX is the process id of hpterm).
logging
This resource defines whether a terminal session will be logged.
It is also available at runtime via the Device Control menu.
loginShell
This resource defines whether the shell to be run in the window
will be started as a login shell (i.e., the first character of
argv[0] will be a dash, indicating to the shell that it should
read the user's /etc/profile and .profile (for ksh and sh) or
/etc/csh.login and .login (for csh).
makeColors
This resource is provided for backward compatibility with older
versions of hpterm; since it may not be supported in future
releases, it is no longer recommended for use. This resource
defines how the bottomShadowColor, foreground, and topShadow‐
Color resources of the scrollbar and softkey widgets will be
generated and how the foreground resource of the term0 widget
will be generated. If the value of this resource is ``all'',
then hpterm will use the value of the background resource of the
term0 widget to generate a value for the foreground, and the
background resource of the softkey and scrollbar widgets to gen‐
erate values for the bottomShadowColor, foreground, and topShad‐
owColor resources such that there is a 3-D look. In this case
the topShadowTile and bottomShadowTile are always set to ``fore‐
ground.'' If the makeColors resource value is ``shadow'' the
bottomShadowColor and topShadowColor will be generated but fore‐
ground will not be generated. If the makeColors resource value
is set to ``none'' then no colors will be generated.
mapOnOutput
This resource defines whether hpterm will map (de-iconify)
itself upon pty output if it is unmapped (iconified). An ini‐
tial period of time during which hpterm will not map itself upon
pty output may be specified to allow hpterm to not map itself
upon initial shell output. The delay is set via the mapOnOut‐
putDelay resource.
mapOnOutputDelay
This resource defines the number of seconds at startup during
which hpterm will not map (de-iconify) itself upon pty output.
paste This resource defines the pointer button/modifier combination to
be used to activate the Paste function. See ``POINTER USAGE''
below.
pointerBlank
This resource defines whether hpterm will put the pointer cursor
into blanking mode. In blanking mode, the pointer cursor will
turn on when the pointer is moved, and will be blanked either
after a selectable number of seconds or after keyboard input has
occurred. The delay is set via the pointerBlankDelay resource.
pointerBlankDelay
This resource defines the number of seconds to wait before
blanking the pointer cursor after the pointer has been moved.
When set to ``0'', the pointer will be blanked only upon key‐
board input.
pointerColor
This resource defines the pointer cursor color. The text cursor
color is defined by the cursorColor resource.
pointerShape
This resource defines the pointer cursor shape. Valid cursor
shapes may be found in the file ``/usr/include/X11/cursor‐
font.h.'' Shapes are specified as the name with the leading
``XC_'' dropped. Valid cursor shapes include ``left_ptr'',
``crosshair'', and ``xterm.''
reverseVideo
This resource defines whether reverse video will be simulated by
swapping the foreground and background colors.
roman8 This resource controls the mapping of keys to characters and is
effective only for western european keyboards. Roman8 encoding
is used when set to TRUE, ISO 8859-1 encoding is used when set
to FALSE. (It is the user's responsibility to ensure that cor‐
rectly encoded fonts are used; refer to the discussion on fonts
in your Using the X Window System Manual for more information on
font characteristics.)
saveLines
This resource defines the number of lines in the terminal buffer
beyond the length of the window. The resource value consists of
a ``number'' followed by an optional ``suffix.'' If no suffix
is included or the suffix is ``l'' the total length of the ter‐
minal buffer will be number plus the length of the terminal win‐
dow. If the suffix is ``s'' the total length of the terminal
buffer will be (number plus one) times the length of the termi‐
nal window. Hpterm will try to maintain the same buffer to win‐
dow ratio when the window is resized larger.
scrollBar
This resource defines whether the scrollbar will be displayed.
softkeyInitialize16
This resource enables initialization of all softkeyLast soft‐
keys. If false, only the first softkeyLast / 2 softkeys can be
initialized via resources. (This resource has been superceded
by softkeyInitializeAll, and will be eliminated in the next
release of HP-UX.)
softkeyInitializeAll
This resource enables initialization of all softkeyLast soft‐
keys. If false, only the first softkeyLast / 2 softkeys can be
initialized via resources.
softkeyLast
This resource tells hpterm the maximum number of user softkeys
to recognize (16 or 24). The only valid values for this
resource are 16 or 24; values greater than 16 are forced to 24,
values less then 16 are forced to 16.
softkeySelect
This resource defines the pointer button/modifier combination to
be used for selecting softkeys. See ``POINTER USAGE'' below.
stickyNextCursor
This resource defines whether the cursor should be homed when
the Next key is pressed. When true, the cursor will be in the
same screen position after the key is pressed that it was in
before pressing the key. When false, the cursor will be moved
to the upper left hand corner of the screen after the key is
pressed.
stickyPrevCursor
This resource defines whether the cursor should be homed when
the Prev key is pressed. When true, the cursor will be in the
same screen position after the key is pressed that it was in
before pressing the key. When false, the cursor will be moved
to the upper left hand corner of the screen after the key is
pressed.
termId This resource defines the name for hpterm to use when identify‐
ing itself to application programs. Refer to the WARNINGS sec‐
tion for additional information about using hpterm with block
mode applications.
termName
This resource defines the string for setting the ``$TERM'' envi‐
ronment variable.
ttyModes
This resource specifies a string containing terminal-setting
keywords and the characters to which they may be bound. Allow‐
able keywords include: intr, quit, erase, kill, eof, eol, swtch,
start, stop, brk, susp, dsusp, rprnt, flush, weras, and Inext.
Control characters may be specified as ^char (e.g. ^c or ^u),
and ^? may be used to indicate delete. This is very useful for
overriding the default terminal settings without having to do an
stty every time an hpterm is started.
userBoldFont
This resource defines the font used for bold (alternate) text.
userFont
This resource defines the font used for normal (primary) text.
visualBell
This resource defines whether a visible bell (i.e. flashing)
should be used instead of an audible bell when Control-G is
received.
The following resources are specified as part of the ``softkey'' widget
(name ``softkey'', class ``Softkey''). For example, the softkey user‐
Font resource would be specified one of:
HPterm*softkey*userFont: hp8.8x16
HPterm*Softkey*userFont: hp8.8x16
*Softkey*UserFont: hp8.8x16
Additional resources and information can be found in the XmPrimi‐
tive(3X) and CORE(3X) man pages along with additional information about
the various shadow options.
Softkey Resource Set
Name Class Type Default
──────────────────────────────────────────────────────────────────────────────────
background Background Pixel ``white''
bottomShadowColor Foreground Pixel ``black'' (see below)
bottomShadowTile BottomShadowTile string ``foreground'' (see below)
foreground Foreground Pixel ``black'' (see below)
topShadowColor Background Pixel ``white'' (see below)
topShadowTile TopShadowTile string ``50_foreground'' (see below)
userFont UserFont XmFontList dynamic
background
This resource defines the background color of the softkey win‐
dow.
bottomShadowColor
This resource defines the color that is combined with the bottom
shadow tile and foreground color to create a pixmap used to draw
the bottom and right sides of the softkey borders. This may be
overridden by the term0 makeColors resource described above.
bottomShadowTile
This resource defines the tile used in creating the pixmap used
for drawing the bottom and right shadows for the softkey bor‐
ders. Valid tile names are described in XmCreateTile(3X). This
may be overridden by the term0 makeColors resource described
above.
foreground
This resource defines the foreground (text) color of the softkey
window. This may be overridden by the term0 makeColors resource
described above.
topShadowColor
This resource defines the color that is combined with the top
shadow tile and foreground color to create a pixmap used to draw
the top and left sides of the softkey borders. This may be
overridden by the term0 makeColors resource described above.
topShadowTile
This resource defines the tile used in creating the pixmap used
for drawing the top and left shadows for the softkey borders.
Valid tile names are described in XmCreateTile(3X). This may be
overridden by the term0 makeColors resource described above.
userFont
This resource defines the font used for softkey text. The soft‐
key font will default to the normal (primary) font of the text
window.
The following resources are specified as part of the ``Xmscrollbar''
widget (name ``scrollBar'', class ``ScrollBar''). Some example scroll‐
bar resources are:
HPterm*scrollBar*initialDelay: 10
HPterm*ScrollBar*RepeatRate: 10
*ScrollBar*Granularity: 1
hpterm*scrollBar*width: 20
Additional resources and information can be found in the XmPrimi‐
tive(3X), XmScrollBar(3X), XmValuator(3X), and Core(3X) man pages along
with additional information about the various shadow options.
Scrollbar Resource Set (name ``scrollBar'', class ``ScrollBar'')
Name Class Type Default
──────────────────────────────────────────────────────────────────────────────
background Background Pixel ``white''
bottomShadowColor Foreground Pixel ``black'' (see below)
bottomShadowTile BottomShadowTile string ``foreground'' (see below)
foreground Foreground Pixel ``black'' (see below)
granularity Granularity int 2
initialDelay InitialDelay int 500
repeatRate RepeatRate int 100
topShadowColor Background Pixel ``white'' (see below)
topShadowTile TopShadowTile string ``50_foreground'' (see below)
width Width int 10
background
This resource defines the background color of the scrollbar win‐
dow.
bottomShadowColor
This resource defines the color that is combined with the bottom
shadow tile and foreground color to create a pixmap used to draw
the bottom and right sides of the scrollbar borders. This may
be overridden by the term0 makeColors resource described above.
bottomShadowTile
This resource defines the tile used in creating the pixmap used
for drawing the bottom and right shadows for the scrollbar bor‐
ders. Valid tile names are described in XmCreateTile(3X). This
may be overridden by the term0 makeColors resource described
above.
foreground
This resource defines the foreground color of the scrollbar win‐
dow. This may be overridden by the term0 makeColors resource
described above.
granularity
This resource defines the number of lines to advance the slider
when the button is being held down on an arrow. The value is
defined in milliseconds.
initialDelay
This resource defines the delay to wait between the time the
button is held down on an arrow before the slider starts its
repetitive movement. The value is defined in milliseconds.
repeatRate
This resource defines the continuous repeat rate to use to move
the slider while the button is being held down on an arrow. The
value is also defined in milliseconds.
topShadowColor
This resource defines the color that is combined with the top
shadow tile and foreground color to create a pixmap used to draw
the top and left sides of the scrollbar borders. This may be
overridden by the term0 makeColors resource described above.
topShadowTile
This resource defines the tile used in creating the pixmap used
for drawing the top and left shadows for the scrollbar borders.
Valid tile names are described in XmCreateTile(3X). This may be
overridden by the term0 makeColors resource described above.
width This resource defines the width of the scrollbar in pixels.
POINTER USAGE
Hpterm allows you to cut and paste text within its own or other win‐
dows. All cutting and pasting is done using the PRIMARY selection.
(To maintain compatability with previous versions of hpterm (and other
applications that use cut buffers), the cutting and pasting is also
done to/from the first global cut buffer. When pasting, hpterm gets
its text from the PRIMARY selection; if the PRIMARY selection is not
owned, or the current owner cannot supply the data as text, hpterm will
try to get its data from the first global cut buffer.) The PRIMARY
selection will be disowned (and the selected text unhighlighted) under
the following conditions:
1)
the cursor is moved anywhere before the end of the selected
region
2)
the beginning of the selected region is scrolled off the end of
the terminal buffer
3)
the selected region is scrolled across the boundaries of the
locked region when memory lock is enabled.
The default button assignments may be changed via various
resource strings. The cut and paste functions and their default
button assignments are:
Cut The left button is used to ``cut'' text into the cut buf‐
fer. Move the pointer to the beginning of the text to cut,
press the button, move the cursor to the end of the region,
and release the button. The ``cut'' text will not include
the character currently under the pointer.
Paste The middle button ``pastes'' the text from the cut buffer,
inserting it as keyboard input.
CopyLine
The right hand button ``cuts'' the text from the pointer
(at button release) through the end of line (including the
new line), saving it in the cut buffer, and immediately
``pastes'' the line, inserting it as keyboard input. This
provides a history mechanism.
The copyLine, cut, and paste key functions can be configured to
any button and modifier combination desired via various
resources. Each assignment consists of an optional combination
of modifiers (``none'' or any combination of ``shift'', ``meta'',
``lock'', ``control'', ``mod1'', ..., ``mod5'' separated by
blanks), followed by a ``|'' and the name of the button
(``left'', ``middle'', ``right'', ``button1'', ..., ``button5'').
For example, if it is desired for the cut function to be associ‐
ated with the middle button with shift and control pressed, one
could use the following resource line:
*cut: shift control | middle
For a full list of resource names, see ``RESOURCES'' above.
XCONSOLES
It is possible to configure a system to allow redirection of con‐
sole output (and input) to an hpterm window. If the ``-C''
option is used, hpterm will redirect console output (and input)
if:
Hpterm is displaying on the local system. Hpterm must be
running on the same system as the server that is display‐
ing the window.
The display is authorized. The display number of the
display name (see ``Display Specification'' in X(1)) must
be authorized to take control of the console via the file
``/etc/X11/Xconsoles.'' The file is parsed as follows:
A `#' and all following text on a line are
ignored.
Blank lines are ignored.
Leading tabs and spaces are ignored.
A number matching the display number authorizes
the server to redirect console output (and
input).
An asterisk (`*') matches all display numbers and
authorizes the server to redirect console output
(and input).
If either condition is not met, a warning will be written to
stderr and console output (and input) will not be redirected.
WARNINGS
When running block mode applications, it may be necessary for
hpterm to identify itself to application programs as some termi‐
nal other than ``hpterm.'' Most applications understand the ter‐
minal id ``2392A.'' Newer applications also understand the ter‐
minal id ``700/92'' while older applications may only understand
the terminal id ``2622A.'' To set the terminal identification
string, use the ``-ti'' command line option, the ``termId''
resource, or the ``TermId'' class.
Hpterm does not support line block mode.
Hpterm does not fully support locales that contain 3 or 4 byte
characters and will silently ignore any 3 or 4 byte characters in
the data stream. Dtterm is the recommended terminal emulator
when operating in Asian EUC locales.
The overflow protect mode of memory lock is not supported.
ENVIRONMENT
Hpterm sets the environment variables ``$LINES'' and ``$COLUMNS''
to the number of lines and columns of the terminal screen. It
also uses and sets the environment variable ``$DISPLAY'' to spec‐
ify its server connection. The resize(1) command may be used to
reset ``$LINES'' and ``$COLUMNS'' after the window size has been
changed.
ORIGIN
Hewlett-Packard Company.
SEE ALSOX(1), dtterm(1), resize(1), xset(1), xterm(1), Core(3X),
XmFontList(3X), XmForm(3X), XmPrimitive(3X), XmScrollBar(3X),
pty(4)HPTERM(1X)