Next: , Previous: Fringe Size/Pos, Up: Fringes


38.13.2 Fringe Indicators

The fringe indicators are tiny icons Emacs displays in the window fringe (on a graphic display) to indicate truncated or continued lines, buffer boundaries, overlay arrow, etc.

— User Option: indicate-empty-lines

When this is non-nil, Emacs displays a special glyph in the fringe of each empty line at the end of the buffer, on graphical displays. See Fringes. This variable is automatically buffer-local in every buffer.

— Variable: indicate-buffer-boundaries

This buffer-local variable controls how the buffer boundaries and window scrolling are indicated in the window fringes.

Emacs can indicate the buffer boundaries—that is, the first and last line in the buffer—with angle icons when they appear on the screen. In addition, Emacs can display an up-arrow in the fringe to show that there is text above the screen, and a down-arrow to show there is text below the screen.

There are four kinds of basic values:

nil
Don't display the icons.
left
Display them in the left fringe.
right
Display them in the right fringe.
anything-else
Display the icon at the top of the window top in the left fringe, and other in the right fringe.

If value is a cons (angles . arrows), angles controls the angle icons, and arrows controls the arrows. Both angles and arrows work according to the table above. Thus, (t . right) places the top angle icon in the left fringe, the bottom angle icon in the right fringe, and both arrows in the right fringe.

— Variable: default-indicate-buffer-boundaries

The value of this variable is the default value for indicate-buffer-boundaries in buffers that do not override it.

— Variable: fringe-indicator-alist

This buffer-local variable specifies the mapping from logical fringe indicators to the actual bitmaps displayed in the window fringes.

These symbols identify the logical fringe indicators:

Truncation and continuation line indicators:
truncation, continuation.
Buffer position indicators:
up, down, top, bottom, top-bottom.
Empty line indicator:
empty-line.
Overlay arrow indicator:
overlay-arrow.
Unknown bitmap indicator:
unknown.

The value is an alist where each element (indicator . bitmaps) specifies the fringe bitmaps used to display a specific logical fringe indicator.

Here, indicator specifies the logical indicator type, and bitmaps is list of symbols (left right [left1 right1]) which specifies the actual bitmap shown in the left or right fringe for the logical indicator.

The left and right symbols specify the bitmaps shown in the left and/or right fringe for the specific indicator. The left1 or right1 bitmaps are used only for the `bottom' and `top-bottom indicators when the last (only) line in has no final newline. Alternatively, bitmaps may be a single symbol which is used in both left and right fringes.

When fringe-indicator-alist has a buffer-local value, and there is no bitmap defined for a logical indicator, or the bitmap is t, the corresponding value from the (non-local) default-fringe-indicator-alist is used.

To completely hide a specific indicator, set the bitmap to nil.

— Variable: default-fringe-indicator-alist

The value of this variable is the default value for fringe-indicator-alist in buffers that do not override it.

Standard fringe bitmaps for indicators:

     left-arrow right-arrow up-arrow down-arrow
     left-curly-arrow right-curly-arrow
     left-triangle right-triangle
     top-left-angle top-right-angle
     bottom-left-angle bottom-right-angle
     left-bracket right-bracket
     filled-rectangle hollow-rectangle
     filled-square hollow-square
     vertical-bar horizontal-bar
     empty-line question-mark

Xah Signet