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
features of HP terminals. Refer to the WARNINGS section below for
additional information about running block mode applications.
OPTIONS
The hpterm terminal emulator accepts all of the standard X Toolkit
command 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
distance 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
surrounding 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:
*backgroundIsSelect.
+bs This option indicates that the "background" of the term0 text
entry window should be the specified background. Associated
resource: *backgroundIsSelect.
Hewlett-Packard Company - 1 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
-bw number
This option specifies the width in pixels of the border
surrounding 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).
Associated resource: none.
-e command [arguments ...]
This option specifies the command (and its command line
arguments) 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
(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: *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.
Hewlett-Packard Company - 2 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
-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
manager 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
display 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
output to a log file as well as to the screen. Associated
resource: *logging.
+l This option indicates that hpterm should not do logging.
Associated 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.
Associated 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.
Hewlett-Packard Company - 3 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
+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
initial 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).
Associated 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
cursor. Associated resource: *pointerColor.
-name name
This option specifies the application name under which
resources are to be obtained, rather than the default
executable 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
simulated. Associated resource: *reverseVideo.
Hewlett-Packard Company - 4 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
-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.background.
-sbfg color
This option specifies the color to use for the foreground of
the scrollbar window. This value will be ignored if the
makeColors resource is set to all. Associated resource:
*scrollBar.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
application. Associated resource: *title.
Hewlett-Packard Company - 5 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
-tm string
This option specifies a string containing terminal-setting
keywords and the characters to which they may be bound.
Associated resource: *ttyModes.
-tn name
This option specifies a name for hpterm to set the $TERM
environment 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
separate 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
output. 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
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 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 compatibility
with
older versions. They may not be supported in future releases as
the X Toolkit provides standard options that accomplish the same
Hewlett-Packard Company - 6 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
task.
#geometry
This option specifies the preferred position of the icon
window. 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
equivalent to -reversevideo or -rv. Associated resource:
*reverseVideo.
+r This option indicates that reverse video should not be
simulated. It is equivalent to +rv. Associated resource:
*reverseVideo.
-w number
This option specifies the width in pixels of the border
surrounding 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
widget, 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
Hewlett-Packard Company - 7 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
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 window
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.
Hewlett-Packard Company - 8 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
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
Hewlett-Packard Company - 9 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
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
visual 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
manager 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
Hewlett-Packard Company - 10 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
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
InhHndShk (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
softkeyLast / 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 ``p'' through
``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.
Hewlett-Packard Company - 11 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
internalBorder
This resource defines the number of pixels between the characters
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 topShadowColor
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 generate values
for the bottomShadowColor, foreground, and topShadowColor
resources such that there is a 3-D look. In this case the
topShadowTile and bottomShadowTile are always set to
``foreground.'' If the makeColors resource value is ``shadow''
the bottomShadowColor and topShadowColor will be generated but
foreground 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 initial 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 mapOnOutputDelay
Hewlett-Packard Company - 12 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
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 keyboard
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/cursorfont.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 correctly
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
Hewlett-Packard Company - 13 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
a ``number'' followed by an optional ``suffix.'' 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.
Hpterm will try to maintain the same buffer to window 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 softkeys.
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 softkeys.
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 identifying
itself to application programs. Refer to the WARNINGS section
for additional information about using hpterm with block mode
Hewlett-Packard Company - 14 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
applications.
termName
This resource defines the string for setting the ``$TERM''
environment variable.
ttyModes
This resource specifies a string containing terminal-setting
keywords and the characters to which they may be bound.
Allowable 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 userFont 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
XmPrimitive(3X) and CORE(3X) man pages along with additional
information about the various shadow options.
Hewlett-Packard Company - 15 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
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 window.
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 borders.
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
softkey font will default to the normal (primary) font of the
text window.
Hewlett-Packard Company - 16 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
The following resources are specified as part of the ``Xmscrollbar''
widget (name ``scrollBar'', class ``ScrollBar''). Some example
scrollbar 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
XmPrimitive(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
window.
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
borders. 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
Hewlett-Packard Company - 17 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
window. 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
windows. 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
Hewlett-Packard Company - 18 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
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 buffer.
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 associated 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 console
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 displaying
the window.
Hewlett-Packard Company - 19 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
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
``/usr/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 terminal other than
``hpterm.'' Most applications understand the terminal id ``2392A.''
Newer applications also understand the terminal 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 specify 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.
Hewlett-Packard Company - 20 - HP-UX HPTERM
HPTERM(1X) HPTERM(1X)
SEE ALSO
X(1), dtterm(1), resize(1), xset(1), xterm(1), Core(3X),
XmFontList(3X), XmForm(3X), XmPrimitive(3X), XmScrollBar(3X), pty(4)
Hewlett-Packard Company - 21 - HP-UX HPTERM