emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] master 760701e: Don't quote symbols 'like-this' in docstri


From: Paul Eggert
Subject: [Emacs-diffs] master 760701e: Don't quote symbols 'like-this' in docstrings etc.
Date: Fri, 21 Aug 2015 00:35:04 +0000

branch: master
commit 760701ebe1b2061619c91c72d41666d3bd42366f
Author: Paul Eggert <address@hidden>
Commit: Paul Eggert <address@hidden>

    Don't quote symbols 'like-this' in docstrings etc.
    
    * admin/unidata/uvs.el (uvs-insert-fields-as-bytes):
    * lisp/allout-widgets.el (allout-widgets-count-buttons-in-region):
    * lisp/allout.el (allout-add-resumptions, allout-mode):
    * lisp/calculator.el (calculator-operators):
    * lisp/cedet/data-debug.el (dd-propertize):
    * lisp/cedet/ede/proj-prog.el (ede-proj-target-makefile-program):
    * lisp/cedet/semantic/analyze/debug.el:
    (semantic-analyzer-debug-global-miss-text):
    * lisp/cedet/semantic/lex-spp.el:
    (semantic-lex-spp-replace-or-symbol-or-keyword):
    * lisp/cedet/semantic/symref.el:
    (semantic-symref-cleanup-recent-buffers-fcn):
    * lisp/cedet/semantic/tag.el (semantic-tag-class):
    * lisp/cedet/srecode/el.el (srecode-semantic-handle-:el-custom):
    * lisp/gnus/nnmairix.el (nnmairix-propagate-marks-upon-close):
    * lisp/gnus/pop3.el (pop3-authentication-scheme):
    * lisp/help-fns.el (describe-function-orig-buffer):
    * lisp/imenu.el (imenu--history-list):
    * lisp/mail/feedmail.el (feedmail-confirm-outgoing)
    (feedmail-display-full-frame, feedmail-deduce-bcc-where)
    (feedmail-queue-default-file-slug)
    (feedmail-queue-buffer-file-name):
    * lisp/net/mairix.el (mairix-searches-mode-map):
    * lisp/net/newst-backend.el (newsticker-retrieval-method)
    (newsticker-auto-mark-filter-list):
    * lisp/obsolete/vi.el (vi-mode):
    * lisp/progmodes/cc-engine.el (c-literal-type):
    * lisp/progmodes/cpp.el (cpp-face):
    * lisp/progmodes/ebrowse.el (ebrowse-electric-list-looper):
    * lisp/progmodes/elisp-mode.el (elisp--xref-make-xref):
    * lisp/progmodes/pascal.el (pascal-auto-lineup):
    * lisp/progmodes/prog-mode.el (prog-widen):
    * lisp/progmodes/verilog-mode.el (verilog-regexp-words)
    (verilog-auto-lineup, verilog-auto-reset-widths)
    (verilog-auto-arg-format, verilog-auto-inst-template-numbers):
    * lisp/textmodes/flyspell.el (flyspell-maybe-correct-transposition)
    (flyspell-maybe-correct-doubling):
    * lisp/textmodes/table.el (table-justify, table-justify-cell)
    (table-justify-row, table-justify-column, table-insert-sequence)
    (table--justify-cell-contents):
    * lisp/url/url-auth.el (url-get-authentication):
    * lisp/window.el (display-buffer-record-window):
    * lisp/xml.el (xml-parse-file, xml-parse-region):
    * src/gfilenotify.c (Fgfile_add_watch):
    Don't quote symbols with apostrophes in doc strings.
    Use asymmetric quotes instead.
    * lisp/cedet/semantic/complete.el (semantic-displayor-show-request):
    Likewise for symbol in diagnostic.
    * lisp/image.el (image-extension-data):
    * lisp/register.el (frame-configuration-to-register):
    * src/buffer.c (syms_of_buffer):
    Remove bogus apostrophes after symbols.
    * lisp/thumbs.el (thumbs-conversion-program):
    Quote Lisp string values using double-quotes, not apostrophes.
---
 admin/unidata/uvs.el                 |    2 +-
 lisp/allout-widgets.el               |    2 +-
 lisp/allout.el                       |    6 ++--
 lisp/calculator.el                   |    2 +-
 lisp/cedet/data-debug.el             |    2 +-
 lisp/cedet/ede/proj-prog.el          |    2 +-
 lisp/cedet/semantic/analyze/debug.el |    2 +-
 lisp/cedet/semantic/complete.el      |    2 +-
 lisp/cedet/semantic/lex-spp.el       |    2 +-
 lisp/cedet/semantic/symref.el        |    2 +-
 lisp/cedet/semantic/tag.el           |    2 +-
 lisp/cedet/srecode/el.el             |    2 +-
 lisp/gnus/nnmairix.el                |    2 +-
 lisp/gnus/pop3.el                    |    2 +-
 lisp/help-fns.el                     |    2 +-
 lisp/image.el                        |    2 +-
 lisp/imenu.el                        |    2 +-
 lisp/mail/feedmail.el                |   36 +++++++++++++++++-----------------
 lisp/net/mairix.el                   |    2 +-
 lisp/net/newst-backend.el            |    8 +++---
 lisp/obsolete/vi.el                  |    4 +-
 lisp/progmodes/cc-engine.el          |    2 +-
 lisp/progmodes/cpp.el                |    2 +-
 lisp/progmodes/ebrowse.el            |    2 +-
 lisp/progmodes/elisp-mode.el         |    2 +-
 lisp/progmodes/pascal.el             |    4 +-
 lisp/progmodes/prog-mode.el          |    2 +-
 lisp/progmodes/verilog-mode.el       |   18 ++++++++--------
 lisp/register.el                     |    2 +-
 lisp/textmodes/flyspell.el           |    4 +-
 lisp/textmodes/table.el              |   24 +++++++++++-----------
 lisp/thumbs.el                       |    2 +-
 lisp/url/url-auth.el                 |    6 ++--
 lisp/window.el                       |   12 +++++-----
 lisp/xml.el                          |    8 +++---
 src/buffer.c                         |    4 +-
 src/gfilenotify.c                    |   24 +++++++++++-----------
 37 files changed, 103 insertions(+), 103 deletions(-)

