man-pages/man1/col.1.html
2021-03-31 01:06:50 +01:00

279 lines
4.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of COL</TITLE>
</HEAD><BODY>
<H1>COL</H1>
Section: User Commands (1)<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<BR>BSD mandoc<BR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
<B>col</B>
- filter reverse line feeds from input
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B></B>
[-<B>bfhpx</B>
]
[-<B>l </B><I>num</I>
]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The
<B></B>
utility filters out reverse (and half reverse) line feeds so that the output is
in the correct order with only forward and half forward line
feeds, and replaces white-space characters with tabs where possible.
This can be useful in processing the output of
<A HREF="/cgi-bin/man/man2html?1+nroff">nroff</A>(1)
and
<A HREF="/cgi-bin/man/man2html?1+tbl">tbl</A>(1).
<P>
The
<B></B>
utility reads from the standard input and writes to the standard output.
<P>
The options are as follows:
<DL COMPACT>
<P>
<DT id="1"><B>-b</B>
<DD>
Do not output any backspaces, printing only the last character
written to each column position.
<DT id="2"><B>-f</B>
<DD>
Forward half line feeds are permitted (``fine'' mode).
Normally characters printed on a half line boundary are printed
on the following line.
<DT id="3"><B>-h</B>
<DD>
Do not output multiple spaces instead of tabs (default).
<DT id="4"><B>-l </B><I>num</I>
<DD>
Buffer at least
<I>num</I>
lines in memory.
By default, 128 lines are buffered.
<DT id="5"><B>-p</B>
<DD>
Force unknown control sequences to be passed through unchanged.
Normally,
<B></B>
will filter out any control sequences from the input other than those
recognized and interpreted by itself, which are listed below.
<DT id="6"><B>-x</B>
<DD>
Output multiple spaces instead of tabs.
</DL>
<P>
<P>
In the input stream,
<B></B>
understands both the escape sequences of the form escape-digit
mandated by
St -susv2
and the traditional
BSD format escape-control-character.
The control sequences for carriage motion and their ASCII values
are as follows:
<P>
<DL COMPACT>
<P>
<DT id="7"><B>ESC-BELL</B>
<DD>
reverse line feed (escape then bell).
<DT id="8"><B>ESC-7</B>
<DD>
reverse line feed (escape then 7).
<DT id="9"><B>ESC-BACKSPACE</B>
<DD>
half reverse line feed (escape then backspace).
<DT id="10"><B>ESC-8</B>
<DD>
half reverse line feed (escape then 8).
<DT id="11"><B>ESC-TAB</B>
<DD>
half forward line feed (escape than tab).
<DT id="12"><B>ESC-9</B>
<DD>
half forward line feed (escape then 9).
In
-<B>f</B>
mode, this sequence may also occur in the output stream.
<DT id="13"><B>backspace</B>
<DD>
moves back one column (8); ignored in the first column
<DT id="14"><B>carriage return</B>
<DD>
(13)
<DT id="15"><B>newline</B>
<DD>
forward line feed (10); also does carriage return
<DT id="16"><B>shift in</B>
<DD>
shift to normal character set (15)
<DT id="17"><B>shift out</B>
<DD>
shift to alternate character set (14)
<DT id="18"><B>space</B>
<DD>
moves forward one column (32)
<DT id="19"><B>tab</B>
<DD>
moves forward to next tab stop (9)
<DT id="20"><B>vertical tab</B>
<DD>
reverse line feed (11)
</DL>
<P>
<P>
All unrecognized control characters and escape sequences are
discarded.
<P>
The
<B></B>
utility keeps track of the character set as characters are read and makes
sure the character set is correct when they are output.
<P>
If the input attempts to back up to the last flushed line,
<B></B>
will display a warning message.
<A NAME="lbAE">&nbsp;</A>
<H2>ENVIRONMENT</H2>
The
<B>LANG , LC_ALL</B>
and
<B>LC_CTYPE</B>
environment variables affect the execution of
<B></B>
as described in
<A HREF="/cgi-bin/man/man2html?7+environ">environ</A>(7).
<A NAME="lbAF">&nbsp;</A>
<H2>EXIT STATUS</H2>
Ex -std
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+colcrt">colcrt</A>(1),
<A HREF="/cgi-bin/man/man2html?1+expand">expand</A>(1),
<A HREF="/cgi-bin/man/man2html?1+nroff">nroff</A>(1),
<A HREF="/cgi-bin/man/man2html?1+tbl">tbl</A>(1)
<A NAME="lbAH">&nbsp;</A>
<H2>STANDARDS</H2>
The
<B></B>
utility conforms to
St -susv2 .
<A NAME="lbAI">&nbsp;</A>
<H2>HISTORY</H2>
A
<B></B>
command
appeared in
AT&amp;T System
v6 .
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="21"><A HREF="#lbAB">NAME</A><DD>
<DT id="22"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="23"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="24"><A HREF="#lbAE">ENVIRONMENT</A><DD>
<DT id="25"><A HREF="#lbAF">EXIT STATUS</A><DD>
<DT id="26"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="27"><A HREF="#lbAH">STANDARDS</A><DD>
<DT id="28"><A HREF="#lbAI">HISTORY</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:09 GMT, March 31, 2021
</BODY>
</HTML>