UL(1)                                                       UL(1)



     NAME
          ul - do underlining

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

     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 -t
          option overrides the terminal kind specified in the
          environment.  The file /usr/lib/terminfo 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 -i option causes ul to indicate underlining onto by a
          separate line containing appropriate dashes `-'; this is
          useful when you want to look at the underlining which is
          present in an nroff output stream on a crt-terminal.

          ul also handles bold printing, alternate character sets,
          etc. when the sequences are defined in the terminal's
          /usr/lib/terminfo entry.

     SEE ALSO
          man(1), nroff(1)

     AUTHOR
          Mark Horton wrote ul.  The -i option was originally a option
          of the editor ex(1), then an iul command.

     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.

     ORIGIN
          4.3 BSD












     Page 1                                        (last mod. 8/20/87)