20.6.1 display-bufferが機能する方法

display-bufferコマンド(およびこのコマンドを内部的に呼び出すコマンド)は、以下で与えられたステップに従って、表示するウィンドウを選択します。このステップの順番を変更する方法については、Choosing a Window for Displaying a Buffer in The Emacs Lisp Reference Manualを参照してください。

• 他に考慮されるべき点とは無関係に、そのバッファーが選択されたウィンドウ内に表示されるべき場合は、選択されたウィンドウを再利用します。デフォルトではこのステップはスキップされますが、オプションdisplay-buffer-alist (Choosing a Window for Displaying a Buffer in The Emacs Lisp Reference Manualを参照)にバッファー名にマッチする正規表現を追加して、アクション関数display-buffer-same-window (Action Functions for Buffer Display in The Emacs Lisp Reference Manualを参照)でそれを参照することにより、Emacsにスキップしないよう告げることができます。たとえば、選択されたウィンドウ内に優先的にバッファー*scratch*を表示するには、以下のように記述します:

  (customize-set-variable
   'display-buffer-alist
   '(("\\*scratch\\*" (display-buffer-same-window))))
  

  デフォルトでは、display-buffer-alistはnilです。

• 上記以外の場合、バッファーがすでに既存のウィンドウに表示されているときは、そのウィンドウを再利用します。通常は選択されたフレームのウィンドウだけが考慮されますが、対応するアクションalistreusable-framesエントリー(Action Alists for Buffer Display in The Emacs Lisp Reference Manualを参照)を使用している場合は、他のフレームのウィンドウも再利用可能です。これを行う例は、次のステップを参照してください。
• 上記以外の場合、オプションで新しいフレームを作成して、バッファーをそこに表示します。デフォルトではこのステップはスキップされます。これを有効にするには、以下のようにオプションdisplay-buffer-base-action (Choosing a Window for Displaying a Buffer in The Emacs Lisp Reference Manualを参照)の値を変更してください:

  (customize-set-variable
   'display-buffer-base-action
   '((display-buffer-reuse-window display-buffer-pop-up-frame)
     (reusable-frames . 0)))
  

  このカスタマイズでは、すべての可視およびアイコン化されたフレーム上の再利用可能なウィンドウを検索するステップを先行して試みるでしょう。

• 上記以外の場合、選択されたフレームのウィンドウを分割することにより、新しいウィンドウを作成して、バッファーを新しく作成したウィンドウに表示しようと試みます。

  分割は垂直または水平に行われる可能性があり、それは変数split-height-thresholdおよびsplit-width-thresholdに依存します。これらの変数には整数値を指定します。split-height-thresholdが選択されたウィンドウの高さより小さい場合、分割により下が新しいウィンドウになります。上記以外の場合、split-width-thresholdが選択されたウィンドウの幅より小さい場合、分割により右が新しいウィンドウになります。どちらの条件も適用できなかったとき、Emacsは分割により下を新しいウィンドウにしようと試みますが、それは選択されたウィンドウが以前に分割されていなかった場合に限られます(過剰な分割を避けるため)。

• 上記以外の場合、そのウィンドウに前に表示されていたバッファーを表示します。通常は選択されたフレームのウィンドウだけが考慮されますが、適正なアクションalistエントリーreusable-frames (上記参照)により、他のフレームのウィンドウかもしれません。
• 上記以外の場合、選択されたフレームの既存のウィンドウのバッファーを表示します。
• 何らかの理由により上記すべてが失敗した場合、新しいフレームを作成して、そこにバッファーを表示します。