1 .\"O .TH M4 "1" "May 2021" "GNU M4 1.4.19" "User Commands"
2 .TH M4 1 2021/05 "GNU M4 1.4.19" ユーザーコマンド
3 .\"O ----------------------------------------
5 .\"O m4 \- macro processor
8 .\"O ----------------------------------------
11 .\"O [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
13 \fBm4\fP [\fI\,OPTION\/\fP]... [\fI\,FILE\/\fP]...
14 .\"O ----------------------------------------
16 .\"O Process macros in FILEs. If no FILE or if FILE is `\-', standard input
19 FILE 内のマクロを処理します。 FILE の指定がない、 あるいは `\-' が指定された場合、 標準入力から読み込みます。
20 .\"O ----------------------------------------
22 .\"O Mandatory or optional arguments to long options are mandatory or optional
23 .\"O for short options too.
25 ロングオプション形式の必須または任意引数は、 ショートオプション形式でも必須または任意引数になります。
26 .\"O ----------------------------------------
27 .\"O .SS "Operation modes:"
29 .\"O ----------------------------------------
32 .\"O display this help and exit
36 .\"O ----------------------------------------
38 .\"O \fB\-\-version\fR
39 .\"O output version information and exit
43 .\"O ----------------------------------------
45 .\"O \fB\-E\fR, \fB\-\-fatal\-warnings\fR
46 .\"O once: warnings become errors, twice: stop
47 .\"O execution at first error
49 \fB\-E\fP, \fB\-\-fatal\-warnings\fP
50 1 度目: 警告をエラーとします、 2 度目: 1 度目のエラー箇所で実行を停止します。
51 .\"O ----------------------------------------
53 .\"O \fB\-i\fR, \fB\-\-interactive\fR
54 .\"O unbuffer output, ignore interrupts
56 \fB\-i\fP, \fB\-\-interactive\fP
58 .\"O ----------------------------------------
60 .\"O \fB\-P\fR, \fB\-\-prefix\-builtins\fR
61 .\"O force a `m4_' prefix to all builtins
63 \fB\-P\fP, \fB\-\-prefix\-builtins\fP
64 ビルトイン名の先頭に強制的に `m4_' をつけます。
65 .\"O ----------------------------------------
67 .\"O \fB\-Q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
68 .\"O suppress some warnings for builtins
70 \fB\-Q\fP, \fB\-\-quiet\fP, \fB\-\-silent\fP
71 ビルトインに対する警告メッセージをいくつか省略します。
72 .\"O ----------------------------------------
74 .\"O \fB\-\-warn\-macro\-sequence\fR[=\fI\,REGEXP\/\fR]
75 .\"O warn if macro definition matches REGEXP,
77 \fB\-\-warn\-macro\-sequence\fP[=\fI\,REGEXP\/\fP]
78 マクロ定義が REGEXP にタッチした場合に警告します。
79 .\"O ----------------------------------------
81 .\"O default \e$\e({[^}]*}\e|[0\-9][0\-9]+\e)
83 デフォルトは \e$\e({[^}]*}\e|[0\-9][0\-9]+\e) です。
84 .\"O ----------------------------------------
86 .\"O \fB\-W\fR, \fB\-\-word\-regexp\fR=\fI\,REGEXP\/\fR
87 .\"O use REGEXP for macro name syntax
89 \fB\-W\fP, \fB\-\-word\-regexp\fP=\fI\,REGEXP\/\fP
90 マクロ名の文法に REGEXP を用います。
91 .\"O ----------------------------------------
92 .\"O .SS "Preprocessor features:"
94 .\"O ----------------------------------------
96 .\"O \fB\-D\fR, \fB\-\-define=NAME\fR[=\fI\,VALUE\/\fR]
97 .\"O define NAME as having VALUE, or empty
99 \fB\-D\fP, \fB\-\-define=NAME\fP[=\fI\,VALUE\/\fP]
100 VALUE という値または空の値を持つ NAME を定義します。
101 .\"O ----------------------------------------
103 .\"O \fB\-I\fR, \fB\-\-include\fR=\fI\,DIRECTORY\/\fR
104 .\"O append DIRECTORY to include path
106 \fB\-I\fP, \fB\-\-include\fP=\fI\,DIRECTORY\/\fP
107 インクルードパスに DIRECTORY を追加します。
108 .\"O ----------------------------------------
110 .\"O \fB\-s\fR, \fB\-\-synclines\fR
111 .\"O generate `#line NUM "FILE"' lines
113 \fB\-s\fP, \fB\-\-synclines\fP
114 `#line NUM "FILE"' 行を生成します。
115 .\"O ----------------------------------------
117 .\"O \fB\-U\fR, \fB\-\-undefine\fR=\fI\,NAME\/\fR
120 \fB\-U\fP, \fB\-\-undefine\fP=\fI\,NAME\/\fP
122 .\"O ----------------------------------------
123 .\"O .SS "Limits control:"
125 .\"O ----------------------------------------
127 .\"O \fB\-g\fR, \fB\-\-gnu\fR
128 .\"O override \fB\-G\fR to re\-enable GNU extensions
130 \fB\-g\fP, \fB\-\-gnu\fP
131 \fB\-G\fP を上書きして GNU 拡張を再度有効にします。
132 .\"O ----------------------------------------
134 .\"O \fB\-G\fR, \fB\-\-traditional\fR
135 .\"O suppress all GNU extensions
137 \fB\-G\fP, \fB\-\-traditional\fP
139 .\"O ----------------------------------------
141 .\"O \fB\-H\fR, \fB\-\-hashsize\fR=\fI\,PRIME\/\fR
142 .\"O set symbol lookup hash table size [509]
144 \fB\-H\fP, \fB\-\-hashsize\fP=\fI\,PRIME\/\fP
145 シンボルの検索ハッシュテーブルのサイズを設定します。 [デフォルト: 509]
146 .\"O ----------------------------------------
148 .\"O \fB\-L\fR, \fB\-\-nesting\-limit\fR=\fI\,NUMBER\/\fR
149 .\"O change nesting limit, 0 for unlimited [0]
151 \fB\-L\fP, \fB\-\-nesting\-limit\fP=\fI\,NUMBER\/\fP
152 ネスト階層の制限を変更します。 0 を指定すると無制限です。[デフォルト: 0]
153 .\"O ----------------------------------------
154 .\"O .SS "Frozen state files:"
155 .SS "凍結 (frozen) 状態のファイル:"
156 .\"O ----------------------------------------
158 .\"O \fB\-F\fR, \fB\-\-freeze\-state\fR=\fI\,FILE\/\fR
159 .\"O produce a frozen state on FILE at end
161 \fB\-F\fP, \fB\-\-freeze\-state\fP=\fI\,FILE\/\fP
162 処理の最後に FILE を凍結状態にします。
163 .\"O ----------------------------------------
165 .\"O \fB\-R\fR, \fB\-\-reload\-state\fR=\fI\,FILE\/\fR
166 .\"O reload a frozen state from FILE at start
168 \fB\-R\fP, \fB\-\-reload\-state\fP=\fI\,FILE\/\fP
169 処理の最初に FILE の凍結状態から再ロードします。
170 .\"O ----------------------------------------
171 .\"O .SS "Debugging:"
173 .\"O ----------------------------------------
175 .\"O \fB\-d\fR, \fB\-\-debug\fR[=\fI\,FLAGS\/\fR]
176 .\"O set debug level (no FLAGS implies `aeq')
178 \fB\-d\fP, \fB\-\-debug\fP[=\fI\,FLAGS\/\fP]
179 デバッグレベルを設定します (FLAGS には `aeq' を含みません)。
180 .\"O ----------------------------------------
182 .\"O \fB\-\-debugfile\fR[=\fI\,FILE\/\fR]
183 .\"O redirect debug and trace output to FILE
184 .\"O (default stderr, discard if empty string)
186 \fB\-\-debugfile\fP[=\fI\,FILE\/\fP]
187 デバッグおよびトレース出力を FILE にリダイレクトします (デフォルトは stderr、 空文字の場合は無視されます)。
188 .\"O ----------------------------------------
190 .\"O \fB\-l\fR, \fB\-\-arglength\fR=\fI\,NUM\/\fR
191 .\"O restrict macro tracing size
193 \fB\-l\fP, \fB\-\-arglength\fP=\fI\,NUM\/\fP
195 .\"O ----------------------------------------
197 .\"O \fB\-t\fR, \fB\-\-trace\fR=\fI\,NAME\/\fR
198 .\"O trace NAME when it is defined
200 \fB\-t\fP, \fB\-\-trace\fP=\fI\,NAME\/\fP
201 NAME が定義されているものとして、 これをトレースします。
202 .\"O ----------------------------------------
203 .\"O .SS "FLAGS is any of:"
204 .SS "FLAGS は以下のいずれか:"
205 .\"O ----------------------------------------
208 .\"O show actual arguments
212 .\"O ----------------------------------------
215 .\"O show before collect, after collect and after call
219 .\"O ----------------------------------------
226 .\"O ----------------------------------------
229 .\"O say current input file name
233 .\"O ----------------------------------------
236 .\"O show changes in input files
240 .\"O ----------------------------------------
243 .\"O say current input line number
247 .\"O ----------------------------------------
250 .\"O show results of path searches
254 .\"O ----------------------------------------
257 .\"O quote values as necessary, with a or e flag
260 a または e フラグを用いる場合に、 必要に応じて値をクォートで囲みます。
261 .\"O ----------------------------------------
264 .\"O trace for all macro calls, not only traceon'ed
267 トレースがオンの時だけでなく、 マクロ呼び出しをすべてトレースします。
268 .\"O ----------------------------------------
271 .\"O add a unique macro call id, useful with c flag
274 マクロ呼び出しの ID を追加します。 c フラグとともに用いると便利です。
275 .\"O ----------------------------------------
278 .\"O shorthand for all of the above flags
282 .\"O ----------------------------------------
284 .\"O If defined, the environment variable `M4PATH' is a colon\-separated list
285 .\"O of directories included after any specified by `\-I'.
287 環境変数 `M4PATH' はディレクトリを、 コロンで区切ったリストを指定しますが、 これが定義されている場合、 `\-I'
289 .\"O ----------------------------------------
291 .\"O Exit status is 0 for success, 1 for failure, 63 for frozen file version
292 .\"O mismatch, or whatever value was passed to the m4exit macro.
294 終了ステータスは成功時が 0、 失敗時が 1、 凍結ファイルのバージョン不一致時が 63 です。 または m4exit マクロに値が設定されれば、
296 .\"O ----------------------------------------
298 .\"O Written by Rene' Seindal.
301 .\"O ----------------------------------------
302 .\"O .SH "REPORTING BUGS"
303 .\"O Report bugs to: bug\-m4@gnu.org
305 .\"O GNU M4 home page: <https://www.gnu.org/software/m4/>
307 .\"O General help using GNU software: <https://www.gnu.org/gethelp/>
309 バグ報告は bug\-m4@gnu.org までお願いします。
311 GNU M4 home page: <https://www.gnu.org/software/m4/>
313 GNU ソフトウェアの全般的なヘルプ: <https://www.gnu.org/gethelp/>
314 .\"O ----------------------------------------
316 .\"O Copyright \(co 2021 Free Software Foundation, Inc.
317 .\"O License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
319 .\"O This is free software: you are free to change and redistribute it.
320 .\"O There is NO WARRANTY, to the extent permitted by law.
322 Copyright \(co 2021 Free Software Foundation, Inc. License GPLv3+: GNU GPL
323 version 3 or later <https://gnu.org/licenses/gpl.html>.
325 This is free software: you are free to change and redistribute it. There is
326 NO WARRANTY, to the extent permitted by law.
327 .\"O ----------------------------------------
329 .\"O The full documentation for
331 .\"O is maintained as a Texinfo manual. If the
335 .\"O programs are properly installed at your site, the command
337 \fBm4\fP の完全なドキュメントは Texinfo マニュアルとしてメンテナンスされています。 \fBinfo\fP と \fBm4\fP
338 の両プログラムが適切にインストールされていれば、 以下のコマンド
339 .\"O ----------------------------------------
344 .\"O ----------------------------------------
346 .\"O should give you access to the complete manual.
348 を実行して完全なマニュアルを参照できます。
349 .\"O ----------------------------------------