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 4/6/89                                                  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), and termcap(5t).



















Printed 4/6/89                                                  2

%%index%%
na:192,71;
sy:263,241;
de:504,1039;
op:1543,1385;
ex:2928,335;3527,40;
fi:3567,143;
va:3710,279;
rv:3989,726;
ca:4715,307;
se:5022,227;
%%index%%000000000169