GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/elisp/Trace-Buffer.html ・ emacs-doc.conao3.com

19.2.12 Trace Buffer

Edebug は実行トレースを記録し、*edebug-trace* という名前のバッファに保存できます。 これは関数呼び出しと戻りのログであり、関数名とその引数および値が表示されます。 トレース記録を有効にするには、edebug-trace に nil 以外の値を設定してください(Edebug オプション を参照)。

トレースバッファを作成することは、トレース実行モードを使用することとは異なります(Edebug 実行モードを参照)。

トレース記録が有効な場合、関数のエントリおよびエグジットのたびにトレースバッファに行が追加されます。関数エントリレコードは ‘::::{’ で始まり、続いて関数名と引数の値が記述されます。関数エグジットレコードは ‘::::}’ で始まり、続いて関数名と関数の結果が記述されます。

エントリ内の「:」の数は、その再帰深度を示します。トレースバッファ内の波括弧を使えば、関数呼び出しの対応する開始位置や終了位置を特定できます。

関数 edebug-print-trace-before と edebug-print-trace-after を再定義することで、関数のエントリおよびエグジット時のトレース記録をカスタマイズできます。

マクロ: edebug-tracing string body…

このマクロは、body フォームの実行前後に関する追加のトレース情報を要求します。引数 string は、‘{’ または ‘}’ の後にトレースバッファに格納するテキストを指定します。すべての引数が評価され、edebug-tracing は body 内の最後のフォームの値を返します。

関数: edebug-trace format-string &rest format-args

この関数は、トレースバッファにテキストを挿入します。(apply 'format format-string format-args) を用いてテキストを算出します。また、エントリを区切るために改行を付加します。

edebug-tracing および edebug-trace は、Edebug がアクティブでない場合でも、呼び出されるたびにトレースバッファに行を挿入します。トレースバッファにテキストを追加すると、そのウィンドウがスクロールして最後に挿入された行が表示されます。