.\"    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 Jul 9 1997 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.TH NL 1 "GNU Text Utilities" "FSF" \" -*- nroff -*-
.SH 名前
nl \- ファイルの行を番号付けする
.SH 書式
.B nl
[\-h header-style] [\-b body-style] [\-f footer-style] [\-p] [\-d cc]
[\-v start-number] [\-i increment] [\-l lines] [\-s line-separator]
[\-w line-no-width] [\-n {ln,rn,rz}] [\-\-header-numbering=style]
[\-\-body-numbering=style] [\-\-footer-numbering=style]
[\-\-first-page=number] [\-\-page-increment=number] [\-\-no-renumber]
[\-\-join-blank-lines=number] [\-\-number-separator=string]
[\-\-number-width=number] [\-\-number-format={ln,rn,rz}]
[\-\-section-delimiter=cc] [\-\-help] [\-\-version] [file...]
.SH 説明
この文書はもうメンテナンスされていないので、不正確・不完全
な可能性がある。現在は texinfo 文書が正式な情報となっている。
.PP
このマニュアルページは GNU 版
.BR nl
について記述したものである。
.B nl
は指定されたファイル (ファイル名がひとつも指定されなかったり、 '\-' が
指定された場合には標準入力) の内容を標準出力に書き込む。その際、行番号
を一部または全部の行に付加する。
.PP
.B nl
は入力を論理ページ (logical page) から構成されるものとみなす。デフォル
トでは、行番号は各々の論理ページの先頭で 1 にリセットされる。
.B nl
は入力されたファイルすべてをまとめてひとつの文書とみなす。したがってファ
イルの切れ目でも行番号や論理ページはリセットされない。
.PP
論理ページは三つのセクションからなる。ヘッダ (header)、本文 (body)、
フッタ (footer) である。セクションは空であってもよい。
また、それぞれを別な形式で番号付けすることもできる。
.PP
入力ファイル中に以下のデリミタ文字列 (delimiter string) だけからなる行
があると、論理ページのセクションの始まりとみなされる。
.PP
.nf

\e:\e:\e: ヘッダの先頭
\e:\e: 本文の先頭
\e: フッタの先頭
.fi
.PP
これらの文字列を構成する二つの文字はオプションによって変更可能である
(以下を参照)。しかし形式とそれぞれの文字列の長さは変更できない。
.PP
セクションのデリミタ文字列は出力では空行となる。入力ファイルのうち、最
初のセクションデリミタ文字列の前に来るテキストは本文セクションとみなさ
れる。したがってセクションのデリミタ文字列を含まないファイルは単一の本
文セクションからなるものとみなされる。
.SS オプション
.TP
.I "\-h, \-\-header-numbering=style"
\-\-footer-numbering を見よ。
.TP
.I "\-b, \-\-body-numbering=style"
\-\-footer-numbering を見よ。
.TP
.I "\-f, \-\-footer-numbering=style"
各論理ページにおけるフッタセクションの行番号表示の形式を選択する。行が
番号付けされない場合は、行番号は増加しない。しかしその場合でも区切り文
字は入力行に前置される。形式には以下のようなものがある:
.RS
.IP a
すべての行を番号付けする
.IP t
空行以外の行を番号付けする (本文セクションのデフォルト)
.IP n
すべての行を番号付けしない (ヘッダとフッタセクションのデフォルト)
.IP p\fIregexp\fP
.I regexp
にマッチする内容を含む行だけを番号付けする
.RE
.TP
.I "\-p, \-\-no-renumber"
論理ページの先頭で行番号をリセットしない。
.TP
.I "\-v, \-\-first-page=number"
それぞれの論理ページの行番号を \fInumber\fP から始める (デフォルトは 1)
.TP
.I "\-i, \-\-page-increment=number"
行番号の増分を \fInumber\fP にする (デフォルトは 1)。
.TP
.I "\-l, \-\-join-blank-lines=number"
.I number
(デフォルトは 1) だけ連続した空行を、番号付けの際に 1 論理行とみなし、
最後の空行にのみ番号を付ける。
空行の連続が
.I number
以下の場合には、番号付けを行わない。
空行とはスペースやタブも含め、文字を全く含まない行のこと。
.TP
.I "\-s, \-\-number-separator=string"
出力ファイルの行番号とテキスト行の間の区切りに
.I string
を用いる (デフォルトはタブ文字)。
.TP
.I "\-w, \-\-number-width=number"
行番号表示に用いる文字数を \fInumber\fP にする (デフォルトは 6)
.TP
.I "\-n, \-\-number-format={ln,rn,rz}"
行番号の出力フォーマットを指定する:
.RS
.IP ln
左詰めにし、先頭の 0 埋めをしない。
.IP rn
右詰めにし、先頭の 0 埋めをしない (デフォルト)。
.IP rz
右詰めにし、先頭は 0 で埋める。
.RE
.TP
.I "\-d, \-\-section-delimiter=cc"
論理ページの先頭を示すデリミタの二つの文字列を指定する。ひとつしか与え
られなかった場合は二つ目の文字は ':' となる。 '\e' を指定する場合には、 '\e\e' を用いること。
.TP
.I "\-\-help"
使い方に関するメッセージを標準出力に表示し、実行成功を返して終了する。
.TP
.I "\-\-version"
バージョン情報を標準出力に表示して終了する。