UL(L)                   System General Commands Manual                   UL(L)

NAME
     ul - do underlining

SYNOPSIS
     ul [-i] [-t terminal] [name ...]

DESCRIPTION
     Ul reads the named files (or standard input if none are given) and trans-
     lates occurrences of underscores to the sequence which indicates under-
     lining for the terminal in use, as specified by the environment variable
     TERM.  The file /etc/termcap 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 ter-
     minal can overstrike, or handles underlining automatically, ul degener-
     ates to cat(t).  If the terminal cannot underline, underlining is
     ignored.

     The following options are available:

     -i      Underlining is indicated by a separate line containing appropri-
             ate dashes `-'; 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 with
             terminal.

ENVIRONMENT
     The following environment variable is used:

     TERM  The TERM variable is used to relate a tty device with its device
           capability description (see termcap(p)).  TERM is set at login
           time, either by the default terminal type specified in /etc/ttys or
           as set during the login process by the user in their login file
           (see environ(n)).

SEE ALSO
     colcrt(t), man(n), nroff(f)

BUGS
     The nroff(f) command usually outputs a series of backspaces and under-
     lines intermixed with the text to indicate underlining.  No attempt is
     made to optimize the backward motion.

HISTORY
     The ul command appeared in 3.0BSD.

BSD                              June 6, 1993                              BSD