diff options
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: @code{scroll-up-aggressively} / @code{scroll-down-aggressively}. @vindex scroll-margin +@vindex maximum-scroll-margin The variable @code{scroll-margin} restricts how close point can come to the top or bottom of a window (even if aggressive scrolling specifies a fraction @var{f} that is larger than the window portion -between the top and the bottom margins). Its value is a number of screen -lines; if point comes within that many lines of the top or bottom of -the window, Emacs performs automatic scrolling. By default, -@code{scroll-margin} is 0. +between the top and the bottom margins). Its value is a number of +screen lines; if point comes within that many lines of the top or +bottom of the window, Emacs performs automatic scrolling. By default, +@code{scroll-margin} is 0. The effective margin size is limited to a +quarter of the window height by default, but this limit can be +increased up to half (or decreased down to zero) by customizing +@code{maximum-scroll-margin}. @node Horizontal Scrolling @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 Display a help message about these options. @end table +@noindent +@vindex save-some-buffers-default-predicate +You can customize the value of +@code{save-some-buffers-default-predicate} to control which buffers +Emacs will ask about. + @kbd{C-x C-c}, the key sequence to exit Emacs, invokes @code{save-some-buffers} and therefore asks the same questions. 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. Here are some other commands that find matches for a regular expression. They all ignore case in matching, if the pattern contains no upper-case letters and @code{case-fold-search} is non-@code{nil}. -Aside from @code{occur} and its variants, all operate on the text from -point to the end of the buffer, or on the region if it is active. +Aside from @code{multi-occur} and @code{multi-occur-in-matching-buffers}, +which always search the whole buffer, all operate on the text from point +to the end of the buffer, or on the region if it is active. @findex list-matching-lines @findex occur @@ -1714,6 +1715,8 @@ a multi-file incremental search is activated automatically. @cindex mode, Occur @cindex match (face name) @vindex list-matching-lines-default-context-lines +@vindex list-matching-lines-jump-to-current-line +@cindex list-matching-lines-current-line-face (face name) @kindex M-s o @item M-x occur @itemx M-s o @@ -1721,11 +1724,14 @@ Prompt for a regexp, and display a list showing each line in the buffer that contains a match for it. If you type @kbd{M-n} at the prompt, you can reuse search strings from previous incremental searches. The text that matched is highlighted using the @code{match} -face. To limit the search to part of the buffer, narrow to that part -(@pxref{Narrowing}). A numeric argument @var{n} specifies that -@var{n} lines of context are to be displayed before and after each -matching line. The default number of context lines is specified by -the variable @code{list-matching-lines-default-context-lines}. +face. A numeric argument @var{n} specifies that @var{n} lines of +context are to be displayed before and after each matching line. +The default number of context lines is specified by the variable +@code{list-matching-lines-default-context-lines}. +When @code{list-matching-lines-jump-to-current-line} is non-nil, +the current line is shown highlighted with face +@code{list-matching-lines-current-line-face} and the point is set +at the first match after such line. You can also run @kbd{M-s o} when an incremental search is active; 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: @findex occur The @code{occur} command shows all the lines in the current buffer -that contain a match for a regular expression. Matching lines are -shown in a buffer called @file{*Occur*}. That buffer serves as a menu -to jump to occurrences. +that contain a match for a regular expression. When the region is +active, @code{occur} restricts matches to such region. Otherwise it +uses the entire buffer. +Matching lines are shown in a buffer called @file{*Occur*}. +That buffer serves as a menu to jump to occurrences. @findex global-unset-key @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. @itemize @bullet @item -@code{max-lisp-eval-depth} and @code{max-specpdl-size} are both -increased to reduce Edebug's impact on the stack. You could, however, -still run out of stack space when using Edebug. +@vindex edebug-max-depth +@code{max-lisp-eval-depth} (@pxref{Eval}) and @code{max-specpdl-size} +(@pxref{Local Variables}) are both increased to reduce Edebug's impact +on the stack. You could, however, still run out of stack space when +using Edebug. You can also enlarge the value of +@code{edebug-max-depth} if Edebug reaches the limit of recursion depth +instrumenting code that contains very large quoted lists. @item 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 non-@code{nil}, it saves all the file-visiting buffers without querying the user. -The optional @var{pred} argument controls which buffers to ask about -(or to save silently if @var{save-silently-p} is non-@code{nil}). -If it is @code{nil}, that means to ask only about file-visiting buffers. -If it is @code{t}, that means also offer to save certain other non-file -buffers---those that have a non-@code{nil} buffer-local value of -@code{buffer-offer-save} (@pxref{Killing Buffers}). A user who says -@samp{yes} to saving a non-file buffer is asked to specify the file -name to use. The @code{save-buffers-kill-emacs} function passes the -value @code{t} for @var{pred}. - -If @var{pred} is neither @code{t} nor @code{nil}, then it should be +@vindex save-some-buffers-default-predicate +The optional @var{pred} argument provides a predicate that controls +which buffers to ask about (or to save silently if +@var{save-silently-p} is non-@code{nil}). If @var{pred} is +@code{nil}, that means to use the value of +@code{save-some-buffers-default-predicate} instead of @var{pred}. If +the result is @code{nil}, it means ask only about file-visiting +buffers. If it is @code{t}, that means also offer to save certain +other non-file buffers---those that have a non-@code{nil} buffer-local +value of @code{buffer-offer-save} (@pxref{Killing Buffers}). A user +who says @samp{yes} to saving a non-file buffer is asked to specify +the file name to use. The @code{save-buffers-kill-emacs} function +passes the value @code{t} for @var{pred}. + +If the predicate is neither @code{t} nor @code{nil}, then it should be a function of no arguments. It will be called in each buffer to decide whether to offer to save that buffer. If it returns a non-@code{nil} 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...) */) if (!NILP (val)) break; args = XCDR (args); - QUIT; + maybe_quit (); @} @end group @@ -792,8 +792,8 @@ their addresses after performing Lisp evaluation. Lisp evaluation can occur via calls to @code{eval_sub} or @code{Feval}, either directly or indirectly. -@cindex @code{QUIT}, use in Lisp primitives - Note the call to the @code{QUIT} macro inside the loop: this macro +@cindex @code{maybe_quit}, use in Lisp primitives + Note the call to @code{maybe_quit} inside the loop: this function checks whether the user pressed @kbd{C-g}, and if so, aborts the processing. You should do that in any loop that can potentially 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}))} or @code{(nthcdr 2 @var{cons-cell})}. @end defun +@findex caaar +@findex caadr +@findex cadar +@findex caddr +@findex cdaar +@findex cdadr +@findex cddar +@findex cdddr +@findex caaaar +@findex caaadr +@findex caadar +@findex caaddr +@findex cadaar +@findex cadadr +@findex caddar +@findex cadddr +@findex cdaaar +@findex cdaadr +@findex cdadar +@findex cdaddr +@findex cddaar +@findex cddadr +@findex cdddar +@findex cddddr +In addition to the above, 24 additional compositions of @code{car} and +@code{cdr} are defined as @code{c@var{xxx}r} and @code{c@var{xxxx}r}, +where each @code{@var{x}} is either @code{a} or @code{d}. @code{cadr}, +@code{caddr}, and @code{cadddr} pick out the second, third or fourth +elements of a list, respectively. @file{cl-lib} provides the same +under the names @code{cl-second}, @code{cl-third}, and +@code{cl-fourth}. @xref{List Functions,,, cl, Common Lisp +Extensions}. + @defun butlast x &optional n This function returns the list @var{x} with the last element, 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. The connection type: @samp{plain} or @samp{tls}. @end table +@item :shell-command @var{string-or-nil} +If the connection @code{type} is @code{shell}, this parameter will be +interpreted as a format-spec string that will be executed to make the +connection. The specs available are @samp{%s} for the host name and +@samp{%p} for the port number. For instance, if you want to first ssh +to @samp{gateway} before making a plain connection, then this +parameter could be something like @samp{ssh gateway nc %s %p}. + @end table @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 out of the margin, closer to the center of the window. @end defopt +@defopt maximum-scroll-margin +This variable limits the effective value of @code{scroll-margin} to a +fraction of the current window line height. For example, if the +current window has 20 lines and @code{maximum-scroll-margin} is 0.1, +then the scroll margins will never be larger than 2 lines, no matter +how big @code{scroll-margin} is. + +@code{maximum-scroll-margin} itself has a maximum value of 0.5, which +allows setting margins large to keep the cursor at the middle line of +the window (or two middle lines if the window has an even number of +lines). If it's set to a larger value (or any value other than a +float between 0.0 and 0.5) then the default value of 0.25 will be used +instead. +@end defopt + @defopt scroll-conservatively This variable controls how scrolling is done automatically when point 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}. @item brace-list-close Close brace of an enum or static array list. @ref{Brace List Symbols}. @item brace-list-intro -First line in an enum or static array list. @ref{Brace List Symbols}. +First line after the opening @samp{@{} in an enum or static array +list. @ref{Brace List Symbols}. @item brace-list-entry Subsequent lines in an enum or static array list. @ref{Brace List Symbols}. @@ -4635,11 +4636,18 @@ example: Here, you've already seen the analysis of lines 1, 2, 3, and 11. On line 4, things get interesting; this line is assigned -@code{brace-entry-open} syntactic symbol because it's a bracelist entry -line that starts with an open brace. Lines 5 and 6 (and line 9) are -pretty standard, and line 7 is a @code{brace-list-close} as you'd -expect. Once again, line 8 is assigned as @code{brace-entry-open} as is -line 10. +@code{brace-entry-open} syntactic symbol because it's a bracelist +entry line that starts with an open brace. Lines 5 and 6 are pretty +standard, and line 7 is a @code{brace-list-close} as you'd expect. +Once again, line 8 is assigned as @code{brace-entry-open} as is line +10. Line 9 is assigned two syntactic elements, @code{brace-list-intro} +with anchor point at the @samp{@{} of line 8@footnote{This extra +syntactic element was introduced in @ccmode{} 5.33.1 to allow extra +flexibility in indenting the second line of such a construct. You can +preserve the behaviour resulting from the former syntactic analysis by +giving @code{brace-list-entry} an offset of +@code{c-lineup-under-anchor} (@pxref{Misc Line-Up}).}, and +@code{brace-list-entry} anchored on the @samp{1} of line 8. @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! @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. @comment ------------------------------------------------------------ +@defun c-lineup-under-anchor + +Line up a line directly underneath its anchor point. This is like +@samp{0}, except any previously calculated offset contributions are +disregarded. + +@workswith Any syntactic symbol which has an anchor point. +@end defun + +@comment ------------------------------------------------------------ + @defun c-lineup-cpp-define @findex lineup-cpp-define (c-) 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. @defun cl-caddr x This function is equivalent to @code{(car (cdr (cdr @var{x})))}. -Likewise, this package defines all 24 @code{c@var{xxx}r} functions +Likewise, this package aliases all 24 @code{c@var{xxx}r} functions where @var{xxx} is up to four @samp{a}s and/or @samp{d}s. All of these functions are @code{setf}-able, and calls to them 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 but that's not necessary unless the value contains white space. So @samp{filename=/home/user/#hello$^yes} is perfectly valid. +If you want to talk about MML in a message, you need a way to +``quote'' these tags. The way to do that is to include an exclamation +point after the opening two characters; i. e. @samp{<#!part ...>}. + The following parameters have meaning in @acronym{MML}; parameters that have no meaning are ignored. The @acronym{MML} parameter names are the same as the @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}). @findex gnus-summary-sort-by-chars Sort by article length (@code{gnus-summary-sort-by-chars}). +@item C-c C-s C-m C-m +@kindex C-c C-s C-m C-m (Summary) +@findex gnus-summary-sort-by-marks +Sort by article ``readedness'' marks (@code{gnus-summary-sort-by-marks}). + @item C-c C-s C-i @kindex C-c C-s C-i (Summary) @findex gnus-summary-sort-by-score @@ -13515,7 +13520,8 @@ Close the connection (if any) to the server @kindex D (Server) @findex gnus-server-deny-server Mark the current server as unreachable -(@code{gnus-server-deny-server}). +(@code{gnus-server-deny-server}). This will effectively disable the +server. @item M-o @kindex M-o (Server) @@ -21857,37 +21863,37 @@ In summary mode: @table @kbd -@item $ m -@kindex $ m (Summary) +@item G G m +@kindex G G m (Summary) @findex nnmairix-widget-search-from-this-article Allows you to create a mairix query or group based on the current message using graphical widgets (same as @code{nnmairix-widget-search}) (@code{nnmairix-widget-search-from-this-article}). -@item $ g -@kindex $ g (Summary) +@item G G g +@kindex G G g (Summary) @findex nnmairix-create-search-group-from-message Interactively creates a new search group with query based on the current message, but uses the minibuffer instead of graphical widgets (@code{nnmairix-create-search-group-from-message}). -@item $ t -@kindex $ t (Summary) +@item G G t +@kindex G G t (Summary) @findex nnmairix-search-thread-this-article Searches thread for the current article (@code{nnmairix-search-thread-this-article}). This is effectively a shortcut for calling @code{nnmairix-search} with @samp{m:msgid} of the current article and enabled threads. -@item $ f -@kindex $ f (Summary) +@item G G f +@kindex G G f (Summary) @findex nnmairix-search-from-this-article Searches all messages from sender of the current article (@code{nnmairix-search-from-this-article}). This is a shortcut for calling @code{nnmairix-search} with @samp{f:From}. -@item $ o -@kindex $ o (Summary) +@item G G o +@kindex G G o (Summary) @findex nnmairix-goto-original-article (Only in @code{nnmairix} groups!) Tries determine the group this article 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 function will use the registry if available, but can also parse the article file name as a fallback method. -@item $ u -@kindex $ u (Summary) +@item G G u +@kindex G G u (Summary) @findex nnmairix-remove-tick-mark-original-article Remove possibly existing tick mark from original article (@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. So far so good---but how do you remove the tick marks in the @code{nnmairix} group? There are two options: You may simply use -@code{nnmairix-remove-tick-mark-original-article} (bound to @kbd{$ u}) to remove +@code{nnmairix-remove-tick-mark-original-article} (bound to @kbd{G G u}) to remove tick marks from the original article. The other possibility is to set @code{nnmairix-propagate-marks-to-nnmairix-groups} to @code{t}, but see the above 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 @@ % Load plain if necessary, i.e., if running under initex. \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi % -\def\texinfoversion{2016-09-18.18} +\def\texinfoversion{2017-01-14.15} % % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, @@ -165,6 +165,9 @@ % Give the space character the catcode for a space. \def\spaceisspace{\catcode`\ =10\relax} +% Likewise for ^^M, the end of line character. +\def\endlineisspace{\catcode13=10\relax} + \chardef\dashChar = `\- \chardef\slashChar = `\/ \chardef\underChar = `\_ @@ -950,21 +953,14 @@ where each line of input produces a line of output.} % @comment ...line which is ignored... % @c is the same as @comment % @ignore ... @end ignore is another way to write a comment -% -\def\comment{\begingroup \catcode`\^^M=\active% -\catcode`\@=\other \catcode`\{=\other \catcode`\}=\other\commentxxx}% -{\catcode`\^^M=\active% -\gdef\commentxxx#1^^M{\endgroup% -\futurelet\nexttoken\commentxxxx}% -\gdef\commentxxxx{\ifx\nexttoken\aftermacro\expandafter\comment\fi}% -} \def\c{\begingroup \catcode`\^^M=\active% \catcode`\@=\other \catcode`\{=\other \catcode`\}=\other% \cxxx} {\catcode`\^^M=\active \gdef\cxxx#1^^M{\endgroup}} -% See comment in \scanmacro about why the definitions of @c and @comment differ +% +\let\comment\c % @paragraphindent NCHARS % We'll use ems for NCHARS, close enough. @@ -8031,9 +8027,6 @@ end } \fi -\let\aftermacroxxx\relax -\def\aftermacro{\aftermacroxxx} - % alias because \c means cedilla in @tex or @math \let\texinfoc=\c @@ -8055,18 +8048,13 @@ end \catcode`\\=\active % % Process the macro body under the current catcode regime. - \scantokens{#1@texinfoc}\aftermacro% + \scantokens{#1@texinfoc}% % \catcode`\@=\savedcatcodeone \catcode`\\=\savedcatcodetwo % % The \texinfoc is to remove the \newlinechar added by \scantokens, and % can be noticed by \parsearg. - % The \aftermacro allows a \comment at the end of the macro definition - % to duplicate itself past the final \newlinechar added by \scantokens: - % this is used in the definition of \group to comment out a newline. We - % don't do the same for \c to support Texinfo files with macros that ended - % with a @c, which should no longer be necessary. % We avoid surrounding the call to \scantokens with \bgroup and \egroup % to allow macros to open or close groups themselves. } @@ -8538,6 +8526,13 @@ end \ifcase\paramno % 0 \expandafter\xdef\csname\the\macname\endcsname{% + \bgroup + \noexpand\spaceisspace + \noexpand\endlineisspace + \noexpand\expandafter % skip any whitespace after the macro name. + \expandafter\noexpand\csname\the\macname @@@\endcsname}% + \expandafter\xdef\csname\the\macname @@@\endcsname{% + \egroup \noexpand\scanmacro{\macrobody}}% \or % 1 \expandafter\xdef\csname\the\macname\endcsname{% |