From 10585c4f30abba0b63f9b8eb4971e814ce910140 Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Tue, 23 Aug 2022 18:16:01 +0200 Subject: [PATCH] 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 b2f43ad0511..847f5a35f9a 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 a5b5e9053d9..44ee9b8fc73 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'. -- 2.39.5