comparison lispref/display.texi @ 58496:c6040c1274b7

(Customizing Bitmaps): Move indicate-buffer-boundaries and default-indicate-buffer-boundaries from here. (Usual Display): To here. (Scroll Bars): Add scroll-bar-mode and scroll-bar-width. (Usual Display): Move tab-width up.
author Richard M. Stallman <rms@gnu.org>
date Thu, 25 Nov 2004 03:12:24 +0000
parents 656195249167
children eb1bd3031b13 f2ebccfa87d4
comparison
equal deleted inserted replaced
58495:a30209899fa0 58496:c6040c1274b7
2815 2815
2816 The face you use here should be derived from @code{fringe}, and should 2816 The face you use here should be derived from @code{fringe}, and should
2817 specify only the foreground color. 2817 specify only the foreground color.
2818 @end defun 2818 @end defun
2819 2819
2820 @defvar indicate-buffer-boundaries
2821 This buffer-local variable controls how the buffer boundaries and
2822 window scrolling are indicated in the window fringes.
2823
2824 Emacs can indicate the buffer boundaries---that is, the first and last
2825 line in the buffer---with angle icons when they appear on the screen.
2826 In addition, Emacs can display an up-arrow in the fringe to show
2827 that there is text above the screen, and a down-arrow to show
2828 there is text below the screen.
2829
2830 There are four kinds of basic values:
2831
2832 @table @asis
2833 @item @code{nil}
2834 Don't display the icons.
2835 @item @code{left}
2836 Display them in the left fringe.
2837 @item @code{right}
2838 Display them in the right fringe.
2839 @item @var{anything-else}
2840 Display the icon at the top of the window top in the left fringe, and other
2841 in the right fringe.
2842 @end table
2843
2844 If value is a cons @code{(@var{angles} . @var{arrows})}, @var{angles}
2845 controls the angle icons, and @var{arrows} controls the arrows. Both
2846 @var{angles} and @var{arrows} work according to the table above.
2847 Thus, @code{(t . right)} places the top angle icon in the left
2848 fringe, the bottom angle icon in the right fringe, and both arrows in
2849 the right fringe.
2850 @end defvar
2851
2852 @defvar default-indicate-buffer-boundaries
2853 The value of this variable is the default value for
2854 @code{indicate-buffer-boundaries} in buffers that do not override it.
2855 @end defvar
2856
2857 @node Scroll Bars 2820 @node Scroll Bars
2858 @section Scroll Bars 2821 @section Scroll Bars
2859 2822
2860 Normally the frame parameter @code{vertical-scroll-bars} controls 2823 Normally the frame parameter @code{vertical-scroll-bars} controls
2861 whether the windows in the frame have vertical scroll bars. A 2824 whether the windows in the frame have vertical scroll bars. A
2900 displayed control the window's vertical scroll bars. The function 2863 displayed control the window's vertical scroll bars. The function
2901 @code{set-window-buffer} examines these variables. If you change them 2864 @code{set-window-buffer} examines these variables. If you change them
2902 in a buffer that is already visible in a window, you can make the 2865 in a buffer that is already visible in a window, you can make the
2903 window take note of the new values by calling @code{set-window-buffer} 2866 window take note of the new values by calling @code{set-window-buffer}
2904 specifying the same buffer that is already displayed. 2867 specifying the same buffer that is already displayed.
2868
2869 @defvar scroll-bar-mode
2870 This variable, always local in all buffers, controls whether and where
2871 to put scroll bars in windows displaying the buffer. The possible values
2872 are @code{nil} for no scroll bar, @code{left} to put a scroll bar on
2873 the left, and @code{right} to put a scroll bar on the right.
2874 @end defvar
2875
2876 @defvar scroll-bar-width
2877 This variable, always local in all buffers, specifies the width of the
2878 buffer's scroll bars, measured in pixels. A value of @code{nil} means
2879 to use the value specified by the frame.
2880 @end defvar
2905 2881
2906 @node Pointer Shape 2882 @node Pointer Shape
2907 @section Pointer Shape 2883 @section Pointer Shape
2908 2884
2909 Normally, the mouse pointer has the @code{text} shape over text and 2885 Normally, the mouse pointer has the @code{text} shape over text and
4384 @defvar default-ctl-arrow 4360 @defvar default-ctl-arrow
4385 The value of this variable is the default value for @code{ctl-arrow} in 4361 The value of this variable is the default value for @code{ctl-arrow} in
4386 buffers that do not override it. @xref{Default Value}. 4362 buffers that do not override it. @xref{Default Value}.
4387 @end defvar 4363 @end defvar
4388 4364
4365 @defopt tab-width
4366 The value of this variable is the spacing between tab stops used for
4367 displaying tab characters in Emacs buffers. The value is in units of
4368 columns, and the default is 8. Note that this feature is completely
4369 independent of the user-settable tab stops used by the command
4370 @code{tab-to-tab-stop}. @xref{Indent Tabs}.
4371 @end defopt
4372
4389 @defopt indicate-empty-lines 4373 @defopt indicate-empty-lines
4390 @tindex indicate-empty-lines 4374 @tindex indicate-empty-lines
4391 @cindex fringes, and empty line indication 4375 @cindex fringes, and empty line indication
4392 When this is non-@code{nil}, Emacs displays a special glyph in the 4376 When this is non-@code{nil}, Emacs displays a special glyph in the
4393 fringe of each empty line at the end of the buffer, on terminals that 4377 fringe of each empty line at the end of the buffer, on terminals that
4394 support it (window systems). @xref{Fringes}. 4378 support it (window systems). @xref{Fringes}.
4395 @end defopt 4379 @end defopt
4396 4380
4397 @defopt tab-width 4381 @defvar indicate-buffer-boundaries
4398 The value of this variable is the spacing between tab stops used for 4382 This buffer-local variable controls how the buffer boundaries and
4399 displaying tab characters in Emacs buffers. The value is in units of 4383 window scrolling are indicated in the window fringes.
4400 columns, and the default is 8. Note that this feature is completely 4384
4401 independent of the user-settable tab stops used by the command 4385 Emacs can indicate the buffer boundaries---that is, the first and last
4402 @code{tab-to-tab-stop}. @xref{Indent Tabs}. 4386 line in the buffer---with angle icons when they appear on the screen.
4403 @end defopt 4387 In addition, Emacs can display an up-arrow in the fringe to show
4388 that there is text above the screen, and a down-arrow to show
4389 there is text below the screen.
4390
4391 There are four kinds of basic values:
4392
4393 @table @asis
4394 @item @code{nil}
4395 Don't display the icons.
4396 @item @code{left}
4397 Display them in the left fringe.
4398 @item @code{right}
4399 Display them in the right fringe.
4400 @item @var{anything-else}
4401 Display the icon at the top of the window top in the left fringe, and other
4402 in the right fringe.
4403 @end table
4404
4405 If value is a cons @code{(@var{angles} . @var{arrows})}, @var{angles}
4406 controls the angle icons, and @var{arrows} controls the arrows. Both
4407 @var{angles} and @var{arrows} work according to the table above.
4408 Thus, @code{(t . right)} places the top angle icon in the left
4409 fringe, the bottom angle icon in the right fringe, and both arrows in
4410 the right fringe.
4411 @end defvar
4412
4413 @defvar default-indicate-buffer-boundaries
4414 The value of this variable is the default value for
4415 @code{indicate-buffer-boundaries} in buffers that do not override it.
4416 @end defvar
4404 4417
4405 @node Display Tables 4418 @node Display Tables
4406 @section Display Tables 4419 @section Display Tables
4407 4420
4408 @cindex display table 4421 @cindex display table