1UL(1)                            User Commands                           UL(1)
2
3
4

NAME

6       ul - do underlining
7

SYNOPSIS

9       ul [options] [file...]
10

DESCRIPTION

12       ul  reads  the  named  files  (or standard input if none are given) and
13       translates occurrences of underscores to the sequence  which  indicates
14       underlining  for  the  terminal in use, as specified by the environment
15       variable TERM.  The terminfo database is read to determine  the  appro‐
16       priate  sequences  for  underlining.   If  the terminal is incapable of
17       underlining but is capable of  a  standout  mode,  then  that  is  used
18       instead.   If the terminal can overstrike, or handles underlining auto‐
19       matically, ul degenerates to cat(1).  If the terminal cannot underline,
20       underlining is ignored.
21

OPTIONS

23       -i, --indicated
24              Underlining is indicated by a separate line containing appropri‐
25              ate dashes `-'; this is useful when you  want  to  look  at  the
26              underlining which is present in an nroff output stream on a crt-
27              terminal.
28
29       -t, -T, --terminal terminal
30              Override the environment variable TERM with the specified termi‐
31              nal type.
32
33       -V, --version
34              Display version information and exit.
35
36       -h, --help
37              Display help text and exit.
38

ENVIRONMENT

40       The following environment variable is used:
41
42       TERM   The TERM variable is used to relate a tty device with its device
43              capability description (see terminfo(5)).  TERM is set at  login
44              time, either by the default terminal type specified in /etc/ttys
45              or as set during the login process by the user  in  their  login
46              file (see setenv(3)).
47

HISTORY

49       The ul command appeared in 3.0BSD.
50

BUGS

52       nroff  usually outputs a series of backspaces and underlines intermixed
53       with the text to indicate underlining.  No attempt is made to  optimize
54       the backward motion.
55

SEE ALSO

57       colcrt(1), login(1), man(1), nroff(1), setenv(3), terminfo(5)
58

AVAILABILITY

60       The  ul command is part of the util-linux package and is available from
61       Linux  Kernel   Archive   ⟨https://www.kernel.org/pub/linux/utils/util-
62       linux/⟩.
63
64
65
66util-linux                      September 2011                           UL(1)
Impressum