オペレーションモード:¶

-h, --help

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

-V, --version

バージョン番号を表示して終了します。

-v, --verbose

詳細な報告を出力します。

-d, --debug

一時ファイルを削除しません。

-o, --output=FILE

出力結果を FILE に保存します(デフォルトは '-', stdout です)。

-f, --force

キャッシュ値を利用しません。

-W, --warnings=CATEGORY

警告をカテゴリー別に表示します。

-l, --language=LANG

利用する M4 マクロのセットを指定します。

-C, --cache=DIRECTORY

その後の実行に備えて DIRECTORY 内に処理結果を保存します。

--no-cache

キャッシュを無効にします。

-m, --mode=OCTAL

トレース出力を行わないファイル出力モード(0666)を変更します。

-M, --melt

M4 の凍結(frozen)されたファイルを利用しません。

言語は以下を対象とします:¶

'Autoconf'

Autoconf の configure スクリプトを生成します。

'Autotest'

Autotest のテストスイートを生成します。

'M4sh'

M4sh シェルスクリプトを生成します。

'M4sugar'

M4sugar 出力を生成します。

警告カテゴリーは以下のとおりです:¶

cross

クロスコンパイルに関する問題。

gnu

GNU コーディング標準(デフォルトは gnu および gnits モード)。

obsolete

古い機能や構成(デフォルト)。

override

Automake ルールや変数に対するユーザーの再定義。

portability

移植性に関する問題(デフォルトは gnu および gnits モード)。

portability-recursive

ネスト化した Make 変数(デフォルトは -Wportability)。

extra-portability

不十分なツールに関連した移植性に関する問題。

syntax

疑わしい構文構造(デフォルト)。

unsupported

非対応または不完全な機能(デフォルト)。

all

警告メッセージすべて。

no-CATEGORY

カテゴリー別の警告表示を行いません。

none

警告メッセージをすべて表示しません。

error

警告をエラーとして扱います。

環境変数 'M4' と 'WARNINGS' は優先処理されます。

ライブラリディレクトリ:¶

-B, --prepend-include=DIR

検索パスを DIR とします。

-I, --include=DIR

検索パスに DIR を追加します。

トレース:¶

-t, --trace=MACRO[:FORMAT]

MACRO の呼び出しを報告します。

-p, --preselect=MACRO

その後の処理のために MACRO をトレースする準備をします。

凍結処理(freezing):¶

-F, --freeze

FILES に対して M4 の凍結(frozen)された状態を作り出します。

FORMAT のデフォルトは '$f:$l:$n:$%' です。以下のエスケープが利用できます。¶

$$

リテラルの $

$f

マクロが呼び出されたファイル

$l

マクロが呼び出された行

$d

マクロ呼び出しのネストの深さ

$n

マクロ名

$NUM

NUM 番目の引数をクォートで囲み、改行つき

$SEP@

全引数を改行つき、クォートで囲み、SEP で区切る

$SEP*

全引数を改行つき、クォートなし、SEP で区切る

$SEP%

全引数を改行なし、クォートなし、SEP で区切る

SEP は、デフォルト値(@ や * においてはカンマ、% においてはコロン)とする場合は空文字、特定の 1 文字とする場合はその文字、文字列とする場合には {STRING} とすることができます。