オーバーレイ矢印は、バッファ内の特定の行にユーザーの注意を向けさせる際に便利です。例えば、デバッガとのインターフェースに使用されるモードでは、オーバーレイ矢印は次に実行されるコード行を示します。この機能はオーバーレイとは無関係です（オーバーレイを参照）。
この変数には、特定の行に注意を向けさせるために表示する文字列、あるいは矢印機能が使用されていない場合は nil
が格納されます。グラフィカルディスプレイでは、左フリンジが表示されている場合、文字列の内容は無視され、代わりに表示領域の左側のフリンジ領域にグリフが表示されます。
この変数には、オーバーレイ矢印を表示する位置を示すマーカーが格納されています。これは行の先頭を指す必要があります。非グラフィカルなディスプレイを使用している場合や、左フリンジが表示されていない場合は、矢印のテキストがその行の先頭に表示され、本来表示されるはずのテキストに重ねて表示されます。通常、矢印は短く、行はインデントされて始まるため、一般的に重要な部分が上書きされることはありません。ウィンドウに十分なスペースのある左マージンがある場合、Emacsは代わりにそこに矢印を表示し、テキスト領域は上書きされません。
オーバーレイ矢印文字列は、任意のバッファにおいて、そのバッファ内の overlay-arrow-position
の値が当該バッファを指している場合に表示されます。したがって、overlay-arrow-position
のバッファローカルなバインディングを作成することで、複数のオーバーレイ矢印文字列を表示することが可能です。ただし、通常はこの結果を得るために overlay-arrow-variable-list を使用する方が簡潔です。
before-string プロパティを持つオーバーレイを作成することで、同様の処理が可能です。オーバーレイプロパティを参照してください。
変数 overlay-arrow-variable-list
で複数のオーバーレイ矢印を定義できます。
この変数の値は変数のリストであり、各変数はオーバーレイ矢印の位置を指定しています。変数 overlay-arrow-position はこのリストに含まれているため、通常の意味を持ちます。
このリストの各変数には、対応するオーバーレイ矢印の位置に表示するオーバーレイ矢印文字列（テキスト端末、または左フリンジが表示されないグラフィカル端末の場合）、あるいはフリンジビットマップ（左フリンジがあるグラフィカル端末の場合）を指定するプロパティ
overlay-arrow-string および overlay-arrow-bitmap
を設定できます。いずれかのプロパティが設定されていない場合は、デフォルトの overlay-arrow-string または overlay-arrow フリンジインジケータが使用されます。