[AUCTeX-diffs] [elpa] externals/auctex aae80c4725 11/14: ; Minor Doc fix

[Tassilo Horn]

branch: externals/auctex
commit aae80c4725e712893882cd041a9c8b3f03749e6d
Author: Ikumi Keita <ikumi@ikumi.que.jp>
Commit: Ikumi Keita <ikumi@ikumi.que.jp>

    ; Minor Doc fix
    
    * latex/preview.dtx (subsection{Supporting conversions}): Wrap "<" in
    math mode so that reversed "!" doesn't appear in PDF output.
    * bib-cite.el:
    * context.el:
    * font-latex.el:
    * latex.el:
    * plain-tex.el:
    * preview.el.in:
    * tex-buf.el:
    * tex-fold.el:
    * tex-info.el:
    * tex.el:
    * toolbar-x.el:
    Fix typos.
    Quote symbols in doc strings with `this' style instead of 'this style.
    Use \= to guard ASCII APOSTROPHE(U+0027) of code example in doc string
    so that it doesn't turn into RIGHT SINGLE QUOTATION MARK(U+2147) in
    the output in *Help* buffer.
    Use t and nil instead of T and NIL in doc string.
    Update copyright year.
    * style/pstricks.el ("pstricks"): Fix spacing in comment.
    Update copyright year.
---
 bib-cite.el       | 28 +++++++++++++++-------------
 context.el        | 16 ++++++++--------
 font-latex.el     | 30 +++++++++++++++---------------
 latex.el          | 24 ++++++++++++------------
 latex/preview.dtx |  2 +-
 plain-tex.el      |  8 ++++----
 preview.el.in     | 36 ++++++++++++++++++------------------
 style/pstricks.el |  4 ++--
 tex-fold.el       | 12 ++++++------
 tex-info.el       |  4 ++--
 tex.el            | 26 +++++++++++++-------------
 toolbar-x.el      |  4 ++--
 12 files changed, 98 insertions(+), 96 deletions(-)

diff --git a/bib-cite.el b/bib-cite.el
index 465f18f973..a6405046f5 100644
--- a/bib-cite.el
+++ b/bib-cite.el
@@ -1,6 +1,6 @@
 ;; bib-cite.el - Display \cite, \ref or \label / Extract refs from BiBTeX 
file. -*- lexical-binding: t; -*-
 
-;; Copyright (C) 1994-1999, 2001, 2003-2005, 2014-2021 Free Software 
Foundation, Inc.
+;; Copyright (C) 1994-1999, 2001, 2003-2005, 2014-2022 Free Software 
Foundation, Inc.
 
 ;; Author:    Peter S. Galbraith <psg@debian.org>
 ;; Created:   06 July 1994
@@ -629,7 +629,7 @@ BiBTeX 0.99b manual says this should be TEXBIB.
 Another version says it should BSTINPUTS.  I don't know anymore!
 
 The colon character (:) is the default path separator in unix, but you may
-use semi-colon (;) for DOS or OS/2 if you set bib-dos-or-os2-variable to t."
+use semi-colon (;) for DOS or OS/2 if you set `bib-dos-or-os2-variable' to t."
   :type 'string)
 
 (defcustom bib-cite-inputs nil
@@ -650,14 +650,14 @@ directory.  You may set this variable to let bib-cite 
find these .aux files."
   ;; Under DOS  system-type equals ms-dos
   "Whether you use DOS or OS/2 for bib-make-bibliography/bib-display.
 
-It tells bib-make-bibliography and bib-display to translate
+It tells `bib-make-bibliography' and `bib-display' to translate
 the BIBINPUTS environment variable using the \";\" character as
 a path separator and to translate DOS' backslash to slash.
 
 e.g. Use a path like \"c:\\emtex\\bibinput;c:\\latex\\bibinput\"
 
 \(You can change the environment variable which is searched by
-setting the elisp variable bib-bibtex-env-variable)"
+setting the elisp variable `bib-bibtex-env-variable')"
   :type 'boolean)
 
 (defcustom bib-etags-command "etags -r '/.*\\\\\\(eq\\|page\\|[fvF]\\)ref.*/' 
-o "
@@ -685,11 +685,11 @@ coexist with some other tags file in your master file 
directory."
 without the curly bracket.
 
 If you change this variable and you use multi-file documents, make sure you
-also edit the variables bib-etags-command and bib-etags-append-command."
+also edit the variables `bib-etags-command' and `bib-etags-append-command'."
   :type 'regexp)
 
 (defcustom bib-substitute-string-in-display t
-  "Determines if bib-display will substitute @string definitions.
+  "Determines if `bib-display' will substitute @string definitions.
 If t, then the @string text is substituted.
 If nil, the text is not substituted but the @string entry is included."
   :type 'boolean)
@@ -1133,7 +1133,7 @@ to create a bibtex file containing only the references 
used in the document."
 Store the TAGS file in the master-directory.
 Expect errors if you use this outside of auctex or within a plain
 single-file document.  Also makes sure that the TAGS buffer is updated.
-See variables bib-etags-command and bib-etags-filename"
+See variables `bib-etags-command' and `bib-etags-filename'."
   (interactive)
   (require 'etags)
   (let* ((the-file-list (bib-document-TeX-files))
@@ -1358,12 +1358,14 @@ If within a single file document:
   You can move back with C-xC-x as the mark is set before moving.
   You can search for next occurrances of a ref command with C-sC-s.
 
-If within a multi-file document (in auctex only)
+If within a multi-file document (in AUCTeX only)
   You can move back with C-xC-x if within the same buffer.  If not, just
   select your previous buffer.
-  You can search for next occurrances of a ref command with tag commands:
+  You can search for next occurrences of a ref command with tag commands:
      C-u M-.     Find next alternate definition of last tag specified.
      C-u - M-.   Go back to previous tag found."
+  ;; FIXME: The last 3 lines of the above doc string no longer hold
+  ;; since M-. is now bound to `xref-find-definitions'.
   (let ((the-regexp (bib-guess-or-prompt-for-label)))
     (if (not the-regexp)
         (message "No name given")
@@ -1954,7 +1956,7 @@ Sets global variable bib-document-TeX-files-warnings."
         (progn
           (kill-buffer tex-buffer)
           (error
-           "Sorry, but this is not a multi-file document (Try C-u C-c C-n if 
using auctex)")))
+           "Sorry, but this is not a multi-file document (Try C-u C-c C-n if 
using AUCTeX)")))
     (with-current-buffer tex-buffer
       ;; set its directory so relative includes work without expanding
       (setq default-directory dir)
@@ -1989,8 +1991,8 @@ Sets global variable bib-document-TeX-files-warnings."
   "Return cite keys obarray for multi-file document.
 Return nil if not a multi-file document.
 This is a AUCTeX supported feature only.
-Also, see bib-buffer-citekeys-obarray.
-Sets global variable bib-document-citekeys-obarray-warnings."
+Also, see `bib-buffer-citekeys-obarray'.
+Set global variable `bib-document-citekeys-obarray-warnings'."
   (setq bib-document-citekeys-obarray-warnings nil)
   (let ((master-tex (bib-master-file))
         (master-aux))
@@ -2319,7 +2321,7 @@ If FIRST-FILE is t, stop after first file is found."
 argument may consist of environment variable plus a trailing directory, e.g.
 HOME or HOME/bin (trailing directory not supported in dos or OS/2).
 
-bib-dos-or-os2-variable affects:
+`bib-dos-or-os2-variable' affects:
   path separator used (: or ;)
   whether backslashes are converted to slashes"
   (if (not (getenv env))
diff --git a/context.el b/context.el
index 2f5c57e8e8..e87feecdb8 100644
--- a/context.el
+++ b/context.el
@@ -414,7 +414,7 @@ The following variables are set before the hooks are run
 `ConTeXt-done-mark' - Position of point afterwards, default nil
                       (meaning end).
 
-The following standard hook exist -
+The following standard hooks exist -
 
 ConTeXt-numbered-section-heading: Query the user about the name
 of the sectioning command.  Modifies `ConTeXt-level' and
@@ -433,12 +433,12 @@ ConTeXt-section-ref: Insert a reference for this section 
command.
 To get a full featured `ConTeXt-section' command, insert
 
  (setq ConTeXt-numbered-section-hook
-                         '(ConTeXt-numbered-section-heading
+                         \\='(ConTeXt-numbered-section-heading
                                  ConTeXt-section-title
                                  ConTeXt-section-section
                                  ConTeXt-section-ref))
 
-in your .emacs file."
+in your init file such as .emacs.d/init.el or .emacs."
   :group 'ConTeXt-macro
   :type 'hook
   :options
@@ -466,7 +466,7 @@ The following variables are set before the hooks are run
 `ConTeXt-done-mark' - Position of point afterwards, default nil
                       (meaning end).
 
-The following standard hook exist -
+The following standard hooks exist -
 
 ConTeXt-unnumbered-section-heading: Query the user about the name
 of the sectioning command.  Modifies `ConTeXt-level' and
@@ -485,12 +485,12 @@ ConTeXt-section-ref: Insert a reference for this section 
command.
 To get a full featured `ConTeXt-section' command, insert
 
  (setq ConTeXt-unnumbered-section-hook
-                         '(ConTeXt-unnumbered-section-heading
+                         \\='(ConTeXt-unnumbered-section-heading
                                  ConTeXt-section-title
                                  ConTeXt-section-section
                                  ConTeXt-section-ref))
 
-in your .emacs file."
+in your init file such as .emacs.d/init.el or .emacs."
   :group 'ConTeXt-macro
   :type 'hook
   :options
@@ -1696,7 +1696,7 @@ file, or any mode derived thereof. See variable
     "-mprun\\.mp" "-mprun\\.mpd" "-mprun\\.mpo" "-mprun\\.mpy")
   "List of regexps matching suffixes of files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
@@ -1704,7 +1704,7 @@ that is, you do _not_ have to cater for this yourself by 
adding \\\\' or $."
   '("\\.dvi" "\\.pdf" "\\.ps")
   "List of regexps matching suffixes of files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
diff --git a/font-latex.el b/font-latex.el
index 2a90f3098b..c49a698754 100644
--- a/font-latex.el
+++ b/font-latex.el
@@ -72,13 +72,13 @@ strings to be used as opening and closing quotation marks
 independently of the value of `font-latex-quotes' or a list with
 three elements where the first and second element are strings for
 opening and closing quotation marks and the third element being
-either the symbol 'german or 'french describing the order of
+either the symbol `german' or `french' describing the order of
 quotes.
 
 If `font-latex-quotes' specifies a different state, order of the
 added quotes will be reversed for fontification.  For example if
 '(\"\\\"<\" \"\\\">\" french) is given but `font-latex-quotes'
-specifies 'german, quotes will be used like \">foo\"< for
+specifies `german', quotes will be used like \">foo\"< for
 fontification.")
 
 (defvar font-latex-quotes-control nil
@@ -453,7 +453,7 @@ The first element of each item is the name of the keyword 
class.
 
 The second element is a list of keywords (macros without an
 escape character) to highlight or, if the fifth element is the
-symbol 'command, a list of lists where the first element of each
+symbol `command', a list of lists where the first element of each
 item is a keyword and the second a string specifying the macro
 syntax.  It can contain \"*\" if the macro has a starred variant,
 \"[\" for an optional argument, \"{\" for a mandatory argument,
@@ -466,9 +466,9 @@ form returning a face symbol.
 The fourth element is the fontification level.
 
 The fifth element is the type of construct to be matched.  It can
-be one of 'noarg which will match simple macros without
-arguments (like \"\\foo\"), 'declaration which will match macros
-inside a TeX group (like \"{\\bfseries foo}\"), or 'command which
+be one of `noarg' which will match simple macros without
+arguments (like \"\\foo\"), `declaration' which will match macros
+inside a TeX group (like \"{\\bfseries foo}\"), or `command' which
 will match macros of the form \"\\foo[bar]{baz}\"."))
 
 (defcustom font-latex-deactivated-keyword-classes nil
@@ -569,7 +569,7 @@ attributes that will be applied to the respective part of 
the
 match returned by the match function.  A lisp form returning a
 face name or a list of face attributes is also valid for FACE.
 TYPE is the type of construct to be highlighted.  Currently the
-symbols 'command, 'declaration and 'noarg are valid.
+symbols `command', `declaration' and `noarg' are valid.
 
 This is a helper function for `font-latex-make-built-in-keywords'
 and `font-latex-make-user-keywords' and not intended for general
@@ -906,12 +906,12 @@ Generated by `font-latex-make-user-keywords'.")))
   "Add KEYWORDS to CLASS.
 KEYWORDS is a list of keywords or keywords with syntax specs.
 CLASS corresponds to a keyword class and can be one of the
-symbols 'warning, 'variable, 'reference, 'biblatexnoarg,
-'biblatex, 'function, 'sectioning-0, 'sectioning-1,
-'sectioning-2, 'sectioning-3, 'sectioning-4, 'sectioning-5,
-'slide-title, 'textual, 'bold-command, 'italic-command,
-'math-command, 'type-command, 'bold-declaration,
-'italic-declaration or 'type-declaration.
+symbols `warning', `variable', `reference', `biblatexnoarg',
+`biblatex', `function', `sectioning-0', `sectioning-1',
+`sectioning-2', `sectioning-3', `sectioning-4', `sectioning-5',
+`slide-title', `textual', `bold-command', `italic-command',
+`math-command', `type-command', `bold-declaration',
+`italic-declaration' or `type-declaration'.
 
 The keywords will be added to the buffer-local list of keywords
 of the respective keyword class and necessary updates of the font
@@ -1648,7 +1648,7 @@ Sets `match-data' so that:
  subexpression 0 is a warning indicator,
  subexpression 1 is the keyword, and
  subexpression 2 is the rest in the TeX group.
-Returns nil if no command is found."
+Return nil if no command is found."
   (catch 'match
     (while (re-search-forward keywords limit t)
       (unless (font-latex-faces-present-p '(font-lock-comment-face
@@ -2026,7 +2026,7 @@ Used for patterns like:
 ``this is a normal quote'' and these are multilingual quoted strings:
 \"< french \"> and \"`german\"' quotes.
 The quotes << french >> and 8-bit french are used if `font-latex-quotes' is
-set to french, and >>german<< (and 8-bit) are used if set to german."
+set to `french', and >>german<< (and 8-bit) are used if set to `german'."
   (when font-latex-quotes
     (font-latex-update-quote-list)
     ;; Search for matches.
diff --git a/latex.el b/latex.el
index ad6908722f..dfbe78dd3d 100644
--- a/latex.el
+++ b/latex.el
@@ -399,7 +399,7 @@ LaTeX-title - The title of the section, default to an empty 
string.
 LaTeX-toc - Entry for the table of contents list, default nil.
 LaTeX-done-mark - Position of point afterwards, default nil (meaning end).
 
-The following standard hook exist -
+The following standard hooks exist -
 
 LaTeX-section-heading: Query the user about the name of the
 sectioning command.  Modifies `LaTeX-level' and `LaTeX-name'.
@@ -422,13 +422,13 @@ Controled by the variable `LaTeX-section-label'.
 To get a full featured `LaTeX-section' command, insert
 
  (setq LaTeX-section-hook
-       '(LaTeX-section-heading
+       \\='(LaTeX-section-heading
          LaTeX-section-title
          LaTeX-section-toc
          LaTeX-section-section
          LaTeX-section-label))
 
-in your .emacs file."
+in your init file such as .emacs.d/init.el or .emacs."
   :group 'LaTeX-macro
   :type 'hook
   :options '(LaTeX-section-heading
@@ -3978,7 +3978,7 @@ If optional argument COMMENT is non-nil, include comment 
env from
   "Return the indentation of a line of LaTeX source.
 FORCE-TYPE can be used to force the calculation of an inner or
 outer indentation in case of a commented line.  The symbols
-'inner and 'outer are recognized."
+`inner' and `outer' are recognized."
   (save-excursion
     (LaTeX-back-to-indentation force-type)
     (let ((i 0)
@@ -4097,7 +4097,7 @@ constructs.  A special case is \\newif where the following
 The point is supposed to be at the beginning of the current line.
 FORCE-TYPE can be used to force the calculation of an inner or
 outer indentation in case of a commented line.  The symbols
-'inner and 'outer are recognized."
+`inner' and `outer' are recognized."
   (let (line-comment-current-flag
         line-comment-last-flag
         comment-current-flag
@@ -4231,7 +4231,7 @@ outer indentation in case of a commented line.  The 
symbols
   "Return the indentation of a line.
 FORCE-TYPE can be used to force the calculation of an inner or
 outer indentation in case of a commented line.  The symbols
-'inner and 'outer are recognized."
+`inner' and `outer' are recognized."
   (if (and fill-prefix
            (or (and force-type
                     (eq force-type 'inner))
@@ -4262,7 +4262,7 @@ character(s), but only if `this-command' is not a newline
 command, that is, `TeX-newline' or the value of
 `TeX-newline-function'.  The optional argument FORCE-TYPE can be
 used to force point being moved to the inner or outer indentation
-in case of a commented line.  The symbols 'inner and 'outer are
+in case of a commented line.  The symbols `inner' and `outer' are
 recognized."
   (if (or (and force-type
                (eq force-type 'inner))
@@ -7209,14 +7209,14 @@ runs the hooks in `docTeX-mode-hook'."
   TeX-clean-default-intermediate-suffixes
   "List of regexps matching suffixes of files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
 (defcustom docTeX-clean-output-suffixes TeX-clean-default-output-suffixes
   "List of regexps matching suffixes of files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
@@ -7226,14 +7226,14 @@ that is, you do _not_ have to cater for this yourself 
by adding \\\\' or $."
           '("\\.acn" "\\.acr" "\\.alg" "\\.glg" "\\.ist"))
   "List of regexps matching suffixes of files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
 (defcustom LaTeX-clean-output-suffixes TeX-clean-default-output-suffixes
   "List of regexps matching suffixes of files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
@@ -8107,7 +8107,7 @@ key=value, default is \"label\".  NUM is an integer for an
 explicitly numbered group construct, useful when adding items to
 `reftex-label-regexps'.
 
-As an extra feature, the key can be the symbol none where the
+As an extra feature, the key can be the symbol `none' where the
 entire matching for the key=value is skipped.  The regexp then is
 useful for skipping complex optional arguments.  It should be
 wrapped in \\(?:...\\)? then."
diff --git a/latex/preview.dtx b/latex/preview.dtx
index 6b21ace38e..de4675e98a 100644
--- a/latex/preview.dtx
+++ b/latex/preview.dtx
@@ -1676,7 +1676,7 @@ Please complain to your document class author}%
 %<tightpage>       7{currentfile token not{stop}if 65781.76 div })) pop}
 %    \end{macrocode}
 % The ``userdict'' at the start of the last special is also there to
-% avoid an unknown special in dvipng<=1.6. This is the end of the
+% avoid an unknown special in dvipng$<=1.6$. This is the end of the
 % backwards-compatibility code.
 %    \begin{macrocode}
 %<tightpage>  \special{!userdict begin/bop-hook{%
diff --git a/plain-tex.el b/plain-tex.el
index a525740643..4f06a026f0 100644
--- a/plain-tex.el
+++ b/plain-tex.el
@@ -253,14 +253,14 @@ of `plain-TeX-mode-hook'."
   TeX-clean-default-intermediate-suffixes
   "List of regexps matching suffixes of intermediate files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
 (defcustom plain-TeX-clean-output-suffixes TeX-clean-default-output-suffixes
   "List of regexps matching suffixes of output files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
@@ -314,14 +314,14 @@ of `AmS-TeX-mode-hook'."
   TeX-clean-default-intermediate-suffixes
   "List of regexps matching suffixes of intermediate files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
 (defcustom AmSTeX-clean-output-suffixes TeX-clean-default-output-suffixes
   "List of regexps matching suffixes of output files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
diff --git a/preview.el.in b/preview.el.in
index a980d814f6..a995485d77 100644
--- a/preview.el.in
+++ b/preview.el.in
@@ -412,7 +412,7 @@ screen content.  Buffer-local to rendering buffer.")
   "Color setup list.
 An array with elements 0, 1 and 2 for background,
 foreground and border colors, respectively.  Each element
-is a list of 3 real numbers between 0 and 1, or NIL
+is a list of 3 real numbers between 0 and 1, or nil
 of nothing special should be done for the color")
 (make-variable-buffer-local 'preview-colors)
 
@@ -1091,7 +1091,7 @@ The usual PROCESS and COMMAND arguments for
 
 (defun preview-dsc-parse (file)
   "Parse DSC comments of FILE.
-Returns a vector with offset/length pairs corresponding to
+Return a vector with offset/length pairs corresponding to
 the pages.  Page 0 corresponds to the initialization section."
   (with-temp-buffer
     (set-buffer-multibyte nil)
@@ -1146,7 +1146,7 @@ object corresponding to the wanted page."
 (defun preview-ps-quote-filename (str &optional nonrel)
   "Make a PostScript string from filename STR.
 The file name is first made relative unless
-NONREL is not NIL."
+NONREL is not nil."
   (unless nonrel (setq str (file-relative-name str)))
   (let ((index 0))
     (while (setq index (string-match "[\\()]" str index))
@@ -1520,7 +1520,7 @@ This is for matching screen font size and previews."
   "Calculate the default font size of document.
 If packages, classes or styles were called with an option
 like 10pt, size is taken from the first such option if you
-had let your document be parsed by AucTeX."
+had let your document be parsed by AUCTeX."
   (let* ((regexp "\\`\\([0-9]+\\)pt\\'")
          (option
           (or
@@ -1630,10 +1630,10 @@ Fallback to :inherit and 'default implemented."
                               #'backward-char #'forward-char))
   "Cause previews to open automatically when entered.
 Possibilities are:
-T autoopens,
-NIL doesn't,
+t autoopens,
+nil doesn't,
 a symbol will have its value consulted if it exists,
-defaulting to NIL if it doesn't.
+defaulting to nil if it doesn't.
 An integer will specify a maximum cursor movement distance.
 Larger movements won't open the preview.
 A CONS-cell means to call a function for determining the value.
@@ -1655,7 +1655,7 @@ All of the options show reasonable defaults."
 
 (defun preview-auto-reveal-p (mode distance)
   "Decide whether to auto-reveal.
-Returns non-NIL if region should be auto-opened.
+Return non-nil if region should be auto-opened.
 See `preview-auto-reveal' for definitions of MODE, which gets
 set to `preview-auto-reveal'.  DISTANCE specifies the movement
 distance with which point has been reached in case it has been
@@ -1671,7 +1671,7 @@ a movement starting in the current buffer."
 
 (defun preview-arrived-via (&rest list)
   "Indicate auto-opening.
-Returns non-NIL if called by one of the commands in LIST."
+Return non-nil if called by one of the commands in LIST."
   (memq this-command list))
 
 (defcustom preview-equality-transforms '(identity
@@ -1784,7 +1784,7 @@ REST as the remainder, returning T."
 
 (defun preview-remove-urgentization (ov)
   "Undo urgentization of OV by `preview-add-urgentization'.
-Returns the old arguments to `preview-add-urgentization'
+Return the old arguments to `preview-add-urgentization'
 if there was any urgentization."
   (let ((dispro (overlay-get ov 'display)))
     (when (eq (car-safe dispro) 'when)
@@ -2423,8 +2423,8 @@ Possible values are nil, t, and `ask'."
   "Alist of dumped masters.
 The elements are (NAME . ASSOC).  NAME is the master file name
 \(without extension), ASSOC is what to do with regard to this
-format.  Possible values: NIL means no format is available
-and none should be generated.  T means no format is available,
+format.  Possible values: nil means no format is available
+and none should be generated.  t means no format is available,
 it should be generated on demand.  If the value is a cons cell,
 the CAR of the cons cell is the command with which the format
 has been generated, and the CDR is some Emacs-flavor specific
@@ -2576,7 +2576,7 @@ TeX bounding BOX passed on to the `place' hook.
 COUNTERS is the info about saved counter structures.
 TEMPDIR is a copy of `TeX-active-tempdir'.
 PLACE-OPTS are additional arguments passed into
-`preview-parse-messages'.  Returns
+`preview-parse-messages'.  Return
 a list with additional info from the placement hook.
 Those lists get concatenated together and get passed
 to the close hook."
@@ -2872,9 +2872,9 @@ using MML mode."
   "Return an MML representation of OV as string.
 This can be used to send inline images in mail and news when
 using MML mode.  If there is nothing current available,
-NIL is returned.  If the image has a colored border and the
+nil is returned.  If the image has a colored border and the
 user wants it removed when asked (unless DONT-ASK is set),
-'badcolor is thrown a t.  The MML is returned in the car of the
+`badcolor' is thrown a t.  The MML is returned in the car of the
 result, DONT-ASK in the cdr."
   (and (memq (overlay-get ov 'preview-state) '(active inactive))
        (not (overlay-get ov 'queued))
@@ -3652,7 +3652,7 @@ name(\\([^)]+\\))\\)\\|\
 
 (defun preview-get-geometry ()
   "Transfer display geometry parameters from current display.
-Returns list of scale, resolution and colors.  Calculation
+Return list of scale, resolution and colors.  Calculation
 is done in current buffer."
   (condition-case err
       (let* ((geometry
@@ -3686,7 +3686,7 @@ and `preview-colors' are set as given."
   "Return colors from the current display.
 Fetches the current screen colors and makes a vector
 of colors as numbers in the range 0..65535.
-Pure borderless black-on-white will return triple NIL.
+Pure borderless black-on-white will return triple nil.
 The fourth value is the transparent border thickness."
   (let
       ((bg (color-values (preview-inherited-face-attribute
@@ -3956,7 +3956,7 @@ This is passed through `preview-do-replacements'."
 For the rest of the session, this file is used when running
 on the same master file.
 
-Returns the process for dumping, nil if there is still a valid
+Return the process for dumping, nil if there is still a valid
 format available.
 
 If FORMAT-CONS is non-nil, a previous format may get reused."
diff --git a/style/pstricks.el b/style/pstricks.el
index ec2455004a..6a6707f38c 100644
--- a/style/pstricks.el
+++ b/style/pstricks.el
@@ -1,6 +1,6 @@
 ;;; pstricks.el --- AUCTeX style for the `pstricks' package.  -*- 
lexical-binding: t; -*-
 
-;; Copyright (C) 2007-2021  Free Software Foundation, Inc.
+;; Copyright (C) 2007-2022  Free Software Foundation, Inc.
 
 ;; Author: Holger Sparr <holger.sparr@gmx.net>
 ;; Maintainer: auctex-devel@gnu.org
@@ -784,7 +784,7 @@ comma separated list. Point has to be within the sexp to 
modify."
    (unless (or (member "pst-pdf" TeX-active-styles)
                (eq TeX-engine 'xetex))
      ;; Leave at user's choice whether to disable `TeX-PDF-mode' or
-     ;; not. Instead set up `TeX-PDF-from-DVI' option so that AUCTeX
+     ;; not.  Instead set up `TeX-PDF-from-DVI' option so that AUCTeX
      ;; takes dvips+ps2pdf route when `TeX-PDF-mode' is enabled.
      ;; (TeX-PDF-mode-off)
      (setq TeX-PDF-from-DVI "Dvips"))
diff --git a/tex-fold.el b/tex-fold.el
index 54f0a70fd2..6d50f31404 100644
--- a/tex-fold.el
+++ b/tex-fold.el
@@ -62,8 +62,8 @@
 
 (defcustom TeX-fold-type-list '(env macro math)
   "List of item types to consider when folding.
-Valid items are the symbols 'env for environments, 'macro for
-macros, 'math for math macros and 'comment for comments."
+Valid items are the symbols `env' for environments, `macro' for
+macros, `math' for math macros and `comment' for comments."
   :type '(set (const :tag "Environments" env)
               (const :tag "Macros" macro)
               (const :tag "Math Macros" math)
@@ -414,7 +414,7 @@ for macros and 'math for math macros."
 (defun TeX-fold-item (type)
   "Hide the item on which point currently is located.
 TYPE specifies the type of item and can be one of the symbols
-'env for environments, 'macro for macros or 'math for math
+`env' for environments, `macro' for macros or `math' for math
 macros.
 Return non-nil if an item was found and folded, nil otherwise."
   (if (and (eq type 'env)
@@ -508,7 +508,7 @@ Return non-nil if a comment was found and folded, nil 
otherwise."
 (defun TeX-fold-make-overlay (ov-start ov-end type display-string-spec)
   "Make a TeX-fold overlay extending from OV-START to OV-END.
 TYPE is a symbol which is used to describe the content to hide
-and may be 'macro for macros, 'math for math macro and 'env for
+and may be `macro' for macros, `math' for math macro and `env' for
 environments.
 DISPLAY-STRING-SPEC is the original specification of the display
 string in the variables `TeX-fold-macro-spec-list' or
@@ -526,8 +526,8 @@ string in the variables `TeX-fold-macro-spec-list' or
 
 (defun TeX-fold-item-end (start type)
   "Return the end of an item of type TYPE starting at START.
-TYPE can be either 'env for environments, 'macro for macros or
-'math for math macros."
+TYPE can be either `env' for environments, `macro' for macros or
+`math' for math macros."
   (save-excursion
     (cond ((and (eq type 'env)
                 (eq major-mode 'context-mode))
diff --git a/tex-info.el b/tex-info.el
index a05920ddcf..66e57517b8 100644
--- a/tex-info.el
+++ b/tex-info.el
@@ -868,7 +868,7 @@ value of `Texinfo-mode-hook'."
   '("\\.cps?" "\\.vrs?" "\\.fns?" "\\.tps?" "\\.pgs?" "\\.kys?")
   "List of regexps matching suffixes of files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
@@ -878,7 +878,7 @@ that is, you do _not_ have to cater for this yourself by 
adding \\\\' or $."
     "_toc\\.html" "_fot\\.html" "_abt\\.html" "_[0-9]+\\.html" "_l2h_img.+")
   "List of regexps matching suffixes of files to be deleted.
 The regexps will be anchored at the end of the file name to be matched,
-that is, you do _not_ have to cater for this yourself by adding \\\\' or $."
+that is, you do _not_ have to cater for this yourself by adding \\\\\\=' or $."
   :type '(repeat regexp)
   :group 'TeX-command)
 
diff --git a/tex.el b/tex.el
index 6b80b4e80c..747753b319 100644
--- a/tex.el
+++ b/tex.el
@@ -268,7 +268,7 @@ expanded.  The expansion is done using the information 
found in
 `TeX-expand-list'.
 
 The third element is the function which actually start the process.
-Several such hooks has been defined:
+Several such hooks have been defined:
 
 TeX-run-command: Start up the process and show the output in a
 separate buffer.  Check that there is not two commands running for the
@@ -723,7 +723,7 @@ Essentially,
 
 is equivalent to
 
-  (if (fboundp 'name) then else...)
+  (if (fboundp \\='name) then else...)
 
 but takes care of byte-compilation issues where the byte-code for
 the latter could signal an error if it has been compiled with
@@ -1782,7 +1782,7 @@ For some users, `x-focus-frame' does the trick.  For some
 users (on GNOME 3.20),
 
   (lambda ()
-    (run-at-time 0.5 nil #'x-focus-frame))
+    (run-at-time 0.5 nil #\\='x-focus-frame))
 
 does the trick.  Some other users use the external wmctrl tool to
 raise the Emacs frame like so:
@@ -1790,7 +1790,7 @@ raise the Emacs frame like so:
   (lambda ()
     (call-process
      \"wmctrl\" nil nil nil \"-i\" \"-R\"
-     (frame-parameter (selected-frame) 'outer-window-id)))"
+     (frame-parameter (selected-frame) \\='outer-window-id)))"
   :type 'function
   :group 'TeX-view)
 
@@ -2265,10 +2265,10 @@ If this variable is nil, AUCTeX will query you for the 
name.
 If the variable is t, AUCTeX will assume the file is a master file
 itself.
 
-If the variable is 'shared, AUCTeX will query for the name, but not
+If the variable is `shared', AUCTeX will query for the name, but not
 change the file.
 
-If the variable is 'dwim, AUCTeX will try to avoid querying by
+If the variable is `dwim', AUCTeX will try to avoid querying by
 attempting to `do what I mean'; and then change the file.
 
 It is suggested that you use the File Variables (see the info node
@@ -3020,7 +3020,7 @@ See variable `TeX-style-hook-dialect' for supported 
dialects."
   :type 'boolean)
 
 (defvar TeX-style-hook-applied-p nil
-  "Nil, unless the style specific hooks have been applied.")
+  "Non-nil means the style specific hooks have been applied.")
  (make-variable-buffer-local 'TeX-style-hook-applied-p)
 
 (defvar TeX-update-style-hook nil
@@ -6106,7 +6106,7 @@ valid languages."
   "If non-nil determines behavior of quote insertion.
 It is usually set by language-related style files.  Its value has
 the same structure as the elements of `TeX-quote-language-alist'.
-The symbol 'override can be used as its car in order to override
+The symbol `override' can be used as its car in order to override
 the settings of style files.  Style files should therefore check
 if this symbol is present and not alter `TeX-quote-language' if
 it is.")
@@ -6114,8 +6114,8 @@ it is.")
 
 (defun TeX-insert-quote (force)
   "Insert the appropriate quotation marks for TeX.
-Inserts the value of `TeX-open-quote' (normally ``) or `TeX-close-quote'
-\(normally '') depending on the context.  If `TeX-quote-after-quote'
+Inserts the value of `TeX-open-quote' (normally \\=`\\=`) or `TeX-close-quote'
+\(normally \\='\\=') depending on the context.  If `TeX-quote-after-quote'
 is non-nil, this insertion works only after \".
 With prefix argument FORCE, always inserts \" characters."
   (interactive "*P")
@@ -7051,7 +7051,7 @@ message buffer and start at the first error."
 (defun TeX-previous-error (arg)
   "Find the previous error in the TeX output buffer.
 
-Prefix arg N says how many error messages to move backward (or
+Prefix ARG says how many error messages to move backward (or
 forward, if negative).
 
 This works only with TeX commands and if the
@@ -8052,7 +8052,7 @@ With support for MS-DOS, especially when dviout is used 
with PC-9801 series."
 (defun TeX-run-interactive (name command file)
   "Run TeX interactively.
 Run command in a buffer (in comint-shell-mode) so that it accepts user
-interaction. If you return to the file buffer after the TeX run,
+interaction.  If you return to the file buffer after the TeX run,
 Error parsing on \\[next-error] should work with a bit of luck."
   (TeX-run-set-command name command)
   (require 'comint)
@@ -8783,7 +8783,7 @@ file and `TeX-region-orig-buffer' to access the buffer 
where
 from.")
 
 (defun TeX-quote-filename (file)
-  "Convert file name into a form acceptable to TeX."
+  "Convert file name FILE into a form acceptable to TeX."
   (let (pos)
     (while (setq pos (string-match "\\\\" file pos))
       (setq file (replace-match "/" t t file 0)
diff --git a/toolbar-x.el b/toolbar-x.el
index cdc4b98768..d97035fd8b 100644
--- a/toolbar-x.el
+++ b/toolbar-x.el
@@ -1,6 +1,6 @@
 ;;; toolbar-x.el --- fancy toolbar handling in Emacs  -*- lexical-binding: t; 
-*-
 
-;; Copyright (C) 2004-2021  Free Software Foundation, Inc.
+;; Copyright (C) 2004-2022  Free Software Foundation, Inc.
 
 ;; This program is free software; you can redistribute it and/or
 ;; modify it under the terms of the GNU General Public License as
@@ -1553,7 +1553,7 @@ To reproduce the default toolbar with use as BUTTON
 in `toolbarx-install-toolbar':
 
 \(toolbarx-install-toolbar
- '((open-file dired kill-buffer save-buffer write-file undo cut
+ \\='((open-file dired kill-buffer save-buffer write-file undo cut
                copy paste search-forward print-buffer customize help))
  toolbarx-default-toolbar-meaning-alist)