User Commands                                               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
                    environment.  If  the  terminal cannot under-
                    line, underlining is ignored. If the terminal
                    name   is   not   found,  no  underlining  is
                    attempted.


     -i             Indicate underlining by a separate line  con-
                    taining  appropriate dashes `-'; this is use-
                    ful 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/*


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











SunOS 5.11          Last change: 17 Mar 1994                    1






User Commands                                               ul(1)



     
           ATRIBUTE TYPE               ATRIBUTE 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.









































SunOS 5.11          Last change: 17 Mar 1994                    2