master d97a77c 5/5: Merge from origin/emacs-27

[Glenn Morris]

branch: master
commit d97a77c481ec913d8c3c24f2eecdc41a28243678
Merge: 8c37649 4df0c1c
Author: Glenn Morris <address@hidden>
Commit: Glenn Morris <address@hidden>

    Merge from origin/emacs-27
    
    4df0c1c6c4 (origin/emacs-27) ; * src/lread.c (force_new_style_backquo...
    069741b2f7 ; * etc/NEWS: Mention latest changes in checkdoc.  (Bug#38...
    a785be29bf Fix wording and punctuation of a recent commit
    0d3d3be35c Merge branch 'emacs-27' of git.savannah.gnu.org:/srv/git/e...
    5da372e17e ; Minor edit in anti.texi
    
    # Conflicts:
    #   etc/NEWS
---
 etc/NEWS.27                 | 8 ++++++++
 lisp/emacs-lisp/checkdoc.el | 4 ++--
 lisp/textmodes/ispell.el    | 6 +++---
 src/lread.c                 | 2 +-
 4 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/etc/NEWS.27 b/etc/NEWS.27
index d6eb5d9..69ffcdb 100644
--- a/etc/NEWS.27
+++ b/etc/NEWS.27
@@ -1458,6 +1458,14 @@ A new command 'xref-revert-buffer' is bound to 'g'.
 ---
 *** Imenu support has been added to 'xref--xref-buffer-mode'.
 
+** Checkdoc
+
+---
+*** Checkdoc can now optionally spell-check doc strings.
+Invoking 'checkdoc-buffer' with a non-nil TAKE-NOTES argument
+(interactively, with a prefix arg) will now spell-check the doc
+strings and report all the spelling mistakes.
+
 ** Icomplete
 
 +++
diff --git a/lisp/emacs-lisp/checkdoc.el b/lisp/emacs-lisp/checkdoc.el
index cbad6f0..ccdddb4 100644
--- a/lisp/emacs-lisp/checkdoc.el
+++ b/lisp/emacs-lisp/checkdoc.el
@@ -2110,8 +2110,8 @@ nil."
   (unless ispell-process
     (condition-case nil
        (progn
-          (ispell-set-spellchecker-params)    ; Initialize variables and dicts 
alists
-          (ispell-accept-buffer-local-defs)   ; use the correct dictionary
+          (ispell-set-spellchecker-params)    ; Initialize variables and dict 
alists.
+          (ispell-accept-buffer-local-defs)   ; Use the correct dictionary.
          ;; This code copied in part from ispell.el Emacs 19.34
          (dolist (w checkdoc-ispell-lisp-words)
            (process-send-string ispell-process (concat "@" w "\n"))))
diff --git a/lisp/textmodes/ispell.el b/lisp/textmodes/ispell.el
index c06f391..fc529a8 100644
--- a/lisp/textmodes/ispell.el
+++ b/lisp/textmodes/ispell.el
@@ -2015,7 +2015,7 @@ quit          spell session exited."
 
 (defun ispell--run-on-word (word)
   "Run ispell on WORD."
-  (ispell-send-string "%\n")   ; put in verbose mode
+  (ispell-send-string "%\n")   ; Put the speller in verbose mode.
   (ispell-send-string (concat "^" word "\n"))
   ;; wait until ispell has processed word
   (while (progn
@@ -2035,13 +2035,13 @@ quit          spell session exited."
           (or ispell-current-dictionary "default")))
 
 (defun ispell-correct-p (&optional following)
-  "Return t if the word at point is correct. Nil otherwise.
+  "Return t if the word at point is correct, nil otherwise.
 
 If optional argument FOLLOWING is non-nil then the following
 word (rather than preceding) is checked when the cursor is not
 over a word."
   (save-excursion
-    ;; reset ispell-filter so it only contains the result of
+    ;; Reset ispell-filter so it only contains the result of
     ;; spell-checking the current-word:
     (setq ispell-filter nil)
     (let* ((word-and-boundaries (ispell-get-word following))
diff --git a/src/lread.c b/src/lread.c
index 290b3d3..4e9860d 100644
--- a/src/lread.c
+++ b/src/lread.c
@@ -5070,7 +5070,7 @@ that are loaded before your customizations are read!  */);
 If nil, `load' and `read' raise errors when encountering some
 old-style variants of backquote and comma.  If non-nil, these
 constructs are always interpreted as described in the Info node
-`(elisp)Backquotes', even if that interpretation is incompatible with
+`(elisp)Backquote', even if that interpretation is incompatible with
 previous versions of Emacs.  Setting this variable to non-nil makes
 Emacs compatible with the behavior planned for Emacs 28.  In Emacs 28,
 this variable will become obsolete.  */);