diff options
author | Glenn Morris <rgm@gnu.org> | 2020-05-28 07:50:26 -0700 |
---|---|---|
committer | Glenn Morris <rgm@gnu.org> | 2020-05-28 07:50:26 -0700 |
commit | 4939beacb33ea91cd35e18fa7d43a4392d47f6f4 (patch) | |
tree | 89abaf5e14f5baece710d57e32e3575cb2be514a /doc/lispref/text.texi | |
parent | a134691435e107f348becb0b695a36e3e9c8fdac (diff) | |
parent | bd7b681dc432ce77fbe3634c919fe49ca335f8e1 (diff) | |
download | emacs-4939beacb33ea91cd35e18fa7d43a4392d47f6f4.tar.gz emacs-4939beacb33ea91cd35e18fa7d43a4392d47f6f4.tar.bz2 emacs-4939beacb33ea91cd35e18fa7d43a4392d47f6f4.zip |
Merge from origin/emacs-27
bd7b681dc4 (origin/emacs-27) Tiny texinfo markup fixes
d0dd0e0612 ; Fix more @var/@code mixups in Elisp manual
313dc0439e ; Fix another format-spec typo in the Elisp manual
9d7fd78421 Make next-error behavior a bit more flexible
0691d25295 * etc/NEWS.25: Belatedly announce upcase-dwim and downcase...
df91c94ca8 Fix access to single-byte characters in buffer text
Diffstat (limited to 'doc/lispref/text.texi')
-rw-r--r-- | doc/lispref/text.texi | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index 70fb7141a1f..7c4bed04cb5 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -4511,33 +4511,33 @@ would destroy these properties. However, the latter combination is typically faster (@xref{Deletion}, and @ref{Insertion}). For its working, @code{replace-buffer-contents} needs to compare the -contents of the original buffer with that of @code{source} which is a +contents of the original buffer with that of @var{source} which is a costly operation if the buffers are huge and there is a high number of differences between them. In order to keep @code{replace-buffer-contents}'s runtime in bounds, it has two optional arguments. -@code{max-secs} defines a hard boundary in terms of seconds. If given +@var{max-secs} defines a hard boundary in terms of seconds. If given and exceeded, it will fall back to @code{delete-region} and @code{insert-buffer-substring}. -@code{max-costs} defines the quality of the difference computation. -If the actual costs exceed this limit, heuristics are used to provide -a faster but suboptimal solution. The default value is 1000000. +@var{max-costs} defines the quality of the difference computation. If +the actual costs exceed this limit, heuristics are used to provide a +faster but suboptimal solution. The default value is 1000000. @code{replace-buffer-contents} returns t if a non-destructive -replacement could be performed. Otherwise, i.e., if @code{max-secs} +replacement could be performed. Otherwise, i.e., if @var{max-secs} was exceeded, it returns nil. @end deffn @defun replace-region-contents beg end replace-fn &optional max-secs max-costs -This function replaces the region between @code{beg} and @code{end} -using the given @code{replace-fn}. The function @code{replace-fn} is +This function replaces the region between @var{beg} and @var{end} +using the given @var{replace-fn}. The function @var{replace-fn} is run in the current buffer narrowed to the specified region and it should return either a string or a buffer replacing the region. The replacement is performed using @code{replace-buffer-contents} (see -above) which also describes the @code{max-secs} and @code{max-costs} +above) which also describes the @var{max-secs} and @var{max-costs} arguments and the return value. Note: If the replacement is a string, it will be placed in a temporary @@ -4678,7 +4678,7 @@ expanded when the header line is computed. To do this, the above. @var{specification} is an alist that has elements where the @code{car} is a character and the @code{cdr} is the substitution. -If @code{ONLY-PRESENT} is @code{nil}, errors will be signaled if a +If @var{only-present} is @code{nil}, errors will be signaled if a format character has been used that's not present in @var{specification}. If it's non-@code{nil}, that format specification is left verbatim in the result. |