UL(1)                   COMMAND REFERENCE                   UL(1)



NAME
     ul - do underlining

SYNOPSIS
     ul [ -i ] [ -{tT} terminal ] [ filename...]

DESCRIPTION
     Ul reads the named files (or standard input if none are
     given) and translates occurrences of underscores, and other
     sequences of specially highlighted text, to the sequence
     which indicates the special mode for the terminal in use, as
     specified by the environment variable TERM.

     When the -i option is not specified, the highlighting
     characters are taken from the termcap entry. The termcap
     entries that may be used are mh, which indicates dim mode,
     md, indicating bold mode, mr, indicating reverse video mode,
     and me, which turns the other three off. If these are not
     given, they default to the contents of the so entry. Reverse
     video is used for the alternate character set.

OPTIONS
     -i  Causes ul to indicate standout modes by printing a
         separate line under each text line containing an
         underscore character (_) for underscores, ! for bold
         mode, g for alternate character set, a caret (^) for
         superscripts, v for subscripts, spaces for normal mode,
         and X for other modes.  This is useful when you want to
         look at the underlining which is present in an nroff
         output stream on a CRT-terminal.

     -t terminal
         Overrides the terminal type specified in the
         environment.  The termcap entry ( found in /etc/termcap
         by default ) is read to determine the appropriate
         sequences for underlining.  If the terminal is incapable
         of underlining, but is capable of a standout mode then
         that is used instead.  If the terminal can overstrike,
         or handles underlining automatically, ul works exactly
         like cat(1).  If the terminal cannot underline,
         underlining is ignored.

     -T terminal
         The same as -t.

EXAMPLES
     The following example runs the contents of the file
     example.nr through nroff(1), filters the formatted text
     through ul, printing it for display on a Tektronix 4105
     terminal:





Printed 10/17/86                                                1

UL(1)                   COMMAND REFERENCE                   UL(1)



          nroff example.nr | ul -t4105


FILES
     /etc/termcap             Default terminal capability file.

VARIABLES
     TERM           The type of the terminal being used.

     TERMCAP        The name of the terminal capability file, or
                    the actual entry for the terminal.

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system
                    errors.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

CAVEATS
     Nroff usually outputs a series of backspaces and underlines
     intermixed with the text to indicate underlining.  No
     attempt is made to optimize the backward motion.

SEE ALSO
     cat(1), col(1), more(1), nroff(1), page(1), termcap(5t).



















Printed 10/17/86                                                2

%%index%%
na:72,55;
sy:127,181;
de:308,923;
op:1231,1296;
ex:2527,295;2966,41;
fi:3007,121;
va:3128,243;
rv:3371,682;
ca:4053,259;
se:4312,195;
%%index%%000000000167