Avoid double spaces around abbrevations in Texinfo
* doc/emacs/custom.texi (Init Rebinding): * doc/emacs/dired.texi (Operating on Files): * doc/emacs/emacs.texi (Top): * doc/emacs/emerge-xtra.texi (Emerge): * doc/emacs/files.texi (Files): * doc/emacs/frames.texi (Drag and Drop): * doc/emacs/misc.texi (Hyperlinking): * doc/emacs/modes.texi (Modes): * doc/emacs/mule.texi (Input Methods): * doc/emacs/windows.texi (Window Tool Bar): * doc/lispintro/emacs-lisp-intro.texi (Lexical & Dynamic Binding Differences): * doc/lispref/elisp.texi (Top): * doc/lispref/functions.texi (Functions, Generic Functions): * doc/lispref/hash.texi (Defining Hash): * doc/lispref/keymaps.texi (Creating Keymaps): * doc/lispref/lists.texi (Property Lists): * doc/lispref/modes.texi (%-Constructs): * doc/lispref/nonascii.texi (Character Properties): * doc/lispref/processes.texi (Misc Network): * doc/lispref/searching.texi (Regexp Functions): * doc/lispref/syntax.texi (Syntax Table Internals): * doc/lispref/text.texi (Filling, Checksum/Hash) (JSONRPC deferred requests): * doc/misc/calc.texi (What is Calc, Modes Tutorial): * doc/misc/cc-mode.texi (List Line-Up, Operator Line-Up) (Custom Macros, Indenting Directives): * doc/misc/efaq.texi (Colors on a TTY, Security risks with Emacs): * doc/misc/eglot.texi (Eglot Variables): * doc/misc/erc.texi (Connecting): * doc/misc/eshell.texi (Aliases, Completion): * doc/misc/flymake.texi (Backend functions): * doc/misc/gnus-faq.texi (FAQ 5 - Composing messages): * doc/misc/gnus.texi (Gnus Unplugged, Window Layout) (Filtering Incoming Mail, History): * doc/misc/idlwave.texi (Online Help, Catalogs): * doc/misc/wisent.texi (Wisent Overview): Be more consistent with abbreviations. Use @: or comma or rewrite to avoid double spaces. Ref: https://lists.gnu.org/r/emacs-devel/2025-01/msg00909.html
This commit is contained in:
parent
bc1ab8ac3d
commit
fb282da2a0
33 changed files with 66 additions and 65 deletions
|
@ -2044,7 +2044,7 @@ sequences. For example, to bind @kbd{C-c h} to the string
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
Non-@acronym{ASCII} characters can be specified directly in the
|
Non-@acronym{ASCII} characters can be specified directly in the
|
||||||
string. To bind to e.g.@: @samp{ol@'a}, use:
|
string. To bind to, for example, @samp{ol@'a}, use:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
(keymap-global-set "C-c h" (key-description "ol@'a"))
|
(keymap-global-set "C-c h" (key-description "ol@'a"))
|
||||||
|
|
|
@ -749,7 +749,7 @@ window with a Dired buffer, or the most recently used window with
|
||||||
a Dired buffer, or to use any other function. When the value is
|
a Dired buffer, or to use any other function. When the value is
|
||||||
a function, it will be called with no arguments and is expected to
|
a function, it will be called with no arguments and is expected to
|
||||||
return a list of directories which will be used as defaults
|
return a list of directories which will be used as defaults
|
||||||
(i.e. default target and ``future history'').
|
(i.e., default target and ``future history'').
|
||||||
|
|
||||||
Here are the file-manipulating Dired commands that operate on files.
|
Here are the file-manipulating Dired commands that operate on files.
|
||||||
|
|
||||||
|
|
|
@ -462,7 +462,7 @@ File Handling
|
||||||
* Copying and Naming:: Copying, naming and renaming files.
|
* Copying and Naming:: Copying, naming and renaming files.
|
||||||
* Misc File Ops:: Other things you can do on files.
|
* Misc File Ops:: Other things you can do on files.
|
||||||
* Compressed Files:: Accessing compressed files.
|
* Compressed Files:: Accessing compressed files.
|
||||||
* File Archives:: Operating on tar, zip, jar etc. archive files.
|
* File Archives:: Operating on tar, zip, jar etc.@: archive files.
|
||||||
* Remote Files:: Accessing files on other machines.
|
* Remote Files:: Accessing files on other machines.
|
||||||
* Quoted File Names:: Quoting special characters in file names.
|
* Quoted File Names:: Quoting special characters in file names.
|
||||||
* File Name Cache:: Completion against a list of files you often use.
|
* File Name Cache:: Completion against a list of files you often use.
|
||||||
|
@ -588,7 +588,7 @@ International Character Set Support
|
||||||
|
|
||||||
Major and Minor Modes
|
Major and Minor Modes
|
||||||
|
|
||||||
* Major Modes:: Text mode vs. Lisp mode vs. C mode...
|
* Major Modes:: Text mode vs.@: Lisp mode vs.@: C mode...
|
||||||
* Minor Modes:: Each minor mode is a feature you can turn on
|
* Minor Modes:: Each minor mode is a feature you can turn on
|
||||||
independently of any others.
|
independently of any others.
|
||||||
* Choosing Modes:: How modes are chosen when visiting files.
|
* Choosing Modes:: How modes are chosen when visiting files.
|
||||||
|
@ -909,7 +909,7 @@ Tags Tables
|
||||||
Merging Files with Emerge
|
Merging Files with Emerge
|
||||||
|
|
||||||
* Overview of Emerge:: How to start Emerge. Basic concepts.
|
* Overview of Emerge:: How to start Emerge. Basic concepts.
|
||||||
* Submodes of Emerge:: Fast mode vs. Edit mode.
|
* Submodes of Emerge:: Fast mode vs.@: Edit mode.
|
||||||
Skip Prefers mode and Auto Advance mode.
|
Skip Prefers mode and Auto Advance mode.
|
||||||
* State of Difference:: You do the merge by specifying state A or B
|
* State of Difference:: You do the merge by specifying state A or B
|
||||||
for each difference.
|
for each difference.
|
||||||
|
@ -1121,7 +1121,7 @@ Hyperlinking and Navigation Features
|
||||||
* Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers.
|
* Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers.
|
||||||
* Browse-URL:: Following URLs.
|
* Browse-URL:: Following URLs.
|
||||||
* Goto Address mode:: Activating URLs.
|
* Goto Address mode:: Activating URLs.
|
||||||
* FFAP:: Finding files etc. at point.
|
* FFAP:: Finding files etc.@: at point.
|
||||||
|
|
||||||
Emacs Lisp Packages
|
Emacs Lisp Packages
|
||||||
|
|
||||||
|
|
|
@ -23,7 +23,7 @@ and @ref{Top,, Ediff, ediff, The Ediff Manual}.
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* Overview of Emerge:: How to start Emerge. Basic concepts.
|
* Overview of Emerge:: How to start Emerge. Basic concepts.
|
||||||
* Submodes of Emerge:: Fast mode vs. Edit mode.
|
* Submodes of Emerge:: Fast mode vs.@: Edit mode.
|
||||||
Skip Prefers mode and Auto Advance mode.
|
Skip Prefers mode and Auto Advance mode.
|
||||||
* State of Difference:: You do the merge by specifying state A or B
|
* State of Difference:: You do the merge by specifying state A or B
|
||||||
for each difference.
|
for each difference.
|
||||||
|
|
|
@ -34,7 +34,7 @@ on file directories.
|
||||||
* Copying and Naming:: Copying, naming and renaming files.
|
* Copying and Naming:: Copying, naming and renaming files.
|
||||||
* Misc File Ops:: Other things you can do on files.
|
* Misc File Ops:: Other things you can do on files.
|
||||||
* Compressed Files:: Accessing compressed files.
|
* Compressed Files:: Accessing compressed files.
|
||||||
* File Archives:: Operating on tar, zip, jar etc. archive files.
|
* File Archives:: Operating on tar, zip, jar etc.@: archive files.
|
||||||
* Remote Files:: Accessing files on other machines.
|
* Remote Files:: Accessing files on other machines.
|
||||||
* Quoted File Names:: Quoting special characters in file names.
|
* Quoted File Names:: Quoting special characters in file names.
|
||||||
* File Name Cache:: Completion against a list of files you often use.
|
* File Name Cache:: Completion against a list of files you often use.
|
||||||
|
|
|
@ -1233,7 +1233,7 @@ or bottom of the window during drag.
|
||||||
Emacs can also optionally drag the region with the mouse into
|
Emacs can also optionally drag the region with the mouse into
|
||||||
another portion of this or another buffer. To enable that, customize
|
another portion of this or another buffer. To enable that, customize
|
||||||
the variable @code{mouse-drag-and-drop-region} to a non-@code{nil}
|
the variable @code{mouse-drag-and-drop-region} to a non-@code{nil}
|
||||||
value. Normally, the text is moved, i.e. cut and pasted, when the
|
value. Normally, the text is moved, i.e.@: cut and pasted, when the
|
||||||
destination is the same buffer as the origin; dropping the region on
|
destination is the same buffer as the origin; dropping the region on
|
||||||
another buffer copies the text instead. If the value of this variable
|
another buffer copies the text instead. If the value of this variable
|
||||||
names a modifier key, such as @samp{shift}, @samp{control} or
|
names a modifier key, such as @samp{shift}, @samp{control} or
|
||||||
|
|
|
@ -2996,7 +2996,7 @@ URLs and other types of links occurring in Emacs buffer text.
|
||||||
* Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers.
|
* Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers.
|
||||||
* Browse-URL:: Following URLs.
|
* Browse-URL:: Following URLs.
|
||||||
* Goto Address mode:: Activating URLs.
|
* Goto Address mode:: Activating URLs.
|
||||||
* FFAP:: Finding files etc. at point.
|
* FFAP:: Finding files etc.@: at point.
|
||||||
@end menu
|
@end menu
|
||||||
|
|
||||||
@node EWW
|
@node EWW
|
||||||
|
|
|
@ -23,7 +23,7 @@ words as you type (@pxref{Auto Fill}). Minor modes are independent of
|
||||||
one another, and of the selected major mode.
|
one another, and of the selected major mode.
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* Major Modes:: Text mode vs. Lisp mode vs. C mode...
|
* Major Modes:: Text mode vs.@: Lisp mode vs.@: C mode...
|
||||||
* Minor Modes:: Each minor mode is a feature you can turn on
|
* Minor Modes:: Each minor mode is a feature you can turn on
|
||||||
independently of any others.
|
independently of any others.
|
||||||
* Choosing Modes:: How modes are chosen when visiting files.
|
* Choosing Modes:: How modes are chosen when visiting files.
|
||||||
|
|
|
@ -516,8 +516,9 @@ do the highlighting in the buffer showing the possible characters,
|
||||||
rather than in the echo area.
|
rather than in the echo area.
|
||||||
|
|
||||||
To enter characters according to the @dfn{p@=iny@=in} transliteration
|
To enter characters according to the @dfn{p@=iny@=in} transliteration
|
||||||
method instead, use the @code{chinese-sisheng} input method. This is
|
method instead, use the @code{chinese-sisheng} input method. This is a
|
||||||
a composition based method, where e.g. @kbd{pi1} results in @samp{p@=i}.
|
composition based method, where, for example, @kbd{pi1} results in
|
||||||
|
@samp{p@=i}.
|
||||||
|
|
||||||
In Japanese input methods, first you input a whole word using
|
In Japanese input methods, first you input a whole word using
|
||||||
phonetic spelling; then, after the word is in the buffer, Emacs
|
phonetic spelling; then, after the word is in the buffer, Emacs
|
||||||
|
|
|
@ -713,7 +713,7 @@ you customize the value of @code{tab-line-format} in Lisp to add
|
||||||
The command @code{global-window-tool-bar-mode} toggles the display of
|
The command @code{global-window-tool-bar-mode} toggles the display of
|
||||||
a tool bar at the top of each window. When enabled, multiple windows
|
a tool bar at the top of each window. When enabled, multiple windows
|
||||||
can display their own tool bar simultaneously. To conserve space, a
|
can display their own tool bar simultaneously. To conserve space, a
|
||||||
window tool bar is hidden if there are no buttons to show, i.e. if
|
window tool bar is hidden if there are no buttons to show, i.e.@: if
|
||||||
@code{tool-bar-map} is @code{nil}.
|
@code{tool-bar-map} is @code{nil}.
|
||||||
|
|
||||||
@findex window-tool-bar-mode
|
@findex window-tool-bar-mode
|
||||||
|
|
|
@ -3812,7 +3812,7 @@ the @code{let} body finishes, it takes that binding off of the stack,
|
||||||
revealing the one it had (if any) before the @code{let} expression.
|
revealing the one it had (if any) before the @code{let} expression.
|
||||||
|
|
||||||
@node Lexical vs Dynamic Binding Example
|
@node Lexical vs Dynamic Binding Example
|
||||||
@unnumberedsubsubsec Example of Lexical vs. Dynamic Binding
|
@unnumberedsubsubsec Example of Lexical vs.@: Dynamic Binding
|
||||||
In some cases, both lexical and dynamic binding behave identically.
|
In some cases, both lexical and dynamic binding behave identically.
|
||||||
However, in other cases, they can change the meaning of your program.
|
However, in other cases, they can change the meaning of your program.
|
||||||
For example, see what happens in this code under lexical binding:
|
For example, see what happens in this code under lexical binding:
|
||||||
|
|
|
@ -560,7 +560,7 @@ Multisession Variables
|
||||||
|
|
||||||
Functions
|
Functions
|
||||||
|
|
||||||
* What Is a Function:: Lisp functions vs. primitives; terminology.
|
* What Is a Function:: Lisp functions vs.@: primitives; terminology.
|
||||||
* Lambda Expressions:: How functions are expressed as Lisp objects.
|
* Lambda Expressions:: How functions are expressed as Lisp objects.
|
||||||
* Function Names:: A symbol can serve as the name of a function.
|
* Function Names:: A symbol can serve as the name of a function.
|
||||||
* Defining Functions:: Lisp expressions for defining functions.
|
* Defining Functions:: Lisp expressions for defining functions.
|
||||||
|
|
|
@ -11,7 +11,7 @@ explains what functions are, how they accept arguments, and how to
|
||||||
define them.
|
define them.
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* What Is a Function:: Lisp functions vs. primitives; terminology.
|
* What Is a Function:: Lisp functions vs.@: primitives; terminology.
|
||||||
* Lambda Expressions:: How functions are expressed as Lisp objects.
|
* Lambda Expressions:: How functions are expressed as Lisp objects.
|
||||||
* Function Names:: A symbol can serve as the name of a function.
|
* Function Names:: A symbol can serve as the name of a function.
|
||||||
* Defining Functions:: Lisp expressions for defining functions.
|
* Defining Functions:: Lisp expressions for defining functions.
|
||||||
|
@ -1378,7 +1378,7 @@ that don't require them.
|
||||||
The type specializer, @code{(@var{arg} @var{type})}, can specify one
|
The type specializer, @code{(@var{arg} @var{type})}, can specify one
|
||||||
of the @dfn{system types} in the following list. When a parent type
|
of the @dfn{system types} in the following list. When a parent type
|
||||||
is specified, an argument whose type is any of its more specific child
|
is specified, an argument whose type is any of its more specific child
|
||||||
types, as well as grand-children, grand-grand-children, etc. will also
|
types, as well as grand-children, grand-grand-children, etc.@: will also
|
||||||
be compatible.
|
be compatible.
|
||||||
|
|
||||||
@table @code
|
@table @code
|
||||||
|
|
|
@ -291,10 +291,10 @@ the same integer.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun sxhash-eql obj
|
@defun sxhash-eql obj
|
||||||
This function returns a hash code for Lisp object @var{obj} suitable
|
This function returns a hash code for Lisp object @var{obj} suitable for
|
||||||
for @code{eql} comparison. I.e. it reflects identity of @var{obj}
|
@code{eql} comparison. In other words, it reflects identity of
|
||||||
except for the case where the object is a bignum or a float number,
|
@var{obj} except for the case where the object is a bignum or a float
|
||||||
in which case a hash code is generated for the value.
|
number, in which case a hash code is generated for the value.
|
||||||
|
|
||||||
If two objects @var{obj1} and @var{obj2} are @code{eql}, then
|
If two objects @var{obj1} and @var{obj2} are @code{eql}, then
|
||||||
@code{(sxhash-eql @var{obj1})} and @code{(sxhash-eql @var{obj2})} are
|
@code{(sxhash-eql @var{obj1})} and @code{(sxhash-eql @var{obj2})} are
|
||||||
|
|
|
@ -459,9 +459,9 @@ Here's an example:
|
||||||
@kindex :repeat
|
@kindex :repeat
|
||||||
@kindex repeat-mode
|
@kindex repeat-mode
|
||||||
@cindex repeatable key bindings
|
@cindex repeatable key bindings
|
||||||
Each command in the keymap can be marked as `repeatable', i.e. usable
|
Each command in the keymap can be marked as `repeatable', i.e.@: usable
|
||||||
in @code{repeat-mode}, by putting a @code{repeat-map} property on it,
|
in @code{repeat-mode}, by putting a @code{repeat-map} property on it,
|
||||||
e.g.
|
for example:
|
||||||
|
|
||||||
@lisp
|
@lisp
|
||||||
(put 'undo 'repeat-map 'undo-repeat-map)
|
(put 'undo 'repeat-map 'undo-repeat-map)
|
||||||
|
|
|
@ -1980,8 +1980,8 @@ valid property list.
|
||||||
|
|
||||||
@node Plists and Alists
|
@node Plists and Alists
|
||||||
@subsection Property Lists and Association Lists
|
@subsection Property Lists and Association Lists
|
||||||
@cindex plist vs. alist
|
@cindex plist vs.@: alist
|
||||||
@cindex alist vs. plist
|
@cindex alist vs.@: plist
|
||||||
|
|
||||||
@cindex property lists vs association lists
|
@cindex property lists vs association lists
|
||||||
Association lists (@pxref{Association Lists}) are very similar to
|
Association lists (@pxref{Association Lists}) are very similar to
|
||||||
|
|
|
@ -2608,7 +2608,7 @@ The value of @code{global-mode-string} (which is part of
|
||||||
|
|
||||||
@item %o
|
@item %o
|
||||||
The degree of @dfn{travel} of the window through (the visible portion
|
The degree of @dfn{travel} of the window through (the visible portion
|
||||||
of) the buffer, i.e. the size of the text above the top of the window
|
of) the buffer, i.e.@: the size of the text above the top of the window
|
||||||
expressed as a percentage of all the text outside the window, or
|
expressed as a percentage of all the text outside the window, or
|
||||||
@samp{Top}, @samp{Bottom} or @samp{All}.
|
@samp{Top}, @samp{Bottom} or @samp{All}.
|
||||||
|
|
||||||
|
|
|
@ -644,7 +644,7 @@ be consulted instead.
|
||||||
Corresponds to Unicode language- and context-independent special
|
Corresponds to Unicode language- and context-independent special
|
||||||
lower-casing rules. The value of this property is a string (which may
|
lower-casing rules. The value of this property is a string (which may
|
||||||
be empty). For example for U+0130 @sc{latin capital letter i
|
be empty). For example for U+0130 @sc{latin capital letter i
|
||||||
with dot above} the value is @code{"i\u0307"} (i.e. a 2-character string
|
with dot above} the value is @code{"i\u0307"} (i.e., a 2-character string
|
||||||
consisting of @sc{latin small letter i} followed by U+0307
|
consisting of @sc{latin small letter i} followed by U+0307
|
||||||
@sc{combining dot above}). This mapping overrides the @code{lowercase}
|
@sc{combining dot above}). This mapping overrides the @code{lowercase}
|
||||||
property, and thus the current case table. For characters with no
|
property, and thus the current case table. For characters with no
|
||||||
|
@ -741,7 +741,7 @@ belongs, according to the Unicode Standard classification of the
|
||||||
Unicode code space into script-specific blocks. This char-table has a
|
Unicode code space into script-specific blocks. This char-table has a
|
||||||
single extra slot whose value is the list of all script symbols. Note
|
single extra slot whose value is the list of all script symbols. Note
|
||||||
that Emacs's classification of characters into scripts is not a 1-for-1
|
that Emacs's classification of characters into scripts is not a 1-for-1
|
||||||
reflection of the Unicode standard, e.g. there is no @samp{symbol}
|
reflection of the Unicode standard, for example there is no @samp{symbol}
|
||||||
script in Unicode.
|
script in Unicode.
|
||||||
@end defvar
|
@end defvar
|
||||||
|
|
||||||
|
|
|
@ -3159,7 +3159,7 @@ machine you are using. The value is an alist whose elements have the
|
||||||
form @code{(@var{ifname} . @var{address})}. @var{ifname} is a string
|
form @code{(@var{ifname} . @var{address})}. @var{ifname} is a string
|
||||||
naming the interface, @var{address} has the same form as the
|
naming the interface, @var{address} has the same form as the
|
||||||
@var{local-address} and @var{remote-address} arguments to
|
@var{local-address} and @var{remote-address} arguments to
|
||||||
@code{make-network-process}, i.e. a vector of integers. By default
|
@code{make-network-process}, i.e.@: a vector of integers. By default
|
||||||
both IPv4 and IPv6 addresses are returned if possible.
|
both IPv4 and IPv6 addresses are returned if possible.
|
||||||
|
|
||||||
Optional argument @var{full} non-@code{nil} means to instead return a
|
Optional argument @var{full} non-@code{nil} means to instead return a
|
||||||
|
|
|
@ -1835,7 +1835,7 @@ The optional argument @var{paren} can be any of the following:
|
||||||
@table @asis
|
@table @asis
|
||||||
@item a string
|
@item a string
|
||||||
The resulting regexp is preceded by @var{paren} and followed by
|
The resulting regexp is preceded by @var{paren} and followed by
|
||||||
@samp{\)}, e.g. use @samp{"\\(?1:"} to produce an explicitly
|
@samp{\)}. For example, use @samp{"\\(?1:"} to produce an explicitly
|
||||||
numbered group.
|
numbered group.
|
||||||
|
|
||||||
@item @code{words}
|
@item @code{words}
|
||||||
|
|
|
@ -996,7 +996,7 @@ character (similar to the second character in a syntax descriptor).
|
||||||
|
|
||||||
@cindex syntax tables (accessing elements of)
|
@cindex syntax tables (accessing elements of)
|
||||||
Use @code{aref} (@pxref{Array Functions}) to get the raw syntax
|
Use @code{aref} (@pxref{Array Functions}) to get the raw syntax
|
||||||
descriptor of a character, e.g. @w{@code{(aref (syntax-table) ch)}}.
|
descriptor of a character, for example @w{@code{(aref (syntax-table) ch)}}.
|
||||||
|
|
||||||
Here are the syntax codes corresponding to the various syntax
|
Here are the syntax codes corresponding to the various syntax
|
||||||
classes:
|
classes:
|
||||||
|
|
|
@ -1695,7 +1695,7 @@ The @code{pixel-fill-width} helper function can be used to compute the
|
||||||
pixel width to use. If given no arguments, it'll return a value
|
pixel width to use. If given no arguments, it'll return a value
|
||||||
slightly less than the width of the current window. The first
|
slightly less than the width of the current window. The first
|
||||||
optional value, @var{columns}, specifies the number of columns using
|
optional value, @var{columns}, specifies the number of columns using
|
||||||
the standard, monospaced fonts, e.g. @code{fill-column}. The second
|
the standard, monospaced fonts, for example @code{fill-column}. The second
|
||||||
optional value is the window to use. You'd typically use it like
|
optional value is the window to use. You'd typically use it like
|
||||||
this:
|
this:
|
||||||
|
|
||||||
|
@ -4970,7 +4970,7 @@ network. MD5 and SHA-1 are not collision resistant (i.e., it is
|
||||||
possible to deliberately design different pieces of data which have
|
possible to deliberately design different pieces of data which have
|
||||||
the same MD5 or SHA-1 hash), so you should not use them for anything
|
the same MD5 or SHA-1 hash), so you should not use them for anything
|
||||||
security-related. For security-related applications you should use
|
security-related. For security-related applications you should use
|
||||||
the other hash types, such as SHA-2 (e.g. @code{sha256} or
|
the other hash types, such as SHA-2 (e.g., @code{sha256} or
|
||||||
@code{sha512}).
|
@code{sha512}).
|
||||||
|
|
||||||
@defun secure-hash-algorithms
|
@defun secure-hash-algorithms
|
||||||
|
@ -6136,7 +6136,7 @@ communicating endpoints is a matter of correctly designing the RPC
|
||||||
application: when synchronization is needed, requests (which are
|
application: when synchronization is needed, requests (which are
|
||||||
blocking) should be used; when it isn't, notifications should suffice.
|
blocking) should be used; when it isn't, notifications should suffice.
|
||||||
However, when Emacs acts as one of these endpoints, asynchronous
|
However, when Emacs acts as one of these endpoints, asynchronous
|
||||||
events (e.g. timer- or process-related) may be triggered while there
|
events (e.g., timer- or process-related) may be triggered while there
|
||||||
is still uncertainty about the state of the remote endpoint.
|
is still uncertainty about the state of the remote endpoint.
|
||||||
Furthermore, acting on these events may only sometimes demand
|
Furthermore, acting on these events may only sometimes demand
|
||||||
synchronization, depending on the event's specific nature.
|
synchronization, depending on the event's specific nature.
|
||||||
|
|
|
@ -234,7 +234,7 @@ series of calculators, its many features include:
|
||||||
@itemize @bullet
|
@itemize @bullet
|
||||||
@item
|
@item
|
||||||
Choice of algebraic or Reverse Polish notation (RPN),
|
Choice of algebraic or Reverse Polish notation (RPN),
|
||||||
i.e. stack-based, entry of calculations.
|
i.e.@: stack-based, entry of calculations.
|
||||||
|
|
||||||
@item
|
@item
|
||||||
Arbitrary precision integers and floating-point numbers.
|
Arbitrary precision integers and floating-point numbers.
|
||||||
|
@ -2630,8 +2630,8 @@ elements.) Calculations involving fractions will always
|
||||||
produce exact fractional results; Fraction mode only says
|
produce exact fractional results; Fraction mode only says
|
||||||
what to do when dividing two integers.
|
what to do when dividing two integers.
|
||||||
|
|
||||||
@cindex Fractions vs. floats
|
@cindex Fractions vs.@: floats
|
||||||
@cindex Floats vs. fractions
|
@cindex Floats vs.@: fractions
|
||||||
(@bullet{}) @strong{Exercise 4.} If fractional arithmetic is exact,
|
(@bullet{}) @strong{Exercise 4.} If fractional arithmetic is exact,
|
||||||
why would you ever use floating-point numbers instead?
|
why would you ever use floating-point numbers instead?
|
||||||
@xref{Modes Answer 4, 4}. (@bullet{})
|
@xref{Modes Answer 4, 4}. (@bullet{})
|
||||||
|
|
|
@ -6047,7 +6047,7 @@ Line up the second entry of a brace block under the first, when the
|
||||||
first line is also contained in an arglist or an enclosing brace
|
first line is also contained in an arglist or an enclosing brace
|
||||||
@emph{on that line}.
|
@emph{on that line}.
|
||||||
|
|
||||||
I.e. handle something like the following:
|
In other words, handle something like the following:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
@group
|
@group
|
||||||
|
@ -6081,7 +6081,7 @@ Line up the second entry of a class (etc.) initializer
|
||||||
@code{c-basic-offset} characters in from the identifier when:
|
@code{c-basic-offset} characters in from the identifier when:
|
||||||
@enumerate
|
@enumerate
|
||||||
@item
|
@item
|
||||||
The type is a class, struct, union, etc. (but not an enum);
|
The type is a class, struct, union, etc.@: (but not an enum);
|
||||||
@item
|
@item
|
||||||
There is a brace block in the type declaration, specifying it; and
|
There is a brace block in the type declaration, specifying it; and
|
||||||
@item
|
@item
|
||||||
|
@ -6089,7 +6089,7 @@ The first element of the initializer is on the same line as its
|
||||||
opening brace.
|
opening brace.
|
||||||
@end enumerate
|
@end enumerate
|
||||||
|
|
||||||
I.e. we have a construct like this:
|
In other words, we have a construct like this:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
@group
|
@group
|
||||||
|
@ -6123,7 +6123,7 @@ Line up the second entry of a class (etc.) initializer after its
|
||||||
opening brace when:
|
opening brace when:
|
||||||
@enumerate
|
@enumerate
|
||||||
@item
|
@item
|
||||||
The type is a class, struct, union, etc. (but not an enum);
|
The type is a class, struct, union, etc.@: (but not an enum);
|
||||||
@item
|
@item
|
||||||
There is a brace block in the type declaration, specifying it; and
|
There is a brace block in the type declaration, specifying it; and
|
||||||
@item
|
@item
|
||||||
|
@ -6131,7 +6131,7 @@ The first element of the initializer is on the same line as its
|
||||||
opening brace.
|
opening brace.
|
||||||
@end enumerate
|
@end enumerate
|
||||||
|
|
||||||
I.e. we have a construct like this:
|
In other words, we have a construct like this:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
@group
|
@group
|
||||||
|
@ -6445,7 +6445,7 @@ function is the same as specifying a list @code{(c-lineup-assignments
|
||||||
@defun c-lineup-ternary-bodies
|
@defun c-lineup-ternary-bodies
|
||||||
@findex lineup-ternary-bodies @r{(c-)}
|
@findex lineup-ternary-bodies @r{(c-)}
|
||||||
Line up true and false branches of a ternary operator
|
Line up true and false branches of a ternary operator
|
||||||
(i.e. @code{?:}). More precisely, if the line starts with a colon
|
(i.e., @code{?:}). More precisely, if the line starts with a colon
|
||||||
which is a part of a said operator, align it with corresponding
|
which is a part of a said operator, align it with corresponding
|
||||||
question mark. For example:
|
question mark. For example:
|
||||||
|
|
||||||
|
@ -7018,7 +7018,7 @@ is @code{nil}, all lines inside macro definitions are analyzed as
|
||||||
@end defopt
|
@end defopt
|
||||||
|
|
||||||
Sometimes you may want to indent particular directives
|
Sometimes you may want to indent particular directives
|
||||||
(e.g. @code{#pragma}) as though they were statements. To do this, see
|
(e.g., @code{#pragma}) as though they were statements. To do this, see
|
||||||
@ref{Indenting Directives}.
|
@ref{Indenting Directives}.
|
||||||
|
|
||||||
Because a macro can expand into anything at all, near where one is
|
Because a macro can expand into anything at all, near where one is
|
||||||
|
@ -7210,7 +7210,7 @@ after the mode hooks have run.
|
||||||
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||||
|
|
||||||
Sometimes you may want to indent particular preprocessor directives
|
Sometimes you may want to indent particular preprocessor directives
|
||||||
(e.g. @code{#pragma}) as though they were statements. To do this,
|
(e.g., @code{#pragma}) as though they were statements. To do this,
|
||||||
first set up @code{c-cpp-indent-to-body-directives} to include the
|
first set up @code{c-cpp-indent-to-body-directives} to include the
|
||||||
directive name(s), then enable the ``indent to body'' feature with
|
directive name(s), then enable the ``indent to body'' feature with
|
||||||
@code{c-toggle-cpp-indent-to-body}.
|
@code{c-toggle-cpp-indent-to-body}.
|
||||||
|
|
|
@ -1889,8 +1889,8 @@ capabilities.
|
||||||
|
|
||||||
If by contrast you wish to @emph{disable} tty color support, either
|
If by contrast you wish to @emph{disable} tty color support, either
|
||||||
start emacs with the @samp{--color=no} command-line option, or ensure
|
start emacs with the @samp{--color=no} command-line option, or ensure
|
||||||
that the frame parameter @code{tty-color-mode} is @code{no}, e.g. by
|
that the frame parameter @code{tty-color-mode} is @code{no}, for example
|
||||||
putting the following in your init file:
|
by putting the following in your init file:
|
||||||
|
|
||||||
@lisp
|
@lisp
|
||||||
(push '(tty-color-mode . no) default-frame-alist)
|
(push '(tty-color-mode . no) default-frame-alist)
|
||||||
|
@ -3687,9 +3687,9 @@ You can tell Emacs the shell's current directory with the command
|
||||||
@item
|
@item
|
||||||
Third party packages.
|
Third party packages.
|
||||||
|
|
||||||
Any package you install into Emacs can run arbitrary code with the
|
Any package you install into Emacs can run arbitrary code with the same
|
||||||
same privileges as the Emacs process itself. Be aware of this when
|
privileges as the Emacs process itself. Be aware of this when you use
|
||||||
you use the package system (e.g. @code{M-x list-packages}) with third
|
the package system (for example, @code{M-x list-packages}) with third
|
||||||
party archives. Use only third parties that you can trust!
|
party archives. Use only third parties that you can trust!
|
||||||
|
|
||||||
@item
|
@item
|
||||||
|
|
|
@ -872,7 +872,7 @@ If this is non-@code{nil}, and @kbd{M-.}
|
||||||
(@code{xref-find-definitions}) lands you in a file outside of your
|
(@code{xref-find-definitions}) lands you in a file outside of your
|
||||||
project, such as a system-installed library or header file,
|
project, such as a system-installed library or header file,
|
||||||
transiently consider that file as managed by the same language server.
|
transiently consider that file as managed by the same language server.
|
||||||
That file is still outside your project (i.e. @code{project-find-file}
|
That file is still outside your project (i.e., @code{project-find-file}
|
||||||
won't find it), but Eglot and the server will consider it to be part
|
won't find it), but Eglot and the server will consider it to be part
|
||||||
of the workspace. The default is @code{nil}.
|
of the workspace. The default is @code{nil}.
|
||||||
|
|
||||||
|
|
|
@ -851,7 +851,7 @@ Examples of use:
|
||||||
|
|
||||||
In the case of @code{:client-certificate t}, you will need to add a
|
In the case of @code{:client-certificate t}, you will need to add a
|
||||||
line like the following to your authinfo file
|
line like the following to your authinfo file
|
||||||
(e.g. @file{~/.authinfo.gpg}):
|
(for example, @file{~/.authinfo.gpg}):
|
||||||
|
|
||||||
@example
|
@example
|
||||||
machine irc.libera.chat key /home/bandali/my-cert.key cert /home/bandali/my-cert.crt
|
machine irc.libera.chat key /home/bandali/my-cert.key cert /home/bandali/my-cert.crt
|
||||||
|
|
|
@ -1593,7 +1593,7 @@ edited aliases.
|
||||||
|
|
||||||
Note that unlike aliases in Bash, arguments must be handled
|
Note that unlike aliases in Bash, arguments must be handled
|
||||||
explicitly. Within aliases, you can use the special variables
|
explicitly. Within aliases, you can use the special variables
|
||||||
@samp{$*}, @samp{$0}, @samp{$1}, @samp{$2}, etc. to refer to the
|
@samp{$*}, @samp{$0}, @samp{$1}, @samp{$2}, etc.@: to refer to the
|
||||||
arguments passed to the alias.
|
arguments passed to the alias.
|
||||||
|
|
||||||
@table @code
|
@table @code
|
||||||
|
@ -2536,8 +2536,8 @@ glob patterns, the pattern will be removed from the input line, and
|
||||||
replaced by the completion.
|
replaced by the completion.
|
||||||
|
|
||||||
@kindex M-?
|
@kindex M-?
|
||||||
If you want to see the entire list of possible completions (e.g. when it's
|
If you want to see the entire list of possible completions (e.g., when
|
||||||
below the @code{completion-cycle-threshold}), press @kbd{M-?}.
|
it's below the @code{completion-cycle-threshold}), press @kbd{M-?}.
|
||||||
|
|
||||||
@subsection pcomplete
|
@subsection pcomplete
|
||||||
Pcomplete, short for programmable completion, is the completion
|
Pcomplete, short for programmable completion, is the completion
|
||||||
|
|
|
@ -582,7 +582,7 @@ function was called for the buffer. If the list is empty, this
|
||||||
indicates that no changes have been recorded. If it is the first time
|
indicates that no changes have been recorded. If it is the first time
|
||||||
that this backend function is called for this activation of
|
that this backend function is called for this activation of
|
||||||
@code{flymake-mode}, then this argument isn't provided at all
|
@code{flymake-mode}, then this argument isn't provided at all
|
||||||
(i.e. it's not merely nil).
|
(in other words, it's not merely nil).
|
||||||
|
|
||||||
Each element is in the form (@var{beg} @var{end} @var{text}) where
|
Each element is in the form (@var{beg} @var{end} @var{text}) where
|
||||||
@var{beg} and @var{end} are buffer positions, and @var{text} is a
|
@var{beg} and @var{end} are buffer positions, and @var{text} is a
|
||||||
|
|
|
@ -1054,7 +1054,7 @@ of the variables @code{shr-color-visible-distance-min} and
|
||||||
messages?
|
messages?
|
||||||
* FAQ 5-3:: How to set stuff like From, Organization, Reply-To,
|
* FAQ 5-3:: How to set stuff like From, Organization, Reply-To,
|
||||||
signature...?
|
signature...?
|
||||||
* FAQ 5-4:: Can I set things like From, Signature etc. group based on
|
* FAQ 5-4:: Can I set things like From, Signature etc.@: group based on
|
||||||
the group I post too?
|
the group I post too?
|
||||||
* FAQ 5-5:: Is there a spell-checker? Perhaps even on-the-fly
|
* FAQ 5-5:: Is there a spell-checker? Perhaps even on-the-fly
|
||||||
spell-checking?
|
spell-checking?
|
||||||
|
|
|
@ -18611,7 +18611,7 @@ sending the diary message to them as well.
|
||||||
@cindex Gnus agent
|
@cindex Gnus agent
|
||||||
@cindex Gnus unplugged
|
@cindex Gnus unplugged
|
||||||
|
|
||||||
In olden times (ca. February '88), people used to run their newsreaders
|
In olden times (ca.@: February '88), people used to run their newsreaders
|
||||||
on big machines with permanent connections to the net. News transport
|
on big machines with permanent connections to the net. News transport
|
||||||
was dealt with by news servers, and all the newsreaders had to do was to
|
was dealt with by news servers, and all the newsreaders had to do was to
|
||||||
read news. Believe it or not.
|
read news. Believe it or not.
|
||||||
|
@ -23348,7 +23348,7 @@ windows resized.
|
||||||
Lastly, it's possible to make Gnus window layouts ``atomic''
|
Lastly, it's possible to make Gnus window layouts ``atomic''
|
||||||
(@pxref{Atomic Windows, , Atomic Windows, elisp, The GNU Emacs Lisp
|
(@pxref{Atomic Windows, , Atomic Windows, elisp, The GNU Emacs Lisp
|
||||||
Reference Manual}) by setting @code{gnus-use-atomic-windows} to
|
Reference Manual}) by setting @code{gnus-use-atomic-windows} to
|
||||||
@code{t}. This will ensure that pop-up buffers (e.g. help or
|
@code{t}. This will ensure that pop-up buffers (e.g., help or
|
||||||
completion buffers), will appear below or to the side of the entire
|
completion buffers), will appear below or to the side of the entire
|
||||||
Gnus window layout and not, for example, squashed between the summary
|
Gnus window layout and not, for example, squashed between the summary
|
||||||
and article buffers.
|
and article buffers.
|
||||||
|
@ -24858,7 +24858,7 @@ particular spam group. You don't have to throw all mail into all the
|
||||||
spam tests. Another reason why this is nice is that messages to
|
spam tests. Another reason why this is nice is that messages to
|
||||||
mailing lists you have rules for don't have to have resource-intensive
|
mailing lists you have rules for don't have to have resource-intensive
|
||||||
blackhole checks performed on them. You could also specify different
|
blackhole checks performed on them. You could also specify different
|
||||||
spam checks for your nnmail split vs. your nnimap split. Go crazy.
|
spam checks for your nnmail split vs.@: your nnimap split. Go crazy.
|
||||||
|
|
||||||
You should set the @code{spam-use-*} variables for whatever spam back
|
You should set the @code{spam-use-*} variables for whatever spam back
|
||||||
ends you intend to use. The reason is that when loading
|
ends you intend to use. The reason is that when loading
|
||||||
|
@ -26979,7 +26979,7 @@ appropriate name, don't you think?)
|
||||||
In any case, after spending all that energy on coming up with a new and
|
In any case, after spending all that energy on coming up with a new and
|
||||||
spunky name, we decided that the name was @emph{too} spunky, so we
|
spunky name, we decided that the name was @emph{too} spunky, so we
|
||||||
renamed it back again to ``Gnus''. But in mixed case. ``Gnus'' vs.
|
renamed it back again to ``Gnus''. But in mixed case. ``Gnus'' vs.
|
||||||
``@sc{gnus}''. New vs. old.
|
``@sc{gnus}''. New vs.@: old.
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* Gnus Versions:: What Gnus versions have been released.
|
* Gnus Versions:: What Gnus versions have been released.
|
||||||
|
|
|
@ -1333,7 +1333,7 @@ corresponding help (@pxref{Routine Info}).
|
||||||
When using completion and Emacs pops up a @file{*Completions*} buffer
|
When using completion and Emacs pops up a @file{*Completions*} buffer
|
||||||
with possible completions, clicking with @kbd{mouse-3} on a completion
|
with possible completions, clicking with @kbd{mouse-3} on a completion
|
||||||
item invokes help on that item (@pxref{Completion}). Items for which
|
item invokes help on that item (@pxref{Completion}). Items for which
|
||||||
help is available in the online system documentation (vs. just the
|
help is available in the online system documentation (vs.@: just the
|
||||||
program source itself) will be emphasized (e.g., colored blue).
|
program source itself) will be emphasized (e.g., colored blue).
|
||||||
@end itemize
|
@end itemize
|
||||||
@noindent
|
@noindent
|
||||||
|
@ -3495,7 +3495,7 @@ Controls under what circumstances routine info is updated automatically.
|
||||||
|
|
||||||
@emph{Catalogs} are files containing scanned information on individual
|
@emph{Catalogs} are files containing scanned information on individual
|
||||||
routines, including arguments and keywords, calling sequence, file path,
|
routines, including arguments and keywords, calling sequence, file path,
|
||||||
class and procedure vs. function type, etc. They represent a way of
|
class and procedure vs.@: function type, etc. They represent a way of
|
||||||
extending the internal built-in information available for IDL system
|
extending the internal built-in information available for IDL system
|
||||||
routines (@pxref{Routine Info}) to other source collections.
|
routines (@pxref{Routine Info}) to other source collections.
|
||||||
|
|
||||||
|
|
|
@ -126,7 +126,7 @@ It uses a fast but not so space-efficient encoding for the parse
|
||||||
tables, described in Corbett's PhD thesis from Berkeley:
|
tables, described in Corbett's PhD thesis from Berkeley:
|
||||||
@quotation
|
@quotation
|
||||||
@cite{Static Semantics in Compiler Error Recovery}@*
|
@cite{Static Semantics in Compiler Error Recovery}@*
|
||||||
June 1985, Report No. UCB/CSD 85/251.
|
June 1985, Report No.@: UCB/CSD 85/251.
|
||||||
@end quotation
|
@end quotation
|
||||||
|
|
||||||
@item
|
@item
|
||||||
|
|
Loading…
Add table
Reference in a new issue