version 1.3, 1998/09/23 04:32:37 |
version 1.4, 1999/06/05 01:21:21 |
|
|
.Op Fl bfx |
.Op Fl bfx |
.Op Fl l Ar num |
.Op Fl l Ar num |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm col |
.Nm |
filters out reverse (and half reverse) line feeds so that the output is |
filters out reverse (and half-reverse) line feeds so that the output is |
in the correct order with only forward and half forward line |
in the correct order with only forward and half-forward line |
feeds, and replaces white-space characters with tabs where possible. |
feeds, and replaces whitespace characters with tabs where possible. |
This can be useful in processing the output of |
This can be useful in processing the output of |
.Xr nroff 1 |
.Xr nroff 1 |
and |
and |
.Xr tbl 1 . |
.Xr tbl 1 . |
.Pp |
.Pp |
.Nm col |
.Nm |
reads from the standard input and writes to the standard output. |
reads from the standard input and writes to the standard output. |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width "-l num " |
.Bl -tag -width "-l num" |
.It Fl b |
.It Fl b |
Do not output any backspaces, printing only the last character |
Do not output any backspaces, printing only the last character |
written to each column position. |
written to each column position. |
.It Fl f |
.It Fl f |
Forward half line feeds are permitted (``fine'' mode). |
Forward half-line feeds are permitted |
Normally characters printed on a half line boundary are printed |
.Pf ( Ns Dq fine |
|
mode). |
|
Normally characters printed on a half-line boundary are printed |
on the following line. |
on the following line. |
.It Fl x |
.It Fl x |
Output multiple spaces instead of tabs. |
Output multiple spaces instead of tabs. |
|
|
.El |
.El |
.Pp |
.Pp |
The control sequences for carriage motion that |
The control sequences for carriage motion that |
.Nm col |
.Nm |
understands and their decimal values are listed in the following |
understands and their decimal values are listed in the following |
table: |
table: |
.Pp |
.Pp |
.Bl -tag -width "carriage return" -compact |
.Bl -tag -width "carriage return" -compact |
.It ESC\-7 |
.It ESC\-7 |
reverse line feed (escape then 7) |
Reverse line feed (escape then 7). |
.It ESC\-8 |
.It ESC\-8 |
half reverse line feed (escape then 8) |
Half reverse line feed (escape then 8). |
.It ESC\-9 |
.It ESC\-9 |
half forward line feed (escape then 9) |
Half forward line feed (escape then 9). |
.It backspace |
.It backspace |
moves back one column (8); ignored in the first column |
Moves back one column (8); ignored in the first column. |
.It carriage return |
.It carriage return |
(13) |
(13) |
.It newline |
.It newline |
forward line feed (10); also does carriage return |
Forward line feed (10); also does carriage return. |
.It shift in |
.It shift in |
shift to normal character set (15) |
Shift to normal character set (15). |
.It shift out |
.It shift out |
shift to alternate character set (14) |
Shift to alternate character set (14). |
.It space |
.It space |
moves forward one column (32) |
Moves forward one column (32). |
.It tab |
.It tab |
moves forward to next tab stop (9) |
Moves forward to next tab stop (9). |
.It vertical tab |
.It vertical tab |
reverse line feed (11) |
Reverse line feed (11). |
.El |
.El |
.Pp |
.Pp |
All unrecognized control characters and escape sequences are |
All unrecognized control characters and escape sequences are |
discarded. |
discarded. |
.Pp |
.Pp |
.Nm col |
.Nm |
keeps track of the character set as characters are read and makes |
keeps track of the character set as characters are read and makes |
sure the character set is correct when they are output. |
sure the character set is correct when they are output. |
.Pp |
.Pp |
If the input attempts to back up to the last flushed line, |
If the input attempts to back up to the last flushed line, |
.Nm col |
.Nm |
will display a warning message. |
will display a warning message. |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr expand 1 , |
.Xr expand 1 , |
|
|
.Xr tbl 1 |
.Xr tbl 1 |
.Sh HISTORY |
.Sh HISTORY |
A |
A |
.Nm col |
.Nm |
command appeared in |
command appeared in |
.At v6 . |
.At v6 . |