xref: /csrg-svn/usr.bin/col/col.1 (revision 47399)
142270Sbostic.\" Copyright (c) 1990 The Regents of the University of California.
242270Sbostic.\" All rights reserved.
319390Smckusick.\"
442270Sbostic.\" This code is derived from software contributed to Berkeley by
544952Scael.\" Michael Rendell.
642270Sbostic.\"
742270Sbostic.\" %sccs.include.redist.man%
842270Sbostic.\"
9*47399Scael.\"     @(#)col.1	6.7 (Berkeley) 03/14/91
1042270Sbostic.\"
1143082Scael.Dd
1243082Scael.Dt COL 1
13*47399Scael.Os
1443082Scael.Sh NAME
1543082Scael.Nm col
1643082Scael.Nd filter reverse line feeds from input
1743082Scael.Sh SYNOPSIS
1843082Scael.Nm col
1943082Scael.Op Fl bfx
2043082Scael.Op Fl l Ar num
2143082Scael.Sh DESCRIPTION
2243082Scael.Nm Col
23*47399Scaelfilters out reverse (and half reverse) line feeds so the output is
24*47399Scaelin the correct order with only forward and half forward line
2542270Sbosticfeeds, and replaces white-space characters with tabs where possible.
2642270SbosticThis can be useful in processing the output of
2743082Scael.Xr nroff 1
2842270Sbosticand
2943082Scael.Xr tbl  1 .
3043082Scael.Pp
3143082Scael.Nm Col
3242270Sbosticreads from standard input and writes to standard output.
3343082Scael.Pp
3442270SbosticThe options are as follows:
35*47399Scael.Bl -tag -width "-lnum"
36*47399Scael.It Fl b
3742270SbosticDo not output any backspaces \- print only the last character
3842270Sbosticwritten to each column position.
39*47399Scael.It Fl f
4042270SbosticForward half line feeds are permitted (``fine'' mode).
4142270SbosticNormally characters printed on a half line boundary are printed
4242270Sbosticon the following line.
43*47399Scael.It Fl x
4442270SbosticOutput multiple spaces instead of tabs.
45*47399Scael.It Fl l Ns Ar num
4642270SbosticBuffer at least
4743082Scael.Ar num
4842270Sbosticlines in memory.
4942270SbosticBy default, 128 lines are buffered.
50*47399Scael.El
5143082Scael.Pp
5242270SbosticThe control sequences for carriage motion that
5343082Scael.Nm col
5442270Sbosticunderstands and their decimal values are listed in the following
5542270Sbostictable:
5643082Scael.Pp
57*47399Scael.Bl -tag -width "carriage return" -compact
58*47399Scael.It ESC\-7
5942270Sbosticreverse line feed (escape then 7)
60*47399Scael.It ESC\-8
6142270Sbostichalf reverse line feed (escape then 8)
62*47399Scael.It ESC\-9
6342270Sbostichalf forward line feed (escape then 9)
64*47399Scael.It backspace
6542270Sbosticmoves back one column (8); ignored in the first column
66*47399Scael.It carriage return
6742270Sbostic(13)
68*47399Scael.It newline
6942270Sbosticforward line feed (10); also does carriage return
70*47399Scael.It shift in
7142270Sbosticshift to normal character set (15)
72*47399Scael.It shift out
7342270Sbosticshift to alternate character set (14)
74*47399Scael.It space
7542270Sbosticmoves forward one column (32)
76*47399Scael.It tab
7742270Sbosticmoves forward to next tab stop (9)
78*47399Scael.It vertical tab
7942270Sbosticreverse line feed (11)
80*47399Scael.El
8143082Scael.Pp
8242270SbosticAll unrecognized control characters and escape sequences are
8342270Sbosticdiscarded.
8443082Scael.Pp
8543082Scael.Nm Col
8642270Sbostickeeps track of the character set as characters are read and makes
8742270Sbosticsure the character set is correct when they are output.
8843082Scael.Pp
8942270SbosticIf the input attempts to back up to the last flushed line,
9043082Scael.Nm col
9142270Sbosticwill display a warning message.
9243082Scael.Sh SEE ALSO
9343082Scael.Xr expand 1 ,
9443082Scael.Xr nroff 1 ,
9543082Scael.Xr tbl 1
9643082Scael.Sh HISTORY
9743082ScaelA
9843082Scael.Nm col
9943082Scaelcommand
100*47399Scaelappeared in Version 6 AT&T UNIX.  The
101*47399Scael.Bx
10243082Scael.Nm col
10343082Scaelis derived from code written by Michael Rendell.
104