Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ col(1) — Digital UNIX 3.2c

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

 deroff(1)

neqn(1)

col(1)  —  Commands

NAME

col − Filters text containing linefeeds

SYNOPSIS

col [-bfhpx] [-l number]

The col command reads from standard input and writes to standard output. 

FLAGS

-bAssumes that the output device in use is not capable of backspacing.  In this case, if two or more characters are to be displayed in the same position, only the last one that is read is displayed in the output.  This function is useful for converting nroff output to produce readable results on terminals or printers that do not support underlining or overstriking characters. 

-fSuppresses the default treatment of half-line motions in the input.  Normally, col does not emit half-line motions on output, although it does accept them in its input.  With this flag, output may contain forward half-linefeeds (<Esc-9>), but not reverse linefeeds (<Esc-7> or <Esc-8>). 

-hCompresses spaces into tabs. This is the default. 

-l number
Buffers at least number lines in memory.  By default, 128 lines" are buffered. 

-pDisplays unknown escape sequences as characters, subject to overprinting from reverse line motions.  Normally, col ignores them.  You should be fully aware of the textual position of escape sequences before you use this flag. 

-xOutputs multiple spaces instead of tabs. 

DESCRIPTION

The col command performs the line overlays implied by reverse linefeeds (ASCII <Esc-7>), and by forward and reverse half-linefeeds (ASCII <Esc-9> and ASCII <Esc-8>).  It also replaces white-space characters with tabs where possible. 

The col command is particularly useful for filtering multicolumn output made by the nroff and tbl commands. 

The col command assumes that the ASCII control characters SO (\017) and SI (\016) begin and end text in an alternate character set.  col remembers the character set each input character belongs to, and on output generates SI and SO characters as appropriate to ensure that each character is printed in the correct character set. 

On input, col accepts only the control characters for the <Space>, <Backspace>, <Tab>, and <Return> keys; the newline character; the SI, SO, and VT control characters; and <Esc-7>, <Esc-8>, or <Esc-9>.  The VT control character (\013) is an alternate form of full reverse linefeed included for compatibility with some earlier programs of this type.  The col command discards all other nonprinting characters. 

If the input attempts to back up to the last flushed line, col displays a warning message. 

EXIT VALUES

     1.Successful completion

     2.Error occurred

RELATED INFORMATION

 deroff(1), neqn(1), nroff, tbl. 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026