HP(1)                                SysV                                HP(1)



NAME
     hp - handle special functions of Hewlett-Packard terminals

SYNOPSIS
     hp [ -e ] [ -m ]

DESCRIPTION
     hp supports special functions of the Hewlett-Packard 2640 series of
     terminals, with the primary purpose of producing accurate representations
     of most nroff output.  A typical usage is in conjunction with
     DOCUMENTER'S WORKBENCH Software:

          nroff -h files . . .  hp

     Regardless of the hardware options on your terminal, hp tries to do
     sensible things with underlining and reverse line-feeds.  If the terminal
     has the "display enhancements" feature, subscripts and superscripts can
     be indicated in distinct ways.  If it has the "mathematical-symbol"
     feature, Greek and other special characters can be displayed.

OPTIONS
     -e        Assumes that your terminal has the "display enhancements"
               feature, and so makes maximum use of the added display modes.
               Overstruck characters are shown underlined.  Superscripts are
               shown half-bright, and subscripts in half-bright, underlined
               mode.  If this option is omitted, hp assumes that your terminal
               lacks the "display enhancements" feature.  In this case, all
               overstruck characters, subscripts, and superscripts are
               displayed in inverse video.

     -m        Requests minimization of output by removal of new-lines.  Any
               contiguous sequence of 3 or more new-lines is converted into a
               sequence of only 2 new-lines; i.e., any number of successive
               blank lines produces only a single blank output line.  This
               allows you to retain more actual text on the screen.

     With regard to Greek and other special characters, hp provides the same
     set as does 300(1), except that "not" is approximated by a right arrow,
     and only the top half of the integral sign is shown.

NOTES
     The exit codes are 0 for normal termination, 2 for all errors.

BUGS
     An "overstriking sequence" is defined as a printing character, followed
     by a backspace, followed by another printing character.  In such
     sequences, if either printing character is an underscore, the other
     printing character is shown underlined or in inverse video; otherwise,
     only the first printing character is shown (again, underlined or in
     Inverse Video).  Nothing special is done if a backspace is adjacent to an
     ASCII control character.  Sequences of control characters (e.g., reverse
     line-feeds, backspaces) can make text "disappear"; in particular, tables
     generated by tbl(1) that contain vertical lines will often be missing the
     lines of text that contain the "foot" of a vertical line, unless the
     input to hp is piped through col(1).
     Although some terminals do provide numerical superscript characters, no
     attempt is made to display them.

DIAGNOSTICS
     line too long
          The representation of a line exceeds 1,024 characters.

SEE ALSO
     300(1), greek(1).
     col(1), eqn(1), nroff(1), tbl(1) in the UNIX System V Documenter's
     Workbench Reference Manual.