ul(1) [posix man page]

UL(1)							    BSD General Commands Manual 						     UL(1)

NAME

     ul -- do underlining

SYNOPSIS

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

DESCRIPTION

     The ul utility 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.  During the translation some other special characters also get translated.  E.g. TAB gets expanded to spaces.

     The following options are available:

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

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

ENVIRONMENT

     The LANG, LC_ALL, LC_CTYPE and TERM environment variables affect the execution of ul as described in environ(7).

EXIT STATUS

     The ul utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

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

HISTORY

     The ul command appeared in 3.0BSD.

BUGS

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

BSD
								  August 4, 2004							       BSD

COLCRT(1)                                                   BSD General Commands Manual                                                  COLCRT(1)

NAME

     colcrt -- filter nroff output for CRT previewing

SYNOPSIS

     colcrt [-] [-2] [file ...]

DESCRIPTION

     The colcrt utility provides virtual half-line and reverse line feed sequences for terminals without such capability, and on which overstrik-
     ing is destructive.  Half-line characters and underlining (changed to dashing `-') are placed on new lines in between the normal output
     lines.

     The following options are available:

     -       Suppress all underlining.  This option is especially useful for previewing allboxed tables from tbl(1).

     -2      Cause all half-lines to be printed, effectively double spacing the output.  Normally, a minimal space output format is used which
             will suppress empty lines.  The program never suppresses two consecutive empty lines, however.  The -2 option is useful for sending
             output to the line printer when the output contains superscripts and subscripts which would otherwise be invisible.

ENVIRONMENT

     The LANG, LC_ALL and LC_CTYPE environment variables affect the execution of colcrt as described in environ(7).

EXIT STATUS

     The colcrt utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

     A typical use of colcrt would be

     tbl exum2.n | nroff -ms | colcrt - | more

SEE ALSO

     col(1), more(1), nroff(1), troff(1), ul(1)

HISTORY

     The colcrt command appeared in 3.0BSD.

BUGS

     Should fold underlines onto blanks even with the '-' option so that a true underline character would show.

     Cannot back up more than 102 lines.

     General overstriking is lost; as a special case '|' overstruck with '-' or underline becomes '+'.

     Lines are trimmed to 132 characters.

     Some provision should be made for processing superscripts and subscripts in documents which are already double-spaced.

     Characters that take up more than one column position may not be underlined correctly.

BSD                                                                July 31, 2004                                                               BSD