22.2.4 コマンドにたいするモード指定

Emacsのコマンドの多くは汎用であり、特定のモードに関連付けられていません。たとえばM-x kill-regionは編集可能テキストをもつほとんどのモード、(M-x list-buffersのような)情報表示コマンドはほとんどのコンテキストで使用できます。

しかしそれ以外の多くのコマンドはモードに具体的に関連付けられており、そのコンテキスト外部では意味をなしません。たとえばDiredバッファーの外部でM-x dired-diffを使用すると、単にエラーをシグナルするでしょう。

したがってEmacsにはコマンドが“所属する”モードが何かを指定するためのメカニズムがあります:

(defun dired-diff (...)
  ...
  (interactive "p" dired-mode)
  ...)

これはそのコマンドをdired-mode (やdired-modeから派生したモード)だけに適用されるようにマークします。interactiveフォームには任意個数のモードを追加できます。

モードの指定は、M-S-x (execute-extended-command-for-buffer)でのコマンド補完に影響を与えます(インタラクティブな呼び出しを参照)。read-extended-command-predicateの値に応じて、モード指定がM-xでの補完にも影響を与えるかもしれません。

たとえばread-extended-command-predicateの値としてcommand-completion-default-include-p述語を使用する際には、特定モードに適用されるとマークされたコマンドはM-xでリストされないでしょう(もちろんそのモードを使用するバッファーにいない場合)。これはメジャーモードとマイナーモードの両方に言えることです(対照的にM-S-xは適用されないコマンドを補完候補から常に省略する)。

read-extended-command-predicateはデフォルトではnilであり、M-xでの補完ではカレントバッファーのモードに適用されるとマークされているか否かに関わらず、ユーザーがタイプしたものにマッチするすべてのコマンドがリストされます。

あるモードにたいして適用されるものとしてコマンドをマークすると、(何らかのキーにバインドされていなければ)それらはC-h mでもリストされるようになります。

(拡張interactiveフォームをサポートしない古いバージョンのEmacsでは動作すると思われるコードがある等で)この拡張interactiveフォームの使用が不便なら、かわりに等価な以下の宣言(declareフォームを参照)を使用できます:

(declare (modes dired-mode))

コマンドのモードへのタグ付けはある意味好みの問題ですが、そのモードの外部では動作しないことが明確なコマンドはタグ付けするべきです。これにはどこか別の場所で呼び出すとエラーをシグナルするだけではなく、期待しないモードからの呼び出しが破壊的なコマンドも含まれます(これは通常はスペシャルモード、すなわち編集不可なモード用に記述されたコマンドのほとんどが含まれる)。

別モードから呼び出した際にも害がなく、“機能する”コマンドもありますが、それでも別の場所使用することが実際に無意味なコマンドには、依然としてタグ付けする必要があります。たとえば多くのスペシャルモードはバッファーのexitコマンドにqをバインドしており、これは"Goodbye from this mode"のようなメッセージを発行してkill-bufferを呼び出す以外は何も行わないかもしれません。このコマンドは別のモードでも“機能する”でしょうが、そのスペシャルモードのコンテキスト外部でこのコマンドを実際に使いたいと思う人が居るようには思えません。

多くのモードには、そのモードを異なる方法で開始するために、一連の異なるコマンドがあります (例: eww-open-in-new-bufferとeww-open-file)。このようなコマンドはユーザーがさまざまなコンテキストから発行し得るので、モード固有とタグ付けするべきでは決してありません。

Emacs 28.1でネイティブコンパイルされた関数では、コマンドへのモードの指定はサポートされていないことに注意してください(以降のバージョンのEmacsでは訂正済み)。これはread-extended-command-predicateがネイティブコンパイルのサポートつきのビルドでもサポートされていないことを意味しています。