.\"    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 Mon Jun 9 1997 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.TH CSPLIT 1 "GNU Text Utilities" "FSF" \" -*- nroff -*-
.SH 名前
csplit \- ファイルを文脈ベースで分割する
.SH 書式
.B csplit
[\-sqkz] [\-f prefix] [\-b suffix] [\-n digits] [\-\-prefix=prefix]
[\-\-suffix\-format=suffix] [\-\-digits=digits] [\-\-quiet] [\-\-silent]
[\-\-keep-files] [\-\-elide\-empty\-files] [\-\-help] [\-\-version]
file pattern...
.SH 説明
この文書はもうメンテナンスされていないので、不正確・不完全
な可能性がある。現在は texinfo 文書が正式な情報となっている。
.PP
このマニュアルページは GNU 版
.BR csplit
について記述したものである。
.B csplit
は与えられた入力ファイル
.IR file
（ファイル名が `-' の場合は標準入力）
の各セクション（section）の内容を持った 0 個以上の出力ファイルを作成す
る。デフォルトでは
.B csplit
はそれぞれの出力ファイルを作成する際に、出力されたバイト数を表示する。
.PP
出力ファイルの内容は引き数
.I pattern
によって定められる。
.I pattern
引き数で指定される行が入力ファイルに存在しない場合はエラーとなる。例え
ば、与えられた正規表現にマッチする行が残っていない場合などが該当する。
ただし与えられた
.I pattern
が一度でもマッチしていれば、残りの出力は最後の出力ファイルにコピーされ
る。
.I pattern
引き数の形式としては以下のようなものがある:
.RS
.TP
.I line
.br
\fIline\fP には正の整数を指定する。出力ファイルを作成し、入力ファイル
の内容を行番号が \fIline\fP になるまで書き込む（ただし \fIline\fP の
行は含まない）。この後にさらに数字が指定されると、次の出力ファイルが作
成され、入力ファイルの続きの内容をその行番号まで書き込んでいく。
.TP
/\fIregexp\fP/[\fIoffset\fP]
.br
出力ファイルを作成し、入力ファイルのうち
.I regexp
にマッチする行の前までの内容を書き込む（マッチ行は含まない）。
.I offset
を付加することもできる。これは `+' または `-' に正の整数を続けて指定す
る。
.I offset
が指定されるとマッチ行に
.I offset
の値を加減した行までが出力される。
入力ファイルの残りは次のセクションの入力として利用される。
.TP
%\fIregexp\fP%[\fIoffset\fP]
.br
直前の形式と同様だが、出力ファイルが作成されない。したがって入力ファイルの
該当するセクションは無視されることになる。
.TP
{\fIrepeat-count\fP}
.br
.I repeat-count
には正の整数を指定する。
直前のパターンを
.I repeat-count
の回数だけ余計に繰りかえす。繰り返し回数の部分に整数でなくアスタリスク
を指定することもできる。この場合は入力ファイルが終わるまで直前の
パターンを繰り返す。
.RE
.PP
出力ファイルのファイル名は二つの部分からなっている。デフォルトでは後半部
は 2 桁の 10 進数で、 00 から 99 まで順にカウントアップされて行く。
このデフォルトの設定は
.I \-\-digits
オプションや
.I \-\-suffix\-format
オプションによって変更できる（詳細は後述）。いずれの場合でも、出力ファ
イルを名前でソートして順に結合させると、入力ファイルが得られるようになっ
ている。前半部のデフォルト名は `xx' である。
.PP
.B csplit
がエラーになったり、 hangup や interrupt、 quit、 terminate などのシグナルを
受け取った場合には、デフォルトではそれまでに作られた出力ファイルは消去される。
.SS オプション
.TP
.I "\-f, \-\-prefix=prefix"
.I prefix
を出力ファイル名の前半部分の文字列として用いる。
.TP
.I "\-b, \-\-suffix\-format=suffix"
.I suffix
を出力ファイル名の後半部に用いる。
.I suffix
には、 printf(3) 形式の変換文字列を指定しなければならない（例えば %d 
のようなもの。書式指定、文字列の幅、精度指定なども指定可能）。変換指定
文字列は整数を可読なかたちで出力するものでなければならない。したがって
使えるのは `d'、 `i'、 `u'、 `o'、 `x' および `X' に限られる。
.I suffix
文字列はすべて（現在の出力ファイルが何番目かを示す数値と共に） 
sprintf(3) 関数に渡され、それぞれの出力ファイルに応じた名前が順番に出
力される。
このオプションが指定された場合には、
.I \-\-digits
オプションは無視されるので注意すること。
.TP
.I "\-n, \-\-digits=digits"
出力ファイル名の数値部分の桁数をデフォルト値の 2 から
.I digits
に変更する。
.TP
.I "\-k, \-\-keep-files"
.\" Do not remove output files when errors are encountered.
エラーが起こったときにそれまでに作成した出力ファイルを消去しないように
する。
.TP
.I "\-z, \-\-elide\-empty\-files"
大きさ 0 の出力ファイルを作らないようにする（セクションの区切りが入力
の最初の行にきた場合、このオプションを指定していなければ対応する出力ファ
イルの大きさは 0 になる。なお出力ファイルの順番を示す番号は、このオプ
ションによって大きさ 0 のファイルの出力が抑制された場合でも、常に 0 か
らスタートする（そのような場合にはファイルの個数がひとつ少なくなること
になる）。
.TP
.I "\-s, \-q, \-\-silent, \-\-quiet"
出力ファイルのサイズを表示しない。
.TP
.I "\-\-help"
使い方に関するメッセージを標準出力に表示し、実行成功を返して終了する。
.TP
.I "\-\-version"
バージョン情報を標準出力に表示して終了する。