From 0bd46619413e83fe3c85c8a1dfbf5e20dfce8605 Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Sat, 2 Sep 2023 15:37:08 +0200 Subject: [PATCH] Doc fixes for obsolete functions and variables * admin/notes/multi-tty: * doc/emacs/building.texi (Debugger Operation): * doc/misc/efaq-w32.texi (Line ends by file system): * doc/misc/gnus.texi (Hashcash): * lisp/emacs-lisp/eieio.el (eieio-class-parents) (eieio-class-children): * lisp/progmodes/perl-mode.el: * lisp/textmodes/ispell.el (ispell-lookup-words): * src/buffer.h: Update or delete references to variables and functions made obsolete in Emacs 24.4. --- admin/notes/multi-tty | 2 -- doc/emacs/building.texi | 7 ++----- doc/misc/efaq-w32.texi | 12 ++++++------ doc/misc/gnus.texi | 4 ++-- lisp/emacs-lisp/eieio.el | 7 ++----- lisp/progmodes/perl-mode.el | 4 ---- lisp/textmodes/ispell.el | 4 ++-- src/buffer.h | 6 +++--- 8 files changed, 17 insertions(+), 29 deletions(-) diff --git a/admin/notes/multi-tty b/admin/notes/multi-tty index d0b63f166fd..16f2bec4d80 100644 --- a/admin/notes/multi-tty +++ b/admin/notes/multi-tty @@ -480,8 +480,6 @@ THINGS TO DO ** Have a look at set_frame_matrix_frame. -** Check if we got term-setup-hook right. - ** I think tip_frame should be display-local. ** Check display reference count handling in x_create_tip_frame. diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi index f82b605598e..d6610099460 100644 --- a/doc/emacs/building.texi +++ b/doc/emacs/building.texi @@ -701,7 +701,6 @@ to recompile and restart the program. @cindex GUD Tooltip mode @cindex mode, GUD Tooltip @findex gud-tooltip-mode -@vindex gud-tooltip-echo-area GUD Tooltip mode is a global minor mode that adds tooltip support to GUD@. To toggle this mode, type @kbd{M-x gud-tooltip-mode}. It is disabled by default. If enabled, you can move the mouse pointer over a @@ -713,10 +712,8 @@ you can tell Emacs more explicitly what expression to evaluate by dragging the mouse over the expression, then leaving the mouse inside the marked area. The GUD Tooltip mode takes effect in the GUD interaction buffer, and in all source buffers with major modes listed -in the variable @code{gud-tooltip-modes}. If the variable -@code{gud-tooltip-echo-area} is non-@code{nil}, or if you turned off -the tooltip mode, values are shown in the echo area instead of a -tooltip. +in the variable @code{gud-tooltip-modes}. If you turned off the +tooltip mode, values are shown in the echo area instead of a tooltip. When using GUD Tooltip mode with @kbd{M-x gud-gdb}, displaying an expression's value in GDB can sometimes expand a macro, potentially diff --git a/doc/misc/efaq-w32.texi b/doc/misc/efaq-w32.texi index 71d4b4e1fc2..de9354500df 100644 --- a/doc/misc/efaq-w32.texi +++ b/doc/misc/efaq-w32.texi @@ -1168,15 +1168,15 @@ binary and the Ctrl-M characters are significant. @subsection CR/LF translation by file system @cindex line ends, determining by filesystem @cindex binary files, determining by filesystem -@vindex untranslated-filesystem-list -@findex add-untranslated-filesystem -@findex remove-untranslated-filesystem +@vindex w32-untranslated-filesystem-list +@findex w32-add-untranslated-filesystem +@findex w32-remove-untranslated-filesystem -The variable @code{untranslated-filesystem-list} defines whole +The variable @code{w32-untranslated-filesystem-list} defines whole directory trees that should not have CR/LF autodetection performed on them. The list can be manipulated with the functions -@code{add-untranslated-filesystem} and -@code{remove-untranslated-filesystem}. With auto-detection in +@code{w32-add-untranslated-filesystem} and +@code{w32-remove-untranslated-filesystem}. With auto-detection in recent versions of Emacs, this is seldom useful for existing files, but can still be used to influence the choice of line ends for newly created files. diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index e995469ee3d..f7a2d730701 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -24523,8 +24523,8 @@ that is needed. It can also contain @samp{(@var{addr} @var{string} @var{amount})} cells, where the @var{string} is the string to use (normally the email address or newsgroup name is used). -@item hashcash-path -@vindex hashcash-path +@item hashcash-program +@vindex hashcash-program Where the @code{hashcash} binary is installed. This variable should be automatically set by @code{executable-find}, but if it's @code{nil} (usually because the @code{hashcash} binary is not in your path) diff --git a/lisp/emacs-lisp/eieio.el b/lisp/emacs-lisp/eieio.el index 064a55f2727..dcb4fe5ee6f 100644 --- a/lisp/emacs-lisp/eieio.el +++ b/lisp/emacs-lisp/eieio.el @@ -448,16 +448,13 @@ If EXTRA, include that in the string returned to represent the symbol." (defun eieio-class-parents (class) ;; FIXME: What does "(overload of variable)" mean here? - "Return parent classes to CLASS. (overload of variable). - -The CLOS function `class-direct-superclasses' is aliased to this function." + "Return parent classes to CLASS. (overload of variable)." (eieio--class-parents (eieio--full-class-object class))) (define-obsolete-function-alias 'class-parents #'eieio-class-parents "24.4") (defun eieio-class-children (class) - "Return child classes to CLASS. -The CLOS function `class-direct-subclasses' is aliased to this function." + "Return child classes to CLASS." (cl-check-type class class) (eieio--class-children (cl--find-class class))) (define-obsolete-function-alias diff --git a/lisp/progmodes/perl-mode.el b/lisp/progmodes/perl-mode.el index ab6333e4b23..9137119d052 100644 --- a/lisp/progmodes/perl-mode.el +++ b/lisp/progmodes/perl-mode.el @@ -47,10 +47,6 @@ ;; comment; move to end of line; create an empty comment; tell you that ;; the line ends in a quoted string, or has a # which should be a \#. -;; If your machine is slow, you may want to remove some of the bindings -;; to perl-electric-terminator. I changed the indenting defaults to be -;; what Larry Wall uses in perl/lib, but left in all the options. - ;; I also tuned a few things: comments and labels starting in column ;; zero are left there by perl-indent-exp; perl-beginning-of-function ;; goes back to the first open brace/paren in column zero, the open brace diff --git a/lisp/textmodes/ispell.el b/lisp/textmodes/ispell.el index 97c4ce9f32d..eb550b639a3 100644 --- a/lisp/textmodes/ispell.el +++ b/lisp/textmodes/ispell.el @@ -2523,9 +2523,9 @@ this function signals an error." (if lookup-dict (unless (file-readable-p lookup-dict) - (error "lookup-words error: Unreadable or missing plain word-list %s." + (error "ispell-lookup-words: Unreadable or missing plain word-list %s" lookup-dict)) - (error (concat "lookup-words error: No plain word-list found at system" + (error (concat "ispell-lookup-words: No plain word-list found at system" "default locations. " "Customize `ispell-alternate-dictionary' to set yours."))) diff --git a/src/buffer.h b/src/buffer.h index c0e38ce9659..69b0aed53e4 100644 --- a/src/buffer.h +++ b/src/buffer.h @@ -651,9 +651,9 @@ struct buffer ptrdiff_t last_window_start; /* If the long line scan cache is enabled (i.e. the buffer-local - variable cache-long-line-scans is non-nil), newline_cache - points to the newline cache, and width_run_cache points to the - width run cache. + variable cache-long-scans is non-nil), newline_cache points to + the newline cache, and width_run_cache points to the width run + cache. The newline cache records which stretches of the buffer are known *not* to contain newlines, so that they can be skipped -- 2.39.2