huschi.net

UL(1)                            User Commands                           UL(1)

NAME
       ul - do underlining
SYNOPSIS
       ul [options] [file ...]
DESCRIPTION
       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 terminfo database is read to determine  the  appro-
       priate  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 auto-
       matically, ul degenerates to cat(1).  If the terminal cannot underline,
       underlining is ignored.
OPTIONS
       -i, --indicated
              Underlining is indicated by a separate line containing appropri-
              ate dashes `-'; this is useful when you  want  to  look  at  the
              underlining which is present in an nroff output stream on a crt-
              terminal.
       -t, -T, --terminal terminal
              Overrides the terminal type specified in  the  environment  with
              TERM.
       -V, --version
              Display version information and exit.
       -h, --help
              Display a help text and exit.
ENVIRONMENT
       The following environment variable is used:
       TERM   The TERM variable is used to relate a tty device with its device
              capability description (see terminfo(5)).  TERM is set at  login
              time, either by the default terminal type specified in /etc/ttys
              or as set during the login process by the user  in  their  login
              file (see setenv(1)).
SEE ALSO
       colcrt(1), login(1), man(1), nroff(1), setenv(1), terminfo(5)
BUGS
       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.
HISTORY
       The ul command appeared in 3.0BSD.
AVAILABILITY
       The  ul command is part of the util-linux package and is available from
       Linux   Kernel   Archive    <ftp://ftp.kernel.org/pub/linux/utils/util-
       linux/>.

util-linux                      September 2011                           UL(1)