master 10585c4f30: Update documentation for obsolete generalized variables

[Stefan Kangas]

branch: master
commit 10585c4f30abba0b63f9b8eb4971e814ce910140
Author: Stefan Kangas <stefankangas@gmail.com>
Commit: Stefan Kangas <stefankangas@gmail.com>

    Update documentation for obsolete generalized variables
    
    * doc/misc/cl.texi (Setf Extensions): Delete obsolete generalized
    variables from list.
    * etc/NEWS: Fix sorting of obsolete generalized variables.
---
 doc/misc/cl.texi | 37 ++++++++-----------------------------
 etc/NEWS         | 10 +++++-----
 2 files changed, 13 insertions(+), 34 deletions(-)

diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi
index b2f43ad051..847f5a35f9 100644
--- a/doc/misc/cl.texi
+++ b/doc/misc/cl.texi
@@ -923,38 +923,17 @@ of the function must itself be a valid @var{place} form.
 @item
 General Emacs Lisp functions:
 @example
-buffer-file-name                   getenv
-buffer-modified-p                  global-key-binding
-buffer-name                        local-key-binding
-buffer-string                      mark
-buffer-substring                   mark-marker
-current-buffer                     marker-position
-current-case-table                 mouse-position
-current-column                     point
-current-global-map                 point-marker
-current-input-mode                 point-max
-current-local-map                  point-min
-current-window-configuration       read-mouse-position
-default-file-modes                 screen-height
-documentation-property             screen-width
-face-background                    selected-window
-face-font                          selected-screen
-face-foreground                    selected-frame
-face-stipple                       standard-case-table
-face-underline-p                   syntax-table
-file-modes                         visited-file-modtime
-frame-height                       window-height
-frame-parameters                   window-width
-frame-visible-p                    x-get-secondary-selection
-frame-width                        x-get-selection
-get-register
+current-case-table                 file-modes
+face-background                    getenv
+face-font                          frame-parameters
+face-foreground                    frame-width
+face-stipple                       get-register
+face-underline-p                   x-get-selection
 @end example
 
 Most of these have directly corresponding ``set'' functions, like
-@code{use-local-map} for @code{current-local-map}, or @code{goto-char}
-for @code{point}.  A few, like @code{point-min}, expand to longer
-sequences of code when they are used with @code{setf}
-(@code{(narrow-to-region x (point-max))} in this case).
+@code{set-face-foreground} for @code{face-foreground}, or
+@code{set-case-table} for @code{current-case-table}.
 
 @item
 A call of the form @code{(substring @var{subplace} @var{n} [@var{m}])},
diff --git a/etc/NEWS b/etc/NEWS
index a5b5e9053d..44ee9b8fc7 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -2581,7 +2581,7 @@ abbrevlist.el, assoc.el, complete.el, cust-print.el,
 erc-hecomplete.el, mailpost.el, mouse-sel.el, old-emacs-lock.el,
 patcomp.el, pc-mode.el, pc-select.el, s-region.el, and sregex.el.
 
----
++++
 ** Many seldom-used generalized variables have been made obsolete.
 Emacs has a number of rather obscure generalized variables defined,
 that, for instance, allowed you to say things like:
@@ -2594,7 +2594,7 @@ for instance, is the same as saying
    (narrow-to-region 4 (point-max))
 
 The following generalized variables have been made obsolete:
-'buffer-local-value', 'visited-file-name', 'buffer-modified-p',
+'buffer-file-name', 'buffer-local-value', 'buffer-modified-p',
 'buffer-name', 'buffer-string', 'buffer-substring', 'current-buffer',
 'current-column', 'current-global-map', 'current-input-mode',
 'current-local-map', 'current-window-configuration',
@@ -2602,9 +2602,9 @@ The following generalized variables have been made 
obsolete:
 'frame-visible-p', 'global-key-binding', 'local-key-binding', 'mark',
 'mark-marker', 'marker-position', 'mouse-position', 'point',
 'point-marker', 'point-max', 'point-min', 'read-mouse-position',
-'screen-height', 'screen-width', 'selected-window', 'selected-screen',
-'selected-frame', 'standard-case-table', 'syntax-table',
-'visited-file-modtime', 'window-height', 'window-width' and
+'screen-height', 'screen-width', 'selected-frame', 'selected-screen',
+'selected-window', 'standard-case-table', 'syntax-table',
+'visited-file-modtime', 'window-height', 'window-width', and
 'x-get-secondary-selection'.