[unix-history] / usr / src / usr.bin / ul / ul.1

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