ul(1)

NAME

     ul - do underlining

SYNOPSIS

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

DESCRIPTION

     ul reads the named filenames (or the 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. ul uses
     the /usr/share/lib/terminfo entry to determine the appropri-
     ate  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.

OPTIONS

     -t terminal
           Override the terminal kind specified in  the  environ-
           ment. If the terminal cannot underline, underlining is
           ignored. If the terminal name is not found, no  under-
           lining is attempted.

     -i    Indicate underlining 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 CRT-terminal.

RETURN VALUES

     ul returns exit code 1 if the file specified is not found.

FILES

     /usr/share/lib/terminfo/*

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWdoc                     |
    |_____________________________|_____________________________|

SEE ALSO

     cat(1), man(1), nroff(1), attributes(5)

BUGS

     nroff usually generates a series of  backspaces  and  under-
     lines  intermixed  with the text to indicate underlining. ul
     makes attempt to optimize the backward motion.