[unix-history] / usr / man / man1 / ul.1

.TH UL 1 "18 January 1983"
.UC 4
.SH NAME
ul \- do underlining
.SH SYNOPSIS
.B ul
[
.B \-i
] [
.B \-t
.I terminal
]
[
.I name
\&...
]
.SH DESCRIPTION
.I Ul
reads the named files (or 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.
The
.B \-t
option overrides the terminal kind specified in the environment.
The file
.I /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 terminal can overstrike,
or handles underlining automatically,
.I ul
degenerates to
.IR cat (1).
If the terminal cannot underline, underlining is ignored.
.PP
The
.B \-i
option causes
.I ul
to indicate underlining onto by a separate line containing appropriate
dashes `\-'; this is useful when you want to look at the underlining
which is present in an
.I nroff
output stream on a crt-terminal.
.SH "SEE ALSO"
man(1), nroff(1), colcrt(1)
.SH AUTHOR
Mark Horton wrote
.IR ul .
The
.B \-i
option was originally a option of the editor
.IR ex (1),
then an
.I iul
command.
.SH BUGS
.I 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.
Commit	Line	Data
90e46d4a C	1	.TH UL 1 "18 January 1983"
	2	.UC 4
	3	.SH NAME
	4	ul \- do underlining
	5	.SH SYNOPSIS
	6	.B ul
	7	[
	8	.B \-i
	9	] [
	10	.B \-t
	11	.I terminal
	12	]
	13	[
	14	.I name
	15	\&...
	16	]
	17	.SH DESCRIPTION
	18	.I Ul
	19	reads the named files (or standard input if none are given)
	20	and translates occurrences of underscores to the sequence
	21	which indicates underlining for the terminal in use, as specified
	22	by the environment variable
	23	TERM.
	24	The
	25	.B \-t
	26	option overrides the terminal kind specified in the environment.
	27	The file
	28	.I /etc/termcap
	29	is read to determine the appropriate sequences for underlining.
	30	If the terminal is incapable of underlining, but is capable of
	31	a standout mode then that is used instead.
	32	If the terminal can overstrike,
	33	or handles underlining automatically,
	34	.I ul
	35	degenerates to
	36	.IR cat (1).
	37	If the terminal cannot underline, underlining is ignored.
	38	.PP
	39	The
	40	.B \-i
	41	option causes
	42	.I ul
	43	to indicate underlining onto by a separate line containing appropriate
	44	dashes `\-'; this is useful when you want to look at the underlining
	45	which is present in an
	46	.I nroff
	47	output stream on a crt-terminal.
	48	.SH "SEE ALSO"
	49	man(1), nroff(1), colcrt(1)
	50	.SH AUTHOR
	51	Mark Horton wrote
	52	.IR ul .
	53	The
	54	.B \-i
	55	option was originally a option of the editor
	56	.IR ex (1),
	57	then an
	58	.I iul
	59	command.
	60	.SH BUGS
	61	.I Nroff
	62	usually outputs a series of backspaces and underlines intermixed
	63	with the text to indicate underlining. No attempt is made to optimize
	64	the backward motion.