unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

ul(1)                            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  indi-
       cates underlining for the terminal in use, as specified by the environ-
       ment variable  TERM.  ul  uses  the  /usr/share/lib/terminfo  entry  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  under-
       line, 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 attributes:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWdoc


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

BUGS
       nroff usually generates a series of backspaces  and  underlines  inter-
       mixed  with the text to indicate underlining. ul makes attempt to opti-
       mize the backward motion.



SunOS 5.10                        17 Mar 1994                            ul(1)