aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
authorEli Zaretskii2025-01-25 10:06:19 -0500
committerEli Zaretskii2025-01-25 10:06:19 -0500
commit6016967e858e12f07c3cf4ade35cddef7b91a0d4 (patch)
treeeafea5f10d6432b3de53dab534604193cafe98e8 /doc/misc
parente8f173f0ba9327033781429ea9a1d99ff8d2f751 (diff)
parent67903f5909db5c6140eeffebfaf818b4f93625d5 (diff)
downloademacs-6016967e858e12f07c3cf4ade35cddef7b91a0d4.tar.gz
emacs-6016967e858e12f07c3cf4ade35cddef7b91a0d4.zip
Merge from origin/emacs-30
67903f5909d Restore the old behavior of `bookmark-write-file' 062da7003f9 ; Improve prompts and error messages in 'info-look' 52dc01f1c8b ; * admin/admin.el (set-version): Note about Android. fb282da2a07 Avoid double spaces around abbrevations in Texinfo bc1ab8ac3d8 ; * doc/emacs/custom.texi (Init Rebinding): Fix spacing. b41ef43af19 ; Fix previous change 5638b1d6bd4 Ispell: Use "personal dictionary" terminology consistently cc791e7499f ; Check man pages for mistakes less frequently 4ed4792e3b9 ; * admin/release-process: Minor copy-edits. 4a867c823b7 Add language server "ruff server" for Python 9e687c2871f Fix go-ts-mode type declaration indentation (Bug#75785) f751b3afa4f ; Minor improvements for doc strings in map.el cda78edc7d9 ; Fix typos ce50a1d3c18 ; * src/w32.c (w32_memory_info): Fix coding style of last... 58d3d4820ad Fix bug in w32_memory_info 77386412050 Avoid crashes in redisplay due to problematic font setups 0e3687e6006 Improve 'key-valid-p' docstring 9878092d2b9 Minor copyedits in internals.texi 4726900fdc5 Better document side-effect free and pure C functions 04c475a39f2 ; Fix documentation about faces of tool-tip text # Conflicts: # admin/codespell/codespell.exclude
Diffstat (limited to 'doc/misc')
-rw-r--r--doc/misc/calc.texi6
-rw-r--r--doc/misc/cc-mode.texi16
-rw-r--r--doc/misc/efaq.texi10
-rw-r--r--doc/misc/eglot.texi2
-rw-r--r--doc/misc/erc.texi2
-rw-r--r--doc/misc/eshell.texi6
-rw-r--r--doc/misc/flymake.texi2
-rw-r--r--doc/misc/gnus-faq.texi2
-rw-r--r--doc/misc/gnus.texi8
-rw-r--r--doc/misc/idlwave.texi4
-rw-r--r--doc/misc/wisent.texi2
11 files changed, 30 insertions, 30 deletions
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi
index d4fbcabc1f1..57bd16cc87d 100644
--- a/doc/misc/calc.texi
+++ b/doc/misc/calc.texi
@@ -234,7 +234,7 @@ series of calculators, its many features include:
234@itemize @bullet 234@itemize @bullet
235@item 235@item
236Choice of algebraic or Reverse Polish notation (RPN), 236Choice of algebraic or Reverse Polish notation (RPN),
237i.e. stack-based, entry of calculations. 237i.e.@: stack-based, entry of calculations.
238 238
239@item 239@item
240Arbitrary precision integers and floating-point numbers. 240Arbitrary precision integers and floating-point numbers.
@@ -2630,8 +2630,8 @@ elements.) Calculations involving fractions will always
2630produce exact fractional results; Fraction mode only says 2630produce exact fractional results; Fraction mode only says
2631what to do when dividing two integers. 2631what to do when dividing two integers.
2632 2632
2633@cindex Fractions vs. floats 2633@cindex Fractions vs.@: floats
2634@cindex Floats vs. fractions 2634@cindex Floats vs.@: fractions
2635(@bullet{}) @strong{Exercise 4.} If fractional arithmetic is exact, 2635(@bullet{}) @strong{Exercise 4.} If fractional arithmetic is exact,
2636why would you ever use floating-point numbers instead? 2636why would you ever use floating-point numbers instead?
2637@xref{Modes Answer 4, 4}. (@bullet{}) 2637@xref{Modes Answer 4, 4}. (@bullet{})
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi
index f98a21743ac..7a3aa61b7ce 100644
--- a/doc/misc/cc-mode.texi
+++ b/doc/misc/cc-mode.texi
@@ -6164,7 +6164,7 @@ Line up the second entry of a brace block under the first, when the
6164first line is also contained in an arglist or an enclosing brace 6164first line is also contained in an arglist or an enclosing brace
6165@emph{on that line}. 6165@emph{on that line}.
6166 6166
6167I.e. handle something like the following: 6167In other words, handle something like the following:
6168 6168
6169@example 6169@example
6170@group 6170@group
@@ -6225,7 +6225,7 @@ Line up the second entry of a class (etc.) initializer
6225@code{c-basic-offset} characters in from the identifier when: 6225@code{c-basic-offset} characters in from the identifier when:
6226@enumerate 6226@enumerate
6227@item 6227@item
6228The type is a class, struct, union, etc. (but not an enum); 6228The type is a class, struct, union, etc.@: (but not an enum);
6229@item 6229@item
6230There is a brace block in the type declaration, specifying it; and 6230There is a brace block in the type declaration, specifying it; and
6231@item 6231@item
@@ -6233,7 +6233,7 @@ The first element of the initializer is on the same line as its
6233opening brace. 6233opening brace.
6234@end enumerate 6234@end enumerate
6235 6235
6236I.e. we have a construct like this: 6236In other words, we have a construct like this:
6237 6237
6238@example 6238@example
6239@group 6239@group
@@ -6267,7 +6267,7 @@ Line up the second entry of a class (etc.) initializer after its
6267opening brace when: 6267opening brace when:
6268@enumerate 6268@enumerate
6269@item 6269@item
6270The type is a class, struct, union, etc. (but not an enum); 6270The type is a class, struct, union, etc.@: (but not an enum);
6271@item 6271@item
6272There is a brace block in the type declaration, specifying it; and 6272There is a brace block in the type declaration, specifying it; and
6273@item 6273@item
@@ -6275,7 +6275,7 @@ The first element of the initializer is on the same line as its
6275opening brace. 6275opening brace.
6276@end enumerate 6276@end enumerate
6277 6277
6278I.e. we have a construct like this: 6278In other words, we have a construct like this:
6279 6279
6280@example 6280@example
6281@group 6281@group
@@ -6589,7 +6589,7 @@ function is the same as specifying a list @code{(c-lineup-assignments
6589@defun c-lineup-ternary-bodies 6589@defun c-lineup-ternary-bodies
6590@findex lineup-ternary-bodies @r{(c-)} 6590@findex lineup-ternary-bodies @r{(c-)}
6591Line up true and false branches of a ternary operator 6591Line up true and false branches of a ternary operator
6592(i.e. @code{?:}). More precisely, if the line starts with a colon 6592(i.e., @code{?:}). More precisely, if the line starts with a colon
6593which is a part of a said operator, align it with corresponding 6593which is a part of a said operator, align it with corresponding
6594question mark. For example: 6594question mark. For example:
6595 6595
@@ -7162,7 +7162,7 @@ is @code{nil}, all lines inside macro definitions are analyzed as
7162@end defopt 7162@end defopt
7163 7163
7164Sometimes you may want to indent particular directives 7164Sometimes you may want to indent particular directives
7165(e.g. @code{#pragma}) as though they were statements. To do this, see 7165(e.g., @code{#pragma}) as though they were statements. To do this, see
7166@ref{Indenting Directives}. 7166@ref{Indenting Directives}.
7167 7167
7168Because a macro can expand into anything at all, near where one is 7168Because a macro can expand into anything at all, near where one is
@@ -7354,7 +7354,7 @@ after the mode hooks have run.
7354@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 7354@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
7355 7355
7356Sometimes you may want to indent particular preprocessor directives 7356Sometimes you may want to indent particular preprocessor directives
7357(e.g. @code{#pragma}) as though they were statements. To do this, 7357(e.g., @code{#pragma}) as though they were statements. To do this,
7358first set up @code{c-cpp-indent-to-body-directives} to include the 7358first set up @code{c-cpp-indent-to-body-directives} to include the
7359directive name(s), then enable the ``indent to body'' feature with 7359directive name(s), then enable the ``indent to body'' feature with
7360@code{c-toggle-cpp-indent-to-body}. 7360@code{c-toggle-cpp-indent-to-body}.
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index b41b51df262..c85c7812b11 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -1889,8 +1889,8 @@ capabilities.
1889 1889
1890If by contrast you wish to @emph{disable} tty color support, either 1890If by contrast you wish to @emph{disable} tty color support, either
1891start emacs with the @samp{--color=no} command-line option, or ensure 1891start emacs with the @samp{--color=no} command-line option, or ensure
1892that the frame parameter @code{tty-color-mode} is @code{no}, e.g. by 1892that the frame parameter @code{tty-color-mode} is @code{no}, for example
1893putting the following in your init file: 1893by putting the following in your init file:
1894 1894
1895@lisp 1895@lisp
1896(push '(tty-color-mode . no) default-frame-alist) 1896(push '(tty-color-mode . no) default-frame-alist)
@@ -3686,9 +3686,9 @@ You can tell Emacs the shell's current directory with the command
3686@item 3686@item
3687Third party packages. 3687Third party packages.
3688 3688
3689Any package you install into Emacs can run arbitrary code with the 3689Any package you install into Emacs can run arbitrary code with the same
3690same privileges as the Emacs process itself. Be aware of this when 3690privileges as the Emacs process itself. Be aware of this when you use
3691you use the package system (e.g. @code{M-x list-packages}) with third 3691the package system (for example, @code{M-x list-packages}) with third
3692party archives. Use only third parties that you can trust! 3692party archives. Use only third parties that you can trust!
3693 3693
3694@item 3694@item
diff --git a/doc/misc/eglot.texi b/doc/misc/eglot.texi
index af38adc094a..d7bd78e134b 100644
--- a/doc/misc/eglot.texi
+++ b/doc/misc/eglot.texi
@@ -872,7 +872,7 @@ If this is non-@code{nil}, and @kbd{M-.}
872(@code{xref-find-definitions}) lands you in a file outside of your 872(@code{xref-find-definitions}) lands you in a file outside of your
873project, such as a system-installed library or header file, 873project, such as a system-installed library or header file,
874transiently consider that file as managed by the same language server. 874transiently consider that file as managed by the same language server.
875That file is still outside your project (i.e. @code{project-find-file} 875That file is still outside your project (i.e., @code{project-find-file}
876won't find it), but Eglot and the server will consider it to be part 876won't find it), but Eglot and the server will consider it to be part
877of the workspace. The default is @code{nil}. 877of the workspace. The default is @code{nil}.
878 878
diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi
index 878ec798b19..7c934d8bb3a 100644
--- a/doc/misc/erc.texi
+++ b/doc/misc/erc.texi
@@ -851,7 +851,7 @@ Examples of use:
851 851
852In the case of @code{:client-certificate t}, you will need to add a 852In the case of @code{:client-certificate t}, you will need to add a
853line like the following to your authinfo file 853line like the following to your authinfo file
854(e.g. @file{~/.authinfo.gpg}): 854(for example, @file{~/.authinfo.gpg}):
855 855
856@example 856@example
857machine irc.libera.chat key /home/bandali/my-cert.key cert /home/bandali/my-cert.crt 857machine irc.libera.chat key /home/bandali/my-cert.key cert /home/bandali/my-cert.crt
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi
index 6f70b270c5a..465d3dede13 100644
--- a/doc/misc/eshell.texi
+++ b/doc/misc/eshell.texi
@@ -1642,7 +1642,7 @@ edited aliases.
1642 1642
1643Note that unlike aliases in Bash, arguments must be handled 1643Note that unlike aliases in Bash, arguments must be handled
1644explicitly. Within aliases, you can use the special variables 1644explicitly. Within aliases, you can use the special variables
1645@samp{$*}, @samp{$0}, @samp{$1}, @samp{$2}, etc. to refer to the 1645@samp{$*}, @samp{$0}, @samp{$1}, @samp{$2}, etc.@: to refer to the
1646arguments passed to the alias. 1646arguments passed to the alias.
1647 1647
1648@table @code 1648@table @code
@@ -2600,8 +2600,8 @@ glob patterns, the pattern will be removed from the input line, and
2600replaced by the completion. 2600replaced by the completion.
2601 2601
2602@kindex M-? 2602@kindex M-?
2603If you want to see the entire list of possible completions (e.g. when it's 2603If you want to see the entire list of possible completions (e.g., when
2604below the @code{completion-cycle-threshold}), press @kbd{M-?}. 2604it's below the @code{completion-cycle-threshold}), press @kbd{M-?}.
2605 2605
2606@subsection pcomplete 2606@subsection pcomplete
2607Pcomplete, short for programmable completion, is the completion 2607Pcomplete, short for programmable completion, is the completion
diff --git a/doc/misc/flymake.texi b/doc/misc/flymake.texi
index 8782089613a..54835767928 100644
--- a/doc/misc/flymake.texi
+++ b/doc/misc/flymake.texi
@@ -582,7 +582,7 @@ function was called for the buffer. If the list is empty, this
582indicates that no changes have been recorded. If it is the first time 582indicates that no changes have been recorded. If it is the first time
583that this backend function is called for this activation of 583that this backend function is called for this activation of
584@code{flymake-mode}, then this argument isn't provided at all 584@code{flymake-mode}, then this argument isn't provided at all
585(i.e. it's not merely nil). 585(in other words, it's not merely nil).
586 586
587Each element is in the form (@var{beg} @var{end} @var{text}) where 587Each element is in the form (@var{beg} @var{end} @var{text}) where
588@var{beg} and @var{end} are buffer positions, and @var{text} is a 588@var{beg} and @var{end} are buffer positions, and @var{text} is a
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi
index 914de5320f0..c4bec5a273f 100644
--- a/doc/misc/gnus-faq.texi
+++ b/doc/misc/gnus-faq.texi
@@ -1054,7 +1054,7 @@ of the variables @code{shr-color-visible-distance-min} and
1054 messages? 1054 messages?
1055* FAQ 5-3:: How to set stuff like From, Organization, Reply-To, 1055* FAQ 5-3:: How to set stuff like From, Organization, Reply-To,
1056 signature...? 1056 signature...?
1057* FAQ 5-4:: Can I set things like From, Signature etc. group based on 1057* FAQ 5-4:: Can I set things like From, Signature etc.@: group based on
1058 the group I post too? 1058 the group I post too?
1059* FAQ 5-5:: Is there a spell-checker? Perhaps even on-the-fly 1059* FAQ 5-5:: Is there a spell-checker? Perhaps even on-the-fly
1060 spell-checking? 1060 spell-checking?
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 8a497ebb228..6ac07e89742 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -18612,7 +18612,7 @@ sending the diary message to them as well.
18612@cindex Gnus agent 18612@cindex Gnus agent
18613@cindex Gnus unplugged 18613@cindex Gnus unplugged
18614 18614
18615In olden times (ca. February '88), people used to run their newsreaders 18615In olden times (ca.@: February '88), people used to run their newsreaders
18616on big machines with permanent connections to the net. News transport 18616on big machines with permanent connections to the net. News transport
18617was dealt with by news servers, and all the newsreaders had to do was to 18617was dealt with by news servers, and all the newsreaders had to do was to
18618read news. Believe it or not. 18618read news. Believe it or not.
@@ -23349,7 +23349,7 @@ windows resized.
23349Lastly, it's possible to make Gnus window layouts ``atomic'' 23349Lastly, it's possible to make Gnus window layouts ``atomic''
23350(@pxref{Atomic Windows, , Atomic Windows, elisp, The GNU Emacs Lisp 23350(@pxref{Atomic Windows, , Atomic Windows, elisp, The GNU Emacs Lisp
23351Reference Manual}) by setting @code{gnus-use-atomic-windows} to 23351Reference Manual}) by setting @code{gnus-use-atomic-windows} to
23352@code{t}. This will ensure that pop-up buffers (e.g. help or 23352@code{t}. This will ensure that pop-up buffers (e.g., help or
23353completion buffers), will appear below or to the side of the entire 23353completion buffers), will appear below or to the side of the entire
23354Gnus window layout and not, for example, squashed between the summary 23354Gnus window layout and not, for example, squashed between the summary
23355and article buffers. 23355and article buffers.
@@ -24859,7 +24859,7 @@ particular spam group. You don't have to throw all mail into all the
24859spam tests. Another reason why this is nice is that messages to 24859spam tests. Another reason why this is nice is that messages to
24860mailing lists you have rules for don't have to have resource-intensive 24860mailing lists you have rules for don't have to have resource-intensive
24861blackhole checks performed on them. You could also specify different 24861blackhole checks performed on them. You could also specify different
24862spam checks for your nnmail split vs. your nnimap split. Go crazy. 24862spam checks for your nnmail split vs.@: your nnimap split. Go crazy.
24863 24863
24864You should set the @code{spam-use-*} variables for whatever spam back 24864You should set the @code{spam-use-*} variables for whatever spam back
24865ends you intend to use. The reason is that when loading 24865ends you intend to use. The reason is that when loading
@@ -26980,7 +26980,7 @@ appropriate name, don't you think?)
26980In any case, after spending all that energy on coming up with a new and 26980In any case, after spending all that energy on coming up with a new and
26981spunky name, we decided that the name was @emph{too} spunky, so we 26981spunky name, we decided that the name was @emph{too} spunky, so we
26982renamed it back again to ``Gnus''. But in mixed case. ``Gnus'' vs. 26982renamed it back again to ``Gnus''. But in mixed case. ``Gnus'' vs.
26983``@sc{gnus}''. New vs. old. 26983``@sc{gnus}''. New vs.@: old.
26984 26984
26985@menu 26985@menu
26986* Gnus Versions:: What Gnus versions have been released. 26986* Gnus Versions:: What Gnus versions have been released.
diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi
index 0e10e2078a4..a9a594dfcee 100644
--- a/doc/misc/idlwave.texi
+++ b/doc/misc/idlwave.texi
@@ -1333,7 +1333,7 @@ corresponding help (@pxref{Routine Info}).
1333When using completion and Emacs pops up a @file{*Completions*} buffer 1333When using completion and Emacs pops up a @file{*Completions*} buffer
1334with possible completions, clicking with @kbd{mouse-3} on a completion 1334with possible completions, clicking with @kbd{mouse-3} on a completion
1335item invokes help on that item (@pxref{Completion}). Items for which 1335item invokes help on that item (@pxref{Completion}). Items for which
1336help is available in the online system documentation (vs. just the 1336help is available in the online system documentation (vs.@: just the
1337program source itself) will be emphasized (e.g., colored blue). 1337program source itself) will be emphasized (e.g., colored blue).
1338@end itemize 1338@end itemize
1339@noindent 1339@noindent
@@ -3495,7 +3495,7 @@ Controls under what circumstances routine info is updated automatically.
3495 3495
3496@emph{Catalogs} are files containing scanned information on individual 3496@emph{Catalogs} are files containing scanned information on individual
3497routines, including arguments and keywords, calling sequence, file path, 3497routines, including arguments and keywords, calling sequence, file path,
3498class and procedure vs. function type, etc. They represent a way of 3498class and procedure vs.@: function type, etc. They represent a way of
3499extending the internal built-in information available for IDL system 3499extending the internal built-in information available for IDL system
3500routines (@pxref{Routine Info}) to other source collections. 3500routines (@pxref{Routine Info}) to other source collections.
3501 3501
diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi
index 6c700779ba7..b49166b5791 100644
--- a/doc/misc/wisent.texi
+++ b/doc/misc/wisent.texi
@@ -126,7 +126,7 @@ It uses a fast but not so space-efficient encoding for the parse
126tables, described in Corbett's PhD thesis from Berkeley: 126tables, described in Corbett's PhD thesis from Berkeley:
127@quotation 127@quotation
128@cite{Static Semantics in Compiler Error Recovery}@* 128@cite{Static Semantics in Compiler Error Recovery}@*
129June 1985, Report No. UCB/CSD 85/251. 129June 1985, Report No.@: UCB/CSD 85/251.
130@end quotation 130@end quotation
131 131
132@item 132@item