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> ¤¬ºîÀ®¤·¤Þ¤·¤¿¡£