procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Prefer "this" to “this” in doc strings

Browse source 
This mostly just straightens quotes introduced in my previous patch.
Suggested by Dmitry Gutov in:
http://lists.gnu.org/archive/html/emacs-devel/2015-05/msg00565.html
* lisp/faces.el, lisp/gnus/gnus-group.el, lisp/ldefs-boot.el:
* lisp/mail/supercite.el, lisp/net/tramp.el, lisp/recentf.el:
* lisp/textmodes/artist.el, lisp/textmodes/rst.el:
* lisp/textmodes/tildify.el, lisp/vc/ediff-util.el:
* lisp/vc/log-edit.el, lisp/xt-mouse.el:
Prefer straight double quotes to curved double quotes in doc strings.
This commit is contained in:
Paul Eggert 2015-05-19 19:08:11 -07:00
parent 9d35bb8d65
commit f743819b57
12 changed files with 33 additions and 33 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
lisp/faces.el
View file

@ -892,7 +892,7 @@ where COLOR is a string or `foreground-color', and STYLE is either
foreground color. :style may be omitted, which means to use a line.
FRAME nil or not specified means change face on all frames.
Use `set-face-attribute' to “unspecify” underlining."
Use `set-face-attribute' to \"unspecify\" underlining."
(interactive (read-face-and-attribute :underline))
(set-face-attribute face frame :underline underline))
@ -905,7 +905,7 @@ Use `set-face-attribute' to “unspecify” underlining."
INVERSE-VIDEO-P non-nil means FACE displays explicitly in inverse video.
INVERSE-VIDEO-P nil means FACE explicitly is not in inverse video.
FRAME nil or not specified means change face on all frames.
Use `set-face-attribute' to “unspecify” the inverse video attribute."
Use `set-face-attribute' to \"unspecify\" the inverse video attribute."
(interactive
(let ((list (read-face-and-attribute :inverse-video)))
(list (car list) (if (cadr list) t))))

2
lisp/gnus/gnus-group.el
View file

@ -3285,7 +3285,7 @@ mail messages or news articles in files that have numeric names."
Rights is a string listing a (possibly empty) set of alphanumeric
characters, each character listing a set of operations which is being
controlled. Letters are reserved for “standard” rights, listed
controlled. Letters are reserved for \"standard\" rights, listed
below. Digits are reserved for implementation or site defined rights.
l - lookup (mailbox is visible to LIST/LSUB commands)

2
lisp/ldefs-boot.el
View file

@ -27708,7 +27708,7 @@ Convert space before point into a hard space if the context is right.
If
* character before point is a space character,
* character before that has “w” character syntax (i.e. it's a word
* character before that has \"w\" character syntax (i.e. it's a word
constituent),
* `tildify-space-pattern' matches when `looking-back' (no more than 10
characters) from before the space character, and

10
lisp/mail/supercite.el
View file

@ -886,10 +886,10 @@ Action can be one of: View, Modify, Add, or Delete."
(defun sc-attribs-%@-addresses (from &optional delim)
"Extract the author's email terminus from email address FROM.
Match addresses of the style “name%[stuff].” when called with DELIM
of \"%\" and addresses of the style “[stuff]name@[stuff]” when
Match addresses of the style \"name%[stuff].\" when called with DELIM
of \"%\" and addresses of the style \"[stuff]name@[stuff]\" when
called with DELIM \"@\". If DELIM is nil or not provided, matches
addresses of the style “name”."
addresses of the style \"name\"."
(and (string-match (concat "[-[:alnum:]_.]+" delim) from 0)
(substring from
(match-beginning 0)
@ -897,7 +897,7 @@ addresses of the style “name”."
(defun sc-attribs-!-addresses (from)
"Extract the author's email terminus from email address FROM.
Match addresses of the style “[stuff]![stuff]...!name[stuff].”"
Match addresses of the style \"[stuff]![stuff]...!name[stuff].\""
(let ((eos (length from))
(mstart (string-match "![-[:alnum:]_.]+\\([^-![:alnum:]_.]\\|$\\)"
from 0))
@ -907,7 +907,7 @@ Match addresses of the style “[stuff]![stuff]...!name[stuff].”"
(defun sc-attribs-<>-addresses (from)
"Extract the author's email terminus from email address FROM.
Match addresses of the style “<name[stuff]>.”"
Match addresses of the style \"<name[stuff]>.\""
(and (string-match "<\\(.*\\)>" from)
(match-string 1 from)))

4
lisp/net/tramp.el
View file

@ -300,8 +300,8 @@ are fit for gateways must have `tramp-default-port' at least.
Notes:
When using `su' or `sudo' the phrase “open connection to a remote
host” sounds strange, but it is used nevertheless, for consistency.
When using `su' or `sudo' the phrase \"open connection to a remote
host\" sounds strange, but it is used nevertheless, for consistency.
No connection is opened to a remote host, but `su' or `sudo' is
started on the local host. You should specify a remote host
`localhost' or the name of the local host. Another host name is

2
lisp/recentf.el
View file

@ -294,7 +294,7 @@ They are successively passed a file name to transform it."
(function :tag "Other function")))))
(defcustom recentf-show-file-shortcuts-flag t
"Whether to show “[N]” for the Nth item up to 10.
"Whether to show \"[N]\" for the Nth item up to 10.
If non-nil, `recentf-open-files' will show labels for keys that can be
used as shortcuts to open the Nth file."
:group 'recentf

24
lisp/textmodes/artist.el
View file

@ -298,7 +298,7 @@ during the flood-fill."
(defcustom artist-ellipse-right-char ?\)
"Character to use at the rightmost position when drawing narrow ellipses.
In this figure, it is the right parenthesis (the “)” character):
In this figure, it is the right parenthesis (the \")\" character):
-----
( )
-----"
@ -309,7 +309,7 @@ In this figure, it is the right parenthesis (the “)” character):
(defcustom artist-ellipse-left-char ?\(
"Character to use at the leftmost position when drawing narrow ellipses.
In this figure, it is the left parenthesis (the “(” character):
In this figure, it is the left parenthesis (the \"(\" character):
-----
( )
-----"
@ -331,7 +331,7 @@ Accept this many characters cutting off a line and still treat
it as one line.
Example:
If `artist-vaporize-fuzziness' is 2, then those will be recognized as
lines from A to B (provided you start vaporizing them at the “*”):
lines from A to B (provided you start vaporizing them at the \"*\"):
/
A----*------/-----------B
\\/
@ -342,7 +342,7 @@ Example:
\\/ /
A----*----/\\/----------B
/ /\\
(in fact, only the left part [between the A and the leftmost “/”
(in fact, only the left part [between the A and the leftmost \"/\"
crossing the line] will be vaporized)."
:group 'artist
:type 'integer)
@ -397,8 +397,8 @@ Example:
;; This is a defvar, not a defcustom, since the custom
;; package shows lists of characters as a lists of integers,
;; which is confusing
"Characters (“color”) to use when spraying.
They should be ordered from the “lightest” to the “heaviest”
"Characters (\"color\") to use when spraying.
They should be ordered from the \"lightest\" to the \"heaviest\"
since spraying replaces a light character with the next heavier one.")
@ -1275,7 +1275,7 @@ Drawing with the mouse:
* Cut copies, then clears the rectangle/square.
* When drawing lines or poly-lines, you can set arrows.
See below under “Arrows” for more info.
See below under \"Arrows\" for more info.
* The mode line shows the currently selected drawing operation.
In addition, if it has an asterisk (*) at the end, you
@ -1383,8 +1383,8 @@ Variables
artist-vaporize-fuzziness Tolerance when recognizing lines
artist-spray-interval Seconds between repeated sprayings
artist-spray-radius Size of the spray-area
artist-spray-chars The spray-“color”
artist-spray-new-chars Initial spray-“color”
artist-spray-chars The spray-\"color\"
artist-spray-new-chars Initial spray-\"color\"
Hooks
@ -2020,7 +2020,7 @@ The replacement is used to convert tabs and new-lines to spaces."
(defsubst artist-replace-string (string &optional see-thru)
"Replace contents at point with STRING.
With optional argument SEE-THRU set to non-nil, text in the buffer
“shines thru” blanks in the STRING."
\"shines thru\" blanks in the STRING."
(let ((char-list (append string nil)) ; convert the string to a list
(overwrite-mode 'overwrite-mode-textual)
(fill-column 32765) ; Large :-)
@ -2385,7 +2385,7 @@ in the coord."
;; Pretend we are plotting a pixel. Instead we just list it
;;
(defmacro artist-put-pixel (point-list x y)
"In POINT-LIST, store a “pixel” at coord X,Y."
"In POINT-LIST, store a \"pixel\" at coord X,Y."
`(setq ,point-list
(append ,point-list (list (artist-new-coord ,x ,y)))))
@ -2928,7 +2928,7 @@ This is done by calling the function specified by
`artist-text-renderer-function', which must return a list of strings,
to be inserted in the buffer.
Text already in the buffer “shines thru” blanks in the rendered text."
Text already in the buffer \"shines thru\" blanks in the rendered text."
(let* ((input-text (read-string "Type text to render: "))
(rendered-text (artist-funcall artist-text-renderer-function input-text)))
(artist-text-insert-see-thru x y rendered-text)))

4
lisp/textmodes/rst.el
View file

@ -1512,8 +1512,8 @@ PFXARG (alternate behavior).
This function is a bit of a swiss knife. It is meant to adjust
the adornments of a section title in reStructuredText. It tries
to deal with all the possible cases gracefully and to do “the
right thing” in all cases.
to deal with all the possible cases gracefully and to do \"the
right thing\" in all cases.
See the documentations of `rst-adjust-adornment-work' and
`rst-promote-region' for full details.

2
lisp/textmodes/tildify.el
View file

@ -431,7 +431,7 @@ current `case-fold-search' setting."
If
* character before point is a space character,
* character before that has “w” character syntax (i.e. it's a word
* character before that has \"w\" character syntax (i.e. it's a word
constituent),
* `tildify-space-pattern' matches when `looking-back' (no more than 10
characters) from before the space character, and

2
lisp/vc/ediff-util.el
View file

@ -3988,7 +3988,7 @@ and mail it to the address above.
Please read this first:
----------------------
Some “bugs” may actually be no bugs at all. For instance, if you are
Some \"bugs\" may actually be no bugs at all. For instance, if you are
reporting that certain difference regions are not matched as you think they
should, this is most likely due to the way Unix diff program decides what
constitutes a difference region. Ediff is an Emacs interface to diff, and

2
lisp/vc/log-edit.el
View file

@ -167,7 +167,7 @@ can be obtained from `log-edit-files'."
(defvar log-edit-changelog-full-paragraphs t
"If non-nil, include full ChangeLog paragraphs in the log.
This may be set in the “local variables” section of a ChangeLog, to
This may be set in the \"local variables\" section of a ChangeLog, to
indicate the policy for that ChangeLog.
A ChangeLog paragraph is a bunch of log text containing no blank lines;

8
lisp/xt-mouse.el
View file

@ -321,21 +321,21 @@ Enables basic mouse tracking, mouse motion events and finally
extended tracking on terminals that support it. The following
escape sequences are understood by modern xterms:
\"\\e[?1000h\" “Basic mouse mode”: Enables reports for mouse
\"\\e[?1000h\" \"Basic mouse mode\": Enables reports for mouse
clicks. There is a limit to the maximum row/column
position (<= 223), which can be reported in this
basic mode.
\"\\e[?1002h\" “Mouse motion mode”: Enables reports for mouse
\"\\e[?1002h\" \"Mouse motion mode\": Enables reports for mouse
motion events during dragging operations.
\"\\e[?1005h\" “UTF-8 coordinate extension”: Enables an extension
\"\\e[?1005h\" \"UTF-8 coordinate extension\": Enables an extension
to the basic mouse mode, which uses UTF-8
characters to overcome the 223 row/column limit. This
extension may conflict with non UTF-8 applications or
non UTF-8 locales.
\"\\e[?1006h\" “SGR coordinate extension”: Enables a newer
\"\\e[?1006h\" \"SGR coordinate extension\": Enables a newer
alternative extension to the basic mouse mode, which
overcomes the 223 row/column limit without the
drawbacks of the UTF-8 coordinate extension.