NAME    [Toc]    [Back]

     ul - do underlining

SYNOPSIS    [Toc]    [Back]

     ul [-i] [-t terminal] [name ...]

DESCRIPTION    [Toc]    [Back]

     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 file /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, ul degenerates
  to cat(1).  If the terminal cannot underline, underlining is ignored.


     The options are as follows:

     -i      Underlining is indicated by a separate line containing appropriate
  dashes  (`-');  this is useful when you want to
look at the underlining
 which is present  in  an  nroff(1)  output
stream on a CRTterminal.


     -t terminal
             Overrides  the  terminal type specified in the environment with
             terminal.

ENVIRONMENT    [Toc]    [Back]

     TERM  Used to relate a tty device with its device capability
description
           (see  termcap(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 environ(7)).

SEE ALSO    [Toc]    [Back]

     colcrt(1), man(1), nroff(1)

HISTORY    [Toc]    [Back]

     The ul command appeared in 3.0BSD.

BUGS    [Toc]    [Back]

     nroff(1) usually outputs a series of backspaces  and  underlines intermixed
     with  the  text to indicate underlining.  No attempt is made
to optimize
     the backward motion.

OpenBSD      3.6                           June      6,      1993