diff options
| author | Paul Eggert | 2016-01-30 11:43:26 -0800 |
|---|---|---|
| committer | Paul Eggert | 2016-01-30 11:43:26 -0800 |
| commit | cb4e054e41cdb7e398351a5ae8224759e721349e (patch) | |
| tree | ae2bec4f10425bd61e2a90563edc178d382bb4b8 /doc | |
| parent | e6d575316a42946aac6d83c9587f09afd1a59d98 (diff) | |
| parent | 60902756b0d794b16b9c1c67c4c40a3ac04d1c1b (diff) | |
| download | emacs-cb4e054e41cdb7e398351a5ae8224759e721349e.tar.gz emacs-cb4e054e41cdb7e398351a5ae8224759e721349e.zip | |
-
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/emacs/anti.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/custom.texi | 4 | ||||
| -rw-r--r-- | doc/emacs/mule.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/control.texi | 10 | ||||
| -rw-r--r-- | doc/lispref/display.texi | 2 | ||||
| -rw-r--r-- | doc/lispref/frames.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/functions.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/nonascii.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/streams.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/variables.texi | 39 | ||||
| -rw-r--r-- | doc/lispref/windows.texi | 18 | ||||
| -rw-r--r-- | doc/misc/dbus.texi | 4 | ||||
| -rw-r--r-- | doc/misc/eww.texi | 4 | ||||
| -rw-r--r-- | doc/misc/flymake.texi | 2 | ||||
| -rw-r--r-- | doc/misc/octave-mode.texi | 2 | ||||
| -rw-r--r-- | doc/misc/org.texi | 6 | ||||
| -rw-r--r-- | doc/misc/reftex.texi | 10 | ||||
| -rw-r--r-- | doc/misc/texinfo.tex | 25 | ||||
| -rw-r--r-- | doc/misc/tramp.texi | 23 | ||||
| -rw-r--r-- | doc/misc/url.texi | 2 | ||||
| -rw-r--r-- | doc/misc/wisent.texi | 4 |
21 files changed, 87 insertions, 96 deletions
diff --git a/doc/emacs/anti.texi b/doc/emacs/anti.texi index ae13ae09a04..ece4d9456f1 100644 --- a/doc/emacs/anti.texi +++ b/doc/emacs/anti.texi | |||
| @@ -197,7 +197,7 @@ for removing the whole bidi support when downgrading to Emacs 23. | |||
| 197 | @item | 197 | @item |
| 198 | Horizontal scroll bars are no longer supported. Enlarge your windows | 198 | Horizontal scroll bars are no longer supported. Enlarge your windows |
| 199 | and frames instead, or use @code{truncate-lines} and the automatic | 199 | and frames instead, or use @code{truncate-lines} and the automatic |
| 200 | horizontal scrolling of text that Emacs had since time immemoriam. | 200 | horizontal scrolling of text that Emacs had since time immemorial. |
| 201 | 201 | ||
| 202 | @item | 202 | @item |
| 203 | Emacs is again counting the height of a frame's menu and its tool bar | 203 | Emacs is again counting the height of a frame's menu and its tool bar |
diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 670848c65a1..7be660c85d1 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi | |||
| @@ -1299,8 +1299,8 @@ named @file{.dir-locals.el}@footnote{ On MS-DOS, the name of this file | |||
| 1299 | should be @file{_dir-locals.el}, due to limitations of the DOS | 1299 | should be @file{_dir-locals.el}, due to limitations of the DOS |
| 1300 | filesystems. If the filesystem is limited to 8+3 file names, the name | 1300 | filesystems. If the filesystem is limited to 8+3 file names, the name |
| 1301 | of the file will be truncated by the OS to @file{_dir-loc.el}. | 1301 | of the file will be truncated by the OS to @file{_dir-loc.el}. |
| 1302 | }@footnote{ You can also use files like @file{.dir-locals2.el}, which | 1302 | }@footnote{ You can also use @file{.dir-locals-2.el}, which |
| 1303 | are loaded in addition. This is useful when @file{.dir-locals.el} is | 1303 | is loaded in addition. This is useful when @file{.dir-locals.el} is |
| 1304 | under version control in a shared repository and can't be used for | 1304 | under version control in a shared repository and can't be used for |
| 1305 | personal customizations. } in a | 1305 | personal customizations. } in a |
| 1306 | directory. Whenever Emacs visits any file in that directory or any of | 1306 | directory. Whenever Emacs visits any file in that directory or any of |
diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi index bcde81b182e..40206d902b9 100644 --- a/doc/emacs/mule.texi +++ b/doc/emacs/mule.texi | |||
| @@ -1216,7 +1216,7 @@ using the internal Emacs representation. | |||
| 1216 | When Emacs runs on MS-Windows versions that are descendants of the | 1216 | When Emacs runs on MS-Windows versions that are descendants of the |
| 1217 | NT family (Windows 2000, XP, Vista, Windows 7, and Windows 8), the | 1217 | NT family (Windows 2000, XP, Vista, Windows 7, and Windows 8), the |
| 1218 | value of @code{file-name-coding-system} is largely ignored, as Emacs | 1218 | value of @code{file-name-coding-system} is largely ignored, as Emacs |
| 1219 | by default uses APIs that allow to pass Unicode file names directly. | 1219 | by default uses APIs that allow passing Unicode file names directly. |
| 1220 | By contrast, on Windows 9X, file names are encoded using | 1220 | By contrast, on Windows 9X, file names are encoded using |
| 1221 | @code{file-name-coding-system}, which should be set to the codepage | 1221 | @code{file-name-coding-system}, which should be set to the codepage |
| 1222 | (@pxref{Coding Systems, codepage}) pertinent for the current system | 1222 | (@pxref{Coding Systems, codepage}) pertinent for the current system |
diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi index df60347f839..6fa802d9fdd 100644 --- a/doc/lispref/control.texi +++ b/doc/lispref/control.texi | |||
| @@ -302,8 +302,8 @@ predicate conditions that compare values of expressions against | |||
| 302 | specific values known and written in advance. However, sometimes it | 302 | specific values known and written in advance. However, sometimes it |
| 303 | is useful to select alternatives based on more general conditions that | 303 | is useful to select alternatives based on more general conditions that |
| 304 | distinguish between broad classes of values. The @code{pcase} macro | 304 | distinguish between broad classes of values. The @code{pcase} macro |
| 305 | allows to choose between alternatives based on matching the value of | 305 | allows you to choose between alternatives based on matching the value |
| 306 | an expression against a series of patterns. A pattern can be a | 306 | of an expression against a series of patterns. A pattern can be a |
| 307 | literal value (comparison to literal values is what @code{cond} does), | 307 | literal value (comparison to literal values is what @code{cond} does), |
| 308 | or it can be a more general description of the expected structure of | 308 | or it can be a more general description of the expected structure of |
| 309 | the expression's value. | 309 | the expression's value. |
| @@ -350,7 +350,7 @@ when called with the value being matched as its argument. | |||
| 350 | @var{predfun} can be one of the possible forms described below. | 350 | @var{predfun} can be one of the possible forms described below. |
| 351 | @item (guard @var{boolean-expression}) | 351 | @item (guard @var{boolean-expression}) |
| 352 | Matches if @var{boolean-expression} evaluates to non-@code{nil}. This | 352 | Matches if @var{boolean-expression} evaluates to non-@code{nil}. This |
| 353 | allows to include in a UPattern boolean conditions that refer to | 353 | allows you to include in a UPattern boolean conditions that refer to |
| 354 | symbols bound to values (including the value being matched) by | 354 | symbols bound to values (including the value being matched) by |
| 355 | previous UPatterns. Typically used inside an @code{and} UPattern, see | 355 | previous UPatterns. Typically used inside an @code{and} UPattern, see |
| 356 | below. For example, @w{@code{(and x (guard (< x 10)))}} is a pattern | 356 | below. For example, @w{@code{(and x (guard (< x 10)))}} is a pattern |
| @@ -358,7 +358,7 @@ which matches any number smaller than 10 and let-binds the variable | |||
| 358 | @code{x} to that number. | 358 | @code{x} to that number. |
| 359 | @item (let @var{upattern} @var{expression}) | 359 | @item (let @var{upattern} @var{expression}) |
| 360 | Matches if the specified @var{expression} matches the specified | 360 | Matches if the specified @var{expression} matches the specified |
| 361 | @var{upattern}. This allows to match a pattern against the value of | 361 | @var{upattern}. This allows matching a pattern against the value of |
| 362 | an @emph{arbitrary} expression, not just the expression that is the | 362 | an @emph{arbitrary} expression, not just the expression that is the |
| 363 | first argument to @code{pcase}. (It is called @code{let} because | 363 | first argument to @code{pcase}. (It is called @code{let} because |
| 364 | @var{upattern} can bind symbols to values using the @var{symbol} | 364 | @var{upattern} can bind symbols to values using the @var{symbol} |
| @@ -407,7 +407,7 @@ Here's an illustrative example of using UPatterns: | |||
| 407 | (code (message "Unknown return code %S" code))) | 407 | (code (message "Unknown return code %S" code))) |
| 408 | @end example | 408 | @end example |
| 409 | 409 | ||
| 410 | The QPatterns are more powerful. They allow to match the value of the | 410 | The QPatterns are more powerful. They allow matching the value of the |
| 411 | @var{expression} that is the first argument of @code{pcase} against | 411 | @var{expression} that is the first argument of @code{pcase} against |
| 412 | specifications of its @emph{structure}. For example, you can specify | 412 | specifications of its @emph{structure}. For example, you can specify |
| 413 | that the value must be a list of 2 elements whose first element is a | 413 | that the value must be a list of 2 elements whose first element is a |
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index d77059916fc..eaba03d5739 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi | |||
| @@ -4303,7 +4303,7 @@ divider ends above the bottom divider. | |||
| 4303 | Dividers can be dragged with the mouse and are therefore useful for | 4303 | Dividers can be dragged with the mouse and are therefore useful for |
| 4304 | adjusting the sizes of adjacent windows with the mouse. They also serve | 4304 | adjusting the sizes of adjacent windows with the mouse. They also serve |
| 4305 | to visually set apart adjacent windows when no scroll bars or mode lines | 4305 | to visually set apart adjacent windows when no scroll bars or mode lines |
| 4306 | are present. The following three faces allow to customize the | 4306 | are present. The following three faces allow the customization of the |
| 4307 | appearance of dividers: | 4307 | appearance of dividers: |
| 4308 | 4308 | ||
| 4309 | @table @code | 4309 | @table @code |
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 614b7db0cac..55d72427548 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi | |||
| @@ -2403,8 +2403,8 @@ The resulting mouse position is not constrained to the native frame of | |||
| 2403 | The return value is not significant. | 2403 | The return value is not significant. |
| 2404 | @end defun | 2404 | @end defun |
| 2405 | 2405 | ||
| 2406 | On a graphical terminal the following two functions allow to retrieve | 2406 | On a graphical terminal the following two functions allow the absolute |
| 2407 | and set the absolute position of the mouse cursor. | 2407 | position of the mouse cursor to be retrieved and set. |
| 2408 | 2408 | ||
| 2409 | @defun mouse-absolute-pixel-position | 2409 | @defun mouse-absolute-pixel-position |
| 2410 | This function returns a cons cell (@var{x} . @var{y}) of the coordinates | 2410 | This function returns a cons cell (@var{x} . @var{y}) of the coordinates |
| @@ -2426,7 +2426,7 @@ This predicate function returns non-@code{nil} if the mouse pointer | |||
| 2426 | displayed on @var{frame} is visible; otherwise it returns @code{nil}. | 2426 | displayed on @var{frame} is visible; otherwise it returns @code{nil}. |
| 2427 | @var{frame} omitted or @code{nil} means the selected frame. This is | 2427 | @var{frame} omitted or @code{nil} means the selected frame. This is |
| 2428 | useful when @code{make-pointer-invisible} is set to @code{t}: it | 2428 | useful when @code{make-pointer-invisible} is set to @code{t}: it |
| 2429 | allows to know if the pointer has been hidden. | 2429 | allows you to know if the pointer has been hidden. |
| 2430 | @xref{Mouse Avoidance,,,emacs, The Emacs Manual}. | 2430 | @xref{Mouse Avoidance,,,emacs, The Emacs Manual}. |
| 2431 | @end defun | 2431 | @end defun |
| 2432 | 2432 | ||
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi index c5f5b4c22c4..a2e94c34b62 100644 --- a/doc/lispref/functions.texi +++ b/doc/lispref/functions.texi | |||
| @@ -1248,7 +1248,7 @@ Parent type: @code{array}. | |||
| 1248 | @item font-object | 1248 | @item font-object |
| 1249 | @end table | 1249 | @end table |
| 1250 | 1250 | ||
| 1251 | The optional @var{qualifier} allows to combine several applicable | 1251 | The optional @var{qualifier} allows combining several applicable |
| 1252 | methods. If it is not present, the defined method is a @dfn{primary} | 1252 | methods. If it is not present, the defined method is a @dfn{primary} |
| 1253 | method, responsible for providing the primary implementation of the | 1253 | method, responsible for providing the primary implementation of the |
| 1254 | generic function for the specialized arguments. You can also define | 1254 | generic function for the specialized arguments. You can also define |
| @@ -1270,8 +1270,8 @@ The most specific of such methods will be run before any other method. | |||
| 1270 | Such methods normally use @code{cl-call-next-method}, described below, | 1270 | Such methods normally use @code{cl-call-next-method}, described below, |
| 1271 | to invoke the other auxiliary or primary methods. | 1271 | to invoke the other auxiliary or primary methods. |
| 1272 | @item :extra @var{string} | 1272 | @item :extra @var{string} |
| 1273 | This allows to add more methods, distinguished by @var{string}, for | 1273 | This allows you to add more methods, distinguished by @var{string}, |
| 1274 | the same specializers and qualifiers. | 1274 | for the same specializers and qualifiers. |
| 1275 | @end table | 1275 | @end table |
| 1276 | @end defmac | 1276 | @end defmac |
| 1277 | 1277 | ||
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi index fca40238805..9cf3b5750f2 100644 --- a/doc/lispref/nonascii.texi +++ b/doc/lispref/nonascii.texi | |||
| @@ -1338,9 +1338,9 @@ operates on the contents of @var{string} instead of bytes in the buffer. | |||
| 1338 | @cindex null bytes, and decoding text | 1338 | @cindex null bytes, and decoding text |
| 1339 | @defvar inhibit-null-byte-detection | 1339 | @defvar inhibit-null-byte-detection |
| 1340 | If this variable has a non-@code{nil} value, null bytes are ignored | 1340 | If this variable has a non-@code{nil} value, null bytes are ignored |
| 1341 | when detecting the encoding of a region or a string. This allows to | 1341 | when detecting the encoding of a region or a string. This allows the |
| 1342 | correctly detect the encoding of text that contains null bytes, such | 1342 | encoding of text that contains null bytes to be correctly detected, |
| 1343 | as Info files with Index nodes. | 1343 | such as Info files with Index nodes. |
| 1344 | @end defvar | 1344 | @end defvar |
| 1345 | 1345 | ||
| 1346 | @defvar inhibit-iso-escape-detection | 1346 | @defvar inhibit-iso-escape-detection |
diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi index 80c194b1bdd..41bc71e6aea 100644 --- a/doc/lispref/streams.texi +++ b/doc/lispref/streams.texi | |||
| @@ -343,10 +343,10 @@ shared structures. @xref{Circular Objects}. Its default value is | |||
| 343 | When reading or writing from the standard input/output streams of the | 343 | When reading or writing from the standard input/output streams of the |
| 344 | Emacs process in batch mode, it is sometimes required to make sure any | 344 | Emacs process in batch mode, it is sometimes required to make sure any |
| 345 | arbitrary binary data will be read/written verbatim, and/or that no | 345 | arbitrary binary data will be read/written verbatim, and/or that no |
| 346 | translation of newlines to or from CR-LF pairs are performed. This | 346 | translation of newlines to or from CR-LF pairs is performed. This |
| 347 | issue does not exist on Posix hosts, only on MS-Windows and MS-DOS@. | 347 | issue does not exist on Posix hosts, only on MS-Windows and MS-DOS@. |
| 348 | The following function allows to control the I/O mode of any standard | 348 | The following function allows you to control the I/O mode of any |
| 349 | stream of the Emacs process. | 349 | standard stream of the Emacs process. |
| 350 | 350 | ||
| 351 | @defun set-binary-mode stream mode | 351 | @defun set-binary-mode stream mode |
| 352 | Switch @var{stream} into binary or text I/O mode. If @var{mode} is | 352 | Switch @var{stream} into binary or text I/O mode. If @var{mode} is |
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi index 42701614365..6c53e9b6cca 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi | |||
| @@ -1765,33 +1765,20 @@ variables: by putting them in a special file, or by defining a | |||
| 1765 | @dfn{project class} for that directory. | 1765 | @dfn{project class} for that directory. |
| 1766 | 1766 | ||
| 1767 | @defvr Constant dir-locals-file | 1767 | @defvr Constant dir-locals-file |
| 1768 | This constant is a wildcard pattern matching the name of files where | 1768 | This constant is the name of the file where Emacs expects to find the |
| 1769 | Emacs expects to find directory-local variables. Its value is | 1769 | directory-local variables. The name of the file is |
| 1770 | @file{.dir-locals*.el}@footnote{ | 1770 | @file{.dir-locals.el}@footnote{ |
| 1771 | The MS-DOS version of Emacs uses @file{_dir-locals*.el} instead, due to | 1771 | The MS-DOS version of Emacs uses @file{_dir-locals.el} instead, due to |
| 1772 | limitations of the DOS filesystems. | 1772 | limitations of the DOS filesystems. |
| 1773 | }, and the most common file name to use is @file{.dir-locals.el}. | 1773 | }. A file by that name in a directory causes Emacs to apply its |
| 1774 | 1774 | settings to any file in that directory or any of its subdirectories | |
| 1775 | Any file matching this name pattern in a directory causes Emacs to | 1775 | (optionally, you can exclude subdirectories; see below). |
| 1776 | apply its settings when visiting files in that directory or any of its | 1776 | If some of the subdirectories have their own @file{.dir-locals.el} |
| 1777 | subdirectories (optionally, you can exclude subdirectories; see | 1777 | files, Emacs uses the settings from the deepest file it finds starting |
| 1778 | below). | 1778 | from the file's directory and moving up the directory tree. The file |
| 1779 | If some of the subdirectories have their own file matching | 1779 | specifies local variables as a specially formatted list; see |
| 1780 | @file{.dir-locals*.el}, Emacs uses the settings from the deepest file | 1780 | @ref{Directory Variables, , Per-directory Local Variables, emacs, The |
| 1781 | it finds starting from the file's directory and moving up the | 1781 | GNU Emacs Manual}, for more details. |
| 1782 | directory tree. The file specifies local variables as a specially | ||
| 1783 | formatted list; see @ref{Directory Variables, , Per-directory Local | ||
| 1784 | Variables, emacs, The GNU Emacs Manual}, for more details. | ||
| 1785 | |||
| 1786 | If the same directory contains multiple such files (for instance, | ||
| 1787 | @file{.dir-locals.el} and @file{.dir-locals2.el}), then all of them | ||
| 1788 | are used in @code{string<} order. This means that, if two files | ||
| 1789 | specify different values for the same variable, the file sorted after | ||
| 1790 | will override the value of the previous file (for instance, values in | ||
| 1791 | @file{.dir-locals2.el} override those in @file{.dir-locals.el}). Note | ||
| 1792 | that, because of how lexicographic order works, values in | ||
| 1793 | @file{.dir-locals10.el} are overridden by values in @file{.dir-locals2.el}. | ||
| 1794 | This can be avoided by using @file{.dir-locals02.el} instead. | ||
| 1795 | @end defvr | 1782 | @end defvr |
| 1796 | 1783 | ||
| 1797 | @defun hack-dir-local-variables | 1784 | @defun hack-dir-local-variables |
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi index 7186791f94a..ca756e3ff7f 100644 --- a/doc/lispref/windows.texi +++ b/doc/lispref/windows.texi | |||
| @@ -383,8 +383,8 @@ as if @var{mini} were @code{nil}. | |||
| 383 | If it doesn't find a suitable window, this function returns @code{nil}. | 383 | If it doesn't find a suitable window, this function returns @code{nil}. |
| 384 | @end defun | 384 | @end defun |
| 385 | 385 | ||
| 386 | The following function allows to retrieve the entire window tree of a | 386 | The following function allows the entire window tree of a frame to be |
| 387 | frame: | 387 | retrieved: |
| 388 | 388 | ||
| 389 | @defun window-tree &optional frame | 389 | @defun window-tree &optional frame |
| 390 | This function returns a list representing the window tree for frame | 390 | This function returns a list representing the window tree for frame |
| @@ -1476,7 +1476,7 @@ displaying a buffer only temporarily (@pxref{Temporary Displays}), and | |||
| 1476 | you want to continue working with the initial layout. | 1476 | you want to continue working with the initial layout. |
| 1477 | 1477 | ||
| 1478 | The behavior can be fixed by making a new parent window when splitting | 1478 | The behavior can be fixed by making a new parent window when splitting |
| 1479 | @var{W2}. The variable described next allows to do that. | 1479 | @var{W2}. The variable described next allows that to be done. |
| 1480 | 1480 | ||
| 1481 | @defopt window-combination-limit | 1481 | @defopt window-combination-limit |
| 1482 | This variable controls whether splitting a window shall make a new | 1482 | This variable controls whether splitting a window shall make a new |
| @@ -1579,7 +1579,7 @@ combination limit of @var{W4} (the parent window of @var{W6} and | |||
| 1579 | 1579 | ||
| 1580 | Alternatively, the problems sketched above can be avoided by always | 1580 | Alternatively, the problems sketched above can be avoided by always |
| 1581 | resizing all windows in the same combination whenever one of its windows | 1581 | resizing all windows in the same combination whenever one of its windows |
| 1582 | is split or deleted. This also permits to split windows that would be | 1582 | is split or deleted. This also permits splitting windows that would be |
| 1583 | otherwise too small for such an operation. | 1583 | otherwise too small for such an operation. |
| 1584 | 1584 | ||
| 1585 | @defopt window-combination-resize | 1585 | @defopt window-combination-resize |
| @@ -2522,11 +2522,11 @@ windows are dedicated to another buffer (@pxref{Dedicated Windows}). | |||
| 2522 | 2522 | ||
| 2523 | @defun display-buffer-no-window buffer alist | 2523 | @defun display-buffer-no-window buffer alist |
| 2524 | If @var{alist} has a non-@code{nil} @code{allow-no-window} entry, then | 2524 | If @var{alist} has a non-@code{nil} @code{allow-no-window} entry, then |
| 2525 | this function does not display @code{buffer}. This allows to override | 2525 | this function does not display @code{buffer}. This allows you to |
| 2526 | the default action and avoid displaying the buffer. It is assumed that | 2526 | override the default action and avoid displaying the buffer. It is |
| 2527 | when the caller specifies a non-@code{nil} @code{allow-no-window} value | 2527 | assumed that when the caller specifies a non-@code{nil} |
| 2528 | it can handle a @code{nil} value returned from @code{display-buffer} in | 2528 | @code{allow-no-window} value it can handle a @code{nil} value returned |
| 2529 | this case. | 2529 | from @code{display-buffer} in this case. |
| 2530 | @end defun | 2530 | @end defun |
| 2531 | 2531 | ||
| 2532 | To illustrate the use of action functions, consider the following | 2532 | To illustrate the use of action functions, consider the following |
diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi index c5901aff104..f4ebfebcbe3 100644 --- a/doc/misc/dbus.texi +++ b/doc/misc/dbus.texi | |||
| @@ -138,8 +138,8 @@ name could be @samp{org.gnu.Emacs.TextEditor} or | |||
| 138 | @section D-Bus version. | 138 | @section D-Bus version. |
| 139 | 139 | ||
| 140 | D-Bus has evolved over the years. New features have been added with | 140 | D-Bus has evolved over the years. New features have been added with |
| 141 | new D-Bus versions. There are two variables, which allow to determine | 141 | new D-Bus versions. There are two variables, which allow the determination |
| 142 | the used D-Bus version. | 142 | of the D-Bus version used. |
| 143 | 143 | ||
| 144 | @defvar dbus-compiled-version | 144 | @defvar dbus-compiled-version |
| 145 | This variable, a string, determines the version of D-Bus Emacs is | 145 | This variable, a string, determines the version of D-Bus Emacs is |
diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi index 14f0a8d0ea2..0e9bedbe1d0 100644 --- a/doc/misc/eww.texi +++ b/doc/misc/eww.texi | |||
| @@ -168,8 +168,8 @@ You can view stored bookmarks with @kbd{B} | |||
| 168 | @kindex S | 168 | @kindex S |
| 169 | @cindex Multiple Buffers | 169 | @cindex Multiple Buffers |
| 170 | To get summary of currently opened EWW buffers, press @kbd{S} | 170 | To get summary of currently opened EWW buffers, press @kbd{S} |
| 171 | (@code{eww-list-buffers}). The @file{*eww buffers*} buffer allows to | 171 | (@code{eww-list-buffers}). The @file{*eww buffers*} buffer allows you |
| 172 | quickly kill, flip through and switch to specific EWW buffer. | 172 | to quickly kill, flip through and switch to specific EWW buffer. |
| 173 | 173 | ||
| 174 | @findex eww-browse-with-external-browser | 174 | @findex eww-browse-with-external-browser |
| 175 | @vindex shr-external-browser | 175 | @vindex shr-external-browser |
diff --git a/doc/misc/flymake.texi b/doc/misc/flymake.texi index 99633b60c70..1c4644bba14 100644 --- a/doc/misc/flymake.texi +++ b/doc/misc/flymake.texi | |||
| @@ -717,7 +717,7 @@ sort error menu items, which shows error messages first. | |||
| 717 | Flymake is also able to interpret error message patterns missing err-text-idx | 717 | Flymake is also able to interpret error message patterns missing err-text-idx |
| 718 | information. This is done by merely taking the rest of the matched line | 718 | information. This is done by merely taking the rest of the matched line |
| 719 | (@code{(substring line (match-end 0))}) as error text. This trick allows | 719 | (@code{(substring line (match-end 0))}) as error text. This trick allows |
| 720 | to make use of a huge collection of error message line patterns from | 720 | making use of a huge collection of error message line patterns from |
| 721 | @code{compile.el}. All these error patterns are appended to | 721 | @code{compile.el}. All these error patterns are appended to |
| 722 | the end of @code{flymake-err-line-patterns}. | 722 | the end of @code{flymake-err-line-patterns}. |
| 723 | 723 | ||
diff --git a/doc/misc/octave-mode.texi b/doc/misc/octave-mode.texi index 65cc6a431eb..0307873df03 100644 --- a/doc/misc/octave-mode.texi +++ b/doc/misc/octave-mode.texi | |||
| @@ -436,7 +436,7 @@ when Octave is waiting for input, or done sending output. | |||
| 436 | @c You can use either 'plain' Emacs Info or the function @code{octave-help} | 436 | @c You can use either 'plain' Emacs Info or the function @code{octave-help} |
| 437 | @c as your Octave info reader (for @samp{help -i}). In the former case, | 437 | @c as your Octave info reader (for @samp{help -i}). In the former case, |
| 438 | @c use @code{info_program ("info-emacs-info")}. | 438 | @c use @code{info_program ("info-emacs-info")}. |
| 439 | @c The latter is perhaps more attractive because it allows to look up keys | 439 | @c The latter is perhaps more attractive because it allows you to look up keys |
| 440 | @c in the indices of @emph{several} info files related to Octave (provided | 440 | @c in the indices of @emph{several} info files related to Octave (provided |
| 441 | @c that the Emacs variable @code{octave-help-files} is set correctly). In | 441 | @c that the Emacs variable @code{octave-help-files} is set correctly). In |
| 442 | @c this case, use @code{info_program ("info-emacs-octave-help")}. | 442 | @c this case, use @code{info_program ("info-emacs-octave-help")}. |
diff --git a/doc/misc/org.texi b/doc/misc/org.texi index ec676fca1d4..a5239acb59f 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi | |||
| @@ -12890,9 +12890,9 @@ including DocBook.}. | |||
| 12890 | When processing a document, @samp{texinfo} back-end generates a minimal file | 12890 | When processing a document, @samp{texinfo} back-end generates a minimal file |
| 12891 | header along with a title page, a copyright page, and a menu. You control | 12891 | header along with a title page, a copyright page, and a menu. You control |
| 12892 | the latter through the structure of the document (@pxref{Headings and | 12892 | the latter through the structure of the document (@pxref{Headings and |
| 12893 | sectioning structure}). Various keywords allow to tweak the other parts. It | 12893 | sectioning structure}). Various keywords allow you to tweak the other parts. |
| 12894 | is also possible to give directions to install the document in the @samp{Top} | 12894 | It is also possible to give directions to install the document in the |
| 12895 | node. | 12895 | @samp{Top} node. |
| 12896 | 12896 | ||
| 12897 | @subsubheading File header | 12897 | @subsubheading File header |
| 12898 | 12898 | ||
diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi index 3dc3ed47b24..ff7011c5a76 100644 --- a/doc/misc/reftex.texi +++ b/doc/misc/reftex.texi | |||
| @@ -5213,7 +5213,7 @@ mouse @r{Highlighting is mouse driven.} | |||
| 5213 | both @r{Both cursor and mouse trigger highlighting.} | 5213 | both @r{Both cursor and mouse trigger highlighting.} |
| 5214 | @end example | 5214 | @end example |
| 5215 | 5215 | ||
| 5216 | Changing this variable requires to rebuild the selection and *toc* | 5216 | Changing this variable requires rebuilding the selection and *toc* |
| 5217 | buffers to become effective (keys @kbd{g} or @kbd{r}). | 5217 | buffers to become effective (keys @kbd{g} or @kbd{r}). |
| 5218 | @end defopt | 5218 | @end defopt |
| 5219 | 5219 | ||
| @@ -5421,8 +5421,8 @@ after words. Disabled indexing in comment lines. | |||
| 5421 | New command @code{reftex-create-bibtex-file} to create a new database | 5421 | New command @code{reftex-create-bibtex-file} to create a new database |
| 5422 | with all entries referenced in the current document. | 5422 | with all entries referenced in the current document. |
| 5423 | @item | 5423 | @item |
| 5424 | New keys @kbd{e} and @kbd{E} allow to produce a BibTeX database file | 5424 | New keys @kbd{e} and @kbd{E} allow you to produce a BibTeX database |
| 5425 | from entries marked in a citation selection buffer. | 5425 | file from entries marked in a citation selection buffer. |
| 5426 | @end itemize | 5426 | @end itemize |
| 5427 | 5427 | ||
| 5428 | @noindent @b{Version 4.21} | 5428 | @noindent @b{Version 4.21} |
| @@ -5610,8 +5610,8 @@ demand. | |||
| 5610 | @item | 5610 | @item |
| 5611 | Index support, along with many new options. | 5611 | Index support, along with many new options. |
| 5612 | @item | 5612 | @item |
| 5613 | The selection of keys for @code{\ref} and @code{\cite} now allows to | 5613 | The selection of keys for @code{\ref} and @code{\cite} now allows you |
| 5614 | select multiple items by marking entries with the @kbd{m} key. | 5614 | to select multiple items by marking entries with the @kbd{m} key. |
| 5615 | @item | 5615 | @item |
| 5616 | Fancyref support. | 5616 | Fancyref support. |
| 5617 | @end itemize | 5617 | @end itemize |
diff --git a/doc/misc/texinfo.tex b/doc/misc/texinfo.tex index 936c32dc5f4..8b3c9490f09 100644 --- a/doc/misc/texinfo.tex +++ b/doc/misc/texinfo.tex | |||
| @@ -3,7 +3,7 @@ | |||
| 3 | % Load plain if necessary, i.e., if running under initex. | 3 | % Load plain if necessary, i.e., if running under initex. |
| 4 | \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi | 4 | \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi |
| 5 | % | 5 | % |
| 6 | \def\texinfoversion{2016-01-11.19} | 6 | \def\texinfoversion{2016-01-20.20} |
| 7 | % | 7 | % |
| 8 | % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, | 8 | % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, |
| 9 | % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, | 9 | % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, |
| @@ -4737,11 +4737,10 @@ end | |||
| 4737 | \def\_{\normalunderscore}% | 4737 | \def\_{\normalunderscore}% |
| 4738 | \def\-{}% @- shouldn't affect sorting | 4738 | \def\-{}% @- shouldn't affect sorting |
| 4739 | % | 4739 | % |
| 4740 | \def\lbracechar{{\indexlbrace}}% | 4740 | \uccode`\1=`\{ \uppercase{\def\{{1}}% |
| 4741 | \def\rbracechar{{\indexrbrace}}% | 4741 | \uccode`\1=`\} \uppercase{\def\}{1}}% |
| 4742 | \let\{=\lbracechar | 4742 | \let\lbracechar\{ |
| 4743 | \let\}=\rbracechar | 4743 | \let\rbracechar\} |
| 4744 | % | ||
| 4745 | % | 4744 | % |
| 4746 | % Non-English letters. | 4745 | % Non-English letters. |
| 4747 | \def\AA{AA}% | 4746 | \def\AA{AA}% |
| @@ -4901,9 +4900,15 @@ end | |||
| 4901 | \indexdummies % Must do this here, since \bf, etc expand at this stage | 4900 | \indexdummies % Must do this here, since \bf, etc expand at this stage |
| 4902 | \useindexbackslash % \indexbackslash isn't defined now so it will be output | 4901 | \useindexbackslash % \indexbackslash isn't defined now so it will be output |
| 4903 | % as is; and it will print as backslash. | 4902 | % as is; and it will print as backslash. |
| 4903 | % The braces around \indexbrace are recognized by texindex. | ||
| 4904 | % | ||
| 4904 | % Get the string to sort by, by processing the index entry with all | 4905 | % Get the string to sort by, by processing the index entry with all |
| 4905 | % font commands turned off. | 4906 | % font commands turned off. |
| 4906 | {\indexnofonts | 4907 | {\indexnofonts |
| 4908 | \def\lbracechar{{\indexlbrace}}% | ||
| 4909 | \def\rbracechar{{\indexrbrace}}% | ||
| 4910 | \let\{=\lbracechar | ||
| 4911 | \let\}=\rbracechar | ||
| 4907 | \indexnonalnumdisappear | 4912 | \indexnonalnumdisappear |
| 4908 | \xdef\indexsortkey{}% | 4913 | \xdef\indexsortkey{}% |
| 4909 | \let\sortas=\indexwritesortas | 4914 | \let\sortas=\indexwritesortas |
| @@ -8526,10 +8531,6 @@ end | |||
| 8526 | }% | 8531 | }% |
| 8527 | \setcolor{\linkcolor}% | 8532 | \setcolor{\linkcolor}% |
| 8528 | \fi | 8533 | \fi |
| 8529 | % | ||
| 8530 | % Float references are printed completely differently: "Figure 1.2" | ||
| 8531 | % instead of "[somenode], p.3". We distinguish them by the | ||
| 8532 | % LABEL-title being set to a magic string. | ||
| 8533 | {% | 8534 | {% |
| 8534 | % Have to otherify everything special to allow the \csname to | 8535 | % Have to otherify everything special to allow the \csname to |
| 8535 | % include an _ in the xref name, etc. | 8536 | % include an _ in the xref name, etc. |
| @@ -8538,6 +8539,10 @@ end | |||
| 8538 | \expandafter\global\expandafter\let\expandafter\Xthisreftitle | 8539 | \expandafter\global\expandafter\let\expandafter\Xthisreftitle |
| 8539 | \csname XR#1-title\endcsname | 8540 | \csname XR#1-title\endcsname |
| 8540 | }% | 8541 | }% |
| 8542 | % | ||
| 8543 | % Float references are printed completely differently: "Figure 1.2" | ||
| 8544 | % instead of "[somenode], p.3". \iffloat distinguishes them by | ||
| 8545 | % \Xthisreftitle being set to a magic string. | ||
| 8541 | \iffloat\Xthisreftitle | 8546 | \iffloat\Xthisreftitle |
| 8542 | % If the user specified the print name (third arg) to the ref, | 8547 | % If the user specified the print name (third arg) to the ref, |
| 8543 | % print it instead of our usual "Figure 1.2". | 8548 | % print it instead of our usual "Figure 1.2". |
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 37bf7ea8bc4..d01f9be9fbf 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi | |||
| @@ -815,11 +815,9 @@ capable of servicing requests from @value{tramp}. | |||
| 815 | @cindex method smb | 815 | @cindex method smb |
| 816 | @cindex smb method | 816 | @cindex smb method |
| 817 | 817 | ||
| 818 | This is another non-native @value{tramp} method. @command{smbclient} | 818 | This non-native @value{tramp} method connects via the Server Message |
| 819 | connects to any host with SMB/CIFS protocol, such as MS Windows and | 819 | Block (SMB) networking protocol to hosts running file servers that are |
| 820 | Samba Servers running on Unixes. Tests show this @value{tramp} method | 820 | typically based on @url{https://www.samba.org/,,Samba} or MS Windows. |
| 821 | works with MS Windows NT, MS Windows 2000, MS Windows XP, MS Windows | ||
| 822 | Vista, and MS Windows 7. | ||
| 823 | 821 | ||
| 824 | Using @command{smbclient} requires a few tweaks when working with | 822 | Using @command{smbclient} requires a few tweaks when working with |
| 825 | @value{tramp}: | 823 | @value{tramp}: |
| @@ -827,7 +825,7 @@ Using @command{smbclient} requires a few tweaks when working with | |||
| 827 | The first directory in the localname must be a share name on the | 825 | The first directory in the localname must be a share name on the |
| 828 | remote host. | 826 | remote host. |
| 829 | 827 | ||
| 830 | Since smb shares end in the @code{$} character, @value{tramp} must use | 828 | Since SMB shares end in the @code{$} character, @value{tramp} must use |
| 831 | @code{$$} when specifying those shares to avoid environment variable | 829 | @code{$$} when specifying those shares to avoid environment variable |
| 832 | substitutions. | 830 | substitutions. |
| 833 | 831 | ||
| @@ -871,16 +869,17 @@ uses the anonymous user (without prompting for password). This | |||
| 871 | behavior is unlike other @value{tramp} methods, where local user name | 869 | behavior is unlike other @value{tramp} methods, where local user name |
| 872 | is substituted. | 870 | is substituted. |
| 873 | 871 | ||
| 874 | @option{smb} method is unavailable if Emacs is run under a local user | 872 | The @option{smb} method is unavailable if Emacs is run under a |
| 875 | authentication context in MS Windows. However such users can still | 873 | local user authentication context in MS Windows. However such users |
| 876 | access remote files using UNC file names instead of @value{tramp}: | 874 | can still access remote files using UNC file names instead of @value{tramp}: |
| 877 | 875 | ||
| 878 | @example | 876 | @example |
| 879 | //melancholia/daniel$$/.emacs | 877 | //melancholia/daniel$$/.emacs |
| 880 | @end example | 878 | @end example |
| 881 | 879 | ||
| 882 | UNC file name specification does not allow to specify a different user | 880 | UNC file name specification does not allow the specification of a |
| 883 | name for authentication like the @command{smbclient} can. | 881 | different user name for authentication like the @command{smbclient} |
| 882 | can. | ||
| 884 | 883 | ||
| 885 | @item @option{adb} | 884 | @item @option{adb} |
| 886 | @cindex method adb | 885 | @cindex method adb |
| @@ -2830,7 +2829,7 @@ open. That is why @value{tramp} prompts for the password again even | |||
| 2830 | if there is an @command{ssh} already open. | 2829 | if there is an @command{ssh} already open. |
| 2831 | 2830 | ||
| 2832 | Some @command{ssh} versions support a @code{ControlPersist} option, | 2831 | Some @command{ssh} versions support a @code{ControlPersist} option, |
| 2833 | which allows to set the @code{ControlPath} provided the variable | 2832 | which allows you to set the @code{ControlPath} provided the variable |
| 2834 | @code{tramp-ssh-controlmaster-options} is customized as follows: | 2833 | @code{tramp-ssh-controlmaster-options} is customized as follows: |
| 2835 | 2834 | ||
| 2836 | @lisp | 2835 | @lisp |
diff --git a/doc/misc/url.texi b/doc/misc/url.texi index acdad6b0d10..c46859968a2 100644 --- a/doc/misc/url.texi +++ b/doc/misc/url.texi | |||
| @@ -423,7 +423,7 @@ the directory specified by @code{url-configuration-directory}. | |||
| 423 | @end defopt | 423 | @end defopt |
| 424 | 424 | ||
| 425 | @defopt url-cookie-confirmation | 425 | @defopt url-cookie-confirmation |
| 426 | Specifies whether confirmation is require to accept cookies. | 426 | Specifies whether confirmation is required to accept cookies. |
| 427 | @end defopt | 427 | @end defopt |
| 428 | 428 | ||
| 429 | @defopt url-cookie-multiple-line | 429 | @defopt url-cookie-multiple-line |
diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi index a4462937f1c..b4efbdad1b8 100644 --- a/doc/misc/wisent.texi +++ b/doc/misc/wisent.texi | |||
| @@ -1155,8 +1155,8 @@ It defaults to the start symbol defined in the grammar | |||
| 1155 | @end table | 1155 | @end table |
| 1156 | @end defun | 1156 | @end defun |
| 1157 | 1157 | ||
| 1158 | The following two normal hooks permit to do some useful processing | 1158 | The following two normal hooks permit doing some useful processing |
| 1159 | respectively before to start parsing, and after the parser terminated. | 1159 | respectively before starting parsing, and after the parser terminated. |
| 1160 | 1160 | ||
| 1161 | @vindex wisent-pre-parse-hook | 1161 | @vindex wisent-pre-parse-hook |
| 1162 | @defvar wisent-pre-parse-hook | 1162 | @defvar wisent-pre-parse-hook |