BSD 4_3 release

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

diff --git a/usr/man/man1/ul.1 b/usr/man/man1/ul.1
index a02c478..6e92c61 100644 (file)
--- a/usr/man/man1/ul.1
+++ b/usr/man/man1/ul.1
@@ -1,10 +1,18 @@
-.TH UL 1 9/23/79
-.UC
+.\" 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) 5/7/86
+.\"
+.TH UL 1 "May 7, 1986"
+.UC 4

 .SH NAME
 ul \- do underlining
 .SH SYNOPSIS
 .B ul
 [
 .SH NAME
 ul \- do underlining
 .SH SYNOPSIS
 .B ul
 [

+.B \-i
+] [

 .B \-t
 .I terminal
 ]
 .B \-t
 .I terminal
 ]


@@ -15,37 +23,36 @@ ul \- do underlining
 .SH DESCRIPTION
 .I Ul
 reads the named files (or standard input if none are given)
 .SH DESCRIPTION
 .I Ul
 reads the named files (or standard input if none are given)

-and translates occurances of underscores to the sequence
-which indicates underlining.
-If
+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
 .B \-t

-is present,
-.I terminal
-is used as the terminal kind.
-Otherwise, the environment is looked in and
+option overrides the terminal kind specified in the environment.
+The file

 .I /etc/termcap
 .I /etc/termcap

-read to determine
-the appropriate sequences for underlining.
-If none of the fields
-.BR us ,
-.BR ue ,
-or
-.BR uc
-is present, and if
-.B so
-and
-.B se
-are present, standout mode is used to indicate underlining.
+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
 If the terminal can overstrike,
 or handles underlining automatically,
 .I ul

-behaves like
+degenerates to

 .IR cat (1).
 If the terminal cannot underline, underlining is ignored.
 .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"
 .SH "SEE ALSO"

-iul(1), man(1), nroff(1)
-.SH AUTHOR
-Mark Horton
+man(1), nroff(1), colcrt(1)

 .SH BUGS
 .I Nroff
 usually outputs a series of backspaces and underlines intermixed
 .SH BUGS
 .I Nroff
 usually outputs a series of backspaces and underlines intermixed