diff options
| author | Paul Eggert | 2015-04-10 11:27:21 -0700 |
|---|---|---|
| committer | Paul Eggert | 2015-04-10 11:28:52 -0700 |
| commit | a2940cd43e7931d16d3a3ce2cf5d4acd148dd00c (patch) | |
| tree | d0345ac3f2d34ee9e734a8824691c1dcadf287e5 | |
| parent | ca401f6fdc512f79d6015c1759a0e8e0c3de5c9a (diff) | |
| download | emacs-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/README | 6 | ||||
| -rw-r--r-- | doc/lispref/buffers.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/commands.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/control.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/customize.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/display.texi | 20 | ||||
| -rw-r--r-- | doc/lispref/elisp.texi | 4 | ||||
| -rw-r--r-- | doc/lispref/files.texi | 10 | ||||
| -rw-r--r-- | doc/lispref/frames.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/hash.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/help.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/internals.texi | 8 | ||||
| -rw-r--r-- | doc/lispref/loading.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/makefile.w32-in | 4 | ||||
| -rw-r--r-- | doc/lispref/markers.texi | 5 | ||||
| -rw-r--r-- | doc/lispref/modes.texi | 8 | ||||
| -rw-r--r-- | doc/lispref/nonascii.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/objects.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/os.texi | 8 | ||||
| -rw-r--r-- | doc/lispref/positions.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/strings.texi | 12 | ||||
| -rw-r--r-- | doc/lispref/syntax.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/text.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/tips.texi | 31 | ||||
| -rw-r--r-- | doc/lispref/two-volume-cross-refs.txt | 6 | ||||
| -rw-r--r-- | doc/lispref/windows.texi | 2 |
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 | |||
| 21 | development work. See <http://shop.fsf.org/>. | 21 | development 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'. |
| 25 | It contains @include commands to include all the chapters that make up | 25 | It contains @include commands to include all the chapters that make up |
| 26 | the manual. | 26 | the 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 | ||
| 35 | This file is part of GNU Emacs. | 35 | This 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 | ||
| 845 | If @var{buffer} is not supplied (or if it is not a live buffer), then | 845 | If @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 |
| 847 | local buffer list. (If @var{frame} is non-@code{nil}, it returns the | 847 | local buffer list. (If @var{frame} is non-@code{nil}, it returns the |
| 848 | first buffer in @var{frame}'s local buffer list instead.) | 848 | first buffer in @var{frame}'s local buffer list instead.) |
| 849 | 849 | ||
| 850 | If @var{frame} has a non-@code{nil} @code{buffer-predicate} parameter, | 850 | If @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 |
| 1463 | handle), @code{up} (the up arrow at one end of the scroll bar), or | 1463 | handle), @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 |
| 1723 | This kind of event is generated only on some kinds of systems. On some | 1723 | This kind of event is generated only on some kinds of systems. On some |
| 1724 | systems, @code{mouse-4} and @code{mouse-5} are used instead. For | 1724 | systems, @code{mouse-4} and @code{mouse-5} are used instead. For |
| 1725 | portable code, use the variables @code{mouse-wheel-up-event} and | 1725 | portable 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 | ||
| 1858 | The frame with input focus might not take up the entire screen, and | 1858 | The frame with input focus might not take up the entire screen, and |
| 1859 | the user might move the mouse outside the scope of the frame. Inside | 1859 | the user might move the mouse outside the scope of the frame. Inside |
| 1860 | the @code{track-mouse} special form, that produces an event like this: | 1860 | the @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 | ||
| 1026 | The argument @var{error-symbol} must be an @dfn{error symbol}---a symbol | 1026 | The argument @var{error-symbol} must be an @dfn{error symbol}---a symbol |
| 1027 | defined with @code{define-error}. This is how Emacs Lisp classifies different | 1027 | defined with @code{define-error}. This is how Emacs Lisp classifies different |
| 1028 | sorts of errors. @xref{Error Symbols}, for a description of error symbols, | 1028 | sorts of errors. @xref{Error Symbols}, for a description of error symbols, |
| 1029 | error conditions and condition names. | 1029 | error conditions and condition names. |
| 1030 | 1030 | ||
| 1031 | If the error is not handled, the two arguments are used in printing | 1031 | If 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{}) |
| 844 | This is similar to @code{choice}, except that the choices are displayed | 844 | This is similar to @code{choice}, except that the choices are displayed |
| 845 | using `radio buttons' rather than a menu. This has the advantage of | 845 | using ``radio buttons'' rather than a menu. This has the advantage of |
| 846 | displaying documentation for the choices when applicable and so is often | 846 | displaying documentation for the choices when applicable and so is often |
| 847 | a good choice for a choice between constant functions | 847 | a 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 | |||
| 2790 | functions instead of setting @code{face-remapping-alist} directly, to | 2790 | functions instead of setting @code{face-remapping-alist} directly, to |
| 2791 | avoid trampling on remappings applied elsewhere. These functions are | 2791 | avoid trampling on remappings applied elsewhere. These functions are |
| 2792 | intended for buffer-local remappings, so they all make | 2792 | intended 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} | |||
| 2820 | if you need to remove the remapping later. | 2820 | if 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 | |||
| 4557 | faces used for the text. | 4557 | faces 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 | |||
| 5628 | specific tasks. | 5628 | specific tasks. |
| 5629 | 5629 | ||
| 5630 | @defun define-button-type name &rest properties | 5630 | @defun define-button-type name &rest properties |
| 5631 | Define a `button type' called @var{name} (a symbol). | 5631 | Define a ``button type'' called @var{name} (a symbol). |
| 5632 | The remaining arguments | 5632 | The remaining arguments |
| 5633 | form a sequence of @var{property value} pairs, specifying default | 5633 | form a sequence of @var{property value} pairs, specifying default |
| 5634 | property values for buttons with this type (a button's type may be set | 5634 | property 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}. | |||
| 5781 | These are commands and functions for locating and operating on | 5781 | These are commands and functions for locating and operating on |
| 5782 | buttons in an Emacs buffer. | 5782 | buttons 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'' |
| 5785 | a button, and is bound by default in the button itself to @key{RET} | 5785 | a button, and is bound by default in the button itself to @key{RET} |
| 5786 | and to @key{mouse-2} using a local keymap in the button's overlay or | 5786 | and to @key{mouse-2} using a local keymap in the button's overlay or |
| 5787 | text properties. Commands that are useful outside the buttons itself, | 5787 | text 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 |
| 6646 | Characters of Unicode General Category `Cf', such as @samp{U+200E} | 6646 | Characters 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 |
| 6648 | images, such as @samp{U+00AD} (Soft Hyphen). | 6648 | images, 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 | |||
| 6652 | by the terminal's coding system. | 6652 | by 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'. |
| 6658 | The @var{method} symbol should be one of @code{zero-width}, | 6658 | The @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 |
| 6660 | the same meanings as in @code{glyphless-char-display}, above. | 6660 | the 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: | |||
| 423 | You might wish to save the file modes value returned by | 423 | You 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 |
| 425 | bits of the file that you write. This is what @code{save-buffer} | 425 | bits of the file that you write. This is what @code{save-buffer} |
| 426 | normally does. @xref{Making Backups,, Making Backup Files}. | 426 | normally does. @xref{Making Backups,, Making Backup Files}. |
| 427 | 427 | ||
| 428 | The hook functions in @code{write-file-functions} are also responsible | 428 | The hook functions in @code{write-file-functions} are also responsible |
| 429 | for encoding the data (if desired): they must choose a suitable coding | 429 | for 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 | |||
| 3352 | specified annotations at the corresponding positions. All this takes | 3352 | specified annotations at the corresponding positions. All this takes |
| 3353 | place without modifying the buffer. | 3353 | place 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 |
| 3359 | are handled immediately. @code{insert-file-contents} sets point to | 3359 | are handled immediately. @code{insert-file-contents} sets point to |
| @@ -3406,8 +3406,8 @@ with one argument, the number of characters inserted, and with point | |||
| 3406 | at the beginning of the inserted text. Each function should leave | 3406 | at the beginning of the inserted text. Each function should leave |
| 3407 | point unchanged, and return the new character count describing the | 3407 | point unchanged, and return the new character count describing the |
| 3408 | inserted text as modified by the function. | 3408 | inserted 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. | |||
| 2693 | This function returns non-@code{nil} if all the face attributes in | 2693 | This 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 | ||
| 2696 | The definition of `supported' is somewhat heuristic, but basically | 2696 | The definition of ``supported'' is somewhat heuristic, but basically |
| 2697 | means that a face containing all the attributes in @var{attributes}, | 2697 | means that a face containing all the attributes in @var{attributes}, |
| 2698 | when merged with the default face for display, can be represented in a | 2698 | when merged with the default face for display, can be represented in a |
| 2699 | way that's | 2699 | way that's |
| @@ -2703,14 +2703,14 @@ way that's | |||
| 2703 | different in appearance than the default face, and | 2703 | different 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 | ||
| 2709 | Point (2) implies that a @code{:weight black} attribute will be | 2709 | Point (2) implies that a @code{:weight black} attribute will be |
| 2710 | satisfied by any display that can display bold, as will | 2710 | satisfied 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 |
| 2712 | displayed, but @code{:slant italic} will @emph{not} be satisfied by | 2712 | displayed, but @code{:slant italic} will @emph{not} be satisfied by |
| 2713 | the tty display code's automatic substitution of a `dim' face for | 2713 | the tty display code's automatic substitution of a ``dim'' face for |
| 2714 | italic. | 2714 | italic. |
| 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 | |||
| 154 | argument list. The argument @var{test} specifies the method | 154 | argument list. The argument @var{test} specifies the method |
| 155 | of key lookup. | 155 | of key lookup. |
| 156 | 156 | ||
| 157 | This function is obsolete. Use @code{make-hash-table} instead. | 157 | This function is obsolete. Use @code{make-hash-table} instead. |
| 158 | @end defun | 158 | @end defun |
| 159 | 159 | ||
| 160 | You can also create a new hash table using the printed representation | 160 | You 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. |
| 173 | All symbols that have PATTERN in their name are described | 173 | All symbols that have PATTERN in their name are described |
| 174 | in the `*Help*' buffer." | 174 | in 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 | |||
| 1317 | no access to the parent windows; they operate on the windows at the | 1317 | no access to the parent windows; they operate on the windows at the |
| 1318 | leaves of the tree, which actually display buffers. | 1318 | leaves 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 |
| 1324 | These fields contain the window's leftmost child and its topmost child | 1324 | These 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 | |||
| 76 | of the file before trying other file names. It decompresses and loads | 76 | of the file before trying other file names. It decompresses and loads |
| 77 | it if it exists. It looks for compressed versions by appending each | 77 | it if it exists. It looks for compressed versions by appending each |
| 78 | of the suffixes in @code{jka-compr-load-suffixes} to the file name. | 78 | of the suffixes in @code{jka-compr-load-suffixes} to the file name. |
| 79 | The value of this variable must be a list of strings. Its standard | 79 | The value of this variable must be a list of strings. Its standard |
| 80 | value is @code{(".gz")}. | 80 | value is @code{(".gz")}. |
| 81 | 81 | ||
| 82 | If the optional argument @var{nosuffix} is non-@code{nil}, then | 82 | If 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 | |||
| 31 | INFO_EXT=.info | 31 | INFO_EXT=.info |
| 32 | INFO_OPTS=--no-split | 32 | INFO_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 |
| 36 | TEX=tex | 36 | TEX=tex |
| 37 | INSTALL_INFO = install-info | 37 | INSTALL_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 | ||
| 107 | info: $(infodir)/elisp$(INFO_EXT) | 107 | info: $(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 | |||
| 287 | This function returns the buffer that @var{marker} points into, or | 287 | This 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 | |||
| 712 | cases, you should not use @code{region-active-p}, since if the region | 712 | cases, you should not use @code{region-active-p}, since if the region |
| 713 | is empty it is often more appropriate to operate on point. | 713 | is 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 |
| 750 | The new mode has its own mode hook, @code{@var{variant}-hook}. It | 750 | The new mode has its own mode hook, @code{@var{variant}-hook}. It |
| 751 | runs this hook, after running the hooks of its ancestor modes, with | 751 | runs 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 | ||
| 755 | In addition, you can specify how to override other aspects of | 755 | In 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 | |||
| 3425 | transpose the two arguments of a @code{+} operator, taking into account | 3425 | transpose the two arguments of a @code{+} operator, taking into account |
| 3426 | the precedence rules of the language. | 3426 | the precedence rules of the language. |
| 3427 | 3427 | ||
| 3428 | Calling `smie-setup' is also sufficient to make TAB indentation work in | 3428 | Calling @code{smie-setup} is also sufficient to make TAB indentation work in |
| 3429 | the expected way, extends @code{blink-matching-paren} to apply to | 3429 | the expected way, extends @code{blink-matching-paren} to apply to |
| 3430 | elements like @code{begin...end}, and provides some commands that you | 3430 | elements like @code{begin...end}, and provides some commands that you |
| 3431 | can bind in the major mode keymap. | 3431 | can bind in the major mode keymap. |
| @@ -3874,7 +3874,7 @@ of instructions (enclosed in a @code{@{...@}} or @code{begin...end} | |||
| 3874 | block). | 3874 | block). |
| 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 | |||
| 248 | characters. | 248 | characters. |
| 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 |
| 254 | This function returns a unibyte string containing a single byte of | 254 | This function returns a unibyte string containing a single byte of |
| @@ -1375,7 +1375,7 @@ alternatives described above. | |||
| 1375 | 1375 | ||
| 1376 | The optional argument @var{accept-default-p}, if non-@code{nil}, | 1376 | The optional argument @var{accept-default-p}, if non-@code{nil}, |
| 1377 | should be a function to determine whether a coding system selected | 1377 | should be a function to determine whether a coding system selected |
| 1378 | without user interaction is acceptable. @code{select-safe-coding-system} | 1378 | without user interaction is acceptable. @code{select-safe-coding-system} |
| 1379 | calls this function with one argument, the base coding system of the | 1379 | calls this function with one argument, the base coding system of the |
| 1380 | selected coding system. If @var{accept-default-p} returns @code{nil}, | 1380 | selected 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 |
| 1439 | This variable is an alist of text patterns and corresponding coding | 1439 | This variable is an alist of text patterns and corresponding coding |
| 1440 | systems. Each element has the form @code{(@var{regexp} | 1440 | systems. 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 |
| 1443 | read into a buffer. The settings in this alist take priority over | 1443 | read 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 |
| 1000 | of characters, and another double-quote, @code{"like this"}. To | 1000 | of characters, and another double-quote, @code{"like this"}. To |
| 1001 | include a double-quote in a string, precede it with a backslash; thus, | 1001 | include 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 |
| 1003 | character. Likewise, you can include a backslash by preceding it with | 1003 | character. Likewise, you can include a backslash by preceding it with |
| 1004 | another backslash, like this: @code{"this \\ is a single embedded | 1004 | another backslash, like this: @code{"this \\ is a single embedded |
| 1005 | backslash"}. | 1005 | backslash"}. |
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 | |||
| 974 | removes @var{variable} from the environment. Otherwise, @var{value} | 974 | removes @var{variable} from the environment. Otherwise, @var{value} |
| 975 | should be a string. | 975 | should be a string. |
| 976 | 976 | ||
| 977 | @c FIXME: Document `substitute-env-vars'? --xfq | 977 | @c FIXME: Document 'substitute-env-vars'? --xfq |
| 978 | If the optional argument @var{substitute} is non-@code{nil}, Emacs | 978 | If the optional argument @var{substitute} is non-@code{nil}, Emacs |
| 979 | calls the function @code{substitute-env-vars} to expand any | 979 | calls the function @code{substitute-env-vars} to expand any |
| 980 | environment variables in @var{value}. | 980 | environment 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} |
| 2385 | A themable named sound from the freedesktop.org sound naming | 2385 | A themable named sound from the freedesktop.org sound naming |
| 2386 | specification from @samp{$XDG_DATA_DIRS/sounds}, to play when the | 2386 | specification from @samp{$XDG_DATA_DIRS/sounds}, to play when the |
| 2387 | notification pops up. Similar to the icon name, only for sounds. An | 2387 | notification pops up. Similar to the icon name, only for sounds. An |
| 2388 | example would be @samp{"message-new-instant"}. | 2388 | example 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 |
| 2395 | When set the server will not automatically remove the notification | 2395 | When set the server will not automatically remove the notification |
| 2396 | when an action has been invoked. The notification will remain resident | 2396 | when an action has been invoked. The notification will remain resident |
| 2397 | in the server until it is explicitly removed by the user or by the | 2397 | in the server until it is explicitly removed by the user or by the |
| 2398 | sender. This hint is likely only useful when the server has the | 2398 | sender. 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.) | |||
| 664 | This function moves forward out of @var{arg} (default 1) levels of | 664 | This function moves forward out of @var{arg} (default 1) levels of |
| 665 | parentheses. A negative argument means move backward but still to a | 665 | parentheses. A negative argument means move backward but still to a |
| 666 | less deep spot. If @var{escape-strings} is non-@code{nil} (as it is | 666 | less deep spot. If @var{escape-strings} is non-@code{nil} (as it is |
| 667 | interactively), move out of enclosing strings as well. If | 667 | interactively), 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 |
| 669 | to break out of any enclosing string instead of moving to the start of | 669 | to break out of any enclosing string instead of moving to the start of |
| 670 | a list broken across multiple strings. On error, location of point is | 670 | a 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. | |||
| 203 | The Lisp modes have two string quote characters: double-quote (@samp{"}) | 203 | The Lisp modes have two string quote characters: double-quote (@samp{"}) |
| 204 | and vertical bar (@samp{|}). @samp{|} is not used in Emacs Lisp, but it | 204 | and vertical bar (@samp{|}). @samp{|} is not used in Emacs Lisp, but it |
| 205 | is used in Common Lisp. C also has two string quote characters: | 205 | is used in Common Lisp. C also has two string quote characters: |
| 206 | double-quote for strings, and single-quote (@samp{'}) for character | 206 | double-quote for strings, and apostrophe (@samp{'}) for character |
| 207 | constants. | 207 | constants. |
| 208 | 208 | ||
| 209 | Human text has no string quote characters. We do not want quotation | 209 | Human 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 |
| 513 | This command performs abbrev expansion if Abbrev mode is enabled and | 513 | This command performs abbrev expansion if Abbrev mode is enabled and |
| 514 | the inserted character does not have word-constituent | 514 | the inserted character does not have word-constituent |
| 515 | syntax. (@xref{Abbrevs}, and @ref{Syntax Class Table}.) It is also | 515 | syntax. (@xref{Abbrevs}, and @ref{Syntax Class Table}.) It is also |
| 516 | responsible for calling @code{blink-paren-function} when the inserted | 516 | responsible for calling @code{blink-paren-function} when the inserted |
| 517 | character has close parenthesis syntax (@pxref{Blinking}). | 517 | character 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 | ||
| 661 | When a documentation string refers to a Lisp symbol, write it as it | 660 | When a documentation string refers to a Lisp symbol, write it as it |
| 662 | would be printed (which usually means in lower case), with single-quotes | 661 | would be printed (which usually means in lower case), with a grave |
| 663 | around it. For example: @samp{`lambda'}. There are two exceptions: | 662 | accent @samp{`} before and apostrophe @samp{'} after it. There are |
| 664 | write @code{t} and @code{nil} without single-quotes. | 663 | two exceptions: write @code{t} and @code{nil} without surrounding |
| 665 | @end iftex | 664 | punctuation. For example: @samp{CODE can be `lambda', nil, or t.} |
| 666 | @ifnottex | 665 | (In this manual, we use a different convention, with single-quotes |
| 667 | When a documentation string refers to a Lisp symbol, write it as it | 666 | around symbols.) |
| 668 | would be printed (which usually means in lower case), with single-quotes | ||
| 669 | around it. For example: @samp{lambda}. There are two exceptions: write | ||
| 670 | t and nil without single-quotes. (In this manual, we use a different | ||
| 671 | convention, with single-quotes for all symbols.) | ||
| 672 | @end ifnottex | ||
| 673 | 667 | ||
| 674 | @cindex hyperlinks in documentation strings | 668 | @cindex hyperlinks in documentation strings |
| 675 | Help mode automatically creates a hyperlink when a documentation string | 669 | Help mode automatically creates a hyperlink when a documentation string |
| 676 | uses a symbol name inside single quotes, if the symbol has either a | 670 | uses a symbol name between grave accent and apostrophe, if the symbol |
| 671 | has either a | ||
| 677 | function or a variable definition. You do not need to do anything | 672 | function or a variable definition. You do not need to do anything |
| 678 | special to make use of this feature. However, when a symbol has both a | 673 | special to make use of this feature. However, when a symbol has both a |
| 679 | function definition and a variable definition, and you want to refer to | 674 | function 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 | |||
| 716 | variable or as a function. | 711 | variable or as a function. |
| 717 | 712 | ||
| 718 | To make a hyperlink to Info documentation, write the name of the Info | 713 | To make a hyperlink to Info documentation, write the name of the Info |
| 719 | node (or anchor) in single quotes, preceded by @samp{info node}, | 714 | node (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 |
| 721 | file name defaults to @samp{emacs}. For example, | 716 | anchor}. The Info file name defaults to @samp{emacs}. For example, |
| 722 | 717 | ||
| 723 | @smallexample | 718 | @smallexample |
| 724 | See Info node `Font Lock' and Info node `(elisp)Font Lock Basics'. | 719 | See Info node `Font Lock' and Info node `(elisp)Font Lock Basics'. |
| 725 | @end smallexample | 720 | @end smallexample |
| 726 | 721 | ||
| 727 | Finally, to create a hyperlink to URLs, write the URL in single | 722 | Finally, to create a hyperlink to URLs, write the URL between grave |
| 728 | quotes, preceded by @samp{URL}. For example, | 723 | accent and apostrophe, preceded by @samp{URL}. For example, |
| 729 | 724 | ||
| 730 | @smallexample | 725 | @smallexample |
| 731 | The home page for the GNU project has more information (see URL | 726 | The 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") |
| 109 | to create elisp2-fn-vol-number-added | 109 | to create elisp2-fn-vol-number-added |
| 110 | 110 | ||
| 111 | insert elisp2-fn-vol-number-added into vol1.fn: do following `cat' | 111 | insert elisp2-fn-vol-number-added into vol1.fn: do following 'cat' |
| 112 | insert elisp1-fn-vol-number-added into vol2.fn: do following `cat' | 112 | insert 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 | ||
| 129 | append vol2.toc to vol1.toc with following `cat' | 129 | append 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 | |||
| 2412 | and @code{split-width-threshold} (@pxref{Choosing Window Options}). | 2412 | and @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 |