'\"macro stdmacro
.if n .pH g1.ul @(#)ul	40.6 of 9/18/89
.nr X
.if \nX=0 .ds x} ul 1 "BSD Compatibility Package" "\&"
.if \nX=1 .ds x} ul 1 "BSD Compatibility Package"
.if \nX=2 .ds x} ul 1 "" "\&"
.if \nX=3 .ds x} ul "" "" "\&"
.TH \*(x}
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
.\"
.SH NAME
\f4ul\f1 \- underline
.SH SYNOPSIS
\f4/usr/ucb/ul\f1
[
\f4\-i\f1
] [
\f4\-t\f1
.I terminal
] [
.IR filename .\|.\|.
]
.SH DESCRIPTION
.P
The
\f4ul\f1
command reads the named
.IR filename s
(or the standard input if none are given)
and translates occurrences of underscores to the sequence
which indicates underlining for the terminal in use, as specified
by the environment variable
\f4TERM\f1.
\f4ul\f1
uses the
\f4/usr/share/lib/termcap\f1
file 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,
\f4ul\f1
degenerates to
\f4cat\f1.
If the terminal cannot underline, underlining is ignored.
.P
The following options are available:
.TP 12
\f4\-t\f2 terminal\f1
Override the terminal kind specified in the environment.
If the terminal cannot underline, underlining is ignored.
.TP
\f4\-i\f1
Indicate underlining by a separate
line containing appropriate dashes
\f4\-\f1;
this is useful when you want to
look at the underlining which is present in an
\f4nroff\f1
output stream on a
.SM CRT\s0-terminal.
.SH "SEE ALSO"
\f4man\fP(1),
\f4nroff\fP(1)
.P
\f4cat\fP(1)
in the \f2User's Reference Manual\f1.
