.\"    This file documents the GNU text utilities.
.\" 
.\"    Copyright (C) 1994, 95, 96 Free Software Foundation, Inc.
.\" 
.\"    Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"  
.\"    Permission is granted to copy and distribute modified versions of
.\" this manual under the conditions for verbatim copying, provided that
.\" the entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"  
.\"    Permission is granted to copy and distribute translations of this
.\" manual into another language, under the above conditions for modified
.\" versions, except that this permission notice may be stated in a
.\" translation approved by the Foundation.
.\" 
.\" Japanese Version Copyright (c) 1997 NAKANO Takeo all rights reserved.
.\" Translated Wed Mar 4 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.TH FMT 1 "GNU Text Utilities" "FSF" \" -*- nroff -*-
.SH 名前
fmt \- 簡単な最適化テキストフォーマッター
.SH 書式
.B fmt
[\-cstu] 
[\-width] 
[\-w width] 
[\-p prefix]
[\-\-crown-margin]
[\-\-split-only]
[\-\-tagged-paragraph]
[\-\-uniform-spacing]
[\-\-width=width]
[\-\-prefix=prefix]
[\-\-help]
[\-\-version]
[file ...]
.SH 説明
この文書はもうメンテナンスされていないので、不正確・不完全
な可能性がある。現在は texinfo 文書が正式な情報となっている。
.PP
このマニュアルページは GNU 版
.B fmt
について記述したものである。
.B fmt
は簡単なテキストフォーマッターで、行を結合したり隙間を埋めたりして
.I width
で指定された幅 (デフォルトは 75) を最大とする出力を生成する。
しかし簡単とはいえ、
.B fmt
は行分割に最適化アルゴリズムを用いている。これは
\*(lqBreaking Paragraphs into Lines\*(rq,
Donald E. Knuth and Michael F. Plass,
.I "Software\(emPractice and Experience"
.B 11
(1981) 1119\-1184.
で示されている方法の簡易版である。
.LP
.B fmt
は引き数で与えられている複数の
.I file
を結合する。ひとつも与えられていない場合は、標準入力からテキストを
読み込んで整形する。
.LP
空行はそのまま出力に残される。単語間のスペースも同様である (
.I \-u
が指定されなかった場合)。
BSD の
.B fmt
とは異なり、入力のタブは一度展開され、出力の際に再生成される。
.LP
段付け (indentation) も出力に保存される。入力行のうちインデントの深さ
が異なるものは結合されない (
.I \-c
または
.I \-t
が指定されなかった場合)。
BSD の
.B fmt
もマニュアルでは同様の動作をするように記述されているが、実は続く行のイ
ンデントが浅い場合は結合してしまうことに注意。
.LP
.B fmt
は文の最後で改行しようとする。また文の最初の単語の直後や、文の最後の単
語の直前での改行は避けようとする。文の区切りは、以下のように定義されて
いる。 (1) 段落の最後。 (2) [.?!] でおわる単語に、二つのスペースまたは
行末が続いたもの。ただし括弧や引用符の内部では文区切りとはみなされない。
.SS オプション
.TP
.I "-c, --crown-margin"
クラウンマージンモード (crown margin mode)。
段落の最初の二行のインデントを保存し、引き続く行の左マージンをそれぞれ第
二行のものに揃える。
.TP
.I "-t, --tagged-paragraph"
タグ付き段落モード (tagged paragraph mode)。
クラウンモードと似ているが、段落の最初の行のインデントは第二行のものと
は異なっていなければならない。同じである場合は、最初の行は一行だけから
なる段落とみなされる。
.TP
.I "-s, --split-only"
行分割だけを行う。短い行を結合して長い行を生成する作業を行わない。プロ
グラムコードなどの整形されたテキストが不正に結合されるのを避けることが
できる。
.TP
.I "-u, --uniform-spacing"
一様なスペース配置 (uniform spacing)。
単語間のスペースをスペース文字ひとつに減らす。ただし文の間には二つのス
ペース文字が用いられる。
.TP
.I "-width, -w width, --width=width"
出力行を
.I width
桁まで埋めようとする (デフォルトは 75)。
.B fmt
は各行の長さを揃えるための空間を確保する目的から、およそ 7% ほど行を短
くする傾向にある。
.TP
.I "-p, --prefix=prefix"
.I prefix
で始まる行だけ (スペースが前置されていても良い) を再配置する。
.I prefix
(と前置されるスペース) は整形前にいったん削除され、整形された出力行に
再び配置される。利用法としては、例えばある種のプログラムのコメントだけ
を整形して、コード部分は変更したくない場合などが考えられる。
.TP
.I "\-\-help"
使い方に関するメッセージを標準出力に表示し、実行成功を返して終了する。
.TP
.I "\-\-version"
バージョン情報を標準出力に表示して終了する。