manual/gnumaniak/draft/man1/nl.1

   1 .\" You may copy, distribute and modify under the terms of the LDP General
   2 .\" Public License as specified in the LICENSE file that comes with the
   3 .\" gnumaniak distribution
   4 .\"
   5 .\" The author kindly requests that no comments regarding the "better"
   6 .\" suitability or up-to-date notices of any info documentation alternative
   7 .\" is added without contacting him first.
   8 .\"
   9 .\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  10 .\"
  11 .\"     GNU nl man page
  12 .\"     man pages are NOT obsolete!
  13 .\"     <ragnar@ragnar-hojland.com>
  14 .\"
  15 .\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
  16 .\" Translated Sun 12 Mar 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  17 .\"
  18 .TH NL 1 "7 October 2002" "GNU textutils 2.1"
  19 .\"O .SH NAME
  20 .\"O \fBnl\fR \- number lines and write files
  21 .SH 名前
  22 nl \- 行番号を付けてファイルを出力する
  23 .\"O .SH SYNOPSIS
  24 .SH 書式
  25 .B nl
  26 .RB [ \-p "] [" "\-b \fISTYLE\fR" "] [" "\-d \fICD\fR" ]
  27 .RB [ "\-f \fISTYLE\fR" "] [" "\-h \fISTYLE\fR" "] [" "\-i \fINUMBER\fR" ]
  28 .RB [ "\-l \fINUMBER\fR" "] [" "\-n \fIFORMAT\fR" "] [" "\-s \fISTRING\fR" ]
  29 .RB [ "\-v \fINUMBER\fR" "] [" "\-w \fINUMBER\fR" ]
  30 .RB [ "\-\-body\-numbering=\fISTYLE\fR" ]
  31 .RB [ "\-\-footer\-numbering=\fISTYLE\fR" ]
  32 .RB [ "\-\-header\-numbering=\fISTYLE\fR" ]
  33 .RB [ "\-\-join\-blank\-lines=\fINUMBER\fR" ]
  34 .RB [ "\-\-page\-increment=\fINUMBER\fR" ]
  35 .RB [ \-\-no\-renumber ]
  36 .RB [ "\-\-number\-format=\fIFORMAT\fR" ]
  37 .RB [ "\-\-number\-separator=\fIFORMAT\fR" ]
  38 .RB [ "\-\-number\-width=\fINUMBER\fR" ]
  39 .RB [ "\-\-section\-delimiter=\fICD\fR" ]
  40 .RB [ "\-\-starting\-line\-number=\fINUMBER\fR" ]
  41 .RI [ FILE... ]
  42
  43 .BR nl " [" \-\-help "] [" \-\-version ]
  44 .\"O .SH DESCRIPTION
  45 .SH 説明
  46 .\"O .B nl
  47 .\"O writes each
  48 .\"O .I FILE
  49 .\"O to standard output, with line numbers added to some or all of the lines.  If
  50 .\"O .I FILE
  51 .\"O is omitted or if is a
  52 .\"O .RB ` \- ',
  53 .\"O standard input is used.
  54 .B nl
  55 は指定された
  56 .I FILE
  57 それぞれを標準出力に書く。
  58 その際行番号を一部または全部の行に追加する。
  59 .I FILE
  60 が一つも与えられないと標準入力から読み込む。また
  61 .I FILE
  62 が
  63 .RB ` \- '
  64 だった場合には、そのファイルには標準入力が用いられる。
  65
  66 .\"O .B nl
  67 .\"O decomposes its input into (logical) pages; by default, the line
  68 .\"O number is reset to 1 at the top of each logical page.
  69 .\"O .B nl
  70 .\"O treats all of the input files as a single document; it does not reset line
  71 .\"O numbers or logical pages between files.
  72 .B nl
  73 は入力を論理ページ (logical page) に分解する。デフォルトでは、
  74 行番号は各々の論理ページの先頭で 1 にリセットされる。
  75 .B nl
  76 は入力されたファイルすべてをまとめてひとつの文書とみなす。
  77 したがってファイルの切れ目でも行番号や論理ページはリセットされない。
  78 .\"O .SH OPTIONS
  79 .SH オプション
  80 .TP
  81 .B \-b \fISTYLE\fB, \-\-body\-numbering=\fISTYLE
  82 .\"O Select the numbering style for lines in the body section of each
  83 .\"O logical page.  When a line is not numbered, the current line number
  84 .\"O is not incremented, but the line number separator character is
  85 .\"O still prepended to the line.  The styles are:
  86 各論理ページの本文セクションにおける行の番号付けの方式を選択する。
  87 行に番号がつかないと、カレントの行番号は増加しないが、
  88 行番号の区切る文字は行の前に置かれる。形式は以下の通り。
  89 .RS
  90 .TP
  91 .B a
  92 .\"O number all lines
  93 全ての行に番号をふる。
  94 .TP
  95 .B t
  96 .\"O number only nonempty lines (default for body)
  97 空行でない行のみに番号をふる (本文セクションのデフォルト)
  98 .TP
  99 .B n
 100 .\"O do not number lines (default for header and footer)
 101 行番号をふらない (ヘッダ・フッタセクションのデフォルト)
 102 .TP
 103 .BI p REGEXP
 104 .\"O number only lines that contain a match for
 105 .\"O .IR REGEXP .
 106 .I REGEXP
 107 にマッチした行だけに番号をふる。
 108 .RE
 109 .TP
 110 .B \-d \fICD\fB, \-\-section\-delimiter=\fICD
 111 .\"O Set the section delimiter characters to \fICD\fR; default is `\e:'. If
 112 .\"O only \fIC\fR is given, the second remains `:'.  (Remember to protect `\e'
 113 .\"O or other metacharacters from shell expansion with quotes or extra
 114 .\"O backslashes)
 115 セクション区切りとなる二文字を
 116 .I CD
 117 にする (デフォルトは `e:')。
 118 .I C
 119 だけが与えられた場合は、2 文字めは `:' のままとなる。
 120 ('\e' 等のメタキャラクタを指定する場合には、シェルの展開から守るために
 121 クォートするか、バックスラッシュを一つ余計に付けるのを忘れないように。)
 122 .TP
 123 .B \-f \fISTYLE\fB, \-\-footer\-numbering=\fISTYLE
 124 .\"O Analogous to
 125 .\"O .BR \-\-body\-numbering .
 126 .B \-\-body\-numbering
 127 を見よ。
 128 .TP
 129 .B \-h \fISTYLE\fB, \-\-header\-numbering=\fISTYLE
 130 .\"O Analogous to
 131 .\"O .BR \-\-body\-numbering .
 132 .B \-\-body\-numbering
 133 を見よ。
 134 .TP
 135 .B \-i \fINUMBER\fB, \-\-page\-increment=\fINUMBER
 136 .\"O Increment line numbers by
 137 .\"O .I NUMBER
 138 .\"O (default 1).
 139 行番号の増分を
 140 .I NUMBER
 141 にする (デフォルトは 1)。
 142 .TP
 143 .B \-l \fINUMBER\fB, \-\-join\-blank\-lines=\fINUMBER
 144 .\"O Consider
 145 .\"O .I NUMBER
 146 .\"O (default 1) consecutive empty lines to be one logical line for numbering,
 147 .\"O and only number the last one.  Where fewer than
 148 .\"O .I NUMBER
 149 .\"O consecutive empty lines occur, do not number them.  An empty line is one
 150 .\"O that contains no characters, not even spaces or tabs.
 151 .I NUMBER
 152 だけ連続した空行を、
 153 番号付けの際に 1 論理行とみなし、最後の空行にのみ番号を付ける
 154 .RI ( NUMBER
 155 のデフォルトは 1)。
 156 空行の連続が
 157 .I number
 158 以下の場合には、番号付けを行わない。
 159 空行とはスペースやタブも含め、文字を全く含まない行のこと。
 160 .TP
 161 .B \-n \fIFORMAT\fB, \-\-number\-format=\fIFORMAT
 162 .\"O Select the line numbering format (default is `\fBrn\fR'):
 163 行番号の出力フォーマットを指定する (デフォルトは `\fBrn\fR'):
 164 .RS
 165 .TP
 166 .B ln
 167 .\"O left justified, no leading zeros
 168 左詰めにし、先頭の 0 埋めをしない。
 169 .TP
 170 .B rn
 171 .\"O right justified, no leading zeros
 172 右詰めにし、先頭の 0 埋めをしない。
 173 .TP
 174 .B rz
 175 .\"O right justified, leading zeros
 176 右詰めにし、先頭は 0 で埋める。
 177 .RE
 178 .TP
 179 .B \-p, \-\-no\-renumber
 180 .\"O Do not reset the line number at the start of a logical page.
 181 論理ページの先頭で行番号をリセットしない。
 182 .TP
 183 .B \-s \fISTRING\fB, \-\-number\-separator=\fIFORMAT
 184 .\"O Separate the line number from the text line in the output with
 185 .\"O .I STRING
 186 .\"O (default is <TAB>).
 187 出力ファイルの行番号とテキスト行の間の区切りに
 188 .I STRING
 189 を用いる (デフォルトは <TAB>)。
 190 .TP
 191 .B \-v \fINUMBER\fB, \-\-starting\-line\-number=\fINUMBER
 192 .\"O Set the initial line number on each logical page to
 193 .\"O .I NUMBER
 194 .\"O (default 1).
 195 それぞれの論理ページの行番号を
 196 .I NUMBER
 197 から始める (デフォルトは 1)。
 198 .TP
 199 .B \-w \fINUMBER\fB, \-\-number\-width=\fINUMBER
 200 .\"O Use
 201 .\"O .I NUMBER
 202 .\"O characters for line numbers (default 6).
 203 行番号表示に用いる文字数を
 204 .I NUMBER
 205 にする (デフォルトは 6)。
 206 .TP
 207 .B "\-\-help"
 208 .\"O Print a usage message on standard output and exit successfully.
 209 標準出力に使用方法のメッセージを出力して正常終了する。
 210 .TP
 211 .B "\-\-version"
 212 .\"O Print version information on standard output then exit successfully.
 213 標準出力にバージョン情報を出力して正常終了する。
 214 .\"O .SH LOGICAL PAGES
 215 .SH 論理ページ
 216 .\"O A logical page consists of three sections: header, body, and footer.
 217 .\"O Any of the sections can be empty.  Each can be numbered in a different
 218 .\"O style from the others.
 219 論理ページは三つのセクションからなる。
 220 ヘッダ (header)、本文 (body)、フッタ (footer) である。
 221 セクションは空であってもよい。
 222 また、それぞれを別な形式で番号付けすることもできる。
 223
 224 .\"O The beginnings of the sections of logical pages are indicated in the
 225 .\"O input file by a line containing exactly one of these delimiter strings:
 226 入力ファイル中に以下のデリミタ文字列 (delimiter string)
 227 だけからなる行があると、論理ページのセクションの始まりとみなされる。
 228 .TP
 229 .B \e:\e:\e:
 230 .\"O start of header
 231 ヘッダの先頭
 232 .TP
 233 .B \e:\e:
 234 .\"O start of body;
 235 本文の先頭
 236 .TP
 237 .B \e:
 238 .\"O start of footer.
 239 フッタの先頭
 240 .PP
 241 .\"O The two characters from which these strings are made can be changed
 242 .\"O from
 243 .\"O .RB ` \e "' and `" : '
 244 .\"O via options, but the pattern and length of each string cannot be
 245 .\"O changed.  A section delimiter is replaced by an empty line on output.  Any
 246 .\"O text that comes before the first section delimiter string in the input file
 247 .\"O is considered to be part of a body section, so
 248 .\"O .B nl
 249 .\"O treats a file that contains no section delimiters as a single body section.
 250 これらの文字列を構成する二文字は、オプションによって
 251 .RB ` \e "' と `" : '
 252 以外にも変更できる。しかしパターンとそれぞれの文字列の長さは変更できない。
 253 セクションのデリミタ文字列は出力では空行となる。
 254 入力ファイルのうち、
 255 最初のセクションデリミタ文字列の前に来るテキストは本文セクションとみなされる。
 256 したがって
 257 .B nl
 258 は、セクションのデリミタ文字列を含まないファイルを
 259 単一の本文セクションからなるものとみなす。
 260 .\"O .SH NOTES
 261 .SH 注意
 262 .\"O Report bugs to bug-textutils@gnu.org.
 263 .\"O .br
 264 .\"O Man page by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
 265 プログラムのバグについては bug-textutils@gnu.org に報告してください。
 266 .br
 267 man ページは Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com> が作成しました。