HPTERM(1X) UNIX Programmer's Manual 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 pro-
grams 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 informa-
tion about running block mode applications.
IMPORTANT DOMAIN NOTES
The NLS capabilities for hpterm that are described later are
not supported for Domain.
Hpterm assumes the presence of certain keys that are not on
a Domain keyboard (e.g. Menu, System, Prev, Next, etc). The
xmodmap(1X) command can be used to redefine Domain keys to
provide the functionality of those keys. See the "Domain
X11 R5 and User Environment Development Kit 2.0" manual (HP
Part No. 019804-A01) for more information about using hpterm
on Domain.
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 charac-
ter and the window border) in pixels. Associated
resource: *borderWidth.
-background color
This option specifies the color to use for the back-
ground of the window. Associated resource: *back-
ground.
-bd color
This option specifies the color to use for the
border of the window. Associated resource: *border-
Color.
Domain/OS July 1993 Release 5 1
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
-bg color
This option specifies the color to use for the back-
ground of the window. Associated resource: *back-
ground.
-borderwidth number
This option specifies the width in pixels of the
border surrounding the window. Associated resource:
*TopLevelShell.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: *backgroun-
dIsSelect.
-bw number
This option specifies the width in pixels of the
border surrounding the window. Associated resource:
*TopLevelShell.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 font
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. Refer to the NLS section. Associated
resource: *boldFont.
-fg color
This option specifies the color to use for display-
ing text. Associated resource: *foreground.
Domain/OS July 1993 Release 5 2
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
-fn font
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. Refer to
the NLS section. Associated resource: *font.
-font font
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. Associ-
ated resource: *font.
-foreground color
This option specifies the color to use for display-
ing text. Associated resource: *foreground.
-geometry geometry
This option specifies the preferred size and posi-
tion of the hpterm window; see X(1). Associated
resource: *term0.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. Asso-
ciated resource: *kshMode.
-l This option indicates that hpterm should send all
terminal output to a log file as well as to the
screen. Logging may not be enabled when the -L
Domain/OS July 1993 Release 5 3
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
option is used. Associated resource: *logging.
+l This option indicates that hpterm should not do log-
ging. 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 Hpterm-
LogXXXXX (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, indi-
cating 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). 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 nor-
mal ``subshell''). Associated resource: *login-
Shell.
-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. Asso-
ciated resource: *mapOnOutput.
+map This option indicates that hpterm should not map
(de-iconify) itself upon pty output if it is
unmapped (iconified). Associated resource: *mapO-
nOutput.
-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
Domain/OS July 1993 Release 5 4
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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''). Associ-
ated 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.
-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 back-
ground of the scrollbar window. Associated
resource: *scrollBar.background.
-sbfg color
This option specifies the color to use for the fore-
ground 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 back-
ground of the softkey window. Associated resource:
*softkey.background.
-skfg color
This option specifies the color to use for
Domain/OS July 1993 Release 5 5
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
displaying softkey text. This value will be ignored
if the makeColors resource is set to all. Associ-
ated resource: *softkey.foreground.
-skfn font
This option specifies a font to be used when
displaying softkey text. Associated resource:
*softkey.font.
-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. Asso-
ciated 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:
.TopLevelShell.title.
-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 pre-
ferred 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
Domain/OS July 1993 Release 5 6
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
This option specifies a resource string to be used.
This is especially useful for setting resources that
do not have separate command line options. Associ-
ated 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 exam-
ple, ``-S p0.1'' specifies ``ttyp0'' on file
descriptor 1 and ``-S p02.13'' specifies ``ttyp02''
on file descriptor 13. Associated resource: none.
-U Reserved for internal use.
-W Reserved for internal use.
The following command line arguments are provided for compa-
tibility with
older versions. They may not be supported in future
releases as the X Toolkit provides standard options
that accomplish the same 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
Domain/OS July 1993 Release 5 7
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
resource: .TopLevelShell.title.
-n string
This option specifies the icon name for hpterm's
windows. It is shorthand for specifying the *icon-
Name 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: *TopLevelShell.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:
center; cB sss lB lB lB lB llll. 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.
Domain/OS July 1993 Release 5 8
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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.
Domain/OS July 1993 Release 5 9
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
center; cB sss lB lB lB lB llll. 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 Font string see NLS below
copyLine CopyLine string ``right''
cursorColor Foreground Pixel ``black''
cut Cut string ``left''
dc1Handshake Dc1Handshake DC1Handshake ``auto''
flashBorder FlashBorder Boolean FALSE
font Font string see NLS below
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
keyboardLanguage KeyboardLanguage string see NLS below
keyboardLanguageList KeyboardLanguageList string see
NLS below 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 ``X-hpterm''
termName TermName string ``hpterm''
ttyModes TtyModes string none
visualBell VisualBell Boolean FALSE
Domain/OS July 1993 Release 5 10
HPTERM(1X) UNIX Programmer's Manual 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 "back-
ground" of the term0 text entry window and defaults to
False. When False, the background is the color speci-
fied. When True, the background is the "select color"
that corresponds to the background. For visual con-
sistency 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 (alter-
nate) text. See ``NLS'' below for defaults.
copyLine
This resource defines the pointer button/modifier com-
bination 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 com-
bination 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
Domain/OS July 1993 Release 5 11
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
``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. Set-
ting 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.
font This resource defines the font used for normal (pri-
mary) text. See the "term0.fontLanguage (class
Term0.FontLanguage) Resource Set" table and ``NLS''
below for defaults.
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 attri-
butes 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 ``<esc>p'' through ``<esc>w''; the
default strings for the remaining softkeys are empty.
Domain/OS July 1993 Release 5 12
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
halfBrightInhibit
This resource defines whether half-bright enhancements
will be not be generated. When true, full-bright char-
acters 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
characters and the window border.
keyboardLanguage
This resource defines the default keyboard language
hpterm should use. See ``NLS'' below for details and
defaults.
keyboardLanguageList
This resource defines the list of keyboard languages
that may be selected from the terminal configuration
menu. See ``NLS'' below for detail and defaults.
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 fol-
lowed by the un-extended character.
logFile
This resource defines the name of the file to which a
terminal session is logged. The default is ``Hpterm-
LogXXXXX'' (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. Logging may not be enabled when
the ``-L'' option is used.
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
Domain/OS July 1993 Release 5 13
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
supported in future releases, it is no longer recom-
mended for use. This resource defines how the bot-
tomShadowColor, 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 topSha-
dowColor 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 ini-
tial 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 com-
bination 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.
Domain/OS July 1993 Release 5 14
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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 speci-
fied 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 charac-
ters and is effective only for western european key-
boards. 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 informa-
tion on font characteristics.)
saveLines
This resource defines the number of lines in the termi-
nal 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 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.)
Domain/OS July 1993 Release 5 15
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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 com-
bination 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 applications.
termName
This resource defines the string for set 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 charac-
ters 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
Domain/OS July 1993 Release 5 16
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
having to do an stty every time an hpterm is started.
visualBell
This resource defines whether a visible bell (i.e.
flashing) should be used instead of an audible bell
when Control-G is received.
center; cB sss lB lB lB lB llll. term0.fontLanguage (class
Term0.FontLanguage) Resource Set Name Class Type Default _
primary.high FontPosition.Size string see NLS below
primary.medium FontPosition.Size string see NLS below
primary.low FontPosition.Size string see NLS below
alternate.high FontPosition.Size string see NLS below
alternate.medium FontPosition.Size string see NLS below
alternate.low FontPosition.Size string see NLS below
fontLanguage.primary.high
This resource defines the default normal (primary) font
for displays with high resolution monitors. See
``NLS'' below for additional information.
fontLanguage.primary.medium
This resource defines the default normal (primary) font
for displays with medium resolution monitors. See
``NLS'' below for additional information.
fontLanguage.primary.low
This resource defines the default normal (primary) font
for displays with low resolution monitors. See ``NLS''
below for additional information.
fontLanguage.alternate.high
This resource defines the default bold (alternate) font
for displays with high resolution monitors. See
``NLS'' below for additional information.
fontLanguage.alternate.medium
This resource defines the default bold (alternate) font
for displays with medium resolution monitors. See
``NLS'' below for additional information.
fontLanguage.alternate.low
This resource defines the default bold (alternate) font
for displays with low resolution monitors. See ``NLS''
below for additional information.
The following resources are specified as part of the ``soft-
key'' widget (name ``softkey'', class ``Softkey''). For
example, the softkey font resource would be specified one
Domain/OS July 1993 Release 5 17
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
of:
center; l l. HPterm*softkey*font: hp8.8x16
HPterm*Softkey*font: hp8.8x16 *Softkey*Font: 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.
center; cB sss lB lB lB lB llll. Softkey Resource Set
Name Class Type Default _
background Background Pixel ``white''
bottomShadowColor Foreground Pixel ``black'' (see
below)
bottomShadowTile BottomShadowTile string ``foreground''
(see below) font Font string (see below)
foreground Foreground Pixel ``black'' (see below)
topShadowColor Background Pixel ``white'' (see below)
topShadowTile TopShadowTile string ``50_foreground'' (see
below)
background
This resource defines the background color of the soft-
key 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.
font This resource defines the font used for softkey text.
The softkey font will default to the normal (primary)
font of the text window.
foreground
This resource defines the foreground (text) color of
the softkey window. This may be overridden by the
term0 makeColors resource described above.
Domain/OS July 1993 Release 5 18
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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 soft-
key 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.
The following resources are specified as part of the
``Xmscrollbar'' widget (name ``scrollBar'', class
``ScrollBar''). Some example scrollbar resources are:
center; l l. 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.
center; cB sss lB lB lB lB llll. 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
Domain/OS July 1993 Release 5 19
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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 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 mil-
liseconds.
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.
Domain/OS July 1993 Release 5 20
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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
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 combina-
tion of modifiers (``none'' or any combination of ``shift'',
``meta'', ``lock'', ``control'', ``mod1'', ..., ``mod5''
separated by blanks), followed by a ``|'' and the name of
Domain/OS July 1993 Release 5 21
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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.
NLS
Hpterm currently supports 23 different language versions of
the HP keyboard. It is possible to switch between different
languages via the ``terminal configuration'' menu. A list
of language to choose from along with their order is speci-
fied via the ``keyboardLanguageList'' resource. The ``key-
boardLanguageList'' resource consists of a list of keyboard
languages separated by spaces, tabs, or new lines. Valid
keyboard languages may be found in the file
``/usr/lib/X11/XHPlib.h.'' Keyboard languages are specified
as the language with the leading ``KB_'' dropped. The
default value for the ``keyboardLanguageList'' resource is
``US_English Belgian Canada_English Danish Dutch Finnish
French Canada_French Swiss_French German Swiss_German
Italian Norwegian Euro_Spanish Latin_Spanish Swedish
UK_English Katakana Swiss_French2 Swiss_German2 Japanese
Korean S_Chinese T_Chinese Russian Bulgarian Czech Hungarian
Polish Romanian SerboCroatian Hebrew Turkish Greek.''
The initial keyboard language is specified via the ``key-
boardLanguage'' resource. If the string is NULL, the
language of the server's keyboard will be used. If the key-
board language specified is not included in the key-
boardLanguageList resource, the first language included in
the keyboardLanguageList resource will be used. The default
is to use the language of the server's keyboard.
Hpterm will try to select default fonts which match your
monitor and your keyboard language. If the normal (primary)
and bold (alternate) fonts are specified, they will be used.
If only one is specified (via either command line options or
resources), it will be used for both the normal (primary)
and bold (alternate) fonts. If neither normal (primary) or
bold (alternate) fonts are specified, hpterm trys to find
them based on the default keyboard language. The default
keyboard language is indicated on the ``terminal configura-
tion'' menu. The built in defaults may be overridden via
the ``term0.fontLanguage'' resources. FontLanguage varies
with the keyboard language as follows.
Domain/OS July 1993 Release 5 22
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
center; lB lB ll. keyboard language fontLanguage _
Katakana hp_kana8 Japanese hp_japanese Korean hp_korean
T_Chinese hp_chinese_t S_Chinese hp_chinese_s all others HP
keyboards hp_roman8 non HP keyboards iso_8859_1
The default font size used will depend upon the resolution
of the monitor as follows:
center; lB lB ll. monitor resolution font size _ 72 DPI or
less low greater than 72 DPI and less 100 DPI medium 100 DPI
or greater high
For example, resource specifications for the US_English,
German, and Finnish keyboards would be:
center; l l. HPterm*hp_roman8.primary.high: *courier-
medium-r-normal--14*hp-roman8
HPterm*hp_roman8.primary.medium: *courier-medium-r-normal--
12*hp-roman8 HPterm*hp_roman8.primary.low: *courier-medium-r-
normal--8*hp-roman8 HPterm*hp_roman8.alternate.high: *courier-
bold-r-normal--14*hp-roman8
HPterm*hp_roman8.alternate.medium: *courier-bold-r-normal--
12*hp-roman8 HPterm*hp_roman8.alternate.low: *courier-bold-r-
normal--8*hp-roman8
For the Japanese keyboard, resource specifications would be:
center; l l. HPterm*hp_japanese.primary.high: jpn.8x18
HPterm*hp_japanese.primary.medium: jpn.8x18
HPterm*hp_japanese.primary.low: jpn.8x18
HPterm*hp_japanese.alternate.high: math.8x18
HPterm*hp_japanese.alternate.medium: math.8x18
HPterm*hp_japanese.alternate.low: math.8x18
If these fonts can not be found, the font ``fixed'' will be
used for both the normal (primary) and bold (alternate)
fonts. These resources are for font defaults only and will
be ignored if either the normal (primary) or bold (alter-
nate) fonts are specified.
Control-N will switch to the bold (alternate) font and
control-O will switch back to the normal (primary) font.
Hpterm will switch back to the normal (primary) font
automatically at the beginning of each line.
XCONSOLES
It is possible to configure a system to allow redirection of
Domain/OS July 1993 Release 5 23
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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.
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 con-
sole via the file ``/usr/lib/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 author-
izes 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 ``X-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 ``Ter-
mId'' class.
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 ter-
minal screen. It also uses and sets the environment
Domain/OS July 1993 Release 5 24
HPTERM(1X) UNIX Programmer's Manual HPTERM(1X)
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.
SEE ALSO
X(1), resize(1), xset(1), xterm(1), pty(4), Core(3X),
XmScrollBar(3X), XmPrimitive(3X), XmForm(3X)
Domain/OS July 1993 Release 5 25