aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul Eggert2016-02-03 17:13:04 -0800
committerPaul Eggert2016-02-03 17:20:17 -0800
commit91557f5e2decb723544a703d01f11879be07fd04 (patch)
tree8f53ef75492e0552746c3f9a6da5b1efbc051b0e
parent2c0dc9fa70dcde56f68db6e72309f995e5c0e6e0 (diff)
downloademacs-91557f5e2decb723544a703d01f11879be07fd04.tar.gz
emacs-91557f5e2decb723544a703d01f11879be07fd04.zip
Quoting fixes in doc strings and diagnostics
* lisp/emacs-lisp/bytecomp.el (byte-compile-setq, byte-compile-funcall): * lisp/gnus/mml-smime.el (mml-smime-get-dns-cert) (mml-smime-get-ldap-cert): Follow user style preference when quoting diagnostics.
-rw-r--r--CONTRIBUTE2
-rw-r--r--admin/release-process18
-rw-r--r--doc/misc/tramp.texi2
-rw-r--r--lisp/emacs-lisp/bytecomp.el8
-rw-r--r--lisp/emacs-lisp/map.el2
-rw-r--r--lisp/emacs-lisp/pcase.el6
-rw-r--r--lisp/gnus/mml-smime.el4
-rw-r--r--lisp/xwidget.el8
8 files changed, 26 insertions, 24 deletions
diff --git a/CONTRIBUTE b/CONTRIBUTE
index 3ccaff3393f..f1f3a3f86fc 100644
--- a/CONTRIBUTE
+++ b/CONTRIBUTE
@@ -252,7 +252,7 @@ Emacs uses ERT, Emacs Lisp Regression Testing, for testing. See (info
252for more information on writing and running tests. 252for more information on writing and running tests.
253 253
254If your test lasts longer than some few seconds, mark it in its 254If your test lasts longer than some few seconds, mark it in its
255`ert-deftest' definition with ":tags '(:expensive-test)". 255'ert-deftest' definition with ":tags '(:expensive-test)".
256 256
257To run tests on the entire Emacs tree, run "make check" from the 257To run tests on the entire Emacs tree, run "make check" from the
258top-level directory. Most tests are in the directory 258top-level directory. Most tests are in the directory
diff --git a/admin/release-process b/admin/release-process
index 5a95fa2d7bc..2f23dac9b7f 100644
--- a/admin/release-process
+++ b/admin/release-process
@@ -7,7 +7,7 @@ Each release cycle will be split into two periods.
7** Phase one: development 7** Phase one: development
8 8
9The first phase of the release schedule is the "heads-down" working 9The first phase of the release schedule is the "heads-down" working
10period for new features, on the `master' branch and several feature 10period for new features, on the 'master' branch and several feature
11branches. 11branches.
12 12
13** Phase two: fixing and stabilizing the release branch 13** Phase two: fixing and stabilizing the release branch
@@ -23,11 +23,11 @@ new features.
23 23
24At the beginning of this phase, a release branch called "emacs-NN" 24At the beginning of this phase, a release branch called "emacs-NN"
25("NN" represents the major version number of the new Emacs release) 25("NN" represents the major version number of the new Emacs release)
26will be cut from `master'. When that happens, the version number on 26will be cut from 'master'. When that happens, the version number on
27`master' should be incremented; use admin/admin.el's `set-version' 27'master' should be incremented; use admin/admin.el's 'set-version'
28command to do that, then commit the changes it made and push to 28command to do that, then commit the changes it made and push to
29`master'. For major releases, also update the value of 29'master'. For major releases, also update the value of
30`customize-changed-options-previous-release'. 30'customize-changed-options-previous-release'.
31 31
32The 2 main manuals, the User Manual and the Emacs Lisp Manual, need to 32The 2 main manuals, the User Manual and the Emacs Lisp Manual, need to
33be proofread, preferably by at least 2 different persons, and any 33be proofread, preferably by at least 2 different persons, and any
@@ -35,7 +35,7 @@ uncovered problems fixed. This is a lot of work, so it is advisable
35to divide the job between several people (see the checklist near the 35to divide the job between several people (see the checklist near the
36end of this file). 36end of this file).
37 37
38In parallel to this phase, `master' can receive new features, to be 38In parallel to this phase, 'master' can receive new features, to be
39released in the next release cycle. From time to time, the master 39released in the next release cycle. From time to time, the master
40branches merges bugfix commits from the "emacs-NN" branch. 40branches merges bugfix commits from the "emacs-NN" branch.
41 41
@@ -55,7 +55,7 @@ Change "block" to "unblock" to unblock the bug.
55* TO BE DONE SHORTLY BEFORE RELEASE 55* TO BE DONE SHORTLY BEFORE RELEASE
56 56
57** Make sure the Copyright date reflects the current year in the source 57** Make sure the Copyright date reflects the current year in the source
58files. See `admin/notes/years' for information about maintaining 58files. See 'admin/notes/years' for information about maintaining
59copyright years for GNU Emacs. 59copyright years for GNU Emacs.
60 60
61** Make sure the necessary sources and scripts for any generated files 61** Make sure the necessary sources and scripts for any generated files
@@ -344,10 +344,10 @@ windows.texi
344 344
345* OTHER INFORMATION 345* OTHER INFORMATION
346 346
347For Emacs's versioning scheme, see `admin/notes/versioning'. 347For Emacs's versioning scheme, see 'admin/notes/versioning'.
348 348
349For instructions to create pretest or release tarballs, announcements, 349For instructions to create pretest or release tarballs, announcements,
350etc., see `admin/make-tarball.txt'. 350etc., see 'admin/make-tarball.txt'.
351 351
352 352
353Local variables: 353Local variables:
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 7bf2e532e01..9320a6e166f 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -2036,7 +2036,7 @@ When
2036@end ifset 2036@end ifset
2037is @code{nil} (the default), such problems do not occur. 2037is @code{nil} (the default), such problems do not occur.
2038 2038
2039To ``turns off'' the backup feature for @value{tramp} files and stop 2039To ``turn off'' the backup feature for @value{tramp} files and stop
2040@value{tramp} from saving to the backup directory, use this: 2040@value{tramp} from saving to the backup directory, use this:
2041 2041
2042@ifset emacs 2042@ifset emacs
diff --git a/lisp/emacs-lisp/bytecomp.el b/lisp/emacs-lisp/bytecomp.el
index 4ee8b37719f..1526e2fdeb9 100644
--- a/lisp/emacs-lisp/bytecomp.el
+++ b/lisp/emacs-lisp/bytecomp.el
@@ -1169,7 +1169,7 @@ Each function's symbol gets added to `byte-compile-noruntime-functions'."
1169 (display-warning 'bytecomp string level byte-compile-log-buffer))) 1169 (display-warning 'bytecomp string level byte-compile-log-buffer)))
1170 1170
1171(defun byte-compile-warn (format &rest args) 1171(defun byte-compile-warn (format &rest args)
1172 "Issue a byte compiler warning; use (format FORMAT ARGS...) for message." 1172 "Issue a byte compiler warning; use (format-message FORMAT ARGS...) for message."
1173 (setq format (apply #'format-message format args)) 1173 (setq format (apply #'format-message format args))
1174 (if byte-compile-error-on-warn 1174 (if byte-compile-error-on-warn
1175 (error "%s" format) ; byte-compile-file catches and logs it 1175 (error "%s" format) ; byte-compile-file catches and logs it
@@ -3746,7 +3746,8 @@ discarding."
3746 (if (= (logand len 1) 1) 3746 (if (= (logand len 1) 1)
3747 (progn 3747 (progn
3748 (byte-compile-log-warning 3748 (byte-compile-log-warning
3749 (format "missing value for `%S' at end of setq" (car (last args))) 3749 (format-message
3750 "missing value for `%S' at end of setq" (car (last args)))
3750 nil :error) 3751 nil :error)
3751 (byte-compile-form 3752 (byte-compile-form
3752 `(signal 'wrong-number-of-arguments '(setq ,len)) 3753 `(signal 'wrong-number-of-arguments '(setq ,len))
@@ -4017,7 +4018,8 @@ that suppresses all warnings during execution of BODY."
4017 (progn 4018 (progn
4018 (mapc 'byte-compile-form (cdr form)) 4019 (mapc 'byte-compile-form (cdr form))
4019 (byte-compile-out 'byte-call (length (cdr (cdr form))))) 4020 (byte-compile-out 'byte-call (length (cdr (cdr form)))))
4020 (byte-compile-log-warning "`funcall' called with no arguments" nil :error) 4021 (byte-compile-log-warning
4022 (format-message "`funcall' called with no arguments") nil :error)
4021 (byte-compile-form '(signal 'wrong-number-of-arguments '(funcall 0)) 4023 (byte-compile-form '(signal 'wrong-number-of-arguments '(funcall 0))
4022 byte-compile--for-effect))) 4024 byte-compile--for-effect)))
4023 4025
diff --git a/lisp/emacs-lisp/map.el b/lisp/emacs-lisp/map.el
index 878611538fc..ec8d3d79d9f 100644
--- a/lisp/emacs-lisp/map.el
+++ b/lisp/emacs-lisp/map.el
@@ -55,7 +55,7 @@ found in the map, the corresponding PAT doesn't match the value
55associated to the KEY. 55associated to the KEY.
56 56
57Each element can also be a SYMBOL, which is an abbreviation of a (KEY 57Each element can also be a SYMBOL, which is an abbreviation of a (KEY
58PAT) tuple of the form ('SYMBOL SYMBOL). 58PAT) tuple of the form (\\='SYMBOL SYMBOL).
59 59
60Keys in ARGS not found in the map are ignored, and the match doesn't 60Keys in ARGS not found in the map are ignored, and the match doesn't
61fail." 61fail."
diff --git a/lisp/emacs-lisp/pcase.el b/lisp/emacs-lisp/pcase.el
index 7be997e6469..7e164c0fe5c 100644
--- a/lisp/emacs-lisp/pcase.el
+++ b/lisp/emacs-lisp/pcase.el
@@ -111,7 +111,7 @@
111CASES is a list of elements of the form (PATTERN CODE...). 111CASES is a list of elements of the form (PATTERN CODE...).
112 112
113A structural PATTERN describes a template that identifies a class 113A structural PATTERN describes a template that identifies a class
114of values. For example, the pattern `(,foo ,bar) matches any 114of values. For example, the pattern \\=`(,foo ,bar) matches any
115two element list, binding its elements to symbols named `foo' and 115two element list, binding its elements to symbols named `foo' and
116`bar' -- in much the same way that `cl-destructuring-bind' would. 116`bar' -- in much the same way that `cl-destructuring-bind' would.
117 117
@@ -119,12 +119,12 @@ A significant difference from `cl-destructuring-bind' is that, if
119a pattern match fails, the next case is tried until either a 119a pattern match fails, the next case is tried until either a
120successful match is found or there are no more cases. 120successful match is found or there are no more cases.
121 121
122Another difference is that pattern elements may be backquoted, 122Another difference is that pattern elements may be quoted,
123meaning they must match exactly: The pattern \\='(foo bar) 123meaning they must match exactly: The pattern \\='(foo bar)
124matches only against two element lists containing the symbols 124matches only against two element lists containing the symbols
125`foo' and `bar' in that order. (As a short-hand, atoms always 125`foo' and `bar' in that order. (As a short-hand, atoms always
126match themselves, such as numbers or strings, and need not be 126match themselves, such as numbers or strings, and need not be
127quoted). 127quoted.)
128 128
129Lastly, a pattern can be logical, such as (pred numberp), that 129Lastly, a pattern can be logical, such as (pred numberp), that
130matches any number-like element; or the symbol `_', that matches 130matches any number-like element; or the symbol `_', that matches
diff --git a/lisp/gnus/mml-smime.el b/lisp/gnus/mml-smime.el
index 2d8f25c5003..248e63682c8 100644
--- a/lisp/gnus/mml-smime.el
+++ b/lisp/gnus/mml-smime.el
@@ -216,7 +216,7 @@ Whether the passphrase is cached at all is controlled by
216 ""))))) 216 "")))))
217 (if (setq cert (smime-cert-by-dns who)) 217 (if (setq cert (smime-cert-by-dns who))
218 (setq result (list 'certfile (buffer-name cert))) 218 (setq result (list 'certfile (buffer-name cert)))
219 (setq bad (format "`%s' not found. " who)))) 219 (setq bad (gnus-format-message "`%s' not found. " who))))
220 (quit)) 220 (quit))
221 result)) 221 result))
222 222
@@ -235,7 +235,7 @@ Whether the passphrase is cached at all is controlled by
235 ""))))) 235 "")))))
236 (if (setq cert (smime-cert-by-ldap who)) 236 (if (setq cert (smime-cert-by-ldap who))
237 (setq result (list 'certfile (buffer-name cert))) 237 (setq result (list 'certfile (buffer-name cert)))
238 (setq bad (format "`%s' not found. " who)))) 238 (setq bad (gnus-format-message "`%s' not found. " who))))
239 (quit)) 239 (quit))
240 result)) 240 result))
241 241
diff --git a/lisp/xwidget.el b/lisp/xwidget.el
index 8c8e679c8da..cd8ec0ec29d 100644
--- a/lisp/xwidget.el
+++ b/lisp/xwidget.el
@@ -144,7 +144,7 @@ Interactively, URL defaults to the string looking like a url around point."
144(defun xwidget-webkit-scroll-up () 144(defun xwidget-webkit-scroll-up ()
145 "Scroll webkit up. 145 "Scroll webkit up.
146Depending on the value of `xwidget-webkit-scroll-behavior', 146Depending on the value of `xwidget-webkit-scroll-behavior',
147this scrolls in 'native' fashion, or like `image-mode' would." 147this scrolls in `native' fashion, or like `image-mode' would."
148 (interactive) 148 (interactive)
149 (if (eq xwidget-webkit-scroll-behavior 'native) 149 (if (eq xwidget-webkit-scroll-behavior 'native)
150 (xwidget-set-adjustment (xwidget-webkit-last-session) 'vertical t 50) 150 (xwidget-set-adjustment (xwidget-webkit-last-session) 'vertical t 50)
@@ -153,7 +153,7 @@ this scrolls in 'native' fashion, or like `image-mode' would."
153(defun xwidget-webkit-scroll-down () 153(defun xwidget-webkit-scroll-down ()
154 "Scroll webkit down. 154 "Scroll webkit down.
155Depending on the value of `xwidget-webkit-scroll-behavior', 155Depending on the value of `xwidget-webkit-scroll-behavior',
156this scrolls in 'native' fashion, or like `image-mode' would." 156this scrolls in `native' fashion, or like `image-mode' would."
157 (interactive) 157 (interactive)
158 (if (eq xwidget-webkit-scroll-behavior 'native) 158 (if (eq xwidget-webkit-scroll-behavior 'native)
159 (xwidget-set-adjustment (xwidget-webkit-last-session) 'vertical t -50) 159 (xwidget-set-adjustment (xwidget-webkit-last-session) 'vertical t -50)
@@ -162,7 +162,7 @@ this scrolls in 'native' fashion, or like `image-mode' would."
162(defun xwidget-webkit-scroll-forward () 162(defun xwidget-webkit-scroll-forward ()
163 "Scroll webkit forwards. 163 "Scroll webkit forwards.
164Depending on the value of `xwidget-webkit-scroll-behavior', 164Depending on the value of `xwidget-webkit-scroll-behavior',
165this scrolls in 'native' fashion, or like `image-mode' would." 165this scrolls in `native' fashion, or like `image-mode' would."
166 (interactive) 166 (interactive)
167 (if (eq xwidget-webkit-scroll-behavior 'native) 167 (if (eq xwidget-webkit-scroll-behavior 'native)
168 (xwidget-set-adjustment (xwidget-webkit-last-session) 'horizontal t 50) 168 (xwidget-set-adjustment (xwidget-webkit-last-session) 'horizontal t 50)
@@ -171,7 +171,7 @@ this scrolls in 'native' fashion, or like `image-mode' would."
171(defun xwidget-webkit-scroll-backward () 171(defun xwidget-webkit-scroll-backward ()
172 "Scroll webkit backwards. 172 "Scroll webkit backwards.
173Depending on the value of `xwidget-webkit-scroll-behavior', 173Depending on the value of `xwidget-webkit-scroll-behavior',
174this scrolls in 'native' fashion, or like `image-mode' would." 174this scrolls in `native' fashion, or like `image-mode' would."
175 (interactive) 175 (interactive)
176 (if (eq xwidget-webkit-scroll-behavior 'native) 176 (if (eq xwidget-webkit-scroll-behavior 'native)
177 (xwidget-set-adjustment (xwidget-webkit-last-session) 'horizontal t -50) 177 (xwidget-set-adjustment (xwidget-webkit-last-session) 'horizontal t -50)