xref: /csrg-svn/usr.bin/col/col.1 (revision 63680)
1*63680Sbostic.\" Copyright (c) 1990, 1993
2*63680Sbostic.\"	The Regents of the University of California.  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*63680Sbostic.\"     @(#)col.1	8.1 (Berkeley) 06/29/93
1042270Sbostic.\"
1143082Scael.Dd
1243082Scael.Dt COL 1
1347399Scael.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
2363679Smckusickfilters out reverse (and half reverse) line feeds so that the output is
2447399Scaelin 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
3263679Smckusickreads from the standard input and writes to the standard output.
3343082Scael.Pp
3442270SbosticThe options are as follows:
3563679Smckusick.Bl -tag -width "-l num  "
3647399Scael.It Fl b
3750071SbosticDo not output any backspaces, printing only the last character
3842270Sbosticwritten to each column position.
3947399Scael.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.
4347399Scael.It Fl x
4442270SbosticOutput multiple spaces instead of tabs.
4563679Smckusick.It Fl l Ar num
4642270SbosticBuffer at least
4743082Scael.Ar num
4842270Sbosticlines in memory.
4942270SbosticBy default, 128 lines are buffered.
5047399Scael.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
5747399Scael.Bl -tag -width "carriage return" -compact
5847399Scael.It ESC\-7
5942270Sbosticreverse line feed (escape then 7)
6047399Scael.It ESC\-8
6142270Sbostichalf reverse line feed (escape then 8)
6247399Scael.It ESC\-9
6342270Sbostichalf forward line feed (escape then 9)
6447399Scael.It backspace
6542270Sbosticmoves back one column (8); ignored in the first column
6647399Scael.It carriage return
6742270Sbostic(13)
6847399Scael.It newline
6942270Sbosticforward line feed (10); also does carriage return
7047399Scael.It shift in
7142270Sbosticshift to normal character set (15)
7247399Scael.It shift out
7342270Sbosticshift to alternate character set (14)
7447399Scael.It space
7542270Sbosticmoves forward one column (32)
7647399Scael.It tab
7742270Sbosticmoves forward to next tab stop (9)
7847399Scael.It vertical tab
7942270Sbosticreverse line feed (11)
8047399Scael.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
10050071Sbosticappeared in Version 6 AT&T UNIX.
101