unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 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 ``<esc>p'' through
	   ``<esc>w''; the default strings for the remaining softkeys are
	   empty.

      halfBrightInhibit
	   This resource defines whether half-bright enhancements will be
	   not be generated.  When true, full-bright characters will be used
	   instead of half-bright characters.

      iconic
	   This resource defines whether hpterm will start up in iconic
	   form.




 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
	       ``/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