diff --git a/admin/unidata/uvs.el b/admin/unidata/uvs.el
index a6beac9..8d3ffe2 100644
--- a/admin/unidata/uvs.el
+++ b/admin/unidata/uvs.el
@@ -114,7 +114,7 @@ The most significant byte comes first."
   "Insert VALUES for FIELDS as a sequence of bytes to the current buffer.
 VALUES and FIELDS are lists of integers and field symbols,
 respectively.  Byte length of each value is determined by the
-'uvs-field-size' property of the corresponding field."
+`uvs-field-size' property of the corresponding field."
   (while fields
     (let ((field (car fields))
          (value (car values)))
diff --git a/lisp/allout-widgets.el b/lisp/allout-widgets.el
index c6dba89..578510d 100644
--- a/lisp/allout-widgets.el
+++ b/lisp/allout-widgets.el
@@ -2372,7 +2372,7 @@ The elements of LIST are not copied, just the list 
structure itself."
     (car list)))
 ;;;_  . allout-widgets-count-buttons-in-region (start end)
 (defun allout-widgets-count-buttons-in-region (start end)
-  "Debugging/diagnostic tool - count overlays with 'button' property in 
region."
+  "Debugging/diagnostic tool - count overlays with `button' property in 
region."
   (interactive "r")
   (setq start (or start (point-min))
         end (or end (point-max)))
diff --git a/lisp/allout.el b/lisp/allout.el
index 025cb17..5c43f9b 100644
--- a/lisp/allout.el
+++ b/lisp/allout.el
@@ -1330,11 +1330,11 @@ cdr is the new value: '(some-var some-value)'.  The 
pairs can actually be
 triples, where the third element qualifies the disposition of the setting,
 as described further below.
 
-If the optional third element is the symbol 'extend, then the new value
+If the optional third element is the symbol `extend', then the new value
 created by `cons'ing the second element of the pair onto the front of the
 existing value.
 
-If the optional third element is the symbol 'append, then the new value is
+If the optional third element is the symbol `append', then the new value is
 extended from the existing one by `append'ing a list containing the second
 element of the pair onto the end of the existing value.
 
@@ -1838,7 +1838,7 @@ M-x outlineify-sticky       Activate outline mode for 
current buffer,
                             buffer with name derived from derived from that
                             of current buffer -- \"*BUFFERNAME exposed*\".
 \\[allout-flatten-exposed-to-buffer] `allout-flatten-exposed-to-buffer'
-                            Like above 'copy-exposed', but convert topic
+                            Like above `copy-exposed', but convert topic
                             prefixes to section.subsection... numeric
                             format.
 \\[customize-variable] allout-auto-activation
diff --git a/lisp/calculator.el b/lisp/calculator.el
index 4027887..55229bc 100644
--- a/lisp/calculator.el
+++ b/lisp/calculator.el
@@ -311,7 +311,7 @@ user-defined operators, use `calculator-user-operators' 
instead.")
    9 (highest) (optional, defaults to 1);
 
 It it possible have a unary prefix version of a binary operator if it
-comes later in this list.  If the list begins with the symbol 'nobind,
+comes later in this list.  If the list begins with the symbol `nobind',
 then no key binding will take place -- this is only useful for
 predefined keys.
 
diff --git a/lisp/cedet/data-debug.el b/lisp/cedet/data-debug.el
index 8a8af4e..300bd04 100644
--- a/lisp/cedet/data-debug.el
+++ b/lisp/cedet/data-debug.el
@@ -55,7 +55,7 @@
       (defalias 'data-debug-overlay-p 'extentp)
       (if (not (fboundp 'propertize))
          (defun dd-propertize (string &rest properties)
-           "Mimic 'propertize' in from Emacs 23."
+           "Mimic `propertize' in from Emacs 23."
            (add-text-properties 0 (length string) properties string)
            string
            )
diff --git a/lisp/cedet/ede/proj-prog.el b/lisp/cedet/ede/proj-prog.el
index b1b26d4..a59317c 100644
--- a/lisp/cedet/ede/proj-prog.el
+++ b/lisp/cedet/ede/proj-prog.el
@@ -62,7 +62,7 @@ specified with ldlibs.")
           "Libraries, such as \"m\" or \"Xt\" which this program depends on.
 The linker flag \"-l\" is automatically prepended.  Do not include a \"lib\"
 prefix, or a \".so\" suffix.
-Use the 'ldflags' slot to specify where in-project libraries might be.
+Use the `ldflags' slot to specify where in-project libraries might be.
 
 Note: Currently only used for Automake projects."
           )
diff --git a/lisp/cedet/semantic/analyze/debug.el 
b/lisp/cedet/semantic/analyze/debug.el
index 9f9270f..d0ab7c82 100644
--- a/lisp/cedet/semantic/analyze/debug.el
+++ b/lisp/cedet/semantic/analyze/debug.el
@@ -512,7 +512,7 @@ Optional argument CLASSCONSTRAINT says to output to tags of 
that class."
   )
 
 (defun semantic-analyzer-debug-global-miss-text (name-in)
-  "Use 'princ' to show text describing not finding symbol NAME-IN.
+  "Use `princ' to show text describing not finding symbol NAME-IN.
 NAME is the name of the unfound symbol."
   (let ((name (cond ((stringp name-in)
                     name-in)
diff --git a/lisp/cedet/semantic/complete.el b/lisp/cedet/semantic/complete.el
index 1e12190..509f802 100644
--- a/lisp/cedet/semantic/complete.el
+++ b/lisp/cedet/semantic/complete.el
@@ -1665,7 +1665,7 @@ Display mechanism using tooltip for a list of possible 
completions.")
        (when (>= (oref obj typing-count) 5)
          (oset obj mode 'standard)
          (setq mode 'standard)
-         (message "Resetting inline-mode to 'standard'."))
+         (message "Resetting inline-mode to ‘standard’."))
        (when (and (> numcompl max-tags)
                   (< (oref obj typing-count) 2))
          ;; Discretely hint at completion availability.
diff --git a/lisp/cedet/semantic/lex-spp.el b/lisp/cedet/semantic/lex-spp.el
index 0aa2f95..761cc1a 100644
--- a/lisp/cedet/semantic/lex-spp.el
+++ b/lisp/cedet/semantic/lex-spp.el
@@ -919,7 +919,7 @@ STR occurs in the current buffer between BEG and END."
     ))
 
 (define-lex-regex-analyzer semantic-lex-spp-replace-or-symbol-or-keyword
-  "Like 'semantic-lex-symbol-or-keyword' plus preprocessor macro replacement."
+  "Like `semantic-lex-symbol-or-keyword' plus preprocessor macro replacement."
   "\\(\\sw\\|\\s_\\)+"
   (let ((str (match-string 0))
        (beg (match-beginning 0))
diff --git a/lisp/cedet/semantic/symref.el b/lisp/cedet/semantic/symref.el
index ca5dd7d..89e8b40 100644
--- a/lisp/cedet/semantic/symref.el
+++ b/lisp/cedet/semantic/symref.el
@@ -337,7 +337,7 @@ Use the  `semantic-symref-hit-tags' method to get this 
list.")
   "List of buffers opened by `semantic-symref-result-get-tags'.")
 
 (defun semantic-symref-cleanup-recent-buffers-fcn ()
-  "Hook function to be used in 'post-command-hook' to cleanup buffers.
+  "Hook function to be used in `post-command-hook' to cleanup buffers.
 Buffers collected during symref can result in some files being
 opened multiple times for one operation.  This will keep buffers open
 until the next command is executed."
diff --git a/lisp/cedet/semantic/tag.el b/lisp/cedet/semantic/tag.el
index 545ca91..6c6616d 100644
--- a/lisp/cedet/semantic/tag.el
+++ b/lisp/cedet/semantic/tag.el
@@ -95,7 +95,7 @@ print statement."
 
 (defsubst semantic-tag-class (tag)
   "Return the class of TAG.
-That is, the symbol 'variable, 'function, 'type, or other.
+This is a symbol like `variable', `function', or `type'.
 There is no limit to the symbols that may represent the class of a tag.
 Each parser generates tags with classes defined by it.
 
diff --git a/lisp/cedet/srecode/el.el b/lisp/cedet/srecode/el.el
index 2bdf804..7e91a61 100644
--- a/lisp/cedet/srecode/el.el
+++ b/lisp/cedet/srecode/el.el
@@ -50,7 +50,7 @@ Adds the following:
 (defun srecode-semantic-handle-:el-custom (dict)
   "Add macros into the dictionary DICT based on the current Emacs Lisp file.
 Adds the following:
-  GROUP - The 'defgroup' name we guess you want for variables.
+  GROUP - The `defgroup' name we guess you want for variables.
   FACEGROUP - The `defgroup' name you might want for faces."
   (require 'semantic/db-find)
   (let ((groups (semanticdb-strip-find-results
diff --git a/lisp/gnus/nnmairix.el b/lisp/gnus/nnmairix.el
index 96b40e5..0a4dbff 100644
--- a/lisp/gnus/nnmairix.el
+++ b/lisp/gnus/nnmairix.el
@@ -311,7 +311,7 @@ The default chooses the largest window in the current 
frame."
 The default of this variable is t.  If set to 'ask, the
 user will be asked if the flags should be propagated when the
 group is closed.  If set to nil, the user will have to manually
-call 'nnmairix-propagate-marks'."
+call `nnmairix-propagate-marks'."
   :version "23.1"
   :type '(choice (const :tag "always" t)
                 (const :tag "ask" ask)
diff --git a/lisp/gnus/pop3.el b/lisp/gnus/pop3.el
index 4d9dfda..696c6e4 100644
--- a/lisp/gnus/pop3.el
+++ b/lisp/gnus/pop3.el
@@ -82,7 +82,7 @@
 (defcustom pop3-authentication-scheme 'pass
   "*POP3 authentication scheme.
 Defaults to `pass', for the standard USER/PASS authentication.  The other
-valid value is 'apop'."
+valid value is `apop'."
   :type '(choice (const :tag "Normal user/password" pass)
                 (const :tag "APOP" apop))
   :version "22.1" ;; Oort Gnus
diff --git a/lisp/help-fns.el b/lisp/help-fns.el
index 71bcdb6..8ed9a47 100644
--- a/lisp/help-fns.el
+++ b/lisp/help-fns.el
@@ -44,7 +44,7 @@ The functions will receive the function name as argument.")
 ;; Functions
 
 (defvar describe-function-orig-buffer nil
-  "Buffer that was current when 'describe-function' was invoked.
+  "Buffer that was current when `describe-function' was invoked.
 Functions on 'help-fns-describe-function-functions' can use this
 to get buffer-local values.")
 
diff --git a/lisp/image.el b/lisp/image.el
index 1c268c4..99a65e3 100644
--- a/lisp/image.el
+++ b/lisp/image.el
@@ -357,7 +357,7 @@ Optional DATA-P non-nil means SOURCE is a string containing 
image data."
 
 (if (fboundp 'image-metadata)           ; eg not --without-x
     (define-obsolete-function-alias 'image-extension-data
-      'image-metadata' "24.1"))
+      'image-metadata "24.1"))
 
 (define-obsolete-variable-alias
     'image-library-alist
diff --git a/lisp/imenu.el b/lisp/imenu.el
index 3a856b8..158718b 100644
--- a/lisp/imenu.el
+++ b/lisp/imenu.el
@@ -476,7 +476,7 @@ element recalculates the buffer's index alist.")
 
 (defvar imenu--history-list nil
   ;; Making this buffer local caused it not to work!
-  "History list for 'jump-to-function-in-buffer'.")
+  "History list for `jump-to-function-in-buffer'.")
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;;;
diff --git a/lisp/mail/feedmail.el b/lisp/mail/feedmail.el
index 7f27599..857cfcc 100644
--- a/lisp/mail/feedmail.el
+++ b/lisp/mail/feedmail.el
@@ -399,10 +399,10 @@
   "If non-nil, give a y-or-n confirmation prompt before sending mail.
 This is done after the message is completely prepped, and you'll be
 looking at the top of the message in a buffer when you get the prompt.
-If set to the symbol 'queued, give the confirmation prompt only while
+If set to the symbol `queued', give the confirmation prompt only while
 running the queue (however, the prompt is always suppressed if you are
 processing the queue via `feedmail-run-the-queue-no-prompts').  If set
-to the symbol 'immediate, give the confirmation prompt only when
+to the symbol `immediate', give the confirmation prompt only when
 sending immediately.  For any other non-nil value, prompt in both
 cases.  You can give a timeout for the prompt; see variable
 `feedmail-confirm-outgoing-timeout'."
@@ -418,9 +418,9 @@ cases.  You can give a timeout for the prompt; see variable
 If nil, the prepped message will be shown, for confirmation or
 otherwise, in some window in the current frame without resizing
 anything.  That may or may not display enough of the message to
-distinguish it from others.  If set to the symbol 'queued, take
+distinguish it from others.  If set to the symbol ‘queued’, take
 this action only when running the queue.  If set to the symbol
-'immediate, take this action only when sending immediately.  For
+‘immediate’, take this action only when sending immediately.  For
 any other non-nil value, take the action in both cases.  Even if
 you're not confirming the sending of immediate or queued messages,
 it can still be interesting to see a lot about them as they are
@@ -471,9 +471,9 @@ Addresses for the message envelope are deduced by examining
 appropriate address headers in the message.  Generally, they will show
 up in the list of deduced addresses in the order that the headers
 happen to appear (duplicate addresses are eliminated in any case).
-This variable can be set to the symbol 'first, in which case the
+This variable can be set to the symbol ‘first’, in which case the
 Bcc:/Resent-Bcc: addresses will appear at the beginning in the list;
-or, it can be set to the symbol 'last, in which case they will appear
+or, it can be set to the symbol ‘last’, in which case they will appear
 at the end of the list.
 
 Why should you care?  Well, maybe you don't, and certainly the same
@@ -484,7 +484,7 @@ addresses are not handled first, there can be substantial 
delays in
 seeing the message again.  Some configurations of sendmail, for example,
 seem to try to deliver to each addressee at least once, immediately
 and serially, so slow SMTP conversations can add up to a delay.  There
-is an option for either 'first or 'last because you might have a
+is an option for either ‘first’ or ‘last’ because you might have a
 delivery agent that processes the addresses backwards."
   :group 'feedmail-headers
   :type '(choice (const nil)
@@ -1231,7 +1231,7 @@ If a string, it is used directly.
 If a function, it is called with no arguments from the buffer containing the 
raw
 text of the message.  It must return a string (which may be empty).
 
-If the symbol 'ask, you will be prompted for a string in the mini-buffer.
+If the symbol `ask', you will be prompted for a string in the mini-buffer.
 Filename completion is available so that you can inspect what's already been
 used, but feedmail will do further manipulation on the string you return, so
 it's not expected to be a complete filename."
@@ -1301,27 +1301,27 @@ the fact in the messages buffer."
 
 
 (defvar feedmail-queue-buffer-file-name nil
-  "If non-nil, has the value normally expected of 'buffer-file-name'.
+  "If non-nil, has the value normally expected of `buffer-file-name'.
 You are not intended to set this to something in your configuration.  Rather,
 you might programmatically set it to something via a hook or function
 advice or whatever.  You might like to do this if you are using a mail
-composition program that eventually uses sendmail.el's 'mail-send'
+composition program that eventually uses sendmail.el's `mail-send'
 function to process the message.  If there is a filename associated
-with the message buffer, 'mail-send' will ask you for confirmation.
+with the message buffer, `mail-send' will ask you for confirmation.
 There's no trivial way to avoid it.  It's unwise to just set the value
-of 'buffer-file-name' to nil because that will defeat feedmail's file
+of `buffer-file-name' to nil because that will defeat feedmail's file
 management features.  Instead, arrange for this variable to be set to
-the value of 'buffer-file-name' before setting that to nil.  An easy way
-to do that would be with defadvice on 'mail-send' \(undoing the
+the value of `buffer-file-name' before setting that to nil.  An easy way
+to do that would be with defadvice on `mail-send' \(undoing the
 assignments in a later advice\).
 
-feedmail will pretend that 'buffer-file-name', if nil, has the value
-assigned of 'feedmail-queue-buffer-file-name' and carry out its normal
+feedmail will pretend that `buffer-file-name', if nil, has the value
+assigned of `feedmail-queue-buffer-file-name' and carry out its normal
 activities.  feedmail does not restore the non-nil value of
-'buffer-file-name'.  For safe bookkeeping, the user should insure that
+`buffer-file-name'.  For safe bookkeeping, the user should insure that
 feedmail-queue-buffer-file-name is restored to nil.
 
-Example 'defadvice' for mail-send:
+Example `defadvice' for mail-send:
 
    (defadvice mail-send (before feedmail-mail-send-before-advice activate)
      (setq feedmail-queue-buffer-file-name buffer-file-name)
diff --git a/lisp/net/mairix.el b/lisp/net/mairix.el
index 087ae43..2d7d46b 100644
--- a/lisp/net/mairix.el
+++ b/lisp/net/mairix.el
@@ -762,7 +762,7 @@ VALUES may contain values for editable fields from current 
article."
     (define-key map [(d)] 'mairix-select-delete)
     (define-key map [(s)] 'mairix-select-save)
     map)
-  "'mairix-searches-mode' keymap.")
+  "`mairix-searches-mode' keymap.")
 
 (defvar mairix-searches-mode-font-lock-keywords
   '(("^\\([0-9]+\\)"
diff --git a/lisp/net/newst-backend.el b/lisp/net/newst-backend.el
index 5db04eb..435851c 100644
--- a/lisp/net/newst-backend.el
+++ b/lisp/net/newst-backend.el
@@ -235,7 +235,7 @@ which apply for this feed only, overriding the value of
   'intern
   "Method for retrieving news from the web, either `intern' or `extern'.
 Default value `intern' uses Emacs' built-in asynchronous download
-capabilities ('url-retrieve').  If set to `extern' the external
+capabilities (`url-retrieve').  If set to `extern' the external
 program wget is used, see `newsticker-wget-name'."
   :type '(choice :tag "Method"
                  (const :tag "Intern" intern)
@@ -332,9 +332,9 @@ deleted at the next retrieval."
 This is an alist of the form (FEED-NAME PATTERN-LIST).  I.e. each
 element consists of a FEED-NAME a PATTERN-LIST.  Each element of
 the pattern-list has the form (AGE TITLE-OR-DESCRIPTION REGEXP).
-AGE must be one of the symbols 'old or 'immortal.
-TITLE-OR-DESCRIPTION must be on of the symbols 'title,
-'description, or 'all.  REGEXP is a regular expression, i.e. a
+AGE must be one of the symbols `old' or `immortal'.
+TITLE-OR-DESCRIPTION must be one of the symbols `title',
+`description', or `all'.  REGEXP is a regular expression, i.e., a
 string.
 
 This filter is checked after a new headline has been retrieved.
diff --git a/lisp/obsolete/vi.el b/lisp/obsolete/vi.el
index c5dc0ef..40d2e22 100644
--- a/lisp/obsolete/vi.el
+++ b/lisp/obsolete/vi.el
@@ -444,11 +444,11 @@ Major differences between this mode and real vi :
 * Extensions
   - Some standard (or modified) Emacs commands were integrated, such as
     incremental search, query replace, transpose objects, and keyboard macros.
-  - In command state, ^X links to the 'ctl-x-map', and ESC can be linked to
+  - In command state, ^X links to the `ctl-x-map', and ESC can be linked to
     esc-map or set undefined.  These can give you the full power of Emacs.
   - See vi-com-map for those keys that are extensions to standard vi, e.g.
     `vi-name-last-change-or-macro', `vi-verify-spelling', `vi-locate-def',
-    `vi-mark-region', and 'vi-quote-words'.  Some of them are quite handy.
+    `vi-mark-region', and `vi-quote-words'.  Some of them are quite handy.
   - Use \\[vi-switch-mode] to switch among different modes quickly.
 
 Syntax table and abbrevs while in vi mode remain as they were in Emacs."
diff --git a/lisp/progmodes/cc-engine.el b/lisp/progmodes/cc-engine.el
index 520b7e5..a0f44a2 100644
--- a/lisp/progmodes/cc-engine.el
+++ b/lisp/progmodes/cc-engine.el
@@ -4616,7 +4616,7 @@ comment at the start of cc-engine.el for more info."
 (defun c-literal-type (range)
   "Convenience function that given the result of `c-literal-limits',
 returns nil or the type of literal that the range surrounds, one
-of the symbols 'c, 'c++ or 'string.  It's much faster than using
+of the symbols `c', `c++' or `string'.  It's much faster than using
 `c-in-literal' and is intended to be used when you need both the
 type of a literal and its limits.
 
diff --git a/lisp/progmodes/cpp.el b/lisp/progmodes/cpp.el
index 0a51add..685bb21 100644
--- a/lisp/progmodes/cpp.el
+++ b/lisp/progmodes/cpp.el
@@ -57,7 +57,7 @@
   :group 'cpp)
 
 (define-widget 'cpp-face 'lazy
-  "Either a face or the special symbol 'invisible'."
+  "Either a face or the special symbol `invisible'."
   :type '(choice (const invisible) (face)))
 
 (defcustom cpp-known-face 'invisible
diff --git a/lisp/progmodes/ebrowse.el b/lisp/progmodes/ebrowse.el
index 8d7c8aa..7c785d4 100644
--- a/lisp/progmodes/ebrowse.el
+++ b/lisp/progmodes/ebrowse.el
@@ -2015,7 +2015,7 @@ COLLAPSE non-nil means collapse the branch."
 (defun ebrowse-electric-list-looper (state condition)
   "Prevent cursor from moving beyond the buffer end.
 Don't let it move into the title lines.
-See 'Electric-command-loop' for a description of STATE and CONDITION."
+See `Electric-command-loop' for a description of STATE and CONDITION."
   (cond ((and condition
              (not (memq (car condition)
                         '(buffer-read-only end-of-buffer
diff --git a/lisp/progmodes/elisp-mode.el b/lisp/progmodes/elisp-mode.el
index 6ad803d..a96fca1 100644
--- a/lisp/progmodes/elisp-mode.el
+++ b/lisp/progmodes/elisp-mode.el
@@ -624,7 +624,7 @@ It can be quoted, or be inside a quoted form."
 
 (defun elisp--xref-make-xref (type symbol file &optional summary)
   "Return an xref for TYPE SYMBOL in FILE.
-TYPE must be a type in 'find-function-regexp-alist' (use nil for
+TYPE must be a type in `find-function-regexp-alist' (use nil for
 'defun).  If SUMMARY is non-nil, use it for the summary;
 otherwise build the summary from TYPE and SYMBOL."
   (xref-make (or summary
diff --git a/lisp/progmodes/pascal.el b/lisp/progmodes/pascal.el
index c05bda5..454367c 100644
--- a/lisp/progmodes/pascal.el
+++ b/lisp/progmodes/pascal.el
@@ -234,9 +234,9 @@ The name of the function or case is included between the 
braces."
 
 (defcustom pascal-auto-lineup '(all)
   "List of contexts where auto lineup of :'s or ='s should be done.
-Elements can be of type: 'paramlist', 'declaration' or 'case', which will
+Elements can be of type: `paramlist', `declaration' or `case', which will
 do auto lineup in parameterlist, declarations or case-statements
-respectively.  The word 'all' will do all lineups.  '(case paramlist) for
+respectively.  The word `all' will do all lineups.  '(case paramlist) for
 instance will do lineup in case-statements and parameterlist, while '(all)
 will do all lineups."
   :type '(set :extra-offset 8
diff --git a/lisp/progmodes/prog-mode.el b/lisp/progmodes/prog-mode.el
index cb8aaad..994eaaf 100644
--- a/lisp/progmodes/prog-mode.el
+++ b/lisp/progmodes/prog-mode.el
@@ -116,7 +116,7 @@ This function can be used instead of `widen' in any 
function used
 by the indentation engine to make it respect the value
 `prog-indentation-context'.
 
-This function (like 'widen') is useful inside a
+This function (like `widen') is useful inside a
 `save-restriction' to make the indentation correctly work when
 narrowing is in effect."
   (let ((chunk (cadr prog-indentation-context)))
diff --git a/lisp/progmodes/verilog-mode.el b/lisp/progmodes/verilog-mode.el
index 3ce185f..3244805 100644
--- a/lisp/progmodes/verilog-mode.el
+++ b/lisp/progmodes/verilog-mode.el
@@ -346,10 +346,10 @@ wherever possible, since it is slow."
 
 (eval-when-compile
   (defun verilog-regexp-words (a)
-    "Call 'regexp-opt' with word delimiters for the words A."
+    "Call `regexp-opt' with word delimiters for the words A."
     (concat "\\<" (verilog-regexp-opt a t) "\\>")))
 (defun verilog-regexp-words (a)
-  "Call 'regexp-opt' with word delimiters for the words A."
+  "Call `regexp-opt' with word delimiters for the words A."
   ;; The FAQ references this function, so user LISP sometimes calls it
   (concat "\\<" (verilog-regexp-opt a t) "\\>"))
 
@@ -541,9 +541,9 @@ entry \"Fontify Buffer\").  XEmacs: turn off and on font 
locking."
 
 (defcustom verilog-auto-lineup 'declarations
   "Type of statements to lineup across multiple lines.
-If 'all' is selected, then all line ups described below are done.
+If `all' is selected, then all line ups described below are done.
 
-If 'declarations', then just declarations are lined up with any
+If `declarations', then just declarations are lined up with any
 preceding declarations, taking into account widths and the like,
 so or example the code:
        reg [31:0] a;
@@ -552,7 +552,7 @@ would become
        reg [31:0] a;
        reg        b;
 
-If 'assignment', then assignments are lined up with any preceding
+If `assignment', then assignments are lined up with any preceding
 assignments, so for example the code
        a_long_variable <= b + c;
        d = e + f;
@@ -1054,7 +1054,7 @@ the MSB or LSB of a signal inside an AUTORESET.
 
 If nil, AUTORESET uses \"0\" as the constant.
 
-If 'unbased', AUTORESET used the unbased unsized literal \"'0\"
+If `unbased', AUTORESET used the unbased unsized literal \"'0\"
 as the constant. This setting is strongly recommended for
 SystemVerilog designs."
   :type 'boolean
@@ -1070,10 +1070,10 @@ SystemVerilog designs."
 
 (defcustom verilog-auto-arg-format 'packed
   "Formatting to use for AUTOARG signal names.
-If 'packed', then as many inputs and outputs that fit within
+If `packed', then as many inputs and outputs that fit within
 `fill-column' will be put onto one line.
 
-If 'single', then a single input or output will be put onto each
+If `single', then a single input or output will be put onto each
 line."
   :version "25.1"
   :type '(radio (const :tag "Line up Assignments and Declarations" packed)
@@ -1172,7 +1172,7 @@ was used for that port declaration.  This setting is 
suggested
 only for debugging use, as regular use may cause a large numbers
 of merge conflicts.
 
-If 'lhs', the comment will show the left hand side of the
+If `lhs', the comment will show the left hand side of the
 AUTO_TEMPLATE rule that is matched.  This is less precise than
 numbering (t) when multiple rules have the same pin name, but
 won't merge conflict."
diff --git a/lisp/register.el b/lisp/register.el
index 7afbc06..110c36f 100644
--- a/lisp/register.el
+++ b/lisp/register.el
@@ -220,7 +220,7 @@ Interactively, reads the register using 
`register-read-with-preview'."
 (set-advertised-calling-convention 'frame-configuration-to-register
                                   '(register) "24.4")
 
-(make-obsolete 'frame-configuration-to-register 'frameset-to-register' "24.4")
+(make-obsolete 'frame-configuration-to-register 'frameset-to-register "24.4")
 
 (defalias 'register-to-point 'jump-to-register)
 (defun jump-to-register (register &optional delete)
diff --git a/lisp/textmodes/flyspell.el b/lisp/textmodes/flyspell.el
index 64aa3de1..14f8744 100644
--- a/lisp/textmodes/flyspell.el
+++ b/lisp/textmodes/flyspell.el
@@ -2326,7 +2326,7 @@ If the text between BEG and END is equal to a correction 
suggested by
 Ispell, after transposing two adjacent characters, correct the text,
 and return t.
 
-The third arg POSS is either the symbol 'doublon' or a list of
+The third arg POSS is either the symbol `doublon' or a list of
 possible corrections as returned by `ispell-parse-output'.
 
 This function is meant to be added to `flyspell-incorrect-hook'."
@@ -2356,7 +2356,7 @@ If the text between BEG and END is equal to a correction 
suggested by
 Ispell, after removing a pair of doubled characters, correct the text,
 and return t.
 
-The third arg POSS is either the symbol 'doublon' or a list of
+The third arg POSS is either the symbol `doublon' or a list of
 possible corrections as returned by `ispell-parse-output'.
 
 This function is meant to be added to `flyspell-incorrect-hook'."
diff --git a/lisp/textmodes/table.el b/lisp/textmodes/table.el
index fa9f0fa..93b31d5 100644
--- a/lisp/textmodes/table.el
+++ b/lisp/textmodes/table.el
@@ -2806,8 +2806,8 @@ ORIENTATION is a symbol either horizontally or 
vertically."
 ;;;###autoload
 (defun table-justify (what justify)
   "Justify contents of a cell, a row of cells or a column of cells.
-WHAT is a symbol 'cell, 'row or 'column.  JUSTIFY is a symbol 'left,
-'center, 'right, 'top, 'middle, 'bottom or 'none."
+WHAT is a symbol ‘cell’, ‘row’ or ‘column’.  JUSTIFY is a symbol
+‘left’, ‘center’, ‘right’, ‘top’, ‘middle’, ‘bottom’ or ‘none’."
   (interactive
    (list (let* ((_ (barf-if-buffer-read-only))
                (completion-ignore-case t)
@@ -2822,8 +2822,8 @@ WHAT is a symbol 'cell, 'row or 'column.  JUSTIFY is a 
symbol 'left,
 ;;;###autoload
 (defun table-justify-cell (justify &optional paragraph)
   "Justify cell contents.
-JUSTIFY is a symbol 'left, 'center or 'right for horizontal, or 'top,
-'middle, 'bottom or 'none for vertical.  When optional PARAGRAPH is
+JUSTIFY is a symbol ‘left’, ‘center’ or ‘right’ for horizontal, or ‘top’,
+‘middle’, ‘bottom’ or ‘none’ for vertical.  When optional PARAGRAPH is
 non-nil the justify operation is limited to the current paragraph,
 otherwise the entire cell contents is justified."
   (interactive
@@ -2835,8 +2835,8 @@ otherwise the entire cell contents is justified."
 ;;;###autoload
 (defun table-justify-row (justify)
   "Justify cells of a row.
-JUSTIFY is a symbol 'left, 'center or 'right for horizontal, or top,
-'middle, 'bottom or 'none for vertical."
+JUSTIFY is a symbol ‘left’, ‘center’ or ‘right’ for horizontal,
+or ‘top’, ‘middle’, ‘bottom’ or ‘none’ for vertical."
   (interactive
    (list (table--query-justification)))
   (let((cell-list (table--horizontal-cell-list nil nil 'top)))
@@ -2852,8 +2852,8 @@ JUSTIFY is a symbol 'left, 'center or 'right for 
horizontal, or top,
 ;;;###autoload
 (defun table-justify-column (justify)
   "Justify cells of a column.
-JUSTIFY is a symbol 'left, 'center or 'right for horizontal, or top,
-'middle, 'bottom or 'none for vertical."
+JUSTIFY is a symbol ‘left’, ‘center’ or ‘right’ for horizontal,
+or ‘top’, ‘middle’, ‘bottom’ or ‘none’ for vertical."
   (interactive
    (list (table--query-justification)))
   (let((cell-list (table--vertical-cell-list nil nil 'left)))
@@ -3341,8 +3341,8 @@ INTERVAL is the number of cells to travel between 
sequence element
 insertion which is normally 1.  When zero or less is given for
 INTERVAL it is interpreted as number of cells per row so that sequence
 is placed straight down vertically as long as the table's cell
-structure is uniform.  JUSTIFY is one of the symbol 'left, 'center or
-'right, that specifies justification of the inserted string.
+structure is uniform.  JUSTIFY is a symbol ‘left’, ‘center’ or
+‘right’ that specifies justification of the inserted string.
 
 Example:
 
@@ -4461,8 +4461,8 @@ looking at the appearance of the CELL contents."
 
 (defun table--justify-cell-contents (justify &optional paragraph)
   "Justify the current cell contents.
-JUSTIFY is a symbol 'left, 'center or 'right for horizontal, or 'top,
-'middle, 'bottom or 'none for vertical.  When PARAGRAPH is non-nil the
+JUSTIFY is a symbol ‘left’, ‘center’ or ‘right’ for horizontal, or ‘top’,
+‘middle’, ‘bottom’ or ‘none’ for vertical.  When PARAGRAPH is non-nil the
 justify operation is limited to the current paragraph."
   (table-with-cache-buffer
     (let ((beg (point-min))
diff --git a/lisp/thumbs.el b/lisp/thumbs.el
index d8bb8cb..409ba7c 100644
--- a/lisp/thumbs.el
+++ b/lisp/thumbs.el
@@ -102,7 +102,7 @@ When it reaches that size (in bytes), a warning is sent."
     (or (executable-find "convert")
        "/usr/X11R6/bin/convert"))
   "Name of conversion program for thumbnails generation.
-It must be 'convert'."
+It must be \"convert\"."
   :type 'string
   :group 'thumbs)
 
diff --git a/lisp/url/url-auth.el b/lisp/url/url-auth.el
index 58bf45b..64f56f0 100644
--- a/lisp/url/url-auth.el
+++ b/lisp/url/url-auth.el
@@ -262,12 +262,12 @@ URL    is the url you are requesting authorization to.  
This can be either a
        string representing the URL, or the parsed representation returned by
        `url-generic-parse-url'
 REALM  is the realm at a specific site we are looking for.  This should be a
-       string specifying the exact realm, or nil or the symbol 'any' to
+       string specifying the exact realm, or nil or the symbol `any' to
        specify that the filename portion of the URL should be used as the
        realm
 TYPE   is the type of authentication to be returned.  This is either a string
-       representing the type (basic, digest, etc), or nil or the symbol 'any'
-       to specify that any authentication is acceptable.  If requesting 'any'
+       representing the type (basic, digest, etc), or nil or the symbol `any'
+       to specify that any authentication is acceptable.  If requesting `any'
        the strongest matching authentication will be returned.  If this is
        wrong, it's no big deal, the error from the server will specify exactly
        what type of auth to use
diff --git a/lisp/window.el b/lisp/window.el
index ebe7054..c783b0d 100644
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -5596,18 +5596,18 @@ windows can get as small as `window-safe-min-height' and
 (defun display-buffer-record-window (type window buffer)
   "Record information for window used by `display-buffer'.
 TYPE specifies the type of the calling operation and must be one
-of the symbols 'reuse (when WINDOW existed already and was
-reused for displaying BUFFER), 'window (when WINDOW was created
-on an already existing frame), or 'frame (when WINDOW was
+of the symbols `reuse' (when WINDOW existed already and was
+reused for displaying BUFFER), `window' (when WINDOW was created
+on an already existing frame), or `frame' (when WINDOW was
 created on a new frame).  WINDOW is the window used for or created
 by the `display-buffer' routines.  BUFFER is the buffer that
 shall be displayed.
 
 This function installs or updates the quit-restore parameter of
 WINDOW.  The quit-restore parameter is a list of four elements:
-The first element is one of the symbols 'window, 'frame, 'same or
-'other.  The second element is either one of the symbols 'window
-or 'frame or a list whose elements are the buffer previously
+The first element is one of the symbols `window', `frame', `same' or
+`other'.  The second element is either one of the symbols `window'
+or `frame' or a list whose elements are the buffer previously
 shown in the window, that buffer's window start and window point,
 and the window's height.  The third element is the window
 selected at the time the parameter was created.  The fourth
diff --git a/lisp/xml.el b/lisp/xml.el
index b3dce41..f5a9a3f 100644
--- a/lisp/xml.el
+++ b/lisp/xml.el
@@ -326,8 +326,8 @@ URIs, and expanded names will be returned as a cons
 If PARSE-NS is an alist, it will be used as the mapping from
 namespace to URIs instead.
 
-If it is the symbol 'symbol-qnames, expanded names will be
-returned as a plain symbol 'namespace:foo instead of a cons.
+If it is the symbol `symbol-qnames', expanded names will be
+returned as a plain symbol `namespace:foo' instead of a cons.
 
 Both features can be combined by providing a cons cell
 
@@ -356,8 +356,8 @@ URIs, and expanded names will be returned as a cons
 If PARSE-NS is an alist, it will be used as the mapping from
 namespace to URIs instead.
 
-If it is the symbol 'symbol-qnames, expanded names will be
-returned as a plain symbol 'namespace:foo instead of a cons.
+If it is the symbol `symbol-qnames', expanded names will be
+returned as a plain symbol `namespace:foo' instead of a cons.
 
 Both features can be combined by providing a cons cell
 
diff --git a/src/buffer.c b/src/buffer.c
index bd7c82c..fb1502a 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5540,12 +5540,12 @@ This is the same as (default-value 
'indicate-buffer-boundaries).  */);
   DEFVAR_BUFFER_DEFAULTS ("default-fringe-indicator-alist",
                          fringe_indicator_alist,
                          doc: /* Default value of `fringe-indicator-alist' for 
buffers that don't override it.
-This is the same as (default-value 'fringe-indicator-alist').  */);
+This is the same as (default-value 'fringe-indicator-alist).  */);
 
   DEFVAR_BUFFER_DEFAULTS ("default-fringe-cursor-alist",
                          fringe_cursor_alist,
                          doc: /* Default value of `fringe-cursor-alist' for 
buffers that don't override it.
-This is the same as (default-value 'fringe-cursor-alist').  */);
+This is the same as (default-value 'fringe-cursor-alist).  */);
 
   DEFVAR_BUFFER_DEFAULTS ("default-scroll-up-aggressively",
                          scroll_up_aggressively,
diff --git a/src/gfilenotify.c b/src/gfilenotify.c
index 08713a8..5488fa3 100644
--- a/src/gfilenotify.c
+++ b/src/gfilenotify.c
@@ -119,9 +119,9 @@ watched for some reason, this function signals a 
`file-notify-error' error.
 FLAGS is a list of conditions to set what will be watched for.  It can
 include the following symbols:
 
-  'watch-mounts' -- watch for mount events
-  'send-moved'   -- pair 'deleted' and 'created' events caused by file
-                    renames and send a single 'renamed' event instead
+  `watch-mounts' -- watch for mount events
+  `send-moved'   -- pair `deleted' and `created' events caused by file
+                    renames and send a single `renamed' event instead
 
 When any event happens, Emacs will call the CALLBACK function passing
 it a single argument EVENT, which is of the form
@@ -132,18 +132,18 @@ DESCRIPTOR is the same object as the one returned by this 
function.
 ACTION is the description of the event.  It could be any one of the
 following:
 
-  'changed'           -- FILE has changed
-  'changes-done-hint' -- a hint that this was probably the last change
+  `changed'           -- FILE has changed
+  `changes-done-hint' -- a hint that this was probably the last change
                          in a set of changes
-  'deleted'           -- FILE was deleted
-  'created'           -- FILE was created
-  'attribute-changed' -- a FILE attribute was changed
-  'pre-unmount'       -- the FILE location will soon be unmounted
-  'unmounted'         -- the FILE location was unmounted
-  'moved'             -- FILE was moved to FILE1
+  `deleted'           -- FILE was deleted
+  `created'           -- FILE was created
+  `attribute-changed' -- a FILE attribute was changed
+  `pre-unmount'       -- the FILE location will soon be unmounted
+  `unmounted'         -- the FILE location was unmounted
+  `moved'             -- FILE was moved to FILE1
 
 FILE is the name of the file whose event is being reported.  FILE1
-will be reported only in case of the 'moved' event.  */)
+will be reported only in case of the `moved' event.  */)
   (Lisp_Object file, Lisp_Object flags, Lisp_Object callback)
 {
   Lisp_Object watch_object;



reply via email to

[Prev in Thread] Current Thread [Next in Thread]