Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 10, 2021
 
 

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 terminal.

Return Values

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

Files

/usr/share/lib/terminfo/*

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
text/doctools

See Also

man(1), cat(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.