aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul Eggert2015-04-10 11:27:21 -0700
committerPaul Eggert2015-04-10 11:28:52 -0700
commita2940cd43e7931d16d3a3ce2cf5d4acd148dd00c (patch)
treed0345ac3f2d34ee9e734a8824691c1dcadf287e5
parentca401f6fdc512f79d6015c1759a0e8e0c3de5c9a (diff)
downloademacs-a2940cd43e7931d16d3a3ce2cf5d4acd148dd00c.tar.gz
emacs-a2940cd43e7931d16d3a3ce2cf5d4acd148dd00c.zip
Minor quoting etc. fixes to lispref manual
* doc/lispref/tips.texi (Documentation Tips): Distinguish more clearly among grave accent, apostrophe, and single quote. * doc/lispref/README, doc/lispref/buffers.texi: * doc/lispref/commands.texi, doc/lispref/control.texi: * doc/lispref/customize.texi, doc/lispref/display.texi: * doc/lispref/elisp.texi, doc/lispref/files.texi: * doc/lispref/frames.texi, doc/lispref/hash.texi: * doc/lispref/help.texi, doc/lispref/internals.texi: * doc/lispref/loading.texi, doc/lispref/makefile.w32-in: * doc/lispref/markers.texi, doc/lispref/modes.texi: * doc/lispref/nonascii.texi, doc/lispref/objects.texi: * doc/lispref/os.texi, doc/lispref/positions.texi: * doc/lispref/strings.texi, doc/lispref/syntax.texi: * doc/lispref/text.texi, doc/lispref/tips.texi: * doc/lispref/two-volume-cross-refs.txt, doc/lispref/windows.texi: Use American-style double quoting in ordinary text, and quote 'like this' when single-quoting in ASCII text. Also, fix some minor spacing issues.
-rw-r--r--doc/lispref/README6
-rw-r--r--doc/lispref/buffers.texi2
-rw-r--r--doc/lispref/commands.texi6
-rw-r--r--doc/lispref/control.texi2
-rw-r--r--doc/lispref/customize.texi2
-rw-r--r--doc/lispref/display.texi20
-rw-r--r--doc/lispref/elisp.texi4
-rw-r--r--doc/lispref/files.texi10
-rw-r--r--doc/lispref/frames.texi6
-rw-r--r--doc/lispref/hash.texi2
-rw-r--r--doc/lispref/help.texi2
-rw-r--r--doc/lispref/internals.texi8
-rw-r--r--doc/lispref/loading.texi2
-rw-r--r--doc/lispref/makefile.w32-in4
-rw-r--r--doc/lispref/markers.texi5
-rw-r--r--doc/lispref/modes.texi8
-rw-r--r--doc/lispref/nonascii.texi6
-rw-r--r--doc/lispref/objects.texi6
-rw-r--r--doc/lispref/os.texi8
-rw-r--r--doc/lispref/positions.texi2
-rw-r--r--doc/lispref/strings.texi12
-rw-r--r--doc/lispref/syntax.texi2
-rw-r--r--doc/lispref/text.texi2
-rw-r--r--doc/lispref/tips.texi31
-rw-r--r--doc/lispref/two-volume-cross-refs.txt6
-rw-r--r--doc/lispref/windows.texi2
26 files changed, 80 insertions, 86 deletions
diff --git a/doc/lispref/README b/doc/lispref/README
index 5ca18a8446a..fd943ce97c2 100644
--- a/doc/lispref/README
+++ b/doc/lispref/README
@@ -21,15 +21,15 @@ Buying a manual from the Free Software Foundation helps support our GNU
21development work. See <http://shop.fsf.org/>. 21development work. See <http://shop.fsf.org/>.
22(At time of writing, this manual is out of print.) 22(At time of writing, this manual is out of print.)
23 23
24* The master file for formatting this manual for Tex is called `elisp.texi'. 24* The master file for formatting this manual for Tex is called 'elisp.texi'.
25It contains @include commands to include all the chapters that make up 25It contains @include commands to include all the chapters that make up
26the manual. 26the manual.
27 27
28* This distribution contains a Makefile that you can use with GNU Make. 28* This distribution contains a Makefile that you can use with GNU Make.
29 29
30** To make an Info file, you need to install Texinfo, then run `make info'. 30** To make an Info file, you need to install Texinfo, then run 'make info'.
31 31
32** Use `make elisp.pdf' or `make elisp.html' to create PDF or HTML versions. 32** Use 'make elisp.pdf' or 'make elisp.html' to create PDF or HTML versions.
33 33
34 34
35This file is part of GNU Emacs. 35This file is part of GNU Emacs.
diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi
index 1c1c423171d..49bfe82a3e1 100644
--- a/doc/lispref/buffers.texi
+++ b/doc/lispref/buffers.texi
@@ -844,7 +844,7 @@ names start with a space are not considered at all.
844 844
845If @var{buffer} is not supplied (or if it is not a live buffer), then 845If @var{buffer} is not supplied (or if it is not a live buffer), then
846@code{other-buffer} returns the first buffer in the selected frame's 846@code{other-buffer} returns the first buffer in the selected frame's
847local buffer list. (If @var{frame} is non-@code{nil}, it returns the 847local buffer list. (If @var{frame} is non-@code{nil}, it returns the
848first buffer in @var{frame}'s local buffer list instead.) 848first buffer in @var{frame}'s local buffer list instead.)
849 849
850If @var{frame} has a non-@code{nil} @code{buffer-predicate} parameter, 850If @var{frame} has a non-@code{nil} @code{buffer-predicate} parameter,
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 5e986debd8a..aec7674284d 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -1462,7 +1462,7 @@ the symbols @code{handle} (the scroll bar handle), @code{above-handle}
1462(the area above the handle), @code{below-handle} (the area below the 1462(the area above the handle), @code{below-handle} (the area below the
1463handle), @code{up} (the up arrow at one end of the scroll bar), or 1463handle), @code{up} (the up arrow at one end of the scroll bar), or
1464@code{down} (the down arrow at one end of the scroll bar). 1464@code{down} (the down arrow at one end of the scroll bar).
1465@c The `top', `bottom', and `end-scroll' codes don't seem to be used. 1465@c The 'top', 'bottom', and 'end-scroll' codes don't seem to be used.
1466@end table 1466@end table
1467 1467
1468 1468
@@ -1720,7 +1720,7 @@ occurred.
1720 1720
1721@vindex mouse-wheel-up-event 1721@vindex mouse-wheel-up-event
1722@vindex mouse-wheel-down-event 1722@vindex mouse-wheel-down-event
1723This kind of event is generated only on some kinds of systems. On some 1723This kind of event is generated only on some kinds of systems. On some
1724systems, @code{mouse-4} and @code{mouse-5} are used instead. For 1724systems, @code{mouse-4} and @code{mouse-5} are used instead. For
1725portable code, use the variables @code{mouse-wheel-up-event} and 1725portable code, use the variables @code{mouse-wheel-up-event} and
1726@code{mouse-wheel-down-event} defined in @file{mwheel.el} to determine 1726@code{mouse-wheel-down-event} defined in @file{mwheel.el} to determine
@@ -1856,7 +1856,7 @@ into another window. That produces a pair of events like these:
1856@end smallexample 1856@end smallexample
1857 1857
1858The frame with input focus might not take up the entire screen, and 1858The frame with input focus might not take up the entire screen, and
1859the user might move the mouse outside the scope of the frame. Inside 1859the user might move the mouse outside the scope of the frame. Inside
1860the @code{track-mouse} special form, that produces an event like this: 1860the @code{track-mouse} special form, that produces an event like this:
1861 1861
1862@smallexample 1862@smallexample
diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi
index f512ad990bd..fb2e1bccb10 100644
--- a/doc/lispref/control.texi
+++ b/doc/lispref/control.texi
@@ -1025,7 +1025,7 @@ the circumstances of the error.
1025 1025
1026The argument @var{error-symbol} must be an @dfn{error symbol}---a symbol 1026The argument @var{error-symbol} must be an @dfn{error symbol}---a symbol
1027defined with @code{define-error}. This is how Emacs Lisp classifies different 1027defined with @code{define-error}. This is how Emacs Lisp classifies different
1028sorts of errors. @xref{Error Symbols}, for a description of error symbols, 1028sorts of errors. @xref{Error Symbols}, for a description of error symbols,
1029error conditions and condition names. 1029error conditions and condition names.
1030 1030
1031If the error is not handled, the two arguments are used in printing 1031If the error is not handled, the two arguments are used in printing
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi
index 0d1b6fac8c0..f984dbe5870 100644
--- a/doc/lispref/customize.texi
+++ b/doc/lispref/customize.texi
@@ -842,7 +842,7 @@ symbols, and symbols are not treated like other Lisp expressions.
842 842
843@item (radio @var{element-types}@dots{}) 843@item (radio @var{element-types}@dots{})
844This is similar to @code{choice}, except that the choices are displayed 844This is similar to @code{choice}, except that the choices are displayed
845using `radio buttons' rather than a menu. This has the advantage of 845using ``radio buttons'' rather than a menu. This has the advantage of
846displaying documentation for the choices when applicable and so is often 846displaying documentation for the choices when applicable and so is often
847a good choice for a choice between constant functions 847a good choice for a choice between constant functions
848(@code{function-item} customization types). 848(@code{function-item} customization types).
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index b73e70d1079..54fe43758a5 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2790,7 +2790,7 @@ then the new definition of the @code{mode-line} face inherits from the
2790functions instead of setting @code{face-remapping-alist} directly, to 2790functions instead of setting @code{face-remapping-alist} directly, to
2791avoid trampling on remappings applied elsewhere. These functions are 2791avoid trampling on remappings applied elsewhere. These functions are
2792intended for buffer-local remappings, so they all make 2792intended for buffer-local remappings, so they all make
2793@code{face-remapping-alist} buffer-local as a side-effect. They manage 2793@code{face-remapping-alist} buffer-local as a side-effect. They manage
2794@code{face-remapping-alist} entries of the form 2794@code{face-remapping-alist} entries of the form
2795 2795
2796@example 2796@example
@@ -2820,11 +2820,11 @@ pass this object as an argument to @code{face-remap-remove-relative}
2820if you need to remove the remapping later. 2820if you need to remove the remapping later.
2821 2821
2822@example 2822@example
2823;; Remap the `escape-glyph' face into a combination 2823;; Remap the 'escape-glyph' face into a combination
2824;; of the `highlight' and `italic' faces: 2824;; of the 'highlight' and 'italic' faces:
2825(face-remap-add-relative 'escape-glyph 'highlight 'italic) 2825(face-remap-add-relative 'escape-glyph 'highlight 'italic)
2826 2826
2827;; Increase the size of the `default' face by 50%: 2827;; Increase the size of the 'default' face by 50%:
2828(face-remap-add-relative 'default :height 1.5) 2828(face-remap-add-relative 'default :height 1.5)
2829@end example 2829@end example
2830@end defun 2830@end defun
@@ -4557,7 +4557,7 @@ not affect the amount of raising or lowering, which is based on the
4557faces used for the text. 4557faces used for the text.
4558@end table 4558@end table
4559 4559
4560@c We put all the `@code{(when ...)}' on one line to encourage 4560@c We put all the '@code{(when ...)}' on one line to encourage
4561@c makeinfo's end-of-sentence heuristics to DTRT. Previously, the dot 4561@c makeinfo's end-of-sentence heuristics to DTRT. Previously, the dot
4562@c was at eol; the info file ended up w/ two spaces rendered after it. 4562@c was at eol; the info file ended up w/ two spaces rendered after it.
4563 You can make any display specification conditional. To do that, 4563 You can make any display specification conditional. To do that,
@@ -5628,7 +5628,7 @@ so that it's easy to define special-purpose types of buttons for
5628specific tasks. 5628specific tasks.
5629 5629
5630@defun define-button-type name &rest properties 5630@defun define-button-type name &rest properties
5631Define a `button type' called @var{name} (a symbol). 5631Define a ``button type'' called @var{name} (a symbol).
5632The remaining arguments 5632The remaining arguments
5633form a sequence of @var{property value} pairs, specifying default 5633form a sequence of @var{property value} pairs, specifying default
5634property values for buttons with this type (a button's type may be set 5634property values for buttons with this type (a button's type may be set
@@ -5781,7 +5781,7 @@ Return @code{t} if button-type @var{type} is a subtype of @var{supertype}.
5781These are commands and functions for locating and operating on 5781These are commands and functions for locating and operating on
5782buttons in an Emacs buffer. 5782buttons in an Emacs buffer.
5783 5783
5784@code{push-button} is the command that a user uses to actually `push' 5784@code{push-button} is the command that a user uses to actually ``push''
5785a button, and is bound by default in the button itself to @key{RET} 5785a button, and is bound by default in the button itself to @key{RET}
5786and to @key{mouse-2} using a local keymap in the button's overlay or 5786and to @key{mouse-2} using a local keymap in the button's overlay or
5787text properties. Commands that are useful outside the buttons itself, 5787text properties. Commands that are useful outside the buttons itself,
@@ -6643,7 +6643,7 @@ Non-@acronym{ASCII}, non-printing characters @code{U+0080} to
6643@samp{\230}). 6643@samp{\230}).
6644 6644
6645@item format-control 6645@item format-control
6646Characters of Unicode General Category `Cf', such as @samp{U+200E} 6646Characters of Unicode General Category ``Cf'', such as @samp{U+200E}
6647(Left-to-Right Mark), but excluding characters that have graphic 6647(Left-to-Right Mark), but excluding characters that have graphic
6648images, such as @samp{U+00AD} (Soft Hyphen). 6648images, such as @samp{U+00AD} (Soft Hyphen).
6649 6649
@@ -6652,9 +6652,9 @@ Characters for there is no suitable font, or which cannot be encoded
6652by the terminal's coding system. 6652by the terminal's coding system.
6653@end table 6653@end table
6654 6654
6655@c FIXME: this can also be `acronym', but that's not currently 6655@c FIXME: this can also be 'acronym', but that's not currently
6656@c completely implemented; it applies only to the format-control 6656@c completely implemented; it applies only to the format-control
6657@c group, and only works if the acronym is in `char-acronym-table'. 6657@c group, and only works if the acronym is in 'char-acronym-table'.
6658The @var{method} symbol should be one of @code{zero-width}, 6658The @var{method} symbol should be one of @code{zero-width},
6659@code{thin-space}, @code{empty-box}, or @code{hex-code}. These have 6659@code{thin-space}, @code{empty-box}, or @code{hex-code}. These have
6660the same meanings as in @code{glyphless-char-display}, above. 6660the same meanings as in @code{glyphless-char-display}, above.
diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi
index fc8ba7b4116..bf1fc4db173 100644
--- a/doc/lispref/elisp.texi
+++ b/doc/lispref/elisp.texi
@@ -247,9 +247,9 @@ Appendices
247@end ignore 247@end ignore
248 248
249@c Do NOT modify the following 3 lines! They must have this form to 249@c Do NOT modify the following 3 lines! They must have this form to
250@c be correctly identified by `texinfo-multiple-files-update'. In 250@c be correctly identified by 'texinfo-multiple-files-update'. In
251@c particular, the detailed menu header line MUST be identical to the 251@c particular, the detailed menu header line MUST be identical to the
252@c value of `texinfo-master-menu-header'. See texnfo-upd.el. 252@c value of 'texinfo-master-menu-header'. See texnfo-upd.el.
253 253
254@detailmenu 254@detailmenu
255 --- The Detailed Node Listing --- 255 --- The Detailed Node Listing ---
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 2739e3e509d..f4c9abd5468 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -423,7 +423,7 @@ To do so, execute the following code:
423You might wish to save the file modes value returned by 423You might wish to save the file modes value returned by
424@code{backup-buffer} and use that (if non-@code{nil}) to set the mode 424@code{backup-buffer} and use that (if non-@code{nil}) to set the mode
425bits of the file that you write. This is what @code{save-buffer} 425bits of the file that you write. This is what @code{save-buffer}
426normally does. @xref{Making Backups,, Making Backup Files}. 426normally does. @xref{Making Backups,, Making Backup Files}.
427 427
428The hook functions in @code{write-file-functions} are also responsible 428The hook functions in @code{write-file-functions} are also responsible
429for encoding the data (if desired): they must choose a suitable coding 429for encoding the data (if desired): they must choose a suitable coding
@@ -3352,8 +3352,8 @@ from the buffer is actually written to the file, it intermixes the
3352specified annotations at the corresponding positions. All this takes 3352specified annotations at the corresponding positions. All this takes
3353place without modifying the buffer. 3353place without modifying the buffer.
3354 3354
3355@c ??? What about ``overriding'' conversions like those allowed 3355@c ??? What about "overriding" conversions like those allowed
3356@c ??? for `write-region-annotate-functions', below? --ttn 3356@c ??? for 'write-region-annotate-functions', below? --ttn
3357 3357
3358 In contrast, when reading, the annotations intermixed with the text 3358 In contrast, when reading, the annotations intermixed with the text
3359are handled immediately. @code{insert-file-contents} sets point to 3359are handled immediately. @code{insert-file-contents} sets point to
@@ -3406,8 +3406,8 @@ with one argument, the number of characters inserted, and with point
3406at the beginning of the inserted text. Each function should leave 3406at the beginning of the inserted text. Each function should leave
3407point unchanged, and return the new character count describing the 3407point unchanged, and return the new character count describing the
3408inserted text as modified by the function. 3408inserted text as modified by the function.
3409@c ??? The docstring mentions a handler from `file-name-handler-alist' 3409@c ??? The docstring mentions a handler from 'file-name-handler-alist'
3410@c "intercepting" `insert-file-contents'. Hmmm. --ttn 3410@c "intercepting" 'insert-file-contents'. Hmmm. --ttn
3411@end defvar 3411@end defvar
3412 3412
3413 We invite users to write Lisp programs to store and retrieve text 3413 We invite users to write Lisp programs to store and retrieve text
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 85695c614c8..e19472e3ca3 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2693,7 +2693,7 @@ This function returns @code{t} if the screen can display shades of gray.
2693This function returns non-@code{nil} if all the face attributes in 2693This function returns non-@code{nil} if all the face attributes in
2694@var{attributes} are supported (@pxref{Face Attributes}). 2694@var{attributes} are supported (@pxref{Face Attributes}).
2695 2695
2696The definition of `supported' is somewhat heuristic, but basically 2696The definition of ``supported'' is somewhat heuristic, but basically
2697means that a face containing all the attributes in @var{attributes}, 2697means that a face containing all the attributes in @var{attributes},
2698when merged with the default face for display, can be represented in a 2698when merged with the default face for display, can be represented in a
2699way that's 2699way that's
@@ -2703,14 +2703,14 @@ way that's
2703different in appearance than the default face, and 2703different in appearance than the default face, and
2704 2704
2705@item 2705@item
2706`close in spirit' to what the attributes specify, if not exact. 2706``close in spirit'' to what the attributes specify, if not exact.
2707@end enumerate 2707@end enumerate
2708 2708
2709Point (2) implies that a @code{:weight black} attribute will be 2709Point (2) implies that a @code{:weight black} attribute will be
2710satisfied by any display that can display bold, as will 2710satisfied by any display that can display bold, as will
2711@code{:foreground "yellow"} as long as some yellowish color can be 2711@code{:foreground "yellow"} as long as some yellowish color can be
2712displayed, but @code{:slant italic} will @emph{not} be satisfied by 2712displayed, but @code{:slant italic} will @emph{not} be satisfied by
2713the tty display code's automatic substitution of a `dim' face for 2713the tty display code's automatic substitution of a ``dim'' face for
2714italic. 2714italic.
2715@end defun 2715@end defun
2716 2716
diff --git a/doc/lispref/hash.texi b/doc/lispref/hash.texi
index bfa60e0d2a6..98da321297c 100644
--- a/doc/lispref/hash.texi
+++ b/doc/lispref/hash.texi
@@ -154,7 +154,7 @@ This is equivalent to @code{make-hash-table}, but with a different style
154argument list. The argument @var{test} specifies the method 154argument list. The argument @var{test} specifies the method
155of key lookup. 155of key lookup.
156 156
157This function is obsolete. Use @code{make-hash-table} instead. 157This function is obsolete. Use @code{make-hash-table} instead.
158@end defun 158@end defun
159 159
160You can also create a new hash table using the printed representation 160You can also create a new hash table using the printed representation
diff --git a/doc/lispref/help.texi b/doc/lispref/help.texi
index 5b3dd58dfc5..868d2843569 100644
--- a/doc/lispref/help.texi
+++ b/doc/lispref/help.texi
@@ -171,7 +171,7 @@ several symbols in a @file{*Help*} buffer.
171(defun describe-symbols (pattern) 171(defun describe-symbols (pattern)
172 "Describe the Emacs Lisp symbols matching PATTERN. 172 "Describe the Emacs Lisp symbols matching PATTERN.
173All symbols that have PATTERN in their name are described 173All symbols that have PATTERN in their name are described
174in the `*Help*' buffer." 174in the *Help* buffer."
175 (interactive "sDescribe symbols matching: ") 175 (interactive "sDescribe symbols matching: ")
176 (let ((describe-func 176 (let ((describe-func
177 (function 177 (function
diff --git a/doc/lispref/internals.texi b/doc/lispref/internals.texi
index a5fff724ea1..0b8e28839fc 100644
--- a/doc/lispref/internals.texi
+++ b/doc/lispref/internals.texi
@@ -898,14 +898,14 @@ DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
898@group 898@group
899 switch (coordinates_in_window (w, x, y)) 899 switch (coordinates_in_window (w, x, y))
900 @{ 900 @{
901 case ON_NOTHING: /* NOT in window at all. */ 901 case ON_NOTHING: /* NOT in window at all. */
902 return Qnil; 902 return Qnil;
903@end group 903@end group
904 904
905 ... 905 ...
906 906
907@group 907@group
908 case ON_MODE_LINE: /* In mode line of window. */ 908 case ON_MODE_LINE: /* In mode line of window. */
909 return Qmode_line; 909 return Qmode_line;
910@end group 910@end group
911 911
@@ -1317,8 +1317,8 @@ except to shape their child windows. Emacs Lisp programs usually have
1317no access to the parent windows; they operate on the windows at the 1317no access to the parent windows; they operate on the windows at the
1318leaves of the tree, which actually display buffers. 1318leaves of the tree, which actually display buffers.
1319 1319
1320@c FIXME: These two slots and the `buffer' slot below were replaced 1320@c FIXME: These two slots and the 'buffer' slot below were replaced
1321@c with a single slot `contents' on 2013-03-28. --xfq 1321@c with a single slot 'contents' on 2013-03-28. --xfq
1322@item hchild 1322@item hchild
1323@itemx vchild 1323@itemx vchild
1324These fields contain the window's leftmost child and its topmost child 1324These fields contain the window's leftmost child and its topmost child
diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi
index 0ae8fbd0686..fc1def60207 100644
--- a/doc/lispref/loading.texi
+++ b/doc/lispref/loading.texi
@@ -76,7 +76,7 @@ If Auto Compression mode is enabled, as it is by default, then if
76of the file before trying other file names. It decompresses and loads 76of the file before trying other file names. It decompresses and loads
77it if it exists. It looks for compressed versions by appending each 77it if it exists. It looks for compressed versions by appending each
78of the suffixes in @code{jka-compr-load-suffixes} to the file name. 78of the suffixes in @code{jka-compr-load-suffixes} to the file name.
79The value of this variable must be a list of strings. Its standard 79The value of this variable must be a list of strings. Its standard
80value is @code{(".gz")}. 80value is @code{(".gz")}.
81 81
82If the optional argument @var{nosuffix} is non-@code{nil}, then 82If the optional argument @var{nosuffix} is non-@code{nil}, then
diff --git a/doc/lispref/makefile.w32-in b/doc/lispref/makefile.w32-in
index 4185629180e..c30d6e2d1a4 100644
--- a/doc/lispref/makefile.w32-in
+++ b/doc/lispref/makefile.w32-in
@@ -31,7 +31,7 @@ texinfodir = $(srcdir)/../misc
31INFO_EXT=.info 31INFO_EXT=.info
32INFO_OPTS=--no-split 32INFO_OPTS=--no-split
33 33
34# Redefine `TEX' if `tex' does not invoke plain TeX. For example: 34# Redefine 'TEX' if 'tex' does not invoke plain TeX. For example:
35# TEX=platex 35# TEX=platex
36TEX=tex 36TEX=tex
37INSTALL_INFO = install-info 37INSTALL_INFO = install-info
@@ -102,7 +102,7 @@ srcs = \
102 102
103.PHONY: clean 103.PHONY: clean
104 104
105# The info file is named `elisp'. 105# The info file is named 'elisp'.
106 106
107info: $(infodir)/elisp$(INFO_EXT) 107info: $(infodir)/elisp$(INFO_EXT)
108 108
diff --git a/doc/lispref/markers.texi b/doc/lispref/markers.texi
index 48ac9f05085..109e9359f2c 100644
--- a/doc/lispref/markers.texi
+++ b/doc/lispref/markers.texi
@@ -287,8 +287,8 @@ This function returns the position that @var{marker} points to, or
287This function returns the buffer that @var{marker} points into, or 287This function returns the buffer that @var{marker} points into, or
288@code{nil} if it points nowhere. 288@code{nil} if it points nowhere.
289 289
290@c FIXME: The `buffer' argument of `set-marker' already defaults to 290@c FIXME: The 'buffer' argument of 'set-marker' already defaults to
291@c the current buffer, why use `(current-buffer)' explicitly here? 291@c the current buffer, why use '(current-buffer)' explicitly here?
292@example 292@example
293@group 293@group
294(setq m (make-marker)) 294(setq m (make-marker))
@@ -712,4 +712,3 @@ A region is valid if it has a non-zero size, or if the user option
712cases, you should not use @code{region-active-p}, since if the region 712cases, you should not use @code{region-active-p}, since if the region
713is empty it is often more appropriate to operate on point. 713is empty it is often more appropriate to operate on point.
714@end defun 714@end defun
715
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index bc247a969c1..8cb0f3db246 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -749,7 +749,7 @@ The new mode has its own abbrev table, kept in the variable
749@item 749@item
750The new mode has its own mode hook, @code{@var{variant}-hook}. It 750The new mode has its own mode hook, @code{@var{variant}-hook}. It
751runs this hook, after running the hooks of its ancestor modes, with 751runs this hook, after running the hooks of its ancestor modes, with
752@code{run-mode-hooks}, as the last thing it does. @xref{Mode Hooks}. 752@code{run-mode-hooks}, as the last thing it does. @xref{Mode Hooks}.
753@end itemize 753@end itemize
754 754
755In addition, you can specify how to override other aspects of 755In addition, you can specify how to override other aspects of
@@ -1122,7 +1122,7 @@ the conventions listed above:
1122 (let ((st (make-syntax-table))) 1122 (let ((st (make-syntax-table)))
1123 (modify-syntax-entry ?\" ". " st) 1123 (modify-syntax-entry ?\" ". " st)
1124 (modify-syntax-entry ?\\ ". " st) 1124 (modify-syntax-entry ?\\ ". " st)
1125 ;; Add `p' so M-c on `hello' leads to `Hello', not `hello'. 1125 ;; Add 'p' so M-c on 'hello' leads to 'Hello', not 'hello'.
1126 (modify-syntax-entry ?' "w p" st) 1126 (modify-syntax-entry ?' "w p" st)
1127 st) 1127 st)
1128 "Syntax table used while in `text-mode'.") 1128 "Syntax table used while in `text-mode'.")
@@ -3425,7 +3425,7 @@ provided grammar is precise enough, @code{transpose-sexps} can correctly
3425transpose the two arguments of a @code{+} operator, taking into account 3425transpose the two arguments of a @code{+} operator, taking into account
3426the precedence rules of the language. 3426the precedence rules of the language.
3427 3427
3428Calling `smie-setup' is also sufficient to make TAB indentation work in 3428Calling @code{smie-setup} is also sufficient to make TAB indentation work in
3429the expected way, extends @code{blink-matching-paren} to apply to 3429the expected way, extends @code{blink-matching-paren} to apply to
3430elements like @code{begin...end}, and provides some commands that you 3430elements like @code{begin...end}, and provides some commands that you
3431can bind in the major mode keymap. 3431can bind in the major mode keymap.
@@ -3874,7 +3874,7 @@ of instructions (enclosed in a @code{@{...@}} or @code{begin...end}
3874block). 3874block).
3875 3875
3876@var{method} should be the method name that was passed to 3876@var{method} should be the method name that was passed to
3877`smie-rules-function'. 3877@code{smie-rules-function}.
3878@end defun 3878@end defun
3879 3879
3880@node SMIE Indentation Example 3880@node SMIE Indentation Example
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index 50e50ff39a6..05d5ca48043 100644
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -248,7 +248,7 @@ unibyte string, it is returned unchanged. Use this function for
248characters. 248characters.
249@end defun 249@end defun
250 250
251@c FIXME: Should `@var{character}' be `@var{byte}'? 251@c FIXME: Should '@var{character}' be '@var{byte}'?
252@defun byte-to-string byte 252@defun byte-to-string byte
253@cindex byte to string 253@cindex byte to string
254This function returns a unibyte string containing a single byte of 254This function returns a unibyte string containing a single byte of
@@ -1375,7 +1375,7 @@ alternatives described above.
1375 1375
1376The optional argument @var{accept-default-p}, if non-@code{nil}, 1376The optional argument @var{accept-default-p}, if non-@code{nil},
1377should be a function to determine whether a coding system selected 1377should be a function to determine whether a coding system selected
1378without user interaction is acceptable. @code{select-safe-coding-system} 1378without user interaction is acceptable. @code{select-safe-coding-system}
1379calls this function with one argument, the base coding system of the 1379calls this function with one argument, the base coding system of the
1380selected coding system. If @var{accept-default-p} returns @code{nil}, 1380selected coding system. If @var{accept-default-p} returns @code{nil},
1381@code{select-safe-coding-system} rejects the silently selected coding 1381@code{select-safe-coding-system} rejects the silently selected coding
@@ -1437,7 +1437,7 @@ don't change these variables; instead, override them using
1437@cindex file contents, and default coding system 1437@cindex file contents, and default coding system
1438@defopt auto-coding-regexp-alist 1438@defopt auto-coding-regexp-alist
1439This variable is an alist of text patterns and corresponding coding 1439This variable is an alist of text patterns and corresponding coding
1440systems. Each element has the form @code{(@var{regexp} 1440systems. Each element has the form @code{(@var{regexp}
1441. @var{coding-system})}; a file whose first few kilobytes match 1441. @var{coding-system})}; a file whose first few kilobytes match
1442@var{regexp} is decoded with @var{coding-system} when its contents are 1442@var{regexp} is decoded with @var{coding-system} when its contents are
1443read into a buffer. The settings in this alist take priority over 1443read into a buffer. The settings in this alist take priority over
diff --git a/doc/lispref/objects.texi b/doc/lispref/objects.texi
index f4beca822cd..c7d71d2aba9 100644
--- a/doc/lispref/objects.texi
+++ b/doc/lispref/objects.texi
@@ -595,8 +595,8 @@ FOO ; @r{A symbol named @samp{FOO}, different from @samp{foo}.}
595 595
596@cindex @samp{##} read syntax 596@cindex @samp{##} read syntax
597@ifinfo 597@ifinfo
598@c This uses ``colon'' instead of a literal `:' because Info cannot 598@c This uses "colon" instead of a literal ':' because Info cannot
599@c cope with a `:' in a menu 599@c cope with a ':' in a menu.
600@cindex @samp{#@var{colon}} read syntax 600@cindex @samp{#@var{colon}} read syntax
601@end ifinfo 601@end ifinfo
602@ifnotinfo 602@ifnotinfo
@@ -999,7 +999,7 @@ of a string returns the same string.
999 The read syntax for a string is a double-quote, an arbitrary number 999 The read syntax for a string is a double-quote, an arbitrary number
1000of characters, and another double-quote, @code{"like this"}. To 1000of characters, and another double-quote, @code{"like this"}. To
1001include a double-quote in a string, precede it with a backslash; thus, 1001include a double-quote in a string, precede it with a backslash; thus,
1002@code{"\""} is a string containing just a single double-quote 1002@code{"\""} is a string containing just one double-quote
1003character. Likewise, you can include a backslash by preceding it with 1003character. Likewise, you can include a backslash by preceding it with
1004another backslash, like this: @code{"this \\ is a single embedded 1004another backslash, like this: @code{"this \\ is a single embedded
1005backslash"}. 1005backslash"}.
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index 4df4a597ea6..97fa083e07d 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -974,7 +974,7 @@ to access the value of @var{variable}. If @var{value} is omitted or
974removes @var{variable} from the environment. Otherwise, @var{value} 974removes @var{variable} from the environment. Otherwise, @var{value}
975should be a string. 975should be a string.
976 976
977@c FIXME: Document `substitute-env-vars'? --xfq 977@c FIXME: Document 'substitute-env-vars'? --xfq
978If the optional argument @var{substitute} is non-@code{nil}, Emacs 978If the optional argument @var{substitute} is non-@code{nil}, Emacs
979calls the function @code{substitute-env-vars} to expand any 979calls the function @code{substitute-env-vars} to expand any
980environment variables in @var{value}. 980environment variables in @var{value}.
@@ -2384,7 +2384,7 @@ The path to a sound file to play when the notification pops up.
2384@item :sound-name @var{name} 2384@item :sound-name @var{name}
2385A themable named sound from the freedesktop.org sound naming 2385A themable named sound from the freedesktop.org sound naming
2386specification from @samp{$XDG_DATA_DIRS/sounds}, to play when the 2386specification from @samp{$XDG_DATA_DIRS/sounds}, to play when the
2387notification pops up. Similar to the icon name, only for sounds. An 2387notification pops up. Similar to the icon name, only for sounds. An
2388example would be @samp{"message-new-instant"}. 2388example would be @samp{"message-new-instant"}.
2389 2389
2390@item :suppress-sound 2390@item :suppress-sound
@@ -2393,9 +2393,9 @@ ability.
2393 2393
2394@item :resident 2394@item :resident
2395When set the server will not automatically remove the notification 2395When set the server will not automatically remove the notification
2396when an action has been invoked. The notification will remain resident 2396when an action has been invoked. The notification will remain resident
2397in the server until it is explicitly removed by the user or by the 2397in the server until it is explicitly removed by the user or by the
2398sender. This hint is likely only useful when the server has the 2398sender. This hint is likely only useful when the server has the
2399@code{:persistence} capability. 2399@code{:persistence} capability.
2400 2400
2401@item :transient 2401@item :transient
diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi
index 103161c7ae2..fc47f1c7a78 100644
--- a/doc/lispref/positions.texi
+++ b/doc/lispref/positions.texi
@@ -664,7 +664,7 @@ quotes are ignored.)
664This function moves forward out of @var{arg} (default 1) levels of 664This function moves forward out of @var{arg} (default 1) levels of
665parentheses. A negative argument means move backward but still to a 665parentheses. A negative argument means move backward but still to a
666less deep spot. If @var{escape-strings} is non-@code{nil} (as it is 666less deep spot. If @var{escape-strings} is non-@code{nil} (as it is
667interactively), move out of enclosing strings as well. If 667interactively), move out of enclosing strings as well. If
668@var{no-syntax-crossing} is non-@code{nil} (as it is interactively), prefer 668@var{no-syntax-crossing} is non-@code{nil} (as it is interactively), prefer
669to break out of any enclosing string instead of moving to the start of 669to break out of any enclosing string instead of moving to the start of
670a list broken across multiple strings. On error, location of point is 670a list broken across multiple strings. On error, location of point is
diff --git a/doc/lispref/strings.texi b/doc/lispref/strings.texi
index aca6189d7bf..c2f06079cb6 100644
--- a/doc/lispref/strings.texi
+++ b/doc/lispref/strings.texi
@@ -956,12 +956,12 @@ is not truncated.
956 956
957@example 957@example
958@group 958@group
959(format "The word `%7s' has %d letters in it." 959(format "The word '%7s' has %d letters in it."
960 "foo" (length "foo")) 960 "foo" (length "foo"))
961 @result{} "The word ` foo' has 3 letters in it." 961 @result{} "The word ' foo' has 3 letters in it."
962(format "The word `%7s' has %d letters in it." 962(format "The word '%7s' has %d letters in it."
963 "specification" (length "specification")) 963 "specification" (length "specification"))
964 @result{} "The word `specification' has 13 letters in it." 964 @result{} "The word 'specification' has 13 letters in it."
965@end group 965@end group
966@end example 966@end example
967 967
@@ -1003,9 +1003,9 @@ ignored.
1003(format "%-6d is padded on the right" 123) 1003(format "%-6d is padded on the right" 123)
1004 @result{} "123 is padded on the right" 1004 @result{} "123 is padded on the right"
1005 1005
1006(format "The word `%-7s' actually has %d letters in it." 1006(format "The word '%-7s' actually has %d letters in it."
1007 "foo" (length "foo")) 1007 "foo" (length "foo"))
1008 @result{} "The word `foo ' actually has 3 letters in it." 1008 @result{} "The word 'foo ' actually has 3 letters in it."
1009@end group 1009@end group
1010@end example 1010@end example
1011 1011
diff --git a/doc/lispref/syntax.texi b/doc/lispref/syntax.texi
index 1f1dd6e8bef..90daf34f0dc 100644
--- a/doc/lispref/syntax.texi
+++ b/doc/lispref/syntax.texi
@@ -203,7 +203,7 @@ suppressed.
203The Lisp modes have two string quote characters: double-quote (@samp{"}) 203The Lisp modes have two string quote characters: double-quote (@samp{"})
204and vertical bar (@samp{|}). @samp{|} is not used in Emacs Lisp, but it 204and vertical bar (@samp{|}). @samp{|} is not used in Emacs Lisp, but it
205is used in Common Lisp. C also has two string quote characters: 205is used in Common Lisp. C also has two string quote characters:
206double-quote for strings, and single-quote (@samp{'}) for character 206double-quote for strings, and apostrophe (@samp{'}) for character
207constants. 207constants.
208 208
209Human text has no string quote characters. We do not want quotation 209Human text has no string quote characters. We do not want quotation
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index da67ec2b541..d4b6950ee95 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -512,7 +512,7 @@ non-@code{nil} and the character inserted is in the table
512@c Cross refs reworded to prevent overfull hbox. --rjc 15mar92 512@c Cross refs reworded to prevent overfull hbox. --rjc 15mar92
513This command performs abbrev expansion if Abbrev mode is enabled and 513This command performs abbrev expansion if Abbrev mode is enabled and
514the inserted character does not have word-constituent 514the inserted character does not have word-constituent
515syntax. (@xref{Abbrevs}, and @ref{Syntax Class Table}.) It is also 515syntax. (@xref{Abbrevs}, and @ref{Syntax Class Table}.) It is also
516responsible for calling @code{blink-paren-function} when the inserted 516responsible for calling @code{blink-paren-function} when the inserted
517character has close parenthesis syntax (@pxref{Blinking}). 517character has close parenthesis syntax (@pxref{Blinking}).
518 518
diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi
index 8970efe72fb..cc1f0e42750 100644
--- a/doc/lispref/tips.texi
+++ b/doc/lispref/tips.texi
@@ -657,23 +657,18 @@ starting double-quote is not part of the string!
657 657
658@anchor{Docstring hyperlinks} 658@anchor{Docstring hyperlinks}
659@item 659@item
660@iftex
661When a documentation string refers to a Lisp symbol, write it as it 660When a documentation string refers to a Lisp symbol, write it as it
662would be printed (which usually means in lower case), with single-quotes 661would be printed (which usually means in lower case), with a grave
663around it. For example: @samp{`lambda'}. There are two exceptions: 662accent @samp{`} before and apostrophe @samp{'} after it. There are
664write @code{t} and @code{nil} without single-quotes. 663two exceptions: write @code{t} and @code{nil} without surrounding
665@end iftex 664punctuation. For example: @samp{CODE can be `lambda', nil, or t.}
666@ifnottex 665(In this manual, we use a different convention, with single-quotes
667When a documentation string refers to a Lisp symbol, write it as it 666around symbols.)
668would be printed (which usually means in lower case), with single-quotes
669around it. For example: @samp{lambda}. There are two exceptions: write
670t and nil without single-quotes. (In this manual, we use a different
671convention, with single-quotes for all symbols.)
672@end ifnottex
673 667
674@cindex hyperlinks in documentation strings 668@cindex hyperlinks in documentation strings
675Help mode automatically creates a hyperlink when a documentation string 669Help mode automatically creates a hyperlink when a documentation string
676uses a symbol name inside single quotes, if the symbol has either a 670uses a symbol name between grave accent and apostrophe, if the symbol
671has either a
677function or a variable definition. You do not need to do anything 672function or a variable definition. You do not need to do anything
678special to make use of this feature. However, when a symbol has both a 673special to make use of this feature. However, when a symbol has both a
679function definition and a variable definition, and you want to refer to 674function definition and a variable definition, and you want to refer to
@@ -716,16 +711,16 @@ documentation will be shown, even if the symbol is also defined as a
716variable or as a function. 711variable or as a function.
717 712
718To make a hyperlink to Info documentation, write the name of the Info 713To make a hyperlink to Info documentation, write the name of the Info
719node (or anchor) in single quotes, preceded by @samp{info node}, 714node (or anchor) between grave accent and apostrophe, preceded by
720@samp{Info node}, @samp{info anchor} or @samp{Info anchor}. The Info 715@samp{info node}, @samp{Info node}, @samp{info anchor} or @samp{Info
721file name defaults to @samp{emacs}. For example, 716anchor}. The Info file name defaults to @samp{emacs}. For example,
722 717
723@smallexample 718@smallexample
724See Info node `Font Lock' and Info node `(elisp)Font Lock Basics'. 719See Info node `Font Lock' and Info node `(elisp)Font Lock Basics'.
725@end smallexample 720@end smallexample
726 721
727Finally, to create a hyperlink to URLs, write the URL in single 722Finally, to create a hyperlink to URLs, write the URL between grave
728quotes, preceded by @samp{URL}. For example, 723accent and apostrophe, preceded by @samp{URL}. For example,
729 724
730@smallexample 725@smallexample
731The home page for the GNU project has more information (see URL 726The home page for the GNU project has more information (see URL
diff --git a/doc/lispref/two-volume-cross-refs.txt b/doc/lispref/two-volume-cross-refs.txt
index eded8c44f2e..89336e1d43b 100644
--- a/doc/lispref/two-volume-cross-refs.txt
+++ b/doc/lispref/two-volume-cross-refs.txt
@@ -108,8 +108,8 @@ on elisp2-fn-vol-number-added
108(volume-index-markup "II") 108(volume-index-markup "II")
109to create elisp2-fn-vol-number-added 109to create elisp2-fn-vol-number-added
110 110
111insert elisp2-fn-vol-number-added into vol1.fn: do following `cat' 111insert elisp2-fn-vol-number-added into vol1.fn: do following 'cat'
112insert elisp1-fn-vol-number-added into vol2.fn: do following `cat' 112insert elisp1-fn-vol-number-added into vol2.fn: do following 'cat'
113 113
114% cat elisp2-fn-vol-number-added >> vol1.fn 114% cat elisp2-fn-vol-number-added >> vol1.fn
115% cat elisp1-fn-vol-number-added >> vol2.fn 115% cat elisp1-fn-vol-number-added >> vol2.fn
@@ -126,7 +126,7 @@ Be sure that .fn file has no blank lines.
126 126
127### Create merged .toc file with volume number headings. 127### Create merged .toc file with volume number headings.
128 128
129append vol2.toc to vol1.toc with following `cat' 129append vol2.toc to vol1.toc with following 'cat'
130 130
131% cat vol1.toc vol2.toc > elisp-toc-2vol.toc 131% cat vol1.toc vol2.toc > elisp-toc-2vol.toc
132 132
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 8d6e1249478..6da3582ddd1 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -2412,7 +2412,7 @@ the window split and the values of
2412and @code{split-width-threshold} (@pxref{Choosing Window Options}). 2412and @code{split-width-threshold} (@pxref{Choosing Window Options}).
2413 2413
2414 Now suppose we combine this call with a preexisting setup for 2414 Now suppose we combine this call with a preexisting setup for
2415`display-buffer-alist' as follows. 2415@code{display-buffer-alist} as follows.
2416 2416
2417@example 2417@example
2418@group 2418@group