名前

m4 - マクロプロセッサー

書式

m4 [OPTION]... [FILE]...

説明

FILE 内のマクロを処理します。 FILE の指定がない、あるいは `-' が指定された場合、標準入力から読み込みます。

ロングオプション形式の必須または任意引数は、ショートオプション形式でも必須または任意引数になります。

操作モード:

--help

このヘルプを表示して終了します。

--version

バージョン情報を表示して終了します。

-E, --fatal-warnings

1 度目: 警告をエラーとします、 2 度目: 1 度目のエラー箇所で実行を停止します。

-i, --interactive

出力をバッファーに残さず、中断しません。

-P, --prefix-builtins

ビルトイン名の先頭に強制的に `m4_' をつけます。

-Q, --quiet, --silent

ビルトインに対する警告メッセージをいくつか省略します。

--warn-macro-sequence[=REGEXP]

マクロ定義が REGEXP に一致した場合に警告します。

デフォルトは \$${[^}]*}\|[0-9][0-9]+$ です。

-W, --word-regexp=REGEXP

マクロ名の文法に REGEXP を用います。

プリプロセッサー機能:

-D, --define=NAME[=VALUE]: VALUE という値または空の値を持つ NAME を定義します。
-I, --include=DIRECTORY: インクルードパスに DIRECTORY を追加します。
-s, --synclines: `#line NUM "FILE"' 行を生成します。
-U, --undefine=NAME: NAME を未定義にします。

制限制御:

-g, --gnu: -G を上書きして GNU 拡張を再度有効にします。
-G, --traditional: GNU 拡張をすべて無効にします。
-H, --hashsize=PRIME: シンボルの検索ハッシュテーブルのサイズを設定します。 [デフォルト: 509]
-L, --nesting-limit=NUMBER: ネスト階層の制限を変更します。 0 を指定すると無制限です。[デフォルト: 0]

凍結 (frozen) 状態のファイル:

-F, --freeze-state=FILE: 処理の最後に FILE を凍結状態にします。
-R, --reload-state=FILE: 処理の最初に FILE の凍結状態から再ロードします。

デバッグ:

-d, --debug[=FLAGS]: デバッグレベルを設定します (FLAGS には `aeq' を含みません)。
--debugfile[=FILE]: デバッグおよびトレース出力を FILE にリダイレクトします (デフォルトは stderr、空文字の場合は無視されます)。
-l, --arglength=NUM: マクロのトレースサイズを制限します。
-t, --trace=NAME: NAME が定義されているものとして、これをトレースします。

FLAGS は以下のいずれか:

a: 実際の引数を表示します。
c: 情報の収集前後、呼び出し後を表示します。
e: 展開結果を表示します。
f: 現在の入力ファイル名を表示します。
i: 入力ファイルにおける変更を表示します。
l: 現在の入力行番号を表示します。
p: パス検索の結果を表示します。
q: a または e フラグを用いる場合に、必要に応じて値をクォートで囲みます。
t: トレースがオンの時だけでなく、マクロ呼び出しをすべてトレースします。
x: マクロ呼び出しの ID を追加します。 c フラグとともに用いると便利です。
V: 簡潔に上記フラグすべてを含める指定です。

環境変数 `M4PATH' はディレクトリを、コロンで区切ったリストを指定しますが、これが定義されている場合、 `-I' の指定の後ろに追加されます。

終了ステータスは成功時が 0、失敗時が 1、凍結ファイルのバージョン不一致時が 63 です。または m4exit マクロに値が設定されれば、その値になります。

著者

Rene' Seindal

バグ報告

バグ報告は bug-m4@gnu.org までお願いします。
GNU M4 home page: <https://www.gnu.org/software/m4/>
GNU ソフトウェアの全般的なヘルプ: <https://www.gnu.org/gethelp/>

著作権

Copyright © 2021 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

名前

書式

説明