diff options
| author | Alan Mackenzie | 2017-02-12 10:59:03 +0000 |
|---|---|---|
| committer | Alan Mackenzie | 2017-02-12 10:59:03 +0000 |
| commit | f4d5b687150810129b7a1d5b006e31ccf82b691b (patch) | |
| tree | 4229b13800349032697daae3904dc3773e6b7a80 /doc | |
| parent | d5514332d4a6092673ce1f78fadcae0c57f7be64 (diff) | |
| parent | 148100d98319499f0ac6f57b8be08cbd14884a5c (diff) | |
| download | emacs-comment-cache.tar.gz emacs-comment-cache.zip | |
Merge branch 'master' into comment-cachecomment-cache
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/emacs/display.texi | 12 | ||||
| -rw-r--r-- | doc/emacs/files.texi | 6 | ||||
| -rw-r--r-- | doc/emacs/search.texi | 20 | ||||
| -rw-r--r-- | doc/lispintro/emacs-lisp-intro.texi | 8 | ||||
| -rw-r--r-- | doc/lispref/edebug.texi | 10 | ||||
| -rw-r--r-- | doc/lispref/files.texi | 26 | ||||
| -rw-r--r-- | doc/lispref/internals.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/lists.texi | 33 | ||||
| -rw-r--r-- | doc/lispref/processes.texi | 8 | ||||
| -rw-r--r-- | doc/lispref/windows.texi | 15 | ||||
| -rw-r--r-- | doc/misc/cc-mode.texi | 31 | ||||
| -rw-r--r-- | doc/misc/cl.texi | 2 | ||||
| -rw-r--r-- | doc/misc/emacs-mime.texi | 4 | ||||
| -rw-r--r-- | doc/misc/gnus.texi | 34 | ||||
| -rw-r--r-- | doc/misc/texinfo.tex | 33 |
15 files changed, 177 insertions, 71 deletions
diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi index c6e990d9082..15c700892bc 100644 --- a/doc/emacs/display.texi +++ b/doc/emacs/display.texi | |||
| @@ -285,13 +285,17 @@ multiple variables, the order of priority is: | |||
| 285 | @code{scroll-up-aggressively} / @code{scroll-down-aggressively}. | 285 | @code{scroll-up-aggressively} / @code{scroll-down-aggressively}. |
| 286 | 286 | ||
| 287 | @vindex scroll-margin | 287 | @vindex scroll-margin |
| 288 | @vindex maximum-scroll-margin | ||
| 288 | The variable @code{scroll-margin} restricts how close point can come | 289 | The variable @code{scroll-margin} restricts how close point can come |
| 289 | to the top or bottom of a window (even if aggressive scrolling | 290 | to the top or bottom of a window (even if aggressive scrolling |
| 290 | specifies a fraction @var{f} that is larger than the window portion | 291 | specifies a fraction @var{f} that is larger than the window portion |
| 291 | between the top and the bottom margins). Its value is a number of screen | 292 | between the top and the bottom margins). Its value is a number of |
| 292 | lines; if point comes within that many lines of the top or bottom of | 293 | screen lines; if point comes within that many lines of the top or |
| 293 | the window, Emacs performs automatic scrolling. By default, | 294 | bottom of the window, Emacs performs automatic scrolling. By default, |
| 294 | @code{scroll-margin} is 0. | 295 | @code{scroll-margin} is 0. The effective margin size is limited to a |
| 296 | quarter of the window height by default, but this limit can be | ||
| 297 | increased up to half (or decreased down to zero) by customizing | ||
| 298 | @code{maximum-scroll-margin}. | ||
| 295 | 299 | ||
| 296 | @node Horizontal Scrolling | 300 | @node Horizontal Scrolling |
| 297 | @section Horizontal Scrolling | 301 | @section Horizontal Scrolling |
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index 5c582e571e2..2b09c69945c 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi | |||
| @@ -417,6 +417,12 @@ changes you would be saving. This calls the command | |||
| 417 | Display a help message about these options. | 417 | Display a help message about these options. |
| 418 | @end table | 418 | @end table |
| 419 | 419 | ||
| 420 | @noindent | ||
| 421 | @vindex save-some-buffers-default-predicate | ||
| 422 | You can customize the value of | ||
| 423 | @code{save-some-buffers-default-predicate} to control which buffers | ||
| 424 | Emacs will ask about. | ||
| 425 | |||
| 420 | @kbd{C-x C-c}, the key sequence to exit Emacs, invokes | 426 | @kbd{C-x C-c}, the key sequence to exit Emacs, invokes |
| 421 | @code{save-some-buffers} and therefore asks the same questions. | 427 | @code{save-some-buffers} and therefore asks the same questions. |
| 422 | 428 | ||
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi index b7282589735..fa69ba48f6a 100644 --- a/doc/emacs/search.texi +++ b/doc/emacs/search.texi | |||
| @@ -1670,8 +1670,9 @@ replacing regexp matches in file names. | |||
| 1670 | Here are some other commands that find matches for a regular | 1670 | Here are some other commands that find matches for a regular |
| 1671 | expression. They all ignore case in matching, if the pattern contains | 1671 | expression. They all ignore case in matching, if the pattern contains |
| 1672 | no upper-case letters and @code{case-fold-search} is non-@code{nil}. | 1672 | no upper-case letters and @code{case-fold-search} is non-@code{nil}. |
| 1673 | Aside from @code{occur} and its variants, all operate on the text from | 1673 | Aside from @code{multi-occur} and @code{multi-occur-in-matching-buffers}, |
| 1674 | point to the end of the buffer, or on the region if it is active. | 1674 | which always search the whole buffer, all operate on the text from point |
| 1675 | to the end of the buffer, or on the region if it is active. | ||
| 1675 | 1676 | ||
| 1676 | @findex list-matching-lines | 1677 | @findex list-matching-lines |
| 1677 | @findex occur | 1678 | @findex occur |
| @@ -1714,6 +1715,8 @@ a multi-file incremental search is activated automatically. | |||
| 1714 | @cindex mode, Occur | 1715 | @cindex mode, Occur |
| 1715 | @cindex match (face name) | 1716 | @cindex match (face name) |
| 1716 | @vindex list-matching-lines-default-context-lines | 1717 | @vindex list-matching-lines-default-context-lines |
| 1718 | @vindex list-matching-lines-jump-to-current-line | ||
| 1719 | @cindex list-matching-lines-current-line-face (face name) | ||
| 1717 | @kindex M-s o | 1720 | @kindex M-s o |
| 1718 | @item M-x occur | 1721 | @item M-x occur |
| 1719 | @itemx M-s o | 1722 | @itemx M-s o |
| @@ -1721,11 +1724,14 @@ Prompt for a regexp, and display a list showing each line in the | |||
| 1721 | buffer that contains a match for it. If you type @kbd{M-n} at the | 1724 | buffer that contains a match for it. If you type @kbd{M-n} at the |
| 1722 | prompt, you can reuse search strings from previous incremental | 1725 | prompt, you can reuse search strings from previous incremental |
| 1723 | searches. The text that matched is highlighted using the @code{match} | 1726 | searches. The text that matched is highlighted using the @code{match} |
| 1724 | face. To limit the search to part of the buffer, narrow to that part | 1727 | face. A numeric argument @var{n} specifies that @var{n} lines of |
| 1725 | (@pxref{Narrowing}). A numeric argument @var{n} specifies that | 1728 | context are to be displayed before and after each matching line. |
| 1726 | @var{n} lines of context are to be displayed before and after each | 1729 | The default number of context lines is specified by the variable |
| 1727 | matching line. The default number of context lines is specified by | 1730 | @code{list-matching-lines-default-context-lines}. |
| 1728 | the variable @code{list-matching-lines-default-context-lines}. | 1731 | When @code{list-matching-lines-jump-to-current-line} is non-nil, |
| 1732 | the current line is shown highlighted with face | ||
| 1733 | @code{list-matching-lines-current-line-face} and the point is set | ||
| 1734 | at the first match after such line. | ||
| 1729 | 1735 | ||
| 1730 | You can also run @kbd{M-s o} when an incremental search is active; | 1736 | You can also run @kbd{M-s o} when an incremental search is active; |
| 1731 | this uses the current search string. | 1737 | this uses the current search string. |
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index 830c072cf5e..36d767737df 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi | |||
| @@ -17151,9 +17151,11 @@ Here is another keybinding, with a comment: | |||
| 17151 | 17151 | ||
| 17152 | @findex occur | 17152 | @findex occur |
| 17153 | The @code{occur} command shows all the lines in the current buffer | 17153 | The @code{occur} command shows all the lines in the current buffer |
| 17154 | that contain a match for a regular expression. Matching lines are | 17154 | that contain a match for a regular expression. When the region is |
| 17155 | shown in a buffer called @file{*Occur*}. That buffer serves as a menu | 17155 | active, @code{occur} restricts matches to such region. Otherwise it |
| 17156 | to jump to occurrences. | 17156 | uses the entire buffer. |
| 17157 | Matching lines are shown in a buffer called @file{*Occur*}. | ||
| 17158 | That buffer serves as a menu to jump to occurrences. | ||
| 17157 | 17159 | ||
| 17158 | @findex global-unset-key | 17160 | @findex global-unset-key |
| 17159 | @cindex Unbinding key | 17161 | @cindex Unbinding key |
diff --git a/doc/lispref/edebug.texi b/doc/lispref/edebug.texi index f6f73ea8947..da72c9b700c 100644 --- a/doc/lispref/edebug.texi +++ b/doc/lispref/edebug.texi | |||
| @@ -979,9 +979,13 @@ program. | |||
| 979 | 979 | ||
| 980 | @itemize @bullet | 980 | @itemize @bullet |
| 981 | @item | 981 | @item |
| 982 | @code{max-lisp-eval-depth} and @code{max-specpdl-size} are both | 982 | @vindex edebug-max-depth |
| 983 | increased to reduce Edebug's impact on the stack. You could, however, | 983 | @code{max-lisp-eval-depth} (@pxref{Eval}) and @code{max-specpdl-size} |
| 984 | still run out of stack space when using Edebug. | 984 | (@pxref{Local Variables}) are both increased to reduce Edebug's impact |
| 985 | on the stack. You could, however, still run out of stack space when | ||
| 986 | using Edebug. You can also enlarge the value of | ||
| 987 | @code{edebug-max-depth} if Edebug reaches the limit of recursion depth | ||
| 988 | instrumenting code that contains very large quoted lists. | ||
| 985 | 989 | ||
| 986 | @item | 990 | @item |
| 987 | The state of keyboard macro execution is saved and restored. While | 991 | The state of keyboard macro execution is saved and restored. While |
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index 853e84477e2..ef373211415 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi | |||
| @@ -368,17 +368,21 @@ asks the user about each buffer. But if @var{save-silently-p} is | |||
| 368 | non-@code{nil}, it saves all the file-visiting buffers without querying | 368 | non-@code{nil}, it saves all the file-visiting buffers without querying |
| 369 | the user. | 369 | the user. |
| 370 | 370 | ||
| 371 | The optional @var{pred} argument controls which buffers to ask about | 371 | @vindex save-some-buffers-default-predicate |
| 372 | (or to save silently if @var{save-silently-p} is non-@code{nil}). | 372 | The optional @var{pred} argument provides a predicate that controls |
| 373 | If it is @code{nil}, that means to ask only about file-visiting buffers. | 373 | which buffers to ask about (or to save silently if |
| 374 | If it is @code{t}, that means also offer to save certain other non-file | 374 | @var{save-silently-p} is non-@code{nil}). If @var{pred} is |
| 375 | buffers---those that have a non-@code{nil} buffer-local value of | 375 | @code{nil}, that means to use the value of |
| 376 | @code{buffer-offer-save} (@pxref{Killing Buffers}). A user who says | 376 | @code{save-some-buffers-default-predicate} instead of @var{pred}. If |
| 377 | @samp{yes} to saving a non-file buffer is asked to specify the file | 377 | the result is @code{nil}, it means ask only about file-visiting |
| 378 | name to use. The @code{save-buffers-kill-emacs} function passes the | 378 | buffers. If it is @code{t}, that means also offer to save certain |
| 379 | value @code{t} for @var{pred}. | 379 | other non-file buffers---those that have a non-@code{nil} buffer-local |
| 380 | 380 | value of @code{buffer-offer-save} (@pxref{Killing Buffers}). A user | |
| 381 | If @var{pred} is neither @code{t} nor @code{nil}, then it should be | 381 | who says @samp{yes} to saving a non-file buffer is asked to specify |
| 382 | the file name to use. The @code{save-buffers-kill-emacs} function | ||
| 383 | passes the value @code{t} for @var{pred}. | ||
| 384 | |||
| 385 | If the predicate is neither @code{t} nor @code{nil}, then it should be | ||
| 382 | a function of no arguments. It will be called in each buffer to decide | 386 | a function of no arguments. It will be called in each buffer to decide |
| 383 | whether to offer to save that buffer. If it returns a non-@code{nil} | 387 | whether to offer to save that buffer. If it returns a non-@code{nil} |
| 384 | value in a certain buffer, that means do offer to save that buffer. | 388 | value in a certain buffer, that means do offer to save that buffer. |
diff --git a/doc/lispref/internals.texi b/doc/lispref/internals.texi index 69d21bedaa4..663d0fd92b9 100644 --- a/doc/lispref/internals.texi +++ b/doc/lispref/internals.texi | |||
| @@ -672,7 +672,7 @@ usage: (or CONDITIONS...) */) | |||
| 672 | if (!NILP (val)) | 672 | if (!NILP (val)) |
| 673 | break; | 673 | break; |
| 674 | args = XCDR (args); | 674 | args = XCDR (args); |
| 675 | QUIT; | 675 | maybe_quit (); |
| 676 | @} | 676 | @} |
| 677 | @end group | 677 | @end group |
| 678 | 678 | ||
| @@ -792,8 +792,8 @@ their addresses after performing Lisp evaluation. Lisp evaluation can | |||
| 792 | occur via calls to @code{eval_sub} or @code{Feval}, either directly or | 792 | occur via calls to @code{eval_sub} or @code{Feval}, either directly or |
| 793 | indirectly. | 793 | indirectly. |
| 794 | 794 | ||
| 795 | @cindex @code{QUIT}, use in Lisp primitives | 795 | @cindex @code{maybe_quit}, use in Lisp primitives |
| 796 | Note the call to the @code{QUIT} macro inside the loop: this macro | 796 | Note the call to @code{maybe_quit} inside the loop: this function |
| 797 | checks whether the user pressed @kbd{C-g}, and if so, aborts the | 797 | checks whether the user pressed @kbd{C-g}, and if so, aborts the |
| 798 | processing. You should do that in any loop that can potentially | 798 | processing. You should do that in any loop that can potentially |
| 799 | require a large number of iterations; in this case, the list of | 799 | require a large number of iterations; in this case, the list of |
diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi index bd7d85aa189..8eab2818f97 100644 --- a/doc/lispref/lists.texi +++ b/doc/lispref/lists.texi | |||
| @@ -362,6 +362,39 @@ This is the same as @code{(cdr (cdr @var{cons-cell}))} | |||
| 362 | or @code{(nthcdr 2 @var{cons-cell})}. | 362 | or @code{(nthcdr 2 @var{cons-cell})}. |
| 363 | @end defun | 363 | @end defun |
| 364 | 364 | ||
| 365 | @findex caaar | ||
| 366 | @findex caadr | ||
| 367 | @findex cadar | ||
| 368 | @findex caddr | ||
| 369 | @findex cdaar | ||
| 370 | @findex cdadr | ||
| 371 | @findex cddar | ||
| 372 | @findex cdddr | ||
| 373 | @findex caaaar | ||
| 374 | @findex caaadr | ||
| 375 | @findex caadar | ||
| 376 | @findex caaddr | ||
| 377 | @findex cadaar | ||
| 378 | @findex cadadr | ||
| 379 | @findex caddar | ||
| 380 | @findex cadddr | ||
| 381 | @findex cdaaar | ||
| 382 | @findex cdaadr | ||
| 383 | @findex cdadar | ||
| 384 | @findex cdaddr | ||
| 385 | @findex cddaar | ||
| 386 | @findex cddadr | ||
| 387 | @findex cdddar | ||
| 388 | @findex cddddr | ||
| 389 | In addition to the above, 24 additional compositions of @code{car} and | ||
| 390 | @code{cdr} are defined as @code{c@var{xxx}r} and @code{c@var{xxxx}r}, | ||
| 391 | where each @code{@var{x}} is either @code{a} or @code{d}. @code{cadr}, | ||
| 392 | @code{caddr}, and @code{cadddr} pick out the second, third or fourth | ||
| 393 | elements of a list, respectively. @file{cl-lib} provides the same | ||
| 394 | under the names @code{cl-second}, @code{cl-third}, and | ||
| 395 | @code{cl-fourth}. @xref{List Functions,,, cl, Common Lisp | ||
| 396 | Extensions}. | ||
| 397 | |||
| 365 | @defun butlast x &optional n | 398 | @defun butlast x &optional n |
| 366 | This function returns the list @var{x} with the last element, | 399 | This function returns the list @var{x} with the last element, |
| 367 | or the last @var{n} elements, removed. If @var{n} is greater | 400 | or the last @var{n} elements, removed. If @var{n} is greater |
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi index 014a0aed913..58e04a311a1 100644 --- a/doc/lispref/processes.texi +++ b/doc/lispref/processes.texi | |||
| @@ -2414,6 +2414,14 @@ If non-@code{nil}, the host's capability string. | |||
| 2414 | The connection type: @samp{plain} or @samp{tls}. | 2414 | The connection type: @samp{plain} or @samp{tls}. |
| 2415 | @end table | 2415 | @end table |
| 2416 | 2416 | ||
| 2417 | @item :shell-command @var{string-or-nil} | ||
| 2418 | If the connection @code{type} is @code{shell}, this parameter will be | ||
| 2419 | interpreted as a format-spec string that will be executed to make the | ||
| 2420 | connection. The specs available are @samp{%s} for the host name and | ||
| 2421 | @samp{%p} for the port number. For instance, if you want to first ssh | ||
| 2422 | to @samp{gateway} before making a plain connection, then this | ||
| 2423 | parameter could be something like @samp{ssh gateway nc %s %p}. | ||
| 2424 | |||
| 2417 | @end table | 2425 | @end table |
| 2418 | 2426 | ||
| 2419 | @end defun | 2427 | @end defun |
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi index 6f3de0c8a0e..affa28c9202 100644 --- a/doc/lispref/windows.texi +++ b/doc/lispref/windows.texi | |||
| @@ -3924,6 +3924,21 @@ redisplay scrolls the text automatically (if possible) to move point | |||
| 3924 | out of the margin, closer to the center of the window. | 3924 | out of the margin, closer to the center of the window. |
| 3925 | @end defopt | 3925 | @end defopt |
| 3926 | 3926 | ||
| 3927 | @defopt maximum-scroll-margin | ||
| 3928 | This variable limits the effective value of @code{scroll-margin} to a | ||
| 3929 | fraction of the current window line height. For example, if the | ||
| 3930 | current window has 20 lines and @code{maximum-scroll-margin} is 0.1, | ||
| 3931 | then the scroll margins will never be larger than 2 lines, no matter | ||
| 3932 | how big @code{scroll-margin} is. | ||
| 3933 | |||
| 3934 | @code{maximum-scroll-margin} itself has a maximum value of 0.5, which | ||
| 3935 | allows setting margins large to keep the cursor at the middle line of | ||
| 3936 | the window (or two middle lines if the window has an even number of | ||
| 3937 | lines). If it's set to a larger value (or any value other than a | ||
| 3938 | float between 0.0 and 0.5) then the default value of 0.25 will be used | ||
| 3939 | instead. | ||
| 3940 | @end defopt | ||
| 3941 | |||
| 3927 | @defopt scroll-conservatively | 3942 | @defopt scroll-conservatively |
| 3928 | This variable controls how scrolling is done automatically when point | 3943 | This variable controls how scrolling is done automatically when point |
| 3929 | moves off the screen (or into the scroll margin). If the value is a | 3944 | moves off the screen (or into the scroll margin). If the value is a |
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi index 68a16c0ed74..14981c9c58b 100644 --- a/doc/misc/cc-mode.texi +++ b/doc/misc/cc-mode.texi | |||
| @@ -4141,7 +4141,8 @@ Open brace of an enum or static array list. @ref{Brace List Symbols}. | |||
| 4141 | @item brace-list-close | 4141 | @item brace-list-close |
| 4142 | Close brace of an enum or static array list. @ref{Brace List Symbols}. | 4142 | Close brace of an enum or static array list. @ref{Brace List Symbols}. |
| 4143 | @item brace-list-intro | 4143 | @item brace-list-intro |
| 4144 | First line in an enum or static array list. @ref{Brace List Symbols}. | 4144 | First line after the opening @samp{@{} in an enum or static array |
| 4145 | list. @ref{Brace List Symbols}. | ||
| 4145 | @item brace-list-entry | 4146 | @item brace-list-entry |
| 4146 | Subsequent lines in an enum or static array list. @ref{Brace List | 4147 | Subsequent lines in an enum or static array list. @ref{Brace List |
| 4147 | Symbols}. | 4148 | Symbols}. |
| @@ -4635,11 +4636,18 @@ example: | |||
| 4635 | 4636 | ||
| 4636 | Here, you've already seen the analysis of lines 1, 2, 3, and 11. On | 4637 | Here, you've already seen the analysis of lines 1, 2, 3, and 11. On |
| 4637 | line 4, things get interesting; this line is assigned | 4638 | line 4, things get interesting; this line is assigned |
| 4638 | @code{brace-entry-open} syntactic symbol because it's a bracelist entry | 4639 | @code{brace-entry-open} syntactic symbol because it's a bracelist |
| 4639 | line that starts with an open brace. Lines 5 and 6 (and line 9) are | 4640 | entry line that starts with an open brace. Lines 5 and 6 are pretty |
| 4640 | pretty standard, and line 7 is a @code{brace-list-close} as you'd | 4641 | standard, and line 7 is a @code{brace-list-close} as you'd expect. |
| 4641 | expect. Once again, line 8 is assigned as @code{brace-entry-open} as is | 4642 | Once again, line 8 is assigned as @code{brace-entry-open} as is line |
| 4642 | line 10. | 4643 | 10. Line 9 is assigned two syntactic elements, @code{brace-list-intro} |
| 4644 | with anchor point at the @samp{@{} of line 8@footnote{This extra | ||
| 4645 | syntactic element was introduced in @ccmode{} 5.33.1 to allow extra | ||
| 4646 | flexibility in indenting the second line of such a construct. You can | ||
| 4647 | preserve the behaviour resulting from the former syntactic analysis by | ||
| 4648 | giving @code{brace-list-entry} an offset of | ||
| 4649 | @code{c-lineup-under-anchor} (@pxref{Misc Line-Up}).}, and | ||
| 4650 | @code{brace-list-entry} anchored on the @samp{1} of line 8. | ||
| 4643 | 4651 | ||
| 4644 | @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! | 4652 | @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 4645 | @node External Scope Symbols, Paren List Symbols, Brace List Symbols, Syntactic Symbols | 4653 | @node External Scope Symbols, Paren List Symbols, Brace List Symbols, Syntactic Symbols |
| @@ -6288,6 +6296,17 @@ already has; think of it as an identity function for lineups. | |||
| 6288 | 6296 | ||
| 6289 | @comment ------------------------------------------------------------ | 6297 | @comment ------------------------------------------------------------ |
| 6290 | 6298 | ||
| 6299 | @defun c-lineup-under-anchor | ||
| 6300 | |||
| 6301 | Line up a line directly underneath its anchor point. This is like | ||
| 6302 | @samp{0}, except any previously calculated offset contributions are | ||
| 6303 | disregarded. | ||
| 6304 | |||
| 6305 | @workswith Any syntactic symbol which has an anchor point. | ||
| 6306 | @end defun | ||
| 6307 | |||
| 6308 | @comment ------------------------------------------------------------ | ||
| 6309 | |||
| 6291 | @defun c-lineup-cpp-define | 6310 | @defun c-lineup-cpp-define |
| 6292 | @findex lineup-cpp-define (c-) | 6311 | @findex lineup-cpp-define (c-) |
| 6293 | Line up macro continuation lines according to the indentation of the | 6312 | Line up macro continuation lines according to the indentation of the |
diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi index 9e56a54ed74..8baa0bd88c6 100644 --- a/doc/misc/cl.texi +++ b/doc/misc/cl.texi | |||
| @@ -3694,7 +3694,7 @@ i.e., chains of cons cells. | |||
| 3694 | 3694 | ||
| 3695 | @defun cl-caddr x | 3695 | @defun cl-caddr x |
| 3696 | This function is equivalent to @code{(car (cdr (cdr @var{x})))}. | 3696 | This function is equivalent to @code{(car (cdr (cdr @var{x})))}. |
| 3697 | Likewise, this package defines all 24 @code{c@var{xxx}r} functions | 3697 | Likewise, this package aliases all 24 @code{c@var{xxx}r} functions |
| 3698 | where @var{xxx} is up to four @samp{a}s and/or @samp{d}s. | 3698 | where @var{xxx} is up to four @samp{a}s and/or @samp{d}s. |
| 3699 | All of these functions are @code{setf}-able, and calls to them | 3699 | All of these functions are @code{setf}-able, and calls to them |
| 3700 | are expanded inline by the byte-compiler for maximum efficiency. | 3700 | are expanded inline by the byte-compiler for maximum efficiency. |
diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi index 771c078be75..b0cfbc9d3c0 100644 --- a/doc/misc/emacs-mime.texi +++ b/doc/misc/emacs-mime.texi | |||
| @@ -654,6 +654,10 @@ Each tag can contain zero or more parameters on the form | |||
| 654 | but that's not necessary unless the value contains white space. So | 654 | but that's not necessary unless the value contains white space. So |
| 655 | @samp{filename=/home/user/#hello$^yes} is perfectly valid. | 655 | @samp{filename=/home/user/#hello$^yes} is perfectly valid. |
| 656 | 656 | ||
| 657 | If you want to talk about MML in a message, you need a way to | ||
| 658 | ``quote'' these tags. The way to do that is to include an exclamation | ||
| 659 | point after the opening two characters; i. e. @samp{<#!part ...>}. | ||
| 660 | |||
| 657 | The following parameters have meaning in @acronym{MML}; parameters that have no | 661 | The following parameters have meaning in @acronym{MML}; parameters that have no |
| 658 | meaning are ignored. The @acronym{MML} parameter names are the same as the | 662 | meaning are ignored. The @acronym{MML} parameter names are the same as the |
| 659 | @acronym{MIME} parameter names; the things in the parentheses say which | 663 | @acronym{MIME} parameter names; the things in the parentheses say which |
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 05159d4b2f7..ceeb42b9182 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi | |||
| @@ -10197,6 +10197,11 @@ Sort by lines (@code{gnus-summary-sort-by-lines}). | |||
| 10197 | @findex gnus-summary-sort-by-chars | 10197 | @findex gnus-summary-sort-by-chars |
| 10198 | Sort by article length (@code{gnus-summary-sort-by-chars}). | 10198 | Sort by article length (@code{gnus-summary-sort-by-chars}). |
| 10199 | 10199 | ||
| 10200 | @item C-c C-s C-m C-m | ||
| 10201 | @kindex C-c C-s C-m C-m (Summary) | ||
| 10202 | @findex gnus-summary-sort-by-marks | ||
| 10203 | Sort by article ``readedness'' marks (@code{gnus-summary-sort-by-marks}). | ||
| 10204 | |||
| 10200 | @item C-c C-s C-i | 10205 | @item C-c C-s C-i |
| 10201 | @kindex C-c C-s C-i (Summary) | 10206 | @kindex C-c C-s C-i (Summary) |
| 10202 | @findex gnus-summary-sort-by-score | 10207 | @findex gnus-summary-sort-by-score |
| @@ -13515,7 +13520,8 @@ Close the connection (if any) to the server | |||
| 13515 | @kindex D (Server) | 13520 | @kindex D (Server) |
| 13516 | @findex gnus-server-deny-server | 13521 | @findex gnus-server-deny-server |
| 13517 | Mark the current server as unreachable | 13522 | Mark the current server as unreachable |
| 13518 | (@code{gnus-server-deny-server}). | 13523 | (@code{gnus-server-deny-server}). This will effectively disable the |
| 13524 | server. | ||
| 13519 | 13525 | ||
| 13520 | @item M-o | 13526 | @item M-o |
| 13521 | @kindex M-o (Server) | 13527 | @kindex M-o (Server) |
| @@ -21857,37 +21863,37 @@ In summary mode: | |||
| 21857 | 21863 | ||
| 21858 | @table @kbd | 21864 | @table @kbd |
| 21859 | 21865 | ||
| 21860 | @item $ m | 21866 | @item G G m |
| 21861 | @kindex $ m (Summary) | 21867 | @kindex G G m (Summary) |
| 21862 | @findex nnmairix-widget-search-from-this-article | 21868 | @findex nnmairix-widget-search-from-this-article |
| 21863 | Allows you to create a mairix query or group based on the current | 21869 | Allows you to create a mairix query or group based on the current |
| 21864 | message using graphical widgets (same as @code{nnmairix-widget-search}) | 21870 | message using graphical widgets (same as @code{nnmairix-widget-search}) |
| 21865 | (@code{nnmairix-widget-search-from-this-article}). | 21871 | (@code{nnmairix-widget-search-from-this-article}). |
| 21866 | 21872 | ||
| 21867 | @item $ g | 21873 | @item G G g |
| 21868 | @kindex $ g (Summary) | 21874 | @kindex G G g (Summary) |
| 21869 | @findex nnmairix-create-search-group-from-message | 21875 | @findex nnmairix-create-search-group-from-message |
| 21870 | Interactively creates a new search group with query based on the current | 21876 | Interactively creates a new search group with query based on the current |
| 21871 | message, but uses the minibuffer instead of graphical widgets | 21877 | message, but uses the minibuffer instead of graphical widgets |
| 21872 | (@code{nnmairix-create-search-group-from-message}). | 21878 | (@code{nnmairix-create-search-group-from-message}). |
| 21873 | 21879 | ||
| 21874 | @item $ t | 21880 | @item G G t |
| 21875 | @kindex $ t (Summary) | 21881 | @kindex G G t (Summary) |
| 21876 | @findex nnmairix-search-thread-this-article | 21882 | @findex nnmairix-search-thread-this-article |
| 21877 | Searches thread for the current article | 21883 | Searches thread for the current article |
| 21878 | (@code{nnmairix-search-thread-this-article}). This is effectively a | 21884 | (@code{nnmairix-search-thread-this-article}). This is effectively a |
| 21879 | shortcut for calling @code{nnmairix-search} with @samp{m:msgid} of the | 21885 | shortcut for calling @code{nnmairix-search} with @samp{m:msgid} of the |
| 21880 | current article and enabled threads. | 21886 | current article and enabled threads. |
| 21881 | 21887 | ||
| 21882 | @item $ f | 21888 | @item G G f |
| 21883 | @kindex $ f (Summary) | 21889 | @kindex G G f (Summary) |
| 21884 | @findex nnmairix-search-from-this-article | 21890 | @findex nnmairix-search-from-this-article |
| 21885 | Searches all messages from sender of the current article | 21891 | Searches all messages from sender of the current article |
| 21886 | (@code{nnmairix-search-from-this-article}). This is a shortcut for | 21892 | (@code{nnmairix-search-from-this-article}). This is a shortcut for |
| 21887 | calling @code{nnmairix-search} with @samp{f:From}. | 21893 | calling @code{nnmairix-search} with @samp{f:From}. |
| 21888 | 21894 | ||
| 21889 | @item $ o | 21895 | @item G G o |
| 21890 | @kindex $ o (Summary) | 21896 | @kindex G G o (Summary) |
| 21891 | @findex nnmairix-goto-original-article | 21897 | @findex nnmairix-goto-original-article |
| 21892 | (Only in @code{nnmairix} groups!) Tries determine the group this article | 21898 | (Only in @code{nnmairix} groups!) Tries determine the group this article |
| 21893 | originally came from and displays the article in this group, so that, | 21899 | originally came from and displays the article in this group, so that, |
| @@ -21896,8 +21902,8 @@ parameters are applied (@code{nnmairix-goto-original-article}). This | |||
| 21896 | function will use the registry if available, but can also parse the | 21902 | function will use the registry if available, but can also parse the |
| 21897 | article file name as a fallback method. | 21903 | article file name as a fallback method. |
| 21898 | 21904 | ||
| 21899 | @item $ u | 21905 | @item G G u |
| 21900 | @kindex $ u (Summary) | 21906 | @kindex G G u (Summary) |
| 21901 | @findex nnmairix-remove-tick-mark-original-article | 21907 | @findex nnmairix-remove-tick-mark-original-article |
| 21902 | Remove possibly existing tick mark from original article | 21908 | Remove possibly existing tick mark from original article |
| 21903 | (@code{nnmairix-remove-tick-mark-original-article}). (@pxref{nnmairix | 21909 | (@code{nnmairix-remove-tick-mark-original-article}). (@pxref{nnmairix |
| @@ -22051,7 +22057,7 @@ activate the always-unread feature by using @kbd{G b r} twice. | |||
| 22051 | 22057 | ||
| 22052 | So far so good---but how do you remove the tick marks in the @code{nnmairix} | 22058 | So far so good---but how do you remove the tick marks in the @code{nnmairix} |
| 22053 | group? There are two options: You may simply use | 22059 | group? There are two options: You may simply use |
| 22054 | @code{nnmairix-remove-tick-mark-original-article} (bound to @kbd{$ u}) to remove | 22060 | @code{nnmairix-remove-tick-mark-original-article} (bound to @kbd{G G u}) to remove |
| 22055 | tick marks from the original article. The other possibility is to set | 22061 | tick marks from the original article. The other possibility is to set |
| 22056 | @code{nnmairix-propagate-marks-to-nnmairix-groups} to @code{t}, but see the above | 22062 | @code{nnmairix-propagate-marks-to-nnmairix-groups} to @code{t}, but see the above |
| 22057 | comments about this option. If it works for you, the tick marks should | 22063 | comments about this option. If it works for you, the tick marks should |
diff --git a/doc/misc/texinfo.tex b/doc/misc/texinfo.tex index c8913ab918e..338bcf65040 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-09-18.18} | 6 | \def\texinfoversion{2017-01-14.15} |
| 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, |
| @@ -165,6 +165,9 @@ | |||
| 165 | % Give the space character the catcode for a space. | 165 | % Give the space character the catcode for a space. |
| 166 | \def\spaceisspace{\catcode`\ =10\relax} | 166 | \def\spaceisspace{\catcode`\ =10\relax} |
| 167 | 167 | ||
| 168 | % Likewise for ^^M, the end of line character. | ||
| 169 | \def\endlineisspace{\catcode13=10\relax} | ||
| 170 | |||
| 168 | \chardef\dashChar = `\- | 171 | \chardef\dashChar = `\- |
| 169 | \chardef\slashChar = `\/ | 172 | \chardef\slashChar = `\/ |
| 170 | \chardef\underChar = `\_ | 173 | \chardef\underChar = `\_ |
| @@ -950,21 +953,14 @@ where each line of input produces a line of output.} | |||
| 950 | % @comment ...line which is ignored... | 953 | % @comment ...line which is ignored... |
| 951 | % @c is the same as @comment | 954 | % @c is the same as @comment |
| 952 | % @ignore ... @end ignore is another way to write a comment | 955 | % @ignore ... @end ignore is another way to write a comment |
| 953 | % | ||
| 954 | \def\comment{\begingroup \catcode`\^^M=\active% | ||
| 955 | \catcode`\@=\other \catcode`\{=\other \catcode`\}=\other\commentxxx}% | ||
| 956 | 956 | ||
| 957 | {\catcode`\^^M=\active% | ||
| 958 | \gdef\commentxxx#1^^M{\endgroup% | ||
| 959 | \futurelet\nexttoken\commentxxxx}% | ||
| 960 | \gdef\commentxxxx{\ifx\nexttoken\aftermacro\expandafter\comment\fi}% | ||
| 961 | } | ||
| 962 | 957 | ||
| 963 | \def\c{\begingroup \catcode`\^^M=\active% | 958 | \def\c{\begingroup \catcode`\^^M=\active% |
| 964 | \catcode`\@=\other \catcode`\{=\other \catcode`\}=\other% | 959 | \catcode`\@=\other \catcode`\{=\other \catcode`\}=\other% |
| 965 | \cxxx} | 960 | \cxxx} |
| 966 | {\catcode`\^^M=\active \gdef\cxxx#1^^M{\endgroup}} | 961 | {\catcode`\^^M=\active \gdef\cxxx#1^^M{\endgroup}} |
| 967 | % See comment in \scanmacro about why the definitions of @c and @comment differ | 962 | % |
| 963 | \let\comment\c | ||
| 968 | 964 | ||
| 969 | % @paragraphindent NCHARS | 965 | % @paragraphindent NCHARS |
| 970 | % We'll use ems for NCHARS, close enough. | 966 | % We'll use ems for NCHARS, close enough. |
| @@ -8031,9 +8027,6 @@ end | |||
| 8031 | } | 8027 | } |
| 8032 | \fi | 8028 | \fi |
| 8033 | 8029 | ||
| 8034 | \let\aftermacroxxx\relax | ||
| 8035 | \def\aftermacro{\aftermacroxxx} | ||
| 8036 | |||
| 8037 | % alias because \c means cedilla in @tex or @math | 8030 | % alias because \c means cedilla in @tex or @math |
| 8038 | \let\texinfoc=\c | 8031 | \let\texinfoc=\c |
| 8039 | 8032 | ||
| @@ -8055,18 +8048,13 @@ end | |||
| 8055 | \catcode`\\=\active | 8048 | \catcode`\\=\active |
| 8056 | % | 8049 | % |
| 8057 | % Process the macro body under the current catcode regime. | 8050 | % Process the macro body under the current catcode regime. |
| 8058 | \scantokens{#1@texinfoc}\aftermacro% | 8051 | \scantokens{#1@texinfoc}% |
| 8059 | % | 8052 | % |
| 8060 | \catcode`\@=\savedcatcodeone | 8053 | \catcode`\@=\savedcatcodeone |
| 8061 | \catcode`\\=\savedcatcodetwo | 8054 | \catcode`\\=\savedcatcodetwo |
| 8062 | % | 8055 | % |
| 8063 | % The \texinfoc is to remove the \newlinechar added by \scantokens, and | 8056 | % The \texinfoc is to remove the \newlinechar added by \scantokens, and |
| 8064 | % can be noticed by \parsearg. | 8057 | % can be noticed by \parsearg. |
| 8065 | % The \aftermacro allows a \comment at the end of the macro definition | ||
| 8066 | % to duplicate itself past the final \newlinechar added by \scantokens: | ||
| 8067 | % this is used in the definition of \group to comment out a newline. We | ||
| 8068 | % don't do the same for \c to support Texinfo files with macros that ended | ||
| 8069 | % with a @c, which should no longer be necessary. | ||
| 8070 | % We avoid surrounding the call to \scantokens with \bgroup and \egroup | 8058 | % We avoid surrounding the call to \scantokens with \bgroup and \egroup |
| 8071 | % to allow macros to open or close groups themselves. | 8059 | % to allow macros to open or close groups themselves. |
| 8072 | } | 8060 | } |
| @@ -8538,6 +8526,13 @@ end | |||
| 8538 | \ifcase\paramno | 8526 | \ifcase\paramno |
| 8539 | % 0 | 8527 | % 0 |
| 8540 | \expandafter\xdef\csname\the\macname\endcsname{% | 8528 | \expandafter\xdef\csname\the\macname\endcsname{% |
| 8529 | \bgroup | ||
| 8530 | \noexpand\spaceisspace | ||
| 8531 | \noexpand\endlineisspace | ||
| 8532 | \noexpand\expandafter % skip any whitespace after the macro name. | ||
| 8533 | \expandafter\noexpand\csname\the\macname @@@\endcsname}% | ||
| 8534 | \expandafter\xdef\csname\the\macname @@@\endcsname{% | ||
| 8535 | \egroup | ||
| 8541 | \noexpand\scanmacro{\macrobody}}% | 8536 | \noexpand\scanmacro{\macrobody}}% |
| 8542 | \or % 1 | 8537 | \or % 1 |
| 8543 | \expandafter\xdef\csname\the\macname\endcsname{% | 8538 | \expandafter\xdef\csname\the\macname\endcsname{% |