.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" Michael Rendell.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)col.1	6.8 (Berkeley) 6/17/91
.\"
.\" Japanese Version Copyright (c) 2001 Yuichi SATO
.\"         all rights reserved.
.\" Translated Sun Mar 3 1995
.\"         by NetBSD jman proj. <jman@spa.is.uec.ac.jp>
.\" Updated Sun Jan  7 21:36:58 JST 2001
.\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\"
.\"WORD:	line feed		改行
.\"WORD:	carrige return		復帰
.\"
.Dd June 17, 1991
.Dt COL 1
.Os
.Sh 名前
.Nm col
.Nd 入力中にある逆改行コードを処理するフィルタ
.Sh 書式
.Nm col
.Op Fl bfpx
.Op Fl l Ar num
.Sh 説明
.Nm col
は、逆方向への改行および半改行を取り除き、
通常の改行方向だけで出力可能なものに変換する。
同時に、可能な限り空白文字部分をタブに置き換える処理をする。
これは、
.Xr nroff 1
や
.Xr tbl 1
の出力を処理するのに役立つ。
.Pp
.Nm col
は、データを標準入力から読み込み、標準出力に書き出す。
.Pp
オプションとしては以下のものがある:
.Bl -tag -width "-lnum"
.It Fl b
バックスペースを出力しないようにする。
(訳註: 同じ箇所に複数の文字が書かれる場合は)
行中のその箇所に最後に書かれた文字だけを表示する。
.It Fl f
半改行を含めることを許可する (``fine'' モード)。
通常、行と行の境界に表示されることになる文字は、次の行に表示される。
.It Fl p
不明なコントロール文字を変更せずに表示する。
通常
.Nm col
は、以下に挙げるような認識・解釈できる
コントロール文字でなければ、その文字を入力から取り除く。
.It Fl x
タブのかわりに複数個の空白文字を出力する。
.It Fl l Ns Ar num
メモリ上に、少なくとも
.Ar num
行分をバッファする。
デフォルトでは 128 行分がバッファされる。
.El
.Pp
.Nm col
が認識する復帰動作のためのコントロール文字と、
その文字の 10 進数での値を以下の表に示す:
.Pp
.Bl -tag -width "carriage return" -compact
.It ESC\-7
逆方向に改行する (エスケープの後に 7)
.It ESC\-8
逆方向に半改行する (エスケープの後に 8)
.It ESC\-9
通常方向に半改行する (エスケープの後に 9)
.It backspace
逆方向に 1 カラム分戻す (8)。最初のカラムでは無視される
.It carriage return
行頭に復帰する (13)
.It newline
通常方向に改行する (10)。行頭への復帰も行う
.It shift in
通常の文字セットを選択する (15)
.It shift out
特別な文字セットを選択する (14)
.It space
通常方向に 1 カラム分に移動する (32)
.It tab
次のタブ位置へ移動する (9)
.It vertical tab
逆方向に改行する (11)
.El
.Pp
col が認識できないコントロール文字およびエスケープシーケンスは削除される。
.Pp
.Nm col
は文字列を読み込みながら追って行き、
出力する際に正しいかを確認する。
.Pp
すでに出力してしまった行を超えて戻るような逆改行の処理が入った場合、
.Nm col
は警告メッセージを表示する。
.Sh 関連項目
.Xr expand 1 ,
.Xr nroff 1 ,
.Xr tbl 1
.Sh 準拠
.Nm col
ユーティリティは Single UNIX Specification, Version 2 に従う。
.Fl l
オプションは、この規格を拡張したものである。
.Sh 履歴
.Nm col
コマンドは
Version 6 AT&T UNIX
から登場した。