procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update documentation for obsolete generalized variables

Browse source 
* doc/misc/cl.texi (Setf Extensions): Delete obsolete generalized
variables from list.
* etc/NEWS: Fix sorting of obsolete generalized variables.
This commit is contained in:
Stefan Kangas 2022-08-23 18:16:01 +02:00
parent 1c837c42c2
commit 10585c4f30
2 changed files with 13 additions and 34 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
doc/misc/cl.texi
View file

@ -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}])},

10
etc/NEWS
View file

@ -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'.