20.6.1 display-bufferが機能する方法

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

• 最初に、他のバッファーを考慮せずに、そのバッファーが選択されたウィンドウに表示されるべきかをチェックします。これを行うようEmacsに指示するには、望むバッファー名をリストsame-window-buffer-namesに加えるか、リストsame-window-regexpsにバッファー名にマッチする正規表現を追加します。デフォルトではこれらの変数はnilなので、このステップはスキップされます。
• 上記以外の場合、バッファーがすでに既存のウィンドウに表示されているときは、そのウィンドウを再利用します。通常は選択されたフレームのウィンドウだけが考慮されますが、変数pop-up-framesをtに変更している場合(以下参照)、他のフレームのウィンドウも再利用可能です、
• 上記以外の場合、オプションで新しいフレームを作成して、バッファーをそこに表示します。デフォルトではこのステップはスキップされます。これを有効にするには変数pop-up-framesを非nil値に変更します。特別な値graphic-onlyは、グラフィカルなディスプレーだけで、これを行うことを意味します。
• 上記以外の場合、選択されたフレームのウィンドウを分割することにより、新しいウィンドウを作成して、バッファーを新しく作成したウィンドウに表示しようと試みます。

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

• 上記以外の場合、そのウィンドウに前に表示されていたバッファーを表示します。通常は選択されたフレームのウィンドウだけが考慮されますが、変数pop-up-framesが非nilの場合、他のフレームのウィンドウかもしれません。
• 上記以外の場合、選択されたフレームの既存のウィンドウのバッファーを表示します。
• 何らかの理由により上記すべてが失敗した場合、新しいフレームを作成して、そこにバッファーを表示します。

display-bufferの振る舞いをカスタマイズするための、より上級かつ柔軟な方法は、次のセクションで言及されているオプションdisplay-buffer-alistを使用する方法です。