changeset 52478:2a049fb2c8d8

Document char-displayable-p more clearly. Add many +++ markers.

--- a/etc/NEWS	Thu Sep 11 23:52:41 2003 +0000
+++ b/etc/NEWS	Fri Sep 12 00:44:10 2003 +0000
@@ -1676,16 +1676,23 @@
 locally to provide Eldoc functionality by some method appropriate to
 the language.
 
-** `latin1-char-displayable-p' is obsoleted by `char-displayable-p'.
-
 ** New coding system property `mime-text-unsuitable' indicates that
 the coding system's `mime-charset' is not suitable for MIME text
 parts, e.g. utf-16.
 
++++
 ** The argument to forward-word, backward-word, forward-to-indentation
 and backward-to-indentation is now optional, and defaults to 1.
 
 +++
+** (char-displayable-p CHAR) returns non-nil if Emacs ought to be able
+to display CHAR.  More precisely, if the selected frame's fontset has
+a font to display the character set that CHAR belongs to.
+
+Fontsets can specify a font on a per-character basis; when the fontset
+does that, this value may not be accurate.
+
++++
 ** The new function `window-inside-edges' returns the edges of the
 actual text portion of the window, not including the scroll bar or
 divider line, the fringes, the display margins, the header line and
@@ -2025,6 +2032,7 @@
 displaying the buffer in a window, or use `set-window-buffer' to force
 an update of the display margins.
 
++++
 ** Per-window vertical scroll-bar settings
 
 Windows can now have their own individual scroll-bar settings
@@ -2163,6 +2171,7 @@
 keymap alist separate from minor-mode-map-alist by adding their keymap
 alist to this list.
 
++++
 ** Atomic change groups.
 
 To perform some changes in the current buffer "atomically" so that
@@ -2302,6 +2311,7 @@
 insert-for-yank automatically sets that variable according to the UNDO
 element of the string argument's yank-handler text property if present.
 
++++
 ** New function display-supports-face-attributes-p may be used to test
 whether a given set of face attributes is actually displayable.
 
@@ -2309,13 +2319,16 @@
 specification language, which can be used to do this test for faces
 defined with defface.
 
++++
 ** face-attribute, face-foreground, face-background, and face-stipple now
 accept a new optional argument, INHERIT, which controls how face
 inheritance is used when determining the value of a face attribute.
 
++++
 ** New functions face-attribute-relative-p and merge-face-attribute
 help with handling relative face attributes.
 
++++
 ** Enhancements to process support
 
 *** Function list-processes now has an optional argument; if non-nil,
@@ -2337,7 +2350,7 @@
 The new low-level functions process-plist and set-process-plist are
 used to access and replace the entire property list of a process.
 
-
++++
 ** Enhanced networking support.
 
 *** There is a new `make-network-process' function which supports
@@ -2400,14 +2413,19 @@
 connections are accepted in the stopped state.  For a client process,
 no input is received in the stopped state.
 
++++
 ** New function copy-tree.
 
++++
 ** New function substring-no-properties.
 
++++
 ** New function minibuffer-selected-window.
 
++++
 ** New function `call-process-shell-command'.
 
+---
 ** The dummy function keys made by easymenu
 are now always lower case.  If you specify the
 menu item name "Ada", for instance, it uses `ada'
@@ -2422,6 +2440,7 @@
 for a function that could be called with `call-interactively',
 and does not return t for keyboard macros.
 
+---
 ** master-mode.el implements a minor mode for scrolling a slave
 buffer without leaving your current buffer, the master buffer.
 
@@ -2442,6 +2461,7 @@
    (function (lambda ()
 	       (master-set-slave sql-buffer))))
 
++++
 ** File local variables.
 
 A file local variables list cannot specify a string with text