HPTERM(1X) — X Version 11
Release 5
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: *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: *backgroundIsSelect.
−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 displaying text. Associated resource: *foreground.
−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. Associated resource: *font.
−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: *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. Associated 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 option is used. 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). 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 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.
−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 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. 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: .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 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.
−U Reserved for internal use.
−W Reserved for internal use.
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 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: .TopLevelShell.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: *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:
| 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 window managers.
nameThis resource specifies the name of the instance of the program. It is used when extracting resources from the resource database.
titleThis 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 | 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 |
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. See “NLS” below for defaults.
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.
cutThis 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 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.
fontThis resource defines the font used for normal (primary) 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 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 “<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.
iconicThis 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 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. 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 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 resource.
mapOnOutputDelay
This resource defines the number of seconds at startup during which hpterm will not map (de-iconify) itself upon pty output.
pasteThis 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 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 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 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.
visualBell
This resource defines whether a visible bell (i.e. flashing) should be used instead of an audible bell when Control-G is received.
| 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 “softkey” widget (name “softkey”, class “Softkey”). For example, the softkey font resource would be specified one of:
| 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.
| 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 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.
fontThis 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.
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.
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 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.
widthThis 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
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:
CutThe 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.
PasteThe 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.
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 specified via the “keyboardLanguageList” resource. The “keyboardLanguageList” 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 “keyboardLanguage” resource. If the string is NULL, the language of the server’s keyboard will be used. If the keyboard language specified is not included in the keyboardLanguageList 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 configuration” menu. The built in defaults may be overridden via the “term0.fontLanguage” resources. FontLanguage varies with the keyboard language as follows.
| 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:
| 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:
| 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:
| 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 (alternate) 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 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 console 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 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 “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 “TermId” 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 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.
SEE ALSO
X(1), resize(1), xset(1), xterm(1), pty(4), Core(3X), XmScrollBar(3X), XmPrimitive(3X), XmForm(3X)
Hewlett-Packard Company — HP-UX 9.0 August 1992