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