From: Kim F. Storm <storm@cua.dk>
Date: Sun, 15 Feb 2004 18:15:38 +0000 (+0000)
Subject: Describe new fringe bitmap features.
X-Git-Tag: ttn-vms-21-2-B4~7619
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b2b681f163507d674868eab3ad1b2a4dccdf9c95;p=emacs.git

Describe new fringe bitmap features.
---

diff --git a/etc/NEWS b/etc/NEWS
index 3e6c69d8120..2e460f4a8b4 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -97,16 +97,28 @@ cursor will be displayed in the fringe when positioned on that newline.
 The new user option 'overflow-newline-into-fringe' may be set to nil to
 revert to the old behaviour of continuing such lines.
 
-** The buffer boundaries (i.e. first and last line in the buffer) may now
-be marked with bitmaps in the fringes.  In addition, up and down
-arrow bitmaps may be shown at the top and bottom of the right fringe
-if the window can be scrolled in either direction.
+** The buffer boundaries (i.e. first and last line in the buffer) may
+now be marked with angle bitmaps in the fringes.  In addition, up and
+down arrow bitmaps may be shown at the top and bottom of the left or
+right fringe if the window can be scrolled in either direction.
 
 This behavior is activated by setting the buffer-local variable
-`indicate-buffer-boundaries' to a non-nil value.  If value is t, both
-boundaries and scrolling arrows are shown; any other non-nil value
-shows only the buffer boundaries.  The default value of this variable
-is found in `default-indicate-buffer-boundaries'.
+`indicate-buffer-boundaries' to a non-nil value.  The default value of
+this variable is found in `default-indicate-buffer-boundaries'.
+
+If value is `left' or `right', both angle and arrow bitmaps are
+displayed in the left or right fringe, resp.  Any other non-nil value
+causes the bitmap on the top line to be displayed in the left fringe,
+and the bitmap on the bottom line in the right fringe.
+
+If value is a cons (ANGLES . ARROWS), the car specifies the position
+of the angle bitmaps, and the cdr specifies the position of the arrow
+bitmaps.  
+
+For example, (t .  right) places the top angle bitmap in left fringe,
+the bottom angle bitmap in right fringe, and both arrow bitmaps in
+right fringe.  To show just the angle bitmaps in the left fringe, but
+no arrow bitmaps, use (left . nil).  
 
 ** New command `display-local-help' displays any local help at point
 in the echo area.  It is bound to `C-h .'.  It normally displays the
@@ -1802,6 +1814,35 @@ configuration files.
 
 * Lisp Changes in Emacs 21.4
 
+** New function 'define-fringe-bitmap' can now be used to change the
+built-in fringe bitmaps, as well as create new fringe bitmaps.
+The return value is a number identifying the new fringe bitmap.
+
+To change a built-in bitmap, do (require 'fringe) and identify the
+bitmap to change with the value of the corresponding symbol, like
+`left-truncation-fringe-bitmap' or `continued-line-fringe-bitmap'.
+
+** New function 'destroy-fringe-bitmap' may be used to destroy a
+previously created bitmap, or restore a built-in bitmap.
+
+** New function 'set-fringe-bitmap-face' can now be used to set a
+specific face to be used for a specific fringe bitmap.  Normally,
+this should be a face derived from the `fringe' face, specifying
+the foreground color as the desired color of the bitmap.
+
+** There are new display properties, left-fringe and right-fringe,
+that can be used to show a specific bitmap in the left or right fringe
+bitmap of the display line.
+
+Format is 'display '(left-fringe BITMAP [FACE]), where BITMAP is a
+number identifying a fringe bitmap, either built-in or as returned by
+`define-fringe-bitmap', and FACE is an optional face name to be used
+for displaying the bitmap.
+
+** New function `fringe-bitmaps-at-pos' returns a cons (LEFT . RIGHT)
+identifying the current fringe bitmaps in the display line at a given
+buffer position.  A nil value means no bitmap.
+
 +++
 ** New function `line-number-at-pos' returns line number of current
 line in current buffer, or if optional buffer position is given, line