diff options
| author | Paul Eggert | 2016-02-03 17:13:04 -0800 |
|---|---|---|
| committer | Paul Eggert | 2016-02-03 17:20:17 -0800 |
| commit | 91557f5e2decb723544a703d01f11879be07fd04 (patch) | |
| tree | 8f53ef75492e0552746c3f9a6da5b1efbc051b0e | |
| parent | 2c0dc9fa70dcde56f68db6e72309f995e5c0e6e0 (diff) | |
| download | emacs-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-- | CONTRIBUTE | 2 | ||||
| -rw-r--r-- | admin/release-process | 18 | ||||
| -rw-r--r-- | doc/misc/tramp.texi | 2 | ||||
| -rw-r--r-- | lisp/emacs-lisp/bytecomp.el | 8 | ||||
| -rw-r--r-- | lisp/emacs-lisp/map.el | 2 | ||||
| -rw-r--r-- | lisp/emacs-lisp/pcase.el | 6 | ||||
| -rw-r--r-- | lisp/gnus/mml-smime.el | 4 | ||||
| -rw-r--r-- | lisp/xwidget.el | 8 |
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 | |||
| 252 | for more information on writing and running tests. | 252 | for more information on writing and running tests. |
| 253 | 253 | ||
| 254 | If your test lasts longer than some few seconds, mark it in its | 254 | If 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 | ||
| 257 | To run tests on the entire Emacs tree, run "make check" from the | 257 | To run tests on the entire Emacs tree, run "make check" from the |
| 258 | top-level directory. Most tests are in the directory | 258 | top-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 | ||
| 9 | The first phase of the release schedule is the "heads-down" working | 9 | The first phase of the release schedule is the "heads-down" working |
| 10 | period for new features, on the `master' branch and several feature | 10 | period for new features, on the 'master' branch and several feature |
| 11 | branches. | 11 | branches. |
| 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 | ||
| 24 | At the beginning of this phase, a release branch called "emacs-NN" | 24 | At 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) |
| 26 | will be cut from `master'. When that happens, the version number on | 26 | will 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' |
| 28 | command to do that, then commit the changes it made and push to | 28 | command 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 | ||
| 32 | The 2 main manuals, the User Manual and the Emacs Lisp Manual, need to | 32 | The 2 main manuals, the User Manual and the Emacs Lisp Manual, need to |
| 33 | be proofread, preferably by at least 2 different persons, and any | 33 | be 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 | |||
| 35 | to divide the job between several people (see the checklist near the | 35 | to divide the job between several people (see the checklist near the |
| 36 | end of this file). | 36 | end of this file). |
| 37 | 37 | ||
| 38 | In parallel to this phase, `master' can receive new features, to be | 38 | In parallel to this phase, 'master' can receive new features, to be |
| 39 | released in the next release cycle. From time to time, the master | 39 | released in the next release cycle. From time to time, the master |
| 40 | branches merges bugfix commits from the "emacs-NN" branch. | 40 | branches 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 |
| 58 | files. See `admin/notes/years' for information about maintaining | 58 | files. See 'admin/notes/years' for information about maintaining |
| 59 | copyright years for GNU Emacs. | 59 | copyright 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 | ||
| 347 | For Emacs's versioning scheme, see `admin/notes/versioning'. | 347 | For Emacs's versioning scheme, see 'admin/notes/versioning'. |
| 348 | 348 | ||
| 349 | For instructions to create pretest or release tarballs, announcements, | 349 | For instructions to create pretest or release tarballs, announcements, |
| 350 | etc., see `admin/make-tarball.txt'. | 350 | etc., see 'admin/make-tarball.txt'. |
| 351 | 351 | ||
| 352 | 352 | ||
| 353 | Local variables: | 353 | Local 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 |
| 2037 | is @code{nil} (the default), such problems do not occur. | 2037 | is @code{nil} (the default), such problems do not occur. |
| 2038 | 2038 | ||
| 2039 | To ``turns off'' the backup feature for @value{tramp} files and stop | 2039 | To ``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 | |||
| 55 | associated to the KEY. | 55 | associated to the KEY. |
| 56 | 56 | ||
| 57 | Each element can also be a SYMBOL, which is an abbreviation of a (KEY | 57 | Each element can also be a SYMBOL, which is an abbreviation of a (KEY |
| 58 | PAT) tuple of the form ('SYMBOL SYMBOL). | 58 | PAT) tuple of the form (\\='SYMBOL SYMBOL). |
| 59 | 59 | ||
| 60 | Keys in ARGS not found in the map are ignored, and the match doesn't | 60 | Keys in ARGS not found in the map are ignored, and the match doesn't |
| 61 | fail." | 61 | fail." |
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 @@ | |||
| 111 | CASES is a list of elements of the form (PATTERN CODE...). | 111 | CASES is a list of elements of the form (PATTERN CODE...). |
| 112 | 112 | ||
| 113 | A structural PATTERN describes a template that identifies a class | 113 | A structural PATTERN describes a template that identifies a class |
| 114 | of values. For example, the pattern `(,foo ,bar) matches any | 114 | of values. For example, the pattern \\=`(,foo ,bar) matches any |
| 115 | two element list, binding its elements to symbols named `foo' and | 115 | two 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 | |||
| 119 | a pattern match fails, the next case is tried until either a | 119 | a pattern match fails, the next case is tried until either a |
| 120 | successful match is found or there are no more cases. | 120 | successful match is found or there are no more cases. |
| 121 | 121 | ||
| 122 | Another difference is that pattern elements may be backquoted, | 122 | Another difference is that pattern elements may be quoted, |
| 123 | meaning they must match exactly: The pattern \\='(foo bar) | 123 | meaning they must match exactly: The pattern \\='(foo bar) |
| 124 | matches only against two element lists containing the symbols | 124 | matches 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 |
| 126 | match themselves, such as numbers or strings, and need not be | 126 | match themselves, such as numbers or strings, and need not be |
| 127 | quoted). | 127 | quoted.) |
| 128 | 128 | ||
| 129 | Lastly, a pattern can be logical, such as (pred numberp), that | 129 | Lastly, a pattern can be logical, such as (pred numberp), that |
| 130 | matches any number-like element; or the symbol `_', that matches | 130 | matches 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. |
| 146 | Depending on the value of `xwidget-webkit-scroll-behavior', | 146 | Depending on the value of `xwidget-webkit-scroll-behavior', |
| 147 | this scrolls in 'native' fashion, or like `image-mode' would." | 147 | this 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. |
| 155 | Depending on the value of `xwidget-webkit-scroll-behavior', | 155 | Depending on the value of `xwidget-webkit-scroll-behavior', |
| 156 | this scrolls in 'native' fashion, or like `image-mode' would." | 156 | this 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. |
| 164 | Depending on the value of `xwidget-webkit-scroll-behavior', | 164 | Depending on the value of `xwidget-webkit-scroll-behavior', |
| 165 | this scrolls in 'native' fashion, or like `image-mode' would." | 165 | this 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. |
| 173 | Depending on the value of `xwidget-webkit-scroll-behavior', | 173 | Depending on the value of `xwidget-webkit-scroll-behavior', |
| 174 | this scrolls in 'native' fashion, or like `image-mode' would." | 174 | this 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) |