aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorPaul Eggert2015-09-07 08:41:44 -0700
committerPaul Eggert2015-09-07 16:09:27 -0700
commit6afef3f6ca2f3009c722b84e249903b7f807b044 (patch)
tree44bdc5bb1e8fb4d1fe66961490db57cbdf56d7a2 /doc
parentadd49b65a0bb50de447a95c1912232c79f28fdf9 (diff)
downloademacs-6afef3f6ca2f3009c722b84e249903b7f807b044.tar.gz
emacs-6afef3f6ca2f3009c722b84e249903b7f807b044.zip
Go back to grave quoting in source-code docstrings etc.
This reverts almost all my recent changes to use curved quotes in docstrings and/or strings used for error diagnostics. There are a few exceptions, e.g., Bahá’í proper names. * admin/unidata/unidata-gen.el (unidata-gen-table): * lisp/abbrev.el (expand-region-abbrevs): * lisp/align.el (align-region): * lisp/allout.el (allout-mode, allout-solicit-alternate-bullet) (outlineify-sticky): * lisp/apropos.el (apropos-library): * lisp/bookmark.el (bookmark-default-annotation-text): * lisp/button.el (button-category-symbol, button-put) (make-text-button): * lisp/calc/calc-aent.el (math-read-if, math-read-factor): * lisp/calc/calc-embed.el (calc-do-embedded): * lisp/calc/calc-ext.el (calc-user-function-list): * lisp/calc/calc-graph.el (calc-graph-show-dumb): * lisp/calc/calc-help.el (calc-describe-key) (calc-describe-thing, calc-full-help): * lisp/calc/calc-lang.el (calc-c-language) (math-parse-fortran-vector-end, math-parse-tex-sum) (math-parse-eqn-matrix, math-parse-eqn-prime) (calc-yacas-language, calc-maxima-language, calc-giac-language) (math-read-giac-subscr, math-read-math-subscr) (math-read-big-rec, math-read-big-balance): * lisp/calc/calc-misc.el (calc-help, report-calc-bug): * lisp/calc/calc-mode.el (calc-auto-why, calc-save-modes) (calc-auto-recompute): * lisp/calc/calc-prog.el (calc-fix-token-name) (calc-read-parse-table-part, calc-user-define-invocation) (math-do-arg-check): * lisp/calc/calc-store.el (calc-edit-variable): * lisp/calc/calc-units.el (math-build-units-table-buffer): * lisp/calc/calc-vec.el (math-read-brackets): * lisp/calc/calc-yank.el (calc-edit-mode): * lisp/calc/calc.el (calc, calc-do, calc-user-invocation): * lisp/calendar/appt.el (appt-display-message): * lisp/calendar/diary-lib.el (diary-check-diary-file) (diary-mail-entries, diary-from-outlook): * lisp/calendar/icalendar.el (icalendar-export-region) (icalendar--convert-float-to-ical) (icalendar--convert-date-to-ical) (icalendar--convert-ical-to-diary) (icalendar--convert-recurring-to-diary) (icalendar--add-diary-entry): * lisp/calendar/time-date.el (format-seconds): * lisp/calendar/timeclock.el (timeclock-mode-line-display) (timeclock-make-hours-explicit, timeclock-log-data): * lisp/calendar/todo-mode.el (todo-prefix, todo-delete-category) (todo-item-mark, todo-check-format) (todo-insert-item--next-param, todo-edit-item--next-key) (todo-mode): * lisp/cedet/ede/pmake.el (ede-proj-makefile-insert-dist-rules): * lisp/cedet/mode-local.el (describe-mode-local-overload) (mode-local-print-binding, mode-local-describe-bindings-2): * lisp/cedet/semantic/complete.el (semantic-displayor-show-request): * lisp/cedet/srecode/srt-mode.el (srecode-macro-help): * lisp/cus-start.el (standard): * lisp/cus-theme.el (describe-theme-1): * lisp/custom.el (custom-add-dependencies, custom-check-theme) (custom--sort-vars-1, load-theme): * lisp/descr-text.el (describe-text-properties-1, describe-char): * lisp/dired-x.el (dired-do-run-mail): * lisp/dired.el (dired-log): * lisp/emacs-lisp/advice.el (ad-read-advised-function) (ad-read-advice-class, ad-read-advice-name, ad-enable-advice) (ad-disable-advice, ad-remove-advice, ad-set-argument) (ad-set-arguments, ad--defalias-fset, ad-activate) (ad-deactivate): * lisp/emacs-lisp/byte-opt.el (byte-compile-inline-expand) (byte-compile-unfold-lambda, byte-optimize-form-code-walker) (byte-optimize-while, byte-optimize-apply): * lisp/emacs-lisp/byte-run.el (defun, defsubst): * lisp/emacs-lisp/bytecomp.el (byte-compile-lapcode) (byte-compile-log-file, byte-compile-format-warn) (byte-compile-nogroup-warn, byte-compile-arglist-warn) (byte-compile-cl-warn) (byte-compile-warn-about-unresolved-functions) (byte-compile-file, byte-compile--declare-var) (byte-compile-file-form-defmumble, byte-compile-form) (byte-compile-normal-call, byte-compile-check-variable) (byte-compile-variable-ref, byte-compile-variable-set) (byte-compile-subr-wrong-args, byte-compile-setq-default) (byte-compile-negation-optimizer) (byte-compile-condition-case--old) (byte-compile-condition-case--new, byte-compile-save-excursion) (byte-compile-defvar, byte-compile-autoload) (byte-compile-lambda-form) (byte-compile-make-variable-buffer-local, display-call-tree) (batch-byte-compile): * lisp/emacs-lisp/cconv.el (cconv-convert, cconv--analyze-use): * lisp/emacs-lisp/chart.el (chart-space-usage): * lisp/emacs-lisp/check-declare.el (check-declare-scan) (check-declare-warn, check-declare-file) (check-declare-directory): * lisp/emacs-lisp/checkdoc.el (checkdoc-this-string-valid-engine) (checkdoc-message-text-engine): * lisp/emacs-lisp/cl-extra.el (cl-parse-integer) (cl--describe-class): * lisp/emacs-lisp/cl-generic.el (cl-defgeneric) (cl--generic-describe, cl-generic-generalizers): * lisp/emacs-lisp/cl-macs.el (cl--parse-loop-clause, cl-tagbody) (cl-symbol-macrolet): * lisp/emacs-lisp/cl.el (cl-unload-function, flet): * lisp/emacs-lisp/copyright.el (copyright) (copyright-update-directory): * lisp/emacs-lisp/edebug.el (edebug-read-list): * lisp/emacs-lisp/eieio-base.el (eieio-persistent-read): * lisp/emacs-lisp/eieio-core.el (eieio--slot-override) (eieio-oref): * lisp/emacs-lisp/eieio-opt.el (eieio-help-constructor): * lisp/emacs-lisp/eieio-speedbar.el: (eieio-speedbar-child-make-tag-lines) (eieio-speedbar-child-description): * lisp/emacs-lisp/eieio.el (defclass, change-class): * lisp/emacs-lisp/elint.el (elint-file, elint-get-top-forms) (elint-init-form, elint-check-defalias-form) (elint-check-let-form): * lisp/emacs-lisp/ert.el (ert-get-test, ert-results-mode-menu) (ert-results-pop-to-backtrace-for-test-at-point) (ert-results-pop-to-messages-for-test-at-point) (ert-results-pop-to-should-forms-for-test-at-point) (ert-describe-test): * lisp/emacs-lisp/find-func.el (find-function-search-for-symbol) (find-function-library): * lisp/emacs-lisp/generator.el (iter-yield): * lisp/emacs-lisp/gv.el (gv-define-simple-setter): * lisp/emacs-lisp/lisp-mnt.el (lm-verify): * lisp/emacs-lisp/macroexp.el (macroexp--obsolete-warning): * lisp/emacs-lisp/map-ynp.el (map-y-or-n-p): * lisp/emacs-lisp/nadvice.el (advice--make-docstring) (advice--make, define-advice): * lisp/emacs-lisp/package-x.el (package-upload-file): * lisp/emacs-lisp/package.el (package-version-join) (package-disabled-p, package-activate-1, package-activate) (package--download-one-archive) (package--download-and-read-archives) (package-compute-transaction, package-install-from-archive) (package-install, package-install-selected-packages) (package-delete, package-autoremove, describe-package-1) (package-install-button-action, package-delete-button-action) (package-menu-hide-package, package-menu--list-to-prompt) (package-menu--perform-transaction) (package-menu--find-and-notify-upgrades): * lisp/emacs-lisp/pcase.el (pcase-exhaustive, pcase--u1): * lisp/emacs-lisp/re-builder.el (reb-enter-subexp-mode): * lisp/emacs-lisp/ring.el (ring-previous, ring-next): * lisp/emacs-lisp/rx.el (rx-check, rx-anything) (rx-check-any-string, rx-check-any, rx-check-not, rx-=) (rx-repeat, rx-check-backref, rx-syntax, rx-check-category) (rx-form): * lisp/emacs-lisp/smie.el (smie-config-save): * lisp/emacs-lisp/subr-x.el (internal--check-binding): * lisp/emacs-lisp/tabulated-list.el (tabulated-list-put-tag): * lisp/emacs-lisp/testcover.el (testcover-1value): * lisp/emacs-lisp/timer.el (timer-event-handler): * lisp/emulation/viper-cmd.el (viper-toggle-parse-sexp-ignore-comments) (viper-toggle-search-style, viper-kill-buffer) (viper-brac-function): * lisp/emulation/viper-macs.el (viper-record-kbd-macro): * lisp/env.el (setenv): * lisp/erc/erc-button.el (erc-nick-popup): * lisp/erc/erc.el (erc-cmd-LOAD, erc-handle-login, english): * lisp/eshell/em-dirs.el (eshell/cd): * lisp/eshell/em-glob.el (eshell-glob-regexp) (eshell-glob-entries): * lisp/eshell/em-pred.el (eshell-parse-modifiers): * lisp/eshell/esh-opt.el (eshell-show-usage): * lisp/facemenu.el (facemenu-add-new-face) (facemenu-add-new-color): * lisp/faces.el (read-face-name, read-face-font, describe-face) (x-resolve-font-name): * lisp/files-x.el (modify-file-local-variable): * lisp/files.el (locate-user-emacs-file, find-alternate-file) (set-auto-mode, hack-one-local-variable--obsolete) (dir-locals-set-directory-class, write-file, basic-save-buffer) (delete-directory, copy-directory, recover-session) (recover-session-finish, insert-directory) (file-modes-char-to-who, file-modes-symbolic-to-number) (move-file-to-trash): * lisp/filesets.el (filesets-add-buffer, filesets-remove-buffer): * lisp/find-cmd.el (find-generic, find-to-string): * lisp/finder.el (finder-commentary): * lisp/font-lock.el (font-lock-fontify-buffer): * lisp/format.el (format-write-file, format-find-file) (format-insert-file): * lisp/frame.el (get-device-terminal, select-frame-by-name): * lisp/fringe.el (fringe--check-style): * lisp/gnus/nnmairix.el (nnmairix-widget-create-query): * lisp/help-fns.el (help-fns--key-bindings) (help-fns--compiler-macro, help-fns--parent-mode) (help-fns--obsolete, help-fns--interactive-only) (describe-function-1, describe-variable): * lisp/help.el (describe-mode) (describe-minor-mode-from-indicator): * lisp/image.el (image-type): * lisp/international/ccl.el (ccl-dump): * lisp/international/fontset.el (x-must-resolve-font-name): * lisp/international/mule-cmds.el (prefer-coding-system) (select-safe-coding-system-interactively) (select-safe-coding-system, activate-input-method) (toggle-input-method, describe-current-input-method) (describe-language-environment): * lisp/international/mule-conf.el (code-offset): * lisp/international/mule-diag.el (describe-character-set) (list-input-methods-1): * lisp/mail/feedmail.el (feedmail-run-the-queue): * lisp/mouse.el (minor-mode-menu-from-indicator): * lisp/mpc.el (mpc-playlist-rename): * lisp/msb.el (msb--choose-menu): * lisp/net/ange-ftp.el (ange-ftp-shell-command): * lisp/net/imap.el (imap-interactive-login): * lisp/net/mairix.el (mairix-widget-create-query): * lisp/net/newst-backend.el (newsticker--sentinel-work): * lisp/net/newst-treeview.el (newsticker--treeview-load): * lisp/net/rlogin.el (rlogin): * lisp/obsolete/iswitchb.el (iswitchb-possible-new-buffer): * lisp/obsolete/otodo-mode.el (todo-more-important-p): * lisp/obsolete/pgg-gpg.el (pgg-gpg-process-region): * lisp/obsolete/pgg-pgp.el (pgg-pgp-process-region): * lisp/obsolete/pgg-pgp5.el (pgg-pgp5-process-region): * lisp/org/ob-core.el (org-babel-goto-named-src-block) (org-babel-goto-named-result): * lisp/org/ob-fortran.el (org-babel-fortran-ensure-main-wrap): * lisp/org/ob-ref.el (org-babel-ref-resolve): * lisp/org/org-agenda.el (org-agenda-prepare): * lisp/org/org-clock.el (org-clock-notify-once-if-expired) (org-clock-resolve): * lisp/org/org-ctags.el (org-ctags-ask-rebuild-tags-file-then-find-tag): * lisp/org/org-feed.el (org-feed-parse-atom-entry): * lisp/org/org-habit.el (org-habit-parse-todo): * lisp/org/org-mouse.el (org-mouse-popup-global-menu) (org-mouse-context-menu): * lisp/org/org-table.el (org-table-edit-formulas): * lisp/org/ox.el (org-export-async-start): * lisp/proced.el (proced-log): * lisp/progmodes/ada-mode.el (ada-get-indent-case) (ada-check-matching-start, ada-goto-matching-start): * lisp/progmodes/ada-prj.el (ada-prj-display-page): * lisp/progmodes/ada-xref.el (ada-find-executable): * lisp/progmodes/ebrowse.el (ebrowse-tags-apropos): * lisp/progmodes/etags.el (etags-tags-apropos-additional): * lisp/progmodes/flymake.el (flymake-parse-err-lines) (flymake-start-syntax-check-process): * lisp/progmodes/python.el (python-shell-get-process-or-error) (python-define-auxiliary-skeleton): * lisp/progmodes/sql.el (sql-comint): * lisp/progmodes/verilog-mode.el (verilog-load-file-at-point): * lisp/progmodes/vhdl-mode.el (vhdl-widget-directory-validate): * lisp/recentf.el (recentf-open-files): * lisp/replace.el (query-replace-read-from) (occur-after-change-function, occur-1): * lisp/scroll-bar.el (scroll-bar-columns): * lisp/server.el (server-get-auth-key): * lisp/simple.el (execute-extended-command) (undo-outer-limit-truncate, list-processes--refresh) (compose-mail, set-variable, choose-completion-string) (define-alternatives): * lisp/startup.el (site-run-file, tty-handle-args, command-line) (command-line-1): * lisp/subr.el (noreturn, define-error, add-to-list) (read-char-choice, version-to-list): * lisp/term/common-win.el (x-handle-xrm-switch) (x-handle-name-switch, x-handle-args): * lisp/term/x-win.el (x-handle-parent-id, x-handle-smid): * lisp/textmodes/reftex-ref.el (reftex-label): * lisp/textmodes/reftex-toc.el (reftex-toc-rename-label): * lisp/textmodes/two-column.el (2C-split): * lisp/tutorial.el (tutorial--describe-nonstandard-key) (tutorial--find-changed-keys): * lisp/type-break.el (type-break-noninteractive-query): * lisp/wdired.el (wdired-do-renames, wdired-do-symlink-changes) (wdired-do-perm-changes): * lisp/whitespace.el (whitespace-report-region): Prefer grave quoting in source-code strings used to generate help and diagnostics. * lisp/faces.el (face-documentation): No need to convert quotes, since the result is a docstring. * lisp/info.el (Info-virtual-index-find-node) (Info-virtual-index, info-apropos): Simplify by generating only curved quotes, since info files are typically that ways nowadays anyway. * lisp/international/mule-diag.el (list-input-methods): Don’t assume text quoting style is curved. * lisp/org/org-bibtex.el (org-bibtex-fields): Revert my recent changes, going back to the old quoting style.
Diffstat (limited to 'doc')
-rw-r--r--doc/lispintro/emacs-lisp-intro.texi36
-rw-r--r--doc/lispref/control.texi2
-rw-r--r--doc/lispref/functions.texi4
-rw-r--r--doc/lispref/help.texi4
-rw-r--r--doc/lispref/modes.texi14
-rw-r--r--doc/lispref/os.texi2
-rw-r--r--doc/lispref/processes.texi4
-rw-r--r--doc/lispref/strings.texi16
-rw-r--r--doc/lispref/text.texi2
-rw-r--r--doc/lispref/tips.texi8
-rw-r--r--doc/misc/ede.texi6
-rw-r--r--doc/misc/efaq.texi2
-rw-r--r--doc/misc/eieio.texi2
-rw-r--r--doc/misc/gnus-faq.texi8
-rw-r--r--doc/misc/gnus.texi6
-rw-r--r--doc/misc/rcirc.texi2
16 files changed, 59 insertions, 59 deletions
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi
index 5ad5f267857..d353241c34a 100644
--- a/doc/lispintro/emacs-lisp-intro.texi
+++ b/doc/lispintro/emacs-lisp-intro.texi
@@ -9268,7 +9268,7 @@ documentation string. For example:
9268@smallexample 9268@smallexample
9269@group 9269@group
9270(defvar shell-command-default-error-buffer nil 9270(defvar shell-command-default-error-buffer nil
9271 "*Buffer name for shell-command @dots{} error output. 9271 "*Buffer name for `shell-command' @dots{} error output.
9272@dots{} ") 9272@dots{} ")
9273@end group 9273@end group
9274@end smallexample 9274@end smallexample
@@ -11107,7 +11107,7 @@ up the number of pebbles in a triangle.
11107@smallexample 11107@smallexample
11108@group 11108@group
11109(defun triangle-using-dotimes (number-of-rows) 11109(defun triangle-using-dotimes (number-of-rows)
11110 "Using dotimes, add up the number of pebbles in a triangle." 11110 "Using `dotimes', add up the number of pebbles in a triangle."
11111(let ((total 0)) ; otherwise a total is a void variable 11111(let ((total 0)) ; otherwise a total is a void variable
11112 (dotimes (number number-of-rows total) 11112 (dotimes (number number-of-rows total)
11113 (setq total (+ total (1+ number)))))) 11113 (setq total (+ total (1+ number))))))
@@ -13514,8 +13514,8 @@ For example:
13514@smallexample 13514@smallexample
13515@group 13515@group
13516(let* ((foo 7) 13516(let* ((foo 7)
13517 (bar (* 3 foo))) 13517 (bar (* 3 foo)))
13518 (message "bar is %d." bar)) 13518 (message "`bar' is %d." bar))
13519 @result{} ‘bar’ is 21. 13519 @result{} ‘bar’ is 21.
13520@end group 13520@end group
13521@end smallexample 13521@end smallexample
@@ -13758,7 +13758,7 @@ All this leads to the following function definition:
13758 "Print number of words in the region. 13758 "Print number of words in the region.
13759Words are defined as at least one word-constituent 13759Words are defined as at least one word-constituent
13760character followed by at least one character that 13760character followed by at least one character that
13761is not a word-constituent. The buffers syntax 13761is not a word-constituent. The buffer's syntax
13762table determines which characters these are." 13762table determines which characters these are."
13763 (interactive "r") 13763 (interactive "r")
13764 (message "Counting words in region ... ") 13764 (message "Counting words in region ... ")
@@ -13825,7 +13825,7 @@ parenthesis and type @kbd{C-x C-e} to install it.
13825(defun @value{COUNT-WORDS} (beginning end) 13825(defun @value{COUNT-WORDS} (beginning end)
13826 "Print number of words in the region. 13826 "Print number of words in the region.
13827Words are defined as at least one word-constituent character followed 13827Words are defined as at least one word-constituent character followed
13828by at least one character that is not a word-constituent. The buffers 13828by at least one character that is not a word-constituent. The buffer's
13829syntax table determines which characters these are." 13829syntax table determines which characters these are."
13830@end group 13830@end group
13831@group 13831@group
@@ -14987,13 +14987,13 @@ beginning of the file. The function definition looks like this:
14987@smallexample 14987@smallexample
14988@group 14988@group
14989(defun lengths-list-file (filename) 14989(defun lengths-list-file (filename)
14990 "Return list of definitions lengths within FILE. 14990 "Return list of definitions' lengths within FILE.
14991The returned list is a list of numbers. 14991The returned list is a list of numbers.
14992Each number is the number of words or 14992Each number is the number of words or
14993symbols in one function definition." 14993symbols in one function definition."
14994@end group 14994@end group
14995@group 14995@group
14996 (message "Working on %s ... " filename) 14996 (message "Working on `%s' ... " filename)
14997 (save-excursion 14997 (save-excursion
14998 (let ((buffer (find-file-noselect filename)) 14998 (let ((buffer (find-file-noselect filename))
14999 (lengths-list)) 14999 (lengths-list))
@@ -15759,7 +15759,7 @@ simpler to write a list manually. Here it is:
15759 160 170 180 190 200 15759 160 170 180 190 200
15760 210 220 230 240 250 15760 210 220 230 240 250
15761 260 270 280 290 300) 15761 260 270 280 290 300)
15762 "List specifying ranges for defuns-per-range.") 15762 "List specifying ranges for `defuns-per-range'.")
15763@end group 15763@end group
15764@end smallexample 15764@end smallexample
15765 15765
@@ -19943,7 +19943,7 @@ row, and the value of the width of the top line, which is calculated
19943@group 19943@group
19944(defun Y-axis-element (number full-Y-label-width) 19944(defun Y-axis-element (number full-Y-label-width)
19945 "Construct a NUMBERed label element. 19945 "Construct a NUMBERed label element.
19946A numbered element looks like this 5 - , 19946A numbered element looks like this ` 5 - ',
19947and is padded as needed so all line up with 19947and is padded as needed so all line up with
19948the element for the largest number." 19948the element for the largest number."
19949@end group 19949@end group
@@ -20044,7 +20044,7 @@ the @code{print-Y-axis} function, which inserts the list as a column.
20044Height must be the maximum height of the graph. 20044Height must be the maximum height of the graph.
20045Full width is the width of the highest label element." 20045Full width is the width of the highest label element."
20046;; Value of height and full-Y-label-width 20046;; Value of height and full-Y-label-width
20047;; are passed by print-graph. 20047;; are passed by print-graph.
20048@end group 20048@end group
20049@group 20049@group
20050 (let ((start (point))) 20050 (let ((start (point)))
@@ -21169,7 +21169,7 @@ each column."
21169@end group 21169@end group
21170@group 21170@group
21171;; Value of symbol-width and full-Y-label-width 21171;; Value of symbol-width and full-Y-label-width
21172;; are passed by print-graph. 21172;; are passed by print-graph.
21173 (let* ((leading-spaces 21173 (let* ((leading-spaces
21174 (make-string full-Y-label-width ? )) 21174 (make-string full-Y-label-width ? ))
21175 ;; symbol-width @r{is provided by} graph-body-print 21175 ;; symbol-width @r{is provided by} graph-body-print
@@ -21269,7 +21269,7 @@ Here are all the graphing definitions in their final form:
21269 110 120 130 140 150 21269 110 120 130 140 150
21270 160 170 180 190 200 21270 160 170 180 190 200
21271 210 220 230 240 250) 21271 210 220 230 240 250)
21272 "List specifying ranges for defuns-per-range.") 21272 "List specifying ranges for `defuns-per-range'.")
21273@end group 21273@end group
21274 21274
21275@group 21275@group
@@ -21330,14 +21330,14 @@ as graph-symbol.")
21330@smallexample 21330@smallexample
21331@group 21331@group
21332(defun lengths-list-file (filename) 21332(defun lengths-list-file (filename)
21333 "Return list of definitions lengths within FILE. 21333 "Return list of definitions' lengths within FILE.
21334The returned list is a list of numbers. 21334The returned list is a list of numbers.
21335Each number is the number of words or 21335Each number is the number of words or
21336symbols in one function definition." 21336symbols in one function definition."
21337@end group 21337@end group
21338 21338
21339@group 21339@group
21340 (message "Working on %s ... " filename) 21340 (message "Working on `%s' ... " filename)
21341 (save-excursion 21341 (save-excursion
21342 (let ((buffer (find-file-noselect filename)) 21342 (let ((buffer (find-file-noselect filename))
21343 (lengths-list)) 21343 (lengths-list))
@@ -21467,7 +21467,7 @@ The strings are either graph-blank or graph-symbol."
21467@group 21467@group
21468(defun Y-axis-element (number full-Y-label-width) 21468(defun Y-axis-element (number full-Y-label-width)
21469 "Construct a NUMBERed label element. 21469 "Construct a NUMBERed label element.
21470A numbered element looks like this 5 - , 21470A numbered element looks like this ` 5 - ',
21471and is padded as needed so all line up with 21471and is padded as needed so all line up with
21472the element for the largest number." 21472the element for the largest number."
21473@end group 21473@end group
@@ -21497,7 +21497,7 @@ Optionally, print according to VERTICAL-STEP."
21497@end group 21497@end group
21498@group 21498@group
21499;; Value of height and full-Y-label-width 21499;; Value of height and full-Y-label-width
21500;; are passed by print-graph. 21500;; are passed by 'print-graph'.
21501 (let ((start (point))) 21501 (let ((start (point)))
21502 (insert-rectangle 21502 (insert-rectangle
21503 (Y-axis-column height full-Y-label-width vertical-step)) 21503 (Y-axis-column height full-Y-label-width vertical-step))
@@ -21662,7 +21662,7 @@ each column."
21662@end group 21662@end group
21663@group 21663@group
21664;; Value of symbol-width and full-Y-label-width 21664;; Value of symbol-width and full-Y-label-width
21665;; are passed by print-graph. 21665;; are passed by 'print-graph'.
21666 (let* ((leading-spaces 21666 (let* ((leading-spaces
21667 (make-string full-Y-label-width ? )) 21667 (make-string full-Y-label-width ? ))
21668 ;; symbol-width @r{is provided by} graph-body-print 21668 ;; symbol-width @r{is provided by} graph-body-print
diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi
index 29d1bd588e3..421f5cc530f 100644
--- a/doc/lispref/control.texi
+++ b/doc/lispref/control.texi
@@ -315,7 +315,7 @@ between a few different constant values:
315@example 315@example
316(pcase (get-return-code x) 316(pcase (get-return-code x)
317 (`success (message "Done!")) 317 (`success (message "Done!"))
318 (`would-block (message "Sorry, cant do it now")) 318 (`would-block (message "Sorry, can't do it now"))
319 (`read-only (message "The shmliblick is read-only")) 319 (`read-only (message "The shmliblick is read-only"))
320 (`access-denied (message "You do not have the needed rights")) 320 (`access-denied (message "You do not have the needed rights"))
321 (code (message "Unknown return code %S" code))) 321 (code (message "Unknown return code %S" code)))
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index 20eaf5dee1e..a853d2fbab5 100644
--- a/doc/lispref/functions.texi
+++ b/doc/lispref/functions.texi
@@ -1561,7 +1561,7 @@ Around advice such as:
1561 1561
1562@example 1562@example
1563(defadvice foo (around foo-around) 1563(defadvice foo (around foo-around)
1564 "Ignore case in foo." 1564 "Ignore case in `foo'."
1565 (let ((case-fold-search t)) 1565 (let ((case-fold-search t))
1566 ad-do-it)) 1566 ad-do-it))
1567(ad-activate 'foo) 1567(ad-activate 'foo)
@@ -1571,7 +1571,7 @@ could translate into:
1571 1571
1572@example 1572@example
1573(defun foo--foo-around (orig-fun &rest args) 1573(defun foo--foo-around (orig-fun &rest args)
1574 "Ignore case in foo." 1574 "Ignore case in `foo'."
1575 (let ((case-fold-search t)) 1575 (let ((case-fold-search t))
1576 (apply orig-fun args))) 1576 (apply orig-fun args)))
1577(advice-add 'foo :around #'foo--foo-around) 1577(advice-add 'foo :around #'foo--foo-around)
diff --git a/doc/lispref/help.texi b/doc/lispref/help.texi
index 89339ffe575..b3042d747b4 100644
--- a/doc/lispref/help.texi
+++ b/doc/lispref/help.texi
@@ -377,7 +377,7 @@ specifies a key binding that the command does not actually have.
377@smallexample 377@smallexample
378@group 378@group
379(substitute-command-keys 379(substitute-command-keys
380 "To abort recursive edit, type \\[abort-recursive-edit].") 380 "To abort recursive edit, type `\\[abort-recursive-edit]'.")
381@result{} "To abort recursive edit, type ‘C-]’." 381@result{} "To abort recursive edit, type ‘C-]’."
382@end group 382@end group
383 383
@@ -398,7 +398,7 @@ C-g abort-recursive-edit
398 398
399@group 399@group
400(substitute-command-keys 400(substitute-command-keys
401 "To abort a recursive edit from the minibuffer, type\ 401 "To abort a recursive edit from the minibuffer, type \
402`\\<minibuffer-local-must-match-map>\\[abort-recursive-edit]'.") 402`\\<minibuffer-local-must-match-map>\\[abort-recursive-edit]'.")
403@result{} "To abort a recursive edit from the minibuffer, type ‘C-g’." 403@result{} "To abort a recursive edit from the minibuffer, type ‘C-g’."
404@end group 404@end group
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index f00e481275f..a8b6bb19c5f 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -1155,9 +1155,9 @@ Many other modes, such as `mail-mode', `outline-mode' and
1155 "Major mode for editing text written for humans to read. 1155 "Major mode for editing text written for humans to read.
1156In this mode, paragraphs are delimited only by blank or white lines. 1156In this mode, paragraphs are delimited only by blank or white lines.
1157You can thus get the full benefit of adaptive filling 1157You can thus get the full benefit of adaptive filling
1158 (see the variable adaptive-fill-mode). 1158 (see the variable `adaptive-fill-mode').
1159\\@{text-mode-map@} 1159\\@{text-mode-map@}
1160Turning on Text mode runs the normal hook text-mode-hook." 1160Turning on Text mode runs the normal hook `text-mode-hook'."
1161@end group 1161@end group
1162@group 1162@group
1163 (set (make-local-variable 'text-mode-variant) t) 1163 (set (make-local-variable 'text-mode-variant) t)
@@ -1252,7 +1252,7 @@ And here is the code to set up the keymap for Lisp mode:
1252 @dots{} 1252 @dots{}
1253 map) 1253 map)
1254 "Keymap for ordinary Lisp mode. 1254 "Keymap for ordinary Lisp mode.
1255All commands in lisp-mode-shared-map are inherited by this map.") 1255All commands in `lisp-mode-shared-map' are inherited by this map.")
1256@end group 1256@end group
1257@end smallexample 1257@end smallexample
1258 1258
@@ -1268,12 +1268,12 @@ Delete converts tabs to spaces as it moves back.
1268Blank lines separate paragraphs. Semicolons start comments. 1268Blank lines separate paragraphs. Semicolons start comments.
1269 1269
1270\\@{lisp-mode-map@} 1270\\@{lisp-mode-map@}
1271Note that run-lisp may be used either to start an inferior Lisp job 1271Note that `run-lisp' may be used either to start an inferior Lisp job
1272or to switch back to an existing one. 1272or to switch back to an existing one.
1273@end group 1273@end group
1274 1274
1275@group 1275@group
1276Entry to this mode calls the value of lisp-mode-hook 1276Entry to this mode calls the value of `lisp-mode-hook'
1277if that value is non-nil." 1277if that value is non-nil."
1278 (lisp-mode-variables nil t) 1278 (lisp-mode-variables nil t)
1279 (set (make-local-variable 'find-tag-default-function) 1279 (set (make-local-variable 'find-tag-default-function)
@@ -1447,7 +1447,7 @@ will load the library that defines the mode. For example:
1447(defcustom msb-mode nil 1447(defcustom msb-mode nil
1448 "Toggle msb-mode. 1448 "Toggle msb-mode.
1449Setting this variable directly does not take effect; 1449Setting this variable directly does not take effect;
1450use either \\[customize] or the function msb-mode." 1450use either \\[customize] or the function `msb-mode'."
1451 :set 'custom-set-minor-mode 1451 :set 'custom-set-minor-mode
1452 :initialize 'custom-initialize-default 1452 :initialize 'custom-initialize-default
1453 :version "20.4" 1453 :version "20.4"
@@ -1605,7 +1605,7 @@ for this macro.
1605Interactively with no argument, this command toggles the mode. 1605Interactively with no argument, this command toggles the mode.
1606A positive prefix argument enables the mode, any other prefix 1606A positive prefix argument enables the mode, any other prefix
1607argument disables it. From Lisp, argument omitted or nil enables 1607argument disables it. From Lisp, argument omitted or nil enables
1608the mode, toggle toggles the state. 1608the mode, `toggle' toggles the state.
1609 1609
1610When Hungry mode is enabled, the control delete key 1610When Hungry mode is enabled, the control delete key
1611gobbles all preceding whitespace except the last. 1611gobbles all preceding whitespace except the last.
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index f7d4117673a..6ef87dfbd53 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -1928,7 +1928,7 @@ idleness. Here's an example:
1928 1928
1929@example 1929@example
1930(defvar my-resume-timer nil 1930(defvar my-resume-timer nil
1931 "Timer for my-timer-function to reschedule itself, or nil.") 1931 "Timer for `my-timer-function' to reschedule itself, or nil.")
1932 1932
1933(defun my-timer-function () 1933(defun my-timer-function ()
1934 ;; @r{If the user types a command while @code{my-resume-timer}} 1934 ;; @r{If the user types a command while @code{my-resume-timer}}
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 98b3dfb9e3a..c9509b0f216 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -1720,13 +1720,13 @@ sentinel, the eventual call to the sentinel will use the new one.
1720@group 1720@group
1721(defun msg-me (process event) 1721(defun msg-me (process event)
1722 (princ 1722 (princ
1723 (format "Process: %s had the event %s" process event))) 1723 (format "Process: %s had the event '%s'" process event)))
1724(set-process-sentinel (get-process "shell") 'msg-me) 1724(set-process-sentinel (get-process "shell") 'msg-me)
1725 @result{} msg-me 1725 @result{} msg-me
1726@end group 1726@end group
1727@group 1727@group
1728(kill-process (get-process "shell")) 1728(kill-process (get-process "shell"))
1729 @print{} Process: #<process shell> had the event killed 1729 @print{} Process: #<process shell> had the event 'killed'
1730 @result{} #<process shell> 1730 @result{} #<process shell>
1731@end group 1731@end group
1732@end smallexample 1732@end smallexample
diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi
index 4a338931601..f42250719e5 100644
--- a/doc/lispref/strings.texi
+++ b/doc/lispref/strings.texi
@@ -969,12 +969,12 @@ is not truncated.
969 969
970@example 970@example
971@group 971@group
972(format "The word %7s has %d letters in it." 972(format "The word '%7s' has %d letters in it."
973 "foo" (length "foo")) 973 "foo" (length "foo"))
974 @result{} "The word foo has 3 letters in it." 974 @result{} "The word ' foo' has 3 letters in it."
975(format "The word %7s has %d letters in it." 975(format "The word '%7s' has %d letters in it."
976 "specification" (length "specification")) 976 "specification" (length "specification"))
977 @result{} "The word specification has 13 letters in it." 977 @result{} "The word 'specification' has 13 letters in it."
978@end group 978@end group
979@end example 979@end example
980 980
@@ -1013,12 +1013,12 @@ ignored.
1013(format "%06d is padded on the left with zeros" 123) 1013(format "%06d is padded on the left with zeros" 123)
1014 @result{} "000123 is padded on the left with zeros" 1014 @result{} "000123 is padded on the left with zeros"
1015 1015
1016(format "%-6d is padded on the right" 123) 1016(format "'%-6d' is padded on the right" 123)
1017 @result{} "123 is padded on the right" 1017 @result{} "'123 ' is padded on the right"
1018 1018
1019(format "The word %-7s actually has %d letters in it." 1019(format "The word '%-7s' actually has %d letters in it."
1020 "foo" (length "foo")) 1020 "foo" (length "foo"))
1021 @result{} "The word foo actually has 3 letters in it." 1021 @result{} "The word 'foo ' actually has 3 letters in it."
1022@end group 1022@end group
1023@end example 1023@end example
1024 1024
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 33044280175..55e550a7b80 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -1960,7 +1960,7 @@ Called from a program, there are three arguments:
1960@group 1960@group
1961REVERSE (non-nil means reverse order),\ 1961REVERSE (non-nil means reverse order),\
1962 BEG and END (region to sort). 1962 BEG and END (region to sort).
1963The variable sort-fold-case determines\ 1963The variable `sort-fold-case' determines\
1964 whether alphabetic case affects 1964 whether alphabetic case affects
1965the sort order." 1965the sort order."
1966@end group 1966@end group
diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi
index 7107bb45872..3bde0a877ab 100644
--- a/doc/lispref/tips.texi
+++ b/doc/lispref/tips.texi
@@ -689,7 +689,7 @@ immediately before the symbol name. (Case makes no difference in
689recognizing these indicator words.) For example, if you write 689recognizing these indicator words.) For example, if you write
690 690
691@example 691@example
692This function sets the variable buffer-file-name. 692This function sets the variable `buffer-file-name'.
693@end example 693@end example
694 694
695@noindent 695@noindent
@@ -702,7 +702,7 @@ you can write the words @samp{symbol} or @samp{program} before the
702symbol name to prevent making any hyperlink. For example, 702symbol name to prevent making any hyperlink. For example,
703 703
704@example 704@example
705If the argument KIND-OF-RESULT is the symbol list, 705If the argument KIND-OF-RESULT is the symbol `list',
706this function returns a list of all the objects 706this function returns a list of all the objects
707that satisfy the criterion. 707that satisfy the criterion.
708@end example 708@end example
@@ -727,7 +727,7 @@ name of the Info node (or anchor), preceded by
727anchor}. The Info file name defaults to @samp{emacs}. For example, 727anchor}. The Info file name defaults to @samp{emacs}. For example,
728 728
729@smallexample 729@smallexample
730See Info node Font Lock and Info node (elisp)Font Lock Basics. 730See Info node `Font Lock' and Info node `(elisp)Font Lock Basics'.
731@end smallexample 731@end smallexample
732 732
733Finally, to create a hyperlink to URLs, write the single-quoted URL, 733Finally, to create a hyperlink to URLs, write the single-quoted URL,
@@ -735,7 +735,7 @@ preceded by @samp{URL}. For example,
735 735
736@smallexample 736@smallexample
737The home page for the GNU project has more information (see URL 737The home page for the GNU project has more information (see URL
738http://www.gnu.org/). 738`http://www.gnu.org/').
739@end smallexample 739@end smallexample
740 740
741@item 741@item
diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi
index 565abb557e2..7a824acfed5 100644
--- a/doc/misc/ede.texi
+++ b/doc/misc/ede.texi
@@ -867,14 +867,14 @@ It would look like this:
867 ) 867 )
868 868
869(defun MY-ROOT-FCN () 869(defun MY-ROOT-FCN ()
870 "Return the root fcn for default-directory" 870 "Return the root fcn for `default-directory'"
871 ;; You might be able to use 'ede-cpp-root-project-root' 871 ;; You might be able to use 'ede-cpp-root-project-root'
872 ;; and not write this at all. 872 ;; and not write this at all.
873 ) 873 )
874 874
875(defun MY-LOAD (dir) 875(defun MY-LOAD (dir)
876 "Load a project of type cpp-root for the directory DIR. 876 "Load a project of type `cpp-root' for the directory DIR.
877Return nil if there isnt one." 877Return nil if there isn't one."
878 ;; Use your preferred construction method here. 878 ;; Use your preferred construction method here.
879 (ede-cpp-root-project "NAME" :file (expand-file-name "FILE" dir) 879 (ede-cpp-root-project "NAME" :file (expand-file-name "FILE" dir)
880 :locate-fcn 'MYFCN) 880 :locate-fcn 'MYFCN)
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index 75df1d41ff9..3e9109d0924 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -4336,7 +4336,7 @@ best fix I've been able to come up with:
4336 4336
4337@lisp 4337@lisp
4338(defun rmail-reply-t () 4338(defun rmail-reply-t ()
4339 "Reply only to the sender of the current message. (See rmail-reply.)" 4339 "Reply only to the sender of the current message. (See rmail-reply.)"
4340 (interactive) 4340 (interactive)
4341 (rmail-reply t)) 4341 (rmail-reply t))
4342 4342
diff --git a/doc/misc/eieio.texi b/doc/misc/eieio.texi
index 7cee5c30a1b..fb4e1470016 100644
--- a/doc/misc/eieio.texi
+++ b/doc/misc/eieio.texi
@@ -1529,7 +1529,7 @@ Currently, the default superclass is defined as follows:
1529 nil 1529 nil
1530 "Default parent class for classes with no specified parent class. 1530 "Default parent class for classes with no specified parent class.
1531Its slots are automatically adopted by classes with no specified 1531Its slots are automatically adopted by classes with no specified
1532parents. This class is not stored in the parent slot of a class vector." 1532parents. This class is not stored in the `parent' slot of a class vector."
1533 :abstract t) 1533 :abstract t)
1534@end example 1534@end example
1535 1535
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi
index 5ab34a0f7ae..19c78bf56c6 100644
--- a/doc/misc/gnus-faq.texi
+++ b/doc/misc/gnus-faq.texi
@@ -1671,7 +1671,7 @@ instead (works for newer versions as well):
1671 (setq message-user-fqdn fqdn) 1671 (setq message-user-fqdn fqdn)
1672 (gnus-message 1 "Redefining `message-make-fqdn'.") 1672 (gnus-message 1 "Redefining `message-make-fqdn'.")
1673 (defun message-make-fqdn () 1673 (defun message-make-fqdn ()
1674 "Return users fully qualified domain name." 1674 "Return user's fully qualified domain name."
1675 fqdn)))) 1675 fqdn))))
1676@end example 1676@end example
1677@noindent 1677@noindent
@@ -1765,9 +1765,9 @@ snippet by Frank Haun <pille3003@@fhaun.de> in
1765 1765
1766@example 1766@example
1767(defun my-archive-article (&optional n) 1767(defun my-archive-article (&optional n)
1768 "Copies one or more article(s) to a corresponding nnml: group, e.g., 1768 "Copies one or more article(s) to a corresponding `nnml:' group, e.g.,
1769gnus.ding goes to nnml:1.gnus.ding. And nnml:List-gnus.ding goes 1769`gnus.ding' goes to `nnml:1.gnus.ding'. And `nnml:List-gnus.ding' goes
1770to nnml:1.List-gnus-ding. 1770to `nnml:1.List-gnus-ding'.
1771 1771
1772Use process marks or mark a region in the summary buffer to archive 1772Use process marks or mark a region in the summary buffer to archive
1773more then one article." 1773more then one article."
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index d50bcd671ae..9093fa24f3d 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -21034,8 +21034,8 @@ function:
21034 21034
21035@lisp 21035@lisp
21036(defun gnus-decay-score (score) 21036(defun gnus-decay-score (score)
21037 "Decay SCORE according to gnus-score-decay-constant 21037 "Decay SCORE according to `gnus-score-decay-constant'
21038and gnus-score-decay-scale." 21038and `gnus-score-decay-scale'."
21039 (let ((n (- score 21039 (let ((n (- score
21040 (* (if (< score 0) -1 1) 21040 (* (if (< score 0) -1 1)
21041 (min (abs score) 21041 (min (abs score)
@@ -24081,7 +24081,7 @@ spam. And here is the nifty function:
24081 24081
24082@lisp 24082@lisp
24083(defun my-gnus-raze-spam () 24083(defun my-gnus-raze-spam ()
24084 "Submit SPAM to Vipuls Razor, then mark it as expirable." 24084 "Submit SPAM to Vipul's Razor, then mark it as expirable."
24085 (interactive) 24085 (interactive)
24086 (gnus-summary-save-in-pipe "razor-report -f -d" t) 24086 (gnus-summary-save-in-pipe "razor-report -f -d" t)
24087 (gnus-summary-mark-as-expirable 1)) 24087 (gnus-summary-mark-as-expirable 1))
diff --git a/doc/misc/rcirc.texi b/doc/misc/rcirc.texi
index a0d74b41be3..a707ba5f03e 100644
--- a/doc/misc/rcirc.texi
+++ b/doc/misc/rcirc.texi
@@ -909,7 +909,7 @@ The real answer, therefore, is a @code{/reconnect} command:
909 "Reconnect the server process." 909 "Reconnect the server process."
910 (interactive "i") 910 (interactive "i")
911 (unless process 911 (unless process
912 (error "Theres no process for this target")) 912 (error "There's no process for this target"))
913 (let* ((server (car (process-contact process))) 913 (let* ((server (car (process-contact process)))
914 (port (process-contact process :service)) 914 (port (process-contact process :service))
915 (nick (rcirc-nick process)) 915 (nick (rcirc-nick process))