UL(1) User Commands UL(1)

NAME

ul - do underlining

SYNOPSIS

ul [-i] [-t terminal] [filename]...

DESCRIPTION

ul reads the named filenames (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 TERM. ul uses the /usr/share/lib/terminfo entry 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 degenerates to cat(1). If the terminal cannot
underline, underlining is ignored.

OPTIONS

-t terminal
Override the terminal kind specified in the environment.
If the terminal cannot underline, underlining is ignored.
If the terminal name is not found, no underlining is
attempted.


-i
Indicate underlining by a separate line containing
appropriate dashes `-'; this is useful when you want to
look at the underlining which is present in an nroff(1)
output stream on a CRT-terminal.

RETURN VALUES

ul returns exit code 1 if the file specified is not found.

FILES

/usr/share/lib/terminfo/*

SEE ALSO

cat(1), man(1), nroff(1), attributes(7)

BUGS

nroff usually generates a series of backspaces and underlines intermixed
with the text to indicate underlining. ul makes attempt to optimize the
backward motion.

March 17, 1994 UL(1)