aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/glossary.texi4
-rw-r--r--doc/emacs/misc.texi96
-rw-r--r--doc/emacs/msdos.texi6
-rw-r--r--doc/lispintro/emacs-lisp-intro.texi45
-rw-r--r--doc/lispref/debugging.texi44
-rw-r--r--doc/lispref/display.texi6
-rw-r--r--doc/lispref/functions.texi8
-rw-r--r--doc/lispref/loading.texi2
-rw-r--r--doc/lispref/objects.texi3
-rw-r--r--doc/lispref/os.texi10
-rw-r--r--doc/lispref/processes.texi1
-rw-r--r--doc/misc/auth.texi10
-rw-r--r--doc/misc/calc.texi2
-rw-r--r--doc/misc/efaq-w32.texi6
-rw-r--r--doc/misc/efaq.texi28
-rw-r--r--doc/misc/emacs-mime.texi6
-rw-r--r--doc/misc/eshell.texi82
-rw-r--r--doc/misc/gnus-faq.texi217
-rw-r--r--doc/misc/gnus.texi102
-rw-r--r--doc/misc/htmlfontify.texi10
-rw-r--r--doc/misc/idlwave.texi11
-rw-r--r--doc/misc/message.texi11
-rw-r--r--doc/misc/mh-e.texi13
-rw-r--r--doc/misc/tramp.texi4
-rw-r--r--doc/misc/viper.texi4
25 files changed, 212 insertions, 519 deletions
diff --git a/doc/emacs/glossary.texi b/doc/emacs/glossary.texi
index 5224e313407..9a537019974 100644
--- a/doc/emacs/glossary.texi
+++ b/doc/emacs/glossary.texi
@@ -1457,8 +1457,8 @@ level by aborting (q.v.@:) and quitting (q.v.). @xref{Quitting}.
1457@item Transient Mark Mode 1457@item Transient Mark Mode
1458The default behavior of the mark (q.v.@:) and region (q.v.), in which 1458The default behavior of the mark (q.v.@:) and region (q.v.), in which
1459setting the mark activates it and highlights the region, is called 1459setting the mark activates it and highlights the region, is called
1460Transient Mark mode. In GNU Emacs 23 and onwards, it is enabled by 1460Transient Mark mode. It is enabled by default. @xref{Disabled
1461default. @xref{Disabled Transient Mark}. 1461Transient Mark}.
1462 1462
1463@item Transposition 1463@item Transposition
1464Transposing two units of text means putting each one into the place 1464Transposing two units of text means putting each one into the place
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index 841a285520a..da1b87b48bd 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -1,6 +1,5 @@
1@c This is part of the Emacs manual. 1@c This is part of the Emacs manual.
2@c Copyright (C) 1985--1987, 1993--1995, 1997, 2000--2022 Free Software 2@c Copyright (C) 1985--2022 Free Software Foundation, Inc.
3@c Foundation, Inc.
4@c See file emacs.texi for copying conditions. 3@c See file emacs.texi for copying conditions.
5@iftex 4@iftex
6@chapter Miscellaneous Commands 5@chapter Miscellaneous Commands
@@ -2870,99 +2869,6 @@ new major mode which provides a command to switch back. These
2870approaches give you more flexibility to go back to unfinished tasks in 2869approaches give you more flexibility to go back to unfinished tasks in
2871the order you choose. 2870the order you choose.
2872 2871
2873@ignore
2874@c Apart from edt and viper, this is all obsolete.
2875@c (Can't believe we were saying "most other editors" into 2014!)
2876@c There seems no point having a node just for those, which both have
2877@c their own manuals.
2878@node Emulation
2879@section Emulation
2880@cindex emulating other editors
2881@cindex other editors
2882@cindex EDT
2883@cindex vi
2884@cindex WordStar
2885
2886 GNU Emacs can be programmed to emulate (more or less) most other
2887editors. Standard facilities can emulate these:
2888
2889@table @asis
2890@item CRiSP/Brief (PC editor)
2891@findex crisp-mode
2892@vindex crisp-override-meta-x
2893@findex scroll-all-mode
2894@cindex CRiSP mode
2895@cindex Brief emulation
2896@cindex emulation of Brief
2897@cindex mode, CRiSP
2898@kbd{M-x crisp-mode} enables key bindings to emulate the CRiSP/Brief
2899editor. Note that this rebinds @kbd{M-x} to exit Emacs unless you set
2900the variable @code{crisp-override-meta-x}. You can also use the
2901command @kbd{M-x scroll-all-mode} or set the variable
2902@code{crisp-load-scroll-all} to emulate CRiSP's scroll-all feature
2903(scrolling all windows together).
2904
2905@item EDT (DEC VMS editor)
2906@findex edt-emulation-on
2907@findex edt-emulation-off
2908Turn on EDT emulation with @kbd{M-x edt-emulation-on}; restore normal
2909command bindings with @kbd{M-x edt-emulation-off}.
2910
2911Most of the EDT emulation commands are keypad keys, and most standard
2912Emacs key bindings are still available. The EDT emulation rebindings
2913are done in the global keymap, so there is no problem switching
2914buffers or major modes while in EDT emulation.
2915
2916@item TPU (DEC VMS editor)
2917@findex tpu-edt-on
2918@cindex TPU
2919@kbd{M-x tpu-edt-on} turns on emulation of the TPU editor emulating EDT.
2920
2921@item vi (Berkeley editor)
2922@findex viper-mode
2923Viper is an emulator for vi. It implements several levels of
2924emulation; level 1 is closest to vi itself, while level 5 departs
2925somewhat from strict emulation to take advantage of the capabilities of
2926Emacs. To invoke Viper, type @kbd{M-x viper-mode}; it will guide you
2927the rest of the way and ask for the emulation level. @inforef{Top,
2928Viper, viper}.
2929
2930@item vi (another emulator)
2931@findex vi-mode
2932@kbd{M-x vi-mode} enters a major mode that replaces the previously
2933established major mode. All of the vi commands that, in real vi, enter
2934input mode are programmed instead to return to the previous major
2935mode. Thus, ordinary Emacs serves as vi's input mode.
2936
2937Because vi emulation works through major modes, it does not work
2938to switch buffers during emulation. Return to normal Emacs first.
2939
2940If you plan to use vi emulation much, you probably want to bind a key
2941to the @code{vi-mode} command.
2942
2943@item vi (alternate emulator)
2944@findex vip-mode
2945@kbd{M-x vip-mode} invokes another vi emulator, said to resemble real vi
2946more thoroughly than @kbd{M-x vi-mode}. Input mode in this emulator
2947is changed from ordinary Emacs so you can use @key{ESC} to go back to
2948emulated vi command mode. To get from emulated vi command mode back to
2949ordinary Emacs, type @kbd{C-z}.
2950
2951This emulation does not work through major modes, and it is possible
2952to switch buffers in various ways within the emulator. It is not
2953so necessary to assign a key to the command @code{vip-mode} as
2954it is with @code{vi-mode} because terminating insert mode does
2955not use it.
2956
2957@inforef{Top, VIP, vip}, for full information.
2958
2959@item WordStar (old wordprocessor)
2960@findex wordstar-mode
2961@kbd{M-x wordstar-mode} provides a major mode with WordStar-like
2962key bindings.
2963@end table
2964@end ignore
2965
2966 2872
2967@node Hyperlinking 2873@node Hyperlinking
2968@section Hyperlinking and Web Navigation Features 2874@section Hyperlinking and Web Navigation Features
diff --git a/doc/emacs/msdos.texi b/doc/emacs/msdos.texi
index e30d623a77c..dd0787cd38d 100644
--- a/doc/emacs/msdos.texi
+++ b/doc/emacs/msdos.texi
@@ -986,9 +986,9 @@ printer, put this in your @file{.emacs} file:
986@section Specifying Fonts on MS-Windows 986@section Specifying Fonts on MS-Windows
987@cindex font specification (MS Windows) 987@cindex font specification (MS Windows)
988 988
989 Starting with Emacs 23, fonts are specified by their name, size 989 Fonts are specified by their name, size and optional properties.
990and optional properties. The format for specifying fonts comes from the 990The format for specifying fonts comes from the fontconfig library used
991fontconfig library used in modern Free desktops: 991in modern Free desktops:
992 992
993@example 993@example
994 [Family[-PointSize]][:Option1=Value1[:Option2=Value2[...]]] 994 [Family[-PointSize]][:Option1=Value1[:Option2=Value2[...]]]
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi
index 049c8a65a8f..47a5a870fde 100644
--- a/doc/lispintro/emacs-lisp-intro.texi
+++ b/doc/lispintro/emacs-lisp-intro.texi
@@ -2020,7 +2020,6 @@ the arguments to the function @code{concat} are the strings
2020@w{@code{"The "}} and @w{@code{" red foxes."}} and the list 2020@w{@code{"The "}} and @w{@code{" red foxes."}} and the list
2021@code{(number-to-string (+ 2 fill-column))}. 2021@code{(number-to-string (+ 2 fill-column))}.
2022 2022
2023@c For GNU Emacs 22, need number-to-string
2024@smallexample 2023@smallexample
2025(concat "The " (number-to-string (+ 2 fill-column)) " red foxes.") 2024(concat "The " (number-to-string (+ 2 fill-column)) " red foxes.")
2026@end smallexample 2025@end smallexample
@@ -10297,9 +10296,8 @@ loop with a list.
10297 10296
10298@cindex @file{*scratch*} buffer 10297@cindex @file{*scratch*} buffer
10299The function requires several lines for its output. If you are 10298The function requires several lines for its output. If you are
10300reading this in a recent instance of GNU Emacs, 10299reading this in a recent instance of GNU Emacs, you can evaluate the
10301@c GNU Emacs 21, GNU Emacs 22, or a later version, 10300following expression inside of Info, as usual.
10302you can evaluate the following expression inside of Info, as usual.
10303 10301
10304If you are using an earlier version of Emacs, you need to copy the 10302If you are using an earlier version of Emacs, you need to copy the
10305necessary expressions to your @file{*scratch*} buffer and evaluate 10303necessary expressions to your @file{*scratch*} buffer and evaluate
@@ -15134,16 +15132,16 @@ Emacs may produce different results.)
15134@end group 15132@end group
15135 15133
15136@group 15134@group
15137(lengths-list-file "./lisp/makesum.el") 15135(lengths-list-file "./lisp/hex-util.el")
15138 @result{} (85 181) 15136 @result{} (82 71)
15139@end group 15137@end group
15140 15138
15141@group 15139@group
15142 (recursive-lengths-list-many-files 15140 (recursive-lengths-list-many-files
15143 '("./lisp/macros.el" 15141 '("./lisp/macros.el"
15144 "./lisp/mail/mailalias.el" 15142 "./lisp/mail/mailalias.el"
15145 "./lisp/makesum.el")) 15143 "./lisp/hex-util.el"))
15146 @result{} (283 263 480 90 38 32 29 95 178 180 321 218 324 85 181) 15144 @result{} (283 263 480 90 38 32 29 95 178 180 321 218 324 82 71)
15147@end group 15145@end group
15148@end smallexample 15146@end smallexample
15149 15147
@@ -15235,27 +15233,13 @@ Sorting the list returned by the
15235@code{recursive-lengths-list-many-files} function is straightforward; 15233@code{recursive-lengths-list-many-files} function is straightforward;
15236it uses the @code{<} function: 15234it uses the @code{<} function:
15237 15235
15238@ignore
152392006 Oct 29
15240In GNU Emacs 22, eval
15241(progn
15242 (cd "/usr/local/share/emacs/22.0.50/")
15243 (sort
15244 (recursive-lengths-list-many-files
15245 '("./lisp/macros.el"
15246 "./lisp/mail/mailalias.el"
15247 "./lisp/makesum.el"))
15248 '<))
15249
15250@end ignore
15251
15252@smallexample 15236@smallexample
15253@group 15237@group
15254(sort 15238(sort
15255 (recursive-lengths-list-many-files 15239 (recursive-lengths-list-many-files
15256 '("./lisp/macros.el" 15240 '("./lisp/macros.el"
15257 "./lisp/mailalias.el" 15241 "./lisp/mailalias.el"
15258 "./lisp/makesum.el")) 15242 "./lisp/hex-util.el"))
15259 '<) 15243 '<)
15260@end group 15244@end group
15261@end smallexample 15245@end smallexample
@@ -15265,7 +15249,7 @@ In GNU Emacs 22, eval
15265which produces: 15249which produces:
15266 15250
15267@smallexample 15251@smallexample
15268(29 32 38 85 90 95 178 180 181 218 263 283 321 324 480) 15252(29 32 38 71 82 90 95 178 180 218 263 283 321 324 480)
15269@end smallexample 15253@end smallexample
15270 15254
15271@noindent 15255@noindent
@@ -15313,7 +15297,7 @@ as a list that looks like this (but with more elements):
15313@group 15297@group
15314("./lisp/macros.el" 15298("./lisp/macros.el"
15315 "./lisp/mail/rmail.el" 15299 "./lisp/mail/rmail.el"
15316 "./lisp/makesum.el") 15300 "./lisp/hex-util.el")
15317@end group 15301@end group
15318@end smallexample 15302@end smallexample
15319 15303
@@ -17711,17 +17695,6 @@ or start GNU Emacs with the command @code{emacs -nbc}.
17711(setq grep-command "grep -i -nH -e ") 17695(setq grep-command "grep -i -nH -e ")
17712@end smallexample 17696@end smallexample
17713 17697
17714@ignore
17715@c Evidently, no longer needed in GNU Emacs 22
17716
17717item Automatically uncompress compressed files when visiting them
17718
17719smallexample
17720(load "uncompress")
17721end smallexample
17722
17723@end ignore
17724
17725@item Find an existing buffer, even if it has a different name@* 17698@item Find an existing buffer, even if it has a different name@*
17726This avoids problems with symbolic links. 17699This avoids problems with symbolic links.
17727 17700
diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi
index 058c9319544..9ae40949d1e 100644
--- a/doc/lispref/debugging.texi
+++ b/doc/lispref/debugging.texi
@@ -77,6 +77,7 @@ debugger recursively. @xref{Recursive Editing}.
77 77
78@menu 78@menu
79* Error Debugging:: Entering the debugger when an error happens. 79* Error Debugging:: Entering the debugger when an error happens.
80* Debugging Redisplay:: Getting backtraces from redisplay errors.
80* Infinite Loops:: Stopping and debugging a program that doesn't exit. 81* Infinite Loops:: Stopping and debugging a program that doesn't exit.
81* Function Debugging:: Entering it when a certain function is called. 82* Function Debugging:: Entering it when a certain function is called.
82* Variable Debugging:: Entering it when a variable is modified. 83* Variable Debugging:: Entering it when a variable is modified.
@@ -105,6 +106,10 @@ debugger, set the variable @code{debug-on-error} to non-@code{nil}.
105(The command @code{toggle-debug-on-error} provides an easy way to do 106(The command @code{toggle-debug-on-error} provides an easy way to do
106this.) 107this.)
107 108
109Note that, for technical reasons, you cannot use the facilities
110defined in this subsection to debug errors in Lisp that the redisplay
111code has invoked. @xref{Debugging Redisplay}, for help with these.
112
108@defopt debug-on-error 113@defopt debug-on-error
109This variable determines whether the debugger is called when an error 114This variable determines whether the debugger is called when an error
110is signaled and not handled. If @code{debug-on-error} is @code{t}, 115is signaled and not handled. If @code{debug-on-error} is @code{t},
@@ -213,6 +218,45 @@ file, use the option @samp{--debug-init}. This binds
213bypasses the @code{condition-case} which normally catches errors in the 218bypasses the @code{condition-case} which normally catches errors in the
214init file. 219init file.
215 220
221@node Debugging Redisplay
222@subsection Debugging Redisplay Errors
223@cindex redisplay errors
224@cindex debugging redisplay errors
225
226When an error occurs in Lisp code which redisplay has invoked, Emacs's
227usual debugging mechanisms are unusable, for technical reasons. This
228subsection describes how to get a backtrace from such an error, which
229should be helpful in debugging it.
230
231These directions apply to Lisp forms used, for example, in
232@code{:eval} mode line constructs (@pxref{Mode Line Data}), and in all
233hooks invoked from redisplay, such as:
234
235@itemize
236@item
237@code{fontification-functions} (@pxref{Auto Faces}).
238@item
239@code{window-scroll-functions} (@pxref{Window Hooks}).
240@end itemize
241
242Note that if you have had an error in a hook function called from
243redisplay, the error handling might have removed this function from
244the hook. You will thus need to reinitialize that hook somehow,
245perhaps with @code{add-hook}, to be able to replay the bug.
246
247To generate a backtrace in these circumstances, set the variable
248@code{backtrace-on-redisplay-error} to non-@code{nil}. When the error
249occurs, Emacs will dump the backtrace to the buffer
250@file{*Redisplay-trace*}, but won't automatically display it in a
251window. This is to avoid needlessly corrupting the redisplay you are
252debugging. You will thus need to display the buffer yourself, with a
253command such as @code{switch-to-buffer-other-frame} @key{C-x 5 b}.
254
255@defvar backtrace-on-redisplay-error
256Set this variable to non-@code{nil} to enable the generation of a
257backtrace when an error occurs in any Lisp called from redisplay.
258@end defvar
259
216@node Infinite Loops 260@node Infinite Loops
217@subsection Debugging Infinite Loops 261@subsection Debugging Infinite Loops
218@cindex infinite loops 262@cindex infinite loops
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index ace67fbedb7..96079dc106a 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -8596,9 +8596,9 @@ Characters of Unicode General Category [Cf], such as U+200E
8596images, such as U+00AD @sc{soft hyphen}. 8596images, such as U+00AD @sc{soft hyphen}.
8597 8597
8598@item variation-selectors 8598@item variation-selectors
8599Unicode VS-1 through VS-16 (U+FE00 through U+FE0F), which are used to 8599Unicode VS-1 through VS-256 (U+FE00 through U+FE0F and U+E0100 through
8600select between different glyphs for the same codepoints (typically 8600U+E01EF), which are used to select between different glyphs for the same
8601emojis). 8601codepoints (typically emojis).
8602 8602
8603@item no-font 8603@item no-font
8604Characters for which there is no suitable font, or which cannot be 8604Characters for which there is no suitable font, or which cannot be
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index 8265e58210e..ddf7cff6c2e 100644
--- a/doc/lispref/functions.texi
+++ b/doc/lispref/functions.texi
@@ -217,6 +217,14 @@ function. For example:
217@end example 217@end example
218@end defun 218@end defun
219 219
220@defun compiled-function-p object
221This function returns @code{t} if @var{object} is a function object
222that was either built-in (a.k.a.@: ``primitive'', @pxref{What Is a
223Function}), or byte-compiled (@pxref{Byte Compilation}), or
224natively-compiled (@pxref{Native Compilation}), or a function loaded
225from a dynamic module (@pxref{Dynamic Modules}).
226@end defun
227
220@defun subr-arity subr 228@defun subr-arity subr
221This works like @code{func-arity}, but only for built-in functions and 229This works like @code{func-arity}, but only for built-in functions and
222without symbol indirection. It signals an error for non-built-in 230without symbol indirection. It signals an error for non-built-in
diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi
index 0972a7a123c..4e4f12dc324 100644
--- a/doc/lispref/loading.texi
+++ b/doc/lispref/loading.texi
@@ -440,7 +440,7 @@ similarly-named file in a directory earlier on @code{load-path}.
440For instance, suppose @code{load-path} is set to 440For instance, suppose @code{load-path} is set to
441 441
442@example 442@example
443 ("/opt/emacs/site-lisp" "/usr/share/emacs/23.3/lisp") 443 ("/opt/emacs/site-lisp" "/usr/share/emacs/29.1/lisp")
444@end example 444@end example
445 445
446@noindent 446@noindent
diff --git a/doc/lispref/objects.texi b/doc/lispref/objects.texi
index 1bae1924557..7b5e9adee29 100644
--- a/doc/lispref/objects.texi
+++ b/doc/lispref/objects.texi
@@ -2022,6 +2022,9 @@ with references to further information.
2022@item byte-code-function-p 2022@item byte-code-function-p
2023@xref{Byte-Code Type, byte-code-function-p}. 2023@xref{Byte-Code Type, byte-code-function-p}.
2024 2024
2025@item compiled-function-p
2026@xref{Byte-Code Type, compiled-function-p}.
2027
2025@item case-table-p 2028@item case-table-p
2026@xref{Case Tables, case-table-p}. 2029@xref{Case Tables, case-table-p}.
2027 2030
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index d591b219cd0..35828018417 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -1544,11 +1544,11 @@ as traditional Gregorian years do; for example, the year number
1544@defun time-convert time form 1544@defun time-convert time form
1545This function converts a time value into a Lisp timestamp. 1545This function converts a time value into a Lisp timestamp.
1546 1546
1547The optional @var{form} argument specifies the timestamp form to be 1547The @var{form} argument specifies the timestamp form to be returned.
1548returned. If @var{form} is the symbol @code{integer}, this function 1548If @var{form} is the symbol @code{integer}, this function returns an
1549returns an integer count of seconds. If @var{form} is a positive 1549integer count of seconds. If @var{form} is a positive integer, it
1550integer, it specifies a clock frequency and this function returns an 1550specifies a clock frequency and this function returns an integer-pair
1551integer-pair timestamp @code{(@var{ticks} . @var{form})}. If @var{form} is 1551timestamp @code{(@var{ticks} . @var{form})}. If @var{form} is
1552@code{t}, this function treats it as a positive integer suitable for 1552@code{t}, this function treats it as a positive integer suitable for
1553representing the timestamp; for example, it is treated as 1000000000 1553representing the timestamp; for example, it is treated as 1000000000
1554if @var{time} is @code{nil} and the platform timestamp has nanosecond 1554if @var{time} is @code{nil} and the platform timestamp has nanosecond
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 382053ab24a..db6b4c35ef7 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -1960,7 +1960,6 @@ because @var{seconds} can be floating point to specify
1960waiting a fractional number of seconds. If @var{seconds} is 0, the 1960waiting a fractional number of seconds. If @var{seconds} is 0, the
1961function accepts whatever output is pending but does not wait. 1961function accepts whatever output is pending but does not wait.
1962 1962
1963@c Emacs 22.1 feature
1964If @var{process} is a process, and the argument @var{just-this-one} is 1963If @var{process} is a process, and the argument @var{just-this-one} is
1965non-@code{nil}, only output from that process is handled, suspending output 1964non-@code{nil}, only output from that process is handled, suspending output
1966from other processes until some output has been received from that 1965from other processes until some output has been received from that
diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi
index 829d7f4fa03..91a9afd9c9f 100644
--- a/doc/misc/auth.texi
+++ b/doc/misc/auth.texi
@@ -652,14 +652,8 @@ before @file{~/.authinfo}, the auth-source library will try to
652read the GnuPG encrypted @file{.gpg} file first, before 652read the GnuPG encrypted @file{.gpg} file first, before
653the unencrypted file. 653the unencrypted file.
654 654
655In Emacs 23 or later there is an option @code{auto-encryption-mode} to 655There is an option @code{auto-encryption-mode} to automatically
656automatically decrypt @file{*.gpg} files. It is enabled by default. 656decrypt @file{*.gpg} files. It is enabled by default.
657If you are using earlier versions of Emacs, you will need:
658
659@lisp
660(require 'epa-file)
661(epa-file-enable)
662@end lisp
663 657
664If you want your GnuPG passwords to be cached, set up @code{gpg-agent} 658If you want your GnuPG passwords to be cached, set up @code{gpg-agent}
665or EasyPG Assistant 659or EasyPG Assistant
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi
index 9bda6af1c5b..98f59b89c01 100644
--- a/doc/misc/calc.texi
+++ b/doc/misc/calc.texi
@@ -1,7 +1,7 @@
1\input texinfo @c -*- mode: texinfo; coding: utf-8 -*- 1\input texinfo @c -*- mode: texinfo; coding: utf-8 -*-
2@setfilename ../../info/calc.info
2@comment %**start of header (This is for running Texinfo on a region.) 3@comment %**start of header (This is for running Texinfo on a region.)
3@c smallbook 4@c smallbook
4@setfilename ../../info/calc.info
5@c [title] 5@c [title]
6@settitle GNU Emacs Calc Manual 6@settitle GNU Emacs Calc Manual
7@include docstyle.texi 7@include docstyle.texi
diff --git a/doc/misc/efaq-w32.texi b/doc/misc/efaq-w32.texi
index 084b5a3254e..46c257e42e5 100644
--- a/doc/misc/efaq-w32.texi
+++ b/doc/misc/efaq-w32.texi
@@ -930,9 +930,9 @@ an indication of whether the font is outline (.TTF, .ATM) or raster (.FON)
930based when fonts are listed, which may let you differentiate between two 930based when fonts are listed, which may let you differentiate between two
931fonts with the same name and different technologies. 931fonts with the same name and different technologies.
932 932
933Starting with Emacs 23, the preferred font name format will be moving 933Starting with Emacs 23, the preferred font name format is the simpler
934to the simpler and more flexible fontconfig format. XLFD names will 934and more flexible fontconfig format. XLFD names will continue to be
935continue to be supported for backward compatibility. 935supported for backward compatibility.
936 936
937@example 937@example
938XLFD: -*-Courier New-normal-r-*-*-13-*-*-*-c-*-iso8859-1 938XLFD: -*-Courier New-normal-r-*-*-13-*-*-*-c-*-iso8859-1
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index a98c4b6a614..c29e4fe4875 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -2891,20 +2891,20 @@ and cause an annoying delay in display, so several features exist to
2891work around this. 2891work around this.
2892 2892
2893@cindex Just-In-Time syntax highlighting 2893@cindex Just-In-Time syntax highlighting
2894In Emacs 21 and later, turning on @code{font-lock-mode} automatically 2894Turning on @code{font-lock-mode} automatically activates
2895activates the new @dfn{Just-In-Time fontification} provided by 2895@dfn{Just-In-Time fontification} provided by @code{jit-lock-mode}.
2896@code{jit-lock-mode}. @code{jit-lock-mode} defers the fontification of 2896@code{jit-lock-mode} defers the fontification of portions of buffer
2897portions of buffer until you actually need to see them, and can also 2897until you actually need to see them, and can also fontify while Emacs
2898fontify while Emacs is idle. This makes display of the visible portion 2898is idle. This makes display of the visible portion of a buffer almost
2899of a buffer almost instantaneous. For details about customizing 2899instantaneous. For details about customizing @code{jit-lock-mode},
2900@code{jit-lock-mode}, type @kbd{C-h f jit-lock-mode @key{RET}}. 2900type @kbd{C-h f jit-lock-mode @key{RET}}.
2901 2901
2902@cindex Levels of syntax highlighting 2902@cindex Levels of syntax highlighting
2903@cindex Decoration level, in @code{font-lock-mode} 2903@cindex Decoration level, in @code{font-lock-mode}
2904In versions of Emacs before 21, different levels of decoration are 2904Different levels of decoration are available, from slight to gaudy.
2905available, from slight to gaudy. More decoration means you need to wait 2905More decoration means you need to wait more time for a buffer to be
2906more time for a buffer to be fontified (or a faster machine). To 2906fontified (or a faster machine). To control how decorated your
2907control how decorated your buffers should become, set the value of 2907buffers should become, set the value of
2908@code{font-lock-maximum-decoration} in your @file{.emacs} file, with a 2908@code{font-lock-maximum-decoration} in your @file{.emacs} file, with a
2909@code{nil} value indicating default (usually minimum) decoration, and a 2909@code{nil} value indicating default (usually minimum) decoration, and a
2910@code{t} value indicating the maximum decoration. For the gaudiest 2910@code{t} value indicating the maximum decoration. For the gaudiest
@@ -2985,11 +2985,7 @@ Add the following line to your @file{.emacs} file:
2985In many systems, @code{ls} is aliased to @samp{ls --color}, which 2985In many systems, @code{ls} is aliased to @samp{ls --color}, which
2986prints using ANSI color escape sequences. Emacs includes the 2986prints using ANSI color escape sequences. Emacs includes the
2987@code{ansi-color} package, which lets Shell mode recognize these 2987@code{ansi-color} package, which lets Shell mode recognize these
2988escape sequences. In Emacs 23.2 and later, the package is enabled by 2988escape sequences. It is enabled by default.
2989default; in earlier versions you can enable it by typing @kbd{M-x
2990ansi-color-for-comint-mode} in the Shell buffer, or by adding
2991@code{(add-hook 'shell-mode-hook 'ansi-color-for-comint-mode-on)} to
2992your init file.
2993 2989
2994@node Fullscreen mode on MS-Windows 2990@node Fullscreen mode on MS-Windows
2995@section How can I start Emacs in fullscreen mode on MS-Windows? 2991@section How can I start Emacs in fullscreen mode on MS-Windows?
diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi
index 640712edf33..5f4e1a639be 100644
--- a/doc/misc/emacs-mime.texi
+++ b/doc/misc/emacs-mime.texi
@@ -403,9 +403,9 @@ This selects the function used to render @acronym{HTML}. The
403predefined renderers are selected by the symbols @code{shr}, 403predefined renderers are selected by the symbols @code{shr},
404@code{gnus-w3m}, @code{w3m}@footnote{See 404@code{gnus-w3m}, @code{w3m}@footnote{See
405@uref{http://emacs-w3m.namazu.org/} for more information about 405@uref{http://emacs-w3m.namazu.org/} for more information about
406emacs-w3m}, @code{links}, @code{lynx}, @code{w3m-standalone} or 406emacs-w3m}, @code{links}, @code{lynx}, or @code{w3m-standalone}. You
407@code{html2text}. You can also specify a function, which will be 407can also specify a function, which will be called with a
408called with a @acronym{MIME} handle as the argument. 408@acronym{MIME} handle as the argument.
409 409
410@item mm-html-inhibit-images 410@item mm-html-inhibit-images
411@vindex mm-html-inhibit-images 411@vindex mm-html-inhibit-images
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi
index 9f9c88582f3..13f13163dd7 100644
--- a/doc/misc/eshell.texi
+++ b/doc/misc/eshell.texi
@@ -201,7 +201,7 @@ history and invoking commands in a script file.
201* Aliases:: 201* Aliases::
202* History:: 202* History::
203* Completion:: 203* Completion::
204* for loop:: 204* Control Flow::
205* Scripts:: 205* Scripts::
206@end menu 206@end menu
207 207
@@ -219,12 +219,18 @@ same name; if there is no match, it then tries to execute it as an
219external command. 219external command.
220 220
221The semicolon (@code{;}) can be used to separate multiple command 221The semicolon (@code{;}) can be used to separate multiple command
222invocations on a single line. A command invocation followed by an 222invocations on a single line. You can also separate commands with
223ampersand (@code{&}) will be run in the background. Eshell has no job 223@code{&&} or @code{||}. When using @code{&&}, Eshell will execute the
224control, so you can not suspend or background the current process, or 224second command only if the first succeeds (i.e.@: has an exit
225bring a background process into the foreground. That said, background 225status of 0); with @code{||}, Eshell will execute the second command
226processes invoked from Eshell can be controlled the same way as any 226only if the first fails.
227other background process in Emacs. 227
228A command invocation followed by an ampersand (@code{&}) will be run
229in the background. Eshell has no job control, so you can not suspend
230or background the current process, or bring a background process into
231the foreground. That said, background processes invoked from Eshell
232can be controlled the same way as any other background process in
233Emacs.
228 234
229@node Arguments 235@node Arguments
230@section Arguments 236@section Arguments
@@ -884,14 +890,18 @@ command (excluding the command name itself).
884 890
885@vindex $$ 891@vindex $$
886@item $$ 892@item $$
887This is the result of the last command. In case of an external 893This is the result of the last command. For external commands, it is
888command, it is @code{t} or @code{nil}. 894@code{t} if the exit code was 0 or @code{nil} otherwise.
889 895
896@vindex eshell-lisp-form-nil-is-failure
890@vindex $? 897@vindex $?
891@item $? 898@item $?
892This variable contains the exit code of the last command. If the last 899This variable contains the exit code of the last command. If the last
893command was a Lisp function, it is 0 for successful completion or 1 900command was a Lisp function, it is 0 for successful completion or 1
894otherwise. 901otherwise. If @code{eshell-lisp-form-nil-is-failure} is
902non-@code{nil}, then a command with a Lisp form, like
903@samp{(@var{command} @var{args}@dots{})}, that returns @code{nil} will
904set this variable to 2.
895 905
896@vindex $COLUMNS 906@vindex $COLUMNS
897@vindex $LINES 907@vindex $LINES
@@ -1008,19 +1018,46 @@ command for which this function provides completions; you can also name
1008the function @code{pcomplete/MAJOR-MODE/COMMAND} to define completions 1018the function @code{pcomplete/MAJOR-MODE/COMMAND} to define completions
1009for a specific major mode. 1019for a specific major mode.
1010 1020
1011@node for loop 1021@node Control Flow
1012@section @code{for} loop 1022@section Control Flow
1013Because Eshell commands can not (easily) be combined with lisp forms, 1023Because Eshell commands can not (easily) be combined with lisp forms,
1014Eshell provides a command-oriented @command{for}-loop for convenience. 1024Eshell provides command-oriented control flow statements for
1015The syntax is as follows: 1025convenience.
1016 1026
1017@example 1027Most of Eshell's control flow statements accept a @var{conditional}.
1018@code{for VAR in TOKENS @{ command invocation(s) @}} 1028This can take a few different forms. If @var{conditional} is a dollar
1019@end example 1029expansion, the condition is satisfied if the result is a
1030non-@code{nil} value. If @var{conditional} is a @samp{@{
1031@var{subcommand} @}} or @samp{(@var{lisp form})}, the condition is
1032satisfied if the command's exit status is 0.
1033
1034@table @code
1035
1036@item if @var{conditional} @{ @var{true-commands} @}
1037@itemx if @var{conditional} @{ @var{true-commands} @} @{ @var{false-commands} @}
1038Evaluate @var{true-commands} if @var{conditional} is satisfied;
1039otherwise, evaluate @var{false-commands}.
1040
1041@item unless @var{conditional} @{ @var{false-commands} @}
1042@itemx unless @var{conditional} @{ @var{false-commands} @} @{ @var{true-commands} @}
1043Evaluate @var{false-commands} if @var{conditional} is not satisfied;
1044otherwise, evaluate @var{true-commands}.
1020 1045
1021where @samp{TOKENS} is a space-separated sequence of values of 1046@item while @var{conditional} @{ @var{commands} @}
1022@var{VAR} for each iteration. This can even be the output of a 1047Repeatedly evaluate @var{commands} so long as @var{conditional} is
1023command if @samp{TOKENS} is replaced with @samp{@{ command invocation @}}. 1048satisfied.
1049
1050@item until @var{conditional} @{ @var{commands} @}
1051Repeatedly evaluate @var{commands} until @var{conditional} is
1052satisfied.
1053
1054@item for @var{var} in @var{list}@dots{} @{ @var{commands} @}
1055Iterate over each element of of @var{list}, storing the element in
1056@var{var} and evaluating @var{commands}. If @var{list} is not a list,
1057treat it as a list of one element. If you specify multiple
1058@var{lists}, this will iterate over each of them in turn.
1059
1060@end table
1024 1061
1025@node Scripts 1062@node Scripts
1026@section Scripts 1063@section Scripts
@@ -1811,11 +1848,6 @@ scrolls back.
1811 1848
1812@item Menu support was removed, but never put back 1849@item Menu support was removed, but never put back
1813 1850
1814@item Using C-p and C-n with rebind gets into a locked state
1815
1816This happened a few times in Emacs 21, but has been irreproducible
1817since.
1818
1819@item If an interactive process is currently running, @kbd{M-!} doesn't work 1851@item If an interactive process is currently running, @kbd{M-!} doesn't work
1820 1852
1821@item Use a timer instead of @code{sleep-for} when killing child processes 1853@item Use a timer instead of @code{sleep-for} when killing child processes
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi
index 4923efb3dbe..c442ca1bacd 100644
--- a/doc/misc/gnus-faq.texi
+++ b/doc/misc/gnus-faq.texi
@@ -1,7 +1,7 @@
1@c \input texinfo @c -*-texinfo-*- 1@c \input texinfo @c -*-texinfo-*-
2@c Uncomment 1st line before texing this file alone. 2@c Uncomment 1st line before texing this file alone.
3@c %**start of header 3@c %**start of header
4@c Copyright (C) 1995, 2001--2022 Free Software Foundation, Inc. 4@c Copyright (C) 1995--2022 Free Software Foundation, Inc.
5@c 5@c
6@c @setfilename gnus-faq.info 6@c @setfilename gnus-faq.info
7@c @settitle Frequently Asked Questions 7@c @settitle Frequently Asked Questions
@@ -13,7 +13,6 @@
13@section Frequently Asked Questions 13@section Frequently Asked Questions
14 14
15@menu 15@menu
16* FAQ - Changes::
17* FAQ - Introduction:: About Gnus and this FAQ. 16* FAQ - Introduction:: About Gnus and this FAQ.
18* FAQ 1 - Installation FAQ:: Installation of Gnus. 17* FAQ 1 - Installation FAQ:: Installation of Gnus.
19* FAQ 2 - Startup / Group buffer:: Start up questions and the 18* FAQ 2 - Startup / Group buffer:: Start up questions and the
@@ -41,21 +40,6 @@ This is the new Gnus Frequently Asked Questions list.
41Please submit features and suggestions to the 40Please submit features and suggestions to the
42@email{ding@@gnus.org, ding list}. 41@email{ding@@gnus.org, ding list}.
43 42
44@node FAQ - Changes
45@subsection Changes
46
47
48
49@itemize @bullet
50
51@item
522008-06-15: Adjust for message-fill-column. Add x-face-file.
53Clarify difference between ding and gnu.emacs.gnus. Remove
54reference to discontinued service.
55
56@item
572006-04-15: Added tip on how to delete sent buffer on exit.
58@end itemize
59 43
60@node FAQ - Introduction 44@node FAQ - Introduction
61@subsection Introduction 45@subsection Introduction
@@ -63,11 +47,11 @@ reference to discontinued service.
63This is the Gnus Frequently Asked Questions list. 47This is the Gnus Frequently Asked Questions list.
64 48
65Gnus is a Usenet Newsreader and Electronic Mail User Agent implemented 49Gnus is a Usenet Newsreader and Electronic Mail User Agent implemented
66as a part of Emacs. It's been around in some form for almost a decade 50as a part of Emacs. It's been around in some form since the early
67now, and has been distributed as a standard part of Emacs for much of 511990s, and has been distributed as a standard part of Emacs for much
68that time. Gnus 5 is the latest (and greatest) incarnation. The 52of that time. Gnus 5 is the latest (and greatest) incarnation. The
69original version was called GNUS, and was written by Masanobu UMEDA@. 53original version was called GNUS, and was written by Masanobu UMEDA@.
70When autumn crept up in '94, Lars Magne Ingebrigtsen grew bored and 54When autumn crept up in 1994, Lars Magne Ingebrigtsen grew bored and
71decided to rewrite Gnus. 55decided to rewrite Gnus.
72 56
73Its biggest strength is the fact that it is extremely 57Its biggest strength is the fact that it is extremely
@@ -84,11 +68,6 @@ would like to thank Steve Baur and Per Abrahamsen for doing a wonderful
84job with this FAQ before him. We would like to do the same: thanks, 68job with this FAQ before him. We would like to do the same: thanks,
85Justin! 69Justin!
86 70
87This version is much nicer than the unofficial hypertext
88versions that are archived at Utrecht, Oxford, Smart Pages, Ohio
89State, and other FAQ archives. See the resources question below
90if you want information on obtaining it in another format.
91
92The information contained here was compiled with the assistance 71The information contained here was compiled with the assistance
93of the Gnus development mailing list, and any errors or 72of the Gnus development mailing list, and any errors or
94misprints are the Gnus team's fault, sorry. 73misprints are the Gnus team's fault, sorry.
@@ -98,11 +77,9 @@ misprints are the Gnus team's fault, sorry.
98 77
99@menu 78@menu
100* FAQ 1-1:: What is the latest version of Gnus? 79* FAQ 1-1:: What is the latest version of Gnus?
101* FAQ 1-2:: What's new in 5.10? 80* FAQ 1-2:: Where and how to get Gnus?
102* FAQ 1-3:: Where and how to get Gnus? 81* FAQ 1-3:: I sometimes read references to No Gnus and Oort Gnus,
103* FAQ 1-4:: I sometimes read references to No Gnus and Oort Gnus,
104 what are those? 82 what are those?
105* FAQ 1-5:: Which version of Emacs do I need?
106@end menu 83@end menu
107 84
108@node FAQ 1-1 85@node FAQ 1-1
@@ -112,80 +89,28 @@ What is the latest version of Gnus?
112 89
113@subsubheading Answer 90@subsubheading Answer
114 91
115Jingle please: Gnus 5.10 is released, get it while it's 92The latest version of Gnus is bundled with Emacs.
116hot! As well as the step in version number is rather
117small, Gnus 5.10 has tons of new features which you
118shouldn't miss. The current release (5.13) should be at
119least as stable as the latest release of the 5.8 series.
120 93
121@node FAQ 1-2 94@node FAQ 1-2
122@subsubheading Question 1.2 95@subsubheading Question 1.2
123 96
124What's new in 5.10?
125
126@subsubheading Answer
127
128First of all, you should have a look into the file
129GNUS-NEWS in the toplevel directory of the Gnus tarball,
130there the most important changes are listed. Here's a
131short list of the changes I find especially
132important/interesting:
133
134@itemize @bullet
135
136@item
137Major rewrite of the Gnus agent, Gnus agent is now
138active by default.
139
140@item
141Many new article washing functions for dealing with
142ugly formatted articles.
143
144@item
145Anti Spam features.
146
147@item
148Message-utils now included in Gnus.
149
150@item
151New format specifiers for summary lines, e.g., %B for
152a complex trn-style thread tree.
153@end itemize
154
155@node FAQ 1-3
156@subsubheading Question 1.3
157
158Where and how to get Gnus? 97Where and how to get Gnus?
159 98
160@subsubheading Answer 99@subsubheading Answer
161 100
162Gnus is bundled with Emacs. 101Gnus is bundled with Emacs.
163 102
164@node FAQ 1-4 103@node FAQ 1-3
165@subsubheading Question 1.4 104@subsubheading Question 1.3
166 105
167I sometimes read references to No Gnus and Oort Gnus, 106I sometimes read references to No Gnus and Oort Gnus,
168what are those? 107what are those?
169 108
170@subsubheading Answer 109@subsubheading Answer
171 110
172Oort Gnus was the name of the development version of 111Oort Gnus was the name of the development version of Gnus, which
173Gnus, which became Gnus 5.10 in autumn 2003. No Gnus is 112became Gnus 5.10 in autumn 2003. No Gnus was the name of the
174the name of the current development version which will 113development version that became Gnus 5.12.
175once become Gnus 5.12 or Gnus 6. (If you're wondering why
176not 5.11, the odd version numbers are normally used for
177the Gnus versions bundled with Emacs)
178
179@node FAQ 1-5
180@subsubheading Question 1.5
181
182Which version of Emacs do I need?
183
184@subsubheading Answer
185
186Gnus 5.13 requires an Emacs version that is greater than or equal
187to Emacs 23.1, although there are some features that
188only work on Emacs 24.
189 114
190@node FAQ 2 - Startup / Group buffer 115@node FAQ 2 - Startup / Group buffer
191@subsection Startup / Group buffer 116@subsection Startup / Group buffer
@@ -718,9 +643,8 @@ in @file{~/.gnus.el} to load enough old articles to prevent teared threads, repl
718all articles (Warning: Both settings enlarge the amount of data which is 643all articles (Warning: Both settings enlarge the amount of data which is
719fetched when you enter a group and slow down the process of entering a group). 644fetched when you enter a group and slow down the process of entering a group).
720 645
721If you already use Gnus 5.10, you can say 646You can say @samp{/o N} in the summary buffer to load the last N
722@samp{/o N} 647messages.
723In summary buffer to load the last N messages, this feature is not available in 5.8.8
724 648
725If you don't want all old messages, but the parent of the message you're just reading, 649If you don't want all old messages, but the parent of the message you're just reading,
726you can say @samp{^}, if you want to retrieve the whole thread 650you can say @samp{^}, if you want to retrieve the whole thread
@@ -820,11 +744,10 @@ Can I use some other browser than w3m to render my HTML-mails?
820 744
821@subsubheading Answer 745@subsubheading Answer
822 746
823Only if you use Gnus 5.10 or younger. In this case you've got the 747You've got the choice between @samp{shr}, @samp{w3m}, @samp{links},
824choice between shr, w3m, links, lynx and html2text, which 748and @samp{lynx}. Which one is used is specified in the variable
825one is used can be specified in the variable 749@code{mm-text-html-renderer}, so if you want links to render your
826mm-text-html-renderer, so if you want links to render your 750mail, say:
827mail say
828 751
829@example 752@example
830(setq mm-text-html-renderer 'links) 753(setq mm-text-html-renderer 'links)
@@ -847,8 +770,7 @@ long lines'' (@samp{W w}), ``Decode ROT13''
847the dumb quoting used by many users of Microsoft products 770the dumb quoting used by many users of Microsoft products
848(@samp{W Y f} gives you full deuglify. 771(@samp{W Y f} gives you full deuglify.
849See @samp{W Y C-h} or have a look at the menus for 772See @samp{W Y C-h} or have a look at the menus for
850other deuglifications). Outlook deuglify is only available since 773other deuglifications).
851Gnus 5.10.
852 774
853@node FAQ 4-9 775@node FAQ 4-9
854@subsubheading Question 4.9 776@subsubheading Question 4.9
@@ -1038,7 +960,7 @@ you'll find useful things like positioning the cursor and
1038tabulators which allow you a summary in table form, but 960tabulators which allow you a summary in table form, but
1039sadly hard tabulators are broken in 5.8.8. 961sadly hard tabulators are broken in 5.8.8.
1040 962
1041Since 5.10, Gnus offers you some very nice new specifiers, 963Gnus offers you some very nice new specifiers,
1042e.g., %B which draws a thread-tree and %&user-date which 964e.g., %B which draws a thread-tree and %&user-date which
1043gives you a date where the details are dependent of the 965gives you a date where the details are dependent of the
1044articles age. Here's an example which uses both: 966articles age. Here's an example which uses both:
@@ -1245,7 +1167,7 @@ How to set stuff like From, Organization, Reply-To, signature...?
1245@subsubheading Answer 1167@subsubheading Answer
1246 1168
1247There are other ways, but you should use posting styles 1169There are other ways, but you should use posting styles
1248for this. (See below why). 1170for this. (See below why.)
1249This example should make the syntax clear: 1171This example should make the syntax clear:
1250 1172
1251@example 1173@example
@@ -1329,19 +1251,14 @@ Is there a spell-checker? Perhaps even on-the-fly spell-checking?
1329 1251
1330@subsubheading Answer 1252@subsubheading Answer
1331 1253
1332You can use ispell.el to spell-check stuff in Emacs. So the 1254You can use ispell.el to spell-check stuff in Emacs, and flyspell.el
1333first thing to do is to make sure that you've got either 1255for on-the-fly spell-checking. So the first thing to do is to make
1334@uref{https://www.cs.hmc.edu/~geoff/ispell.html, ispell} 1256sure that you've got either
1335or @uref{http://aspell.net, aspell} 1257@uref{https://hunspell.github.io/, hunspell},
1336installed and in your Path. Then you need 1258@uref{https://www.cs.hmc.edu/~geoff/ispell.html, ispell} or
1337ispell.el 1259@uref{http://aspell.net, aspell} installed and in your Path.
1338and for on-the-fly spell-checking
1339@uref{https://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}.
1340Ispell.el is shipped with Emacs,
1341flyspell.el is shipped with Emacs, so there should be no need to install them
1342manually.
1343 1260
1344Ispell.el assumes you use ispell, if you choose aspell say 1261Ispell.el assumes you use ispell. If you use aspell say
1345 1262
1346@example 1263@example
1347(setq ispell-program-name "aspell") 1264(setq ispell-program-name "aspell")
@@ -1494,14 +1411,14 @@ Now you only have to tell Gnus to include the X-face in your postings by saying
1494@end example 1411@end example
1495@noindent 1412@noindent
1496 1413
1497in @file{~/.gnus.el}. If you use Gnus 5.10, you can simply add an entry 1414in @file{~/.gnus.el}. You can add an entry
1498 1415
1499@example 1416@example
1500(x-face-file "~/.xface") 1417(x-face-file "~/.xface")
1501@end example 1418@end example
1502@noindent 1419@noindent
1503 1420
1504to gnus-posting-styles. 1421to @code{gnus-posting-styles}.
1505 1422
1506@node FAQ 5-9 1423@node FAQ 5-9
1507@subsubheading Question 5.9 1424@subsubheading Question 5.9
@@ -1519,21 +1436,6 @@ Put this in @file{~/.gnus.el}:
1519@end example 1436@end example
1520@noindent 1437@noindent
1521 1438
1522if you already use Gnus 5.10, if you still use 5.8.8 or
15235.9 try this instead:
1524
1525@example
1526(with-eval-after-load "gnus-msg"
1527 (unless (boundp 'gnus-confirm-mail-reply-to-news)
1528 (defadvice gnus-summary-reply (around reply-in-news activate)
1529 "Request confirmation when replying to news."
1530 (interactive)
1531 (when (or (not (gnus-news-group-p gnus-newsgroup-name))
1532 (y-or-n-p "Really reply by mail to article author?"))
1533 ad-do-it))))
1534@end example
1535@noindent
1536
1537@node FAQ 5-10 1439@node FAQ 5-10
1538@subsubheading Question 5.10 1440@subsubheading Question 5.10
1539 1441
@@ -1541,14 +1443,7 @@ How to tell Gnus not to generate a sender header?
1541 1443
1542@subsubheading Answer 1444@subsubheading Answer
1543 1445
1544Since 5.10 Gnus doesn't generate a sender header by 1446Gnus doesn't generate a sender header by default.
1545default. For older Gnus' try this in @file{~/.gnus.el}:
1546
1547@example
1548(with-eval-after-load "message"
1549 (add-to-list 'message-syntax-checks '(sender . disabled)))
1550@end example
1551@noindent
1552 1447
1553@node FAQ 5-11 1448@node FAQ 5-11
1554@subsubheading Question 5.11 1449@subsubheading Question 5.11
@@ -1729,7 +1624,7 @@ more then one article."
1729You can now say @samp{M-x 1624You can now say @samp{M-x
1730my-archive-article} in summary buffer to 1625my-archive-article} in summary buffer to
1731archive the article under the cursor in a nnml 1626archive the article under the cursor in a nnml
1732group. (Change nnml to your preferred back end) 1627group. (Change nnml to your preferred back end.)
1733 1628
1734Of course you can also make sure the cache is enabled by saying 1629Of course you can also make sure the cache is enabled by saying
1735 1630
@@ -1756,7 +1651,7 @@ if you found the posting there, tell Google to display
1756the raw message, look for the message-id, and say 1651the raw message, look for the message-id, and say
1757@samp{M-^ the@@message.id @key{RET}} in a 1652@samp{M-^ the@@message.id @key{RET}} in a
1758summary buffer. 1653summary buffer.
1759Since Gnus 5.10 there's also a Gnus interface for 1654There's a Gnus interface for
1760groups.google.com which you can call with 1655groups.google.com which you can call with
1761@samp{G W}) in group buffer. 1656@samp{G W}) in group buffer.
1762 1657
@@ -1770,25 +1665,6 @@ instead. Further on there are the
1770gnus-summary-limit-to-foo functions, which can help you, 1665gnus-summary-limit-to-foo functions, which can help you,
1771too. 1666too.
1772 1667
1773Of course you can also use grep to search through your
1774local mail, but this is both slow for big archives and
1775inconvenient since you are not displaying the found mail
1776in Gnus. Here nnir comes into action. Nnir is a front end
1777to search engines like swish-e or swish++ and
1778others. You index your mail with one of those search
1779engines and with the help of nnir you can search through
1780the indexed mail and generate a temporary group with all
1781messages which met your search criteria. If this sounds
1782cool to you, get nnir.el from
1783@c FIXME Isn't this file in Gnus?
1784@ignore
1785@c Dead link 2013/7.
1786@uref{ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/}
1787or
1788@end ignore
1789@uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}.
1790Instructions on how to use it are at the top of the file.
1791
1792@node FAQ 6-4 1668@node FAQ 6-4
1793@subsubheading Question 6.4 1669@subsubheading Question 6.4
1794 1670
@@ -1937,16 +1813,9 @@ So what was this thing about the Agent?
1937The Gnus agent is part of Gnus, it allows you to fetch 1813The Gnus agent is part of Gnus, it allows you to fetch
1938mail and news and store them on disk for reading them 1814mail and news and store them on disk for reading them
1939later when you're offline. It kind of mimics offline 1815later when you're offline. It kind of mimics offline
1940newsreaders like Forte Agent. If you want to use 1816newsreaders like Forte Agent. It is enabled by default.
1941the Agent place the following in @file{~/.gnus.el} if you are
1942still using 5.8.8 or 5.9 (it's the default since 5.10):
1943 1817
1944@example 1818You've got to select the servers whose groups can be
1945(setq gnus-agent t)
1946@end example
1947@noindent
1948
1949Now you've got to select the servers whose groups can be
1950stored locally. To do this, open the server buffer 1819stored locally. To do this, open the server buffer
1951(that is press @samp{^} while in the 1820(that is press @samp{^} while in the
1952group buffer). Now select a server by moving point to 1821group buffer). Now select a server by moving point to
@@ -2161,12 +2030,12 @@ How to speed up the process of entering a group?
2161 2030
2162@subsubheading Answer 2031@subsubheading Answer
2163 2032
2164A speed killer is setting the variable 2033A speed killer is setting the variable @code{gnus-fetch-old-headers}
2165gnus-fetch-old-headers to anything different from @code{nil}, 2034to anything different from @code{nil}, so don't do this if speed is an
2166so don't do this if speed is an issue. 2035issue.
2167 2036
2168You could increase the value of gc-cons-threshold 2037You could increase the value of @code{gc-cons-threshold} by saying
2169by saying something like 2038something like:
2170 2039
2171@example 2040@example
2172(setq gc-cons-threshold 3500000) 2041(setq gc-cons-threshold 3500000)
@@ -2204,10 +2073,6 @@ between core Gnus and the real NNTP-, POP3-, IMAP- or
2204whatever-server which offers Gnus a standardized interface 2073whatever-server which offers Gnus a standardized interface
2205to functions like "get message", "get Headers" etc. 2074to functions like "get message", "get Headers" etc.
2206 2075
2207@item Emacs
2208When the term Emacs is used in this FAQ, it means GNU
2209Emacs.
2210
2211@item Message 2076@item Message
2212In this FAQ message means either a mail or a posting to a 2077In this FAQ message means either a mail or a posting to a
2213Usenet Newsgroup or to some other fancy back end, no matter 2078Usenet Newsgroup or to some other fancy back end, no matter
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 7da90dfb1d6..c5298d8ef59 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -885,8 +885,6 @@ History
885* Why?:: What's the point of Gnus? 885* Why?:: What's the point of Gnus?
886* Compatibility:: Just how compatible is Gnus with @sc{gnus}? 886* Compatibility:: Just how compatible is Gnus with @sc{gnus}?
887* Conformity:: Gnus tries to conform to all standards. 887* Conformity:: Gnus tries to conform to all standards.
888* Emacsen:: Gnus can be run on a few modern Emacsen.
889* Gnus Development:: How Gnus is developed.
890* Contributors:: Oodles of people. 888* Contributors:: Oodles of people.
891* New Features:: Pointers to some of the new stuff in Gnus. 889* New Features:: Pointers to some of the new stuff in Gnus.
892 890
@@ -8621,14 +8619,6 @@ uuencoded files that have had trailing spaces deleted.
8621@vindex gnus-uu-pre-uudecode-hook 8619@vindex gnus-uu-pre-uudecode-hook
8622Hook run before sending a message to @code{uudecode}. 8620Hook run before sending a message to @code{uudecode}.
8623 8621
8624@item gnus-uu-view-with-metamail
8625@vindex gnus-uu-view-with-metamail
8626@cindex metamail
8627Non-@code{nil} means that @code{gnus-uu} will ignore the viewing
8628commands defined by the rule variables and just fudge a @acronym{MIME}
8629content type based on the file name. The result will be fed to
8630@code{metamail} for viewing.
8631
8632@item gnus-uu-save-in-digest 8622@item gnus-uu-save-in-digest
8633@vindex gnus-uu-save-in-digest 8623@vindex gnus-uu-save-in-digest
8634Non-@code{nil} means that @code{gnus-uu}, when asked to save without 8624Non-@code{nil} means that @code{gnus-uu}, when asked to save without
@@ -9364,9 +9354,6 @@ Use @uref{https://almende.github.io/chap-links-library/, CHAP Links}.
9364@item lynx 9354@item lynx
9365Use @uref{https://lynx.browser.org/, Lynx}. 9355Use @uref{https://lynx.browser.org/, Lynx}.
9366 9356
9367@item html2text
9368Use html2text---a simple @acronym{HTML} converter included with Gnus.
9369
9370@end table 9357@end table
9371 9358
9372@item W D F 9359@item W D F
@@ -15440,8 +15427,6 @@ files. If a positive number, delete files older than number of days
15440(the deletion will only happen when receiving new mail). You may also 15427(the deletion will only happen when receiving new mail). You may also
15441set @code{mail-source-delete-incoming} to @code{nil} and call 15428set @code{mail-source-delete-incoming} to @code{nil} and call
15442@code{mail-source-delete-old-incoming} from a hook or interactively. 15429@code{mail-source-delete-old-incoming} from a hook or interactively.
15443@code{mail-source-delete-incoming} defaults to @code{10} in alpha Gnusae
15444and @code{2} in released Gnusae. @xref{Gnus Development}.
15445 15430
15446@item mail-source-delete-old-incoming-confirm 15431@item mail-source-delete-old-incoming-confirm
15447@vindex mail-source-delete-old-incoming-confirm 15432@vindex mail-source-delete-old-incoming-confirm
@@ -21962,7 +21947,7 @@ you can set up a local @acronym{IMAP} server, which you then access via
21962@code{nnimap}. This is a rather massive setup for accessing some mbox 21947@code{nnimap}. This is a rather massive setup for accessing some mbox
21963files, so just change to MH or Maildir already... However, if you're 21948files, so just change to MH or Maildir already... However, if you're
21964really, really passionate about using mbox, you might want to look into 21949really, really passionate about using mbox, you might want to look into
21965the package @file{mairix.el}, which comes with Emacs 23. 21950the package @file{mairix.el}, which comes with Emacs.
21966 21951
21967@node What nnmairix does 21952@node What nnmairix does
21968@subsection What nnmairix does 21953@subsection What nnmairix does
@@ -26919,8 +26904,6 @@ renamed it back again to ``Gnus''. But in mixed case. ``Gnus'' vs.
26919* Why?:: What's the point of Gnus? 26904* Why?:: What's the point of Gnus?
26920* Compatibility:: Just how compatible is Gnus with @sc{gnus}? 26905* Compatibility:: Just how compatible is Gnus with @sc{gnus}?
26921* Conformity:: Gnus tries to conform to all standards. 26906* Conformity:: Gnus tries to conform to all standards.
26922* Emacsen:: Gnus can be run on a few modern Emacsen.
26923* Gnus Development:: How Gnus is developed.
26924* Contributors:: Oodles of people. 26907* Contributors:: Oodles of people.
26925* New Features:: Pointers to some of the new stuff in Gnus. 26908* New Features:: Pointers to some of the new stuff in Gnus.
26926@end menu 26909@end menu
@@ -27035,16 +27018,6 @@ maintains a hash table that points to the entries in this alist (which
27035speeds up many functions), and changing the alist directly will lead to 27018speeds up many functions), and changing the alist directly will lead to
27036peculiar results. 27019peculiar results.
27037 27020
27038@cindex hilit19
27039@cindex highlighting
27040Old hilit19 code does not work at all. In fact, you should probably
27041remove all hilit code from all Gnus hooks
27042(@code{gnus-group-prepare-hook} and @code{gnus-summary-prepare-hook}).
27043Gnus provides various integrated functions for highlighting. These are
27044faster and more accurate. To make life easier for everybody, Gnus will
27045by default remove all hilit calls from all hilit hooks. Uncleanliness!
27046Away!
27047
27048Packages like @code{expire-kill} will no longer work. As a matter of 27021Packages like @code{expire-kill} will no longer work. As a matter of
27049fact, you should probably remove all old @sc{gnus} packages (and other 27022fact, you should probably remove all old @sc{gnus} packages (and other
27050code) when you start using Gnus. More likely than not, Gnus already 27023code) when you start using Gnus. More likely than not, Gnus already
@@ -27147,79 +27120,6 @@ mentioned above, don't hesitate to drop a note to Gnus Towers and let us
27147know. 27120know.
27148 27121
27149 27122
27150@node Emacsen
27151@subsection Emacsen
27152@cindex Emacsen
27153@cindex Mule
27154@cindex Emacs
27155
27156This version of Gnus should work on:
27157
27158@itemize @bullet
27159
27160@item
27161Emacs 23.1 and up.
27162
27163@end itemize
27164
27165This Gnus version will absolutely not work on any Emacsen older than
27166that. Not reliably, at least. Older versions of Gnus may work on older
27167Emacs versions. Particularly, Gnus 5.10.8 should also work on Emacs
2716820.7.
27169
27170@c No-merge comment: The paragraph added in v5-10 here must not be
27171@c synced here!
27172
27173@node Gnus Development
27174@subsection Gnus Development
27175
27176Gnus is developed in a two-phased cycle. The first phase involves much
27177discussion on the development mailing list @samp{ding@@gnus.org}, where people
27178propose changes and new features, post patches and new back ends. This
27179phase is called the @dfn{alpha} phase, since the Gnusae released in this
27180phase are @dfn{alpha releases}, or (perhaps more commonly in other
27181circles) @dfn{snapshots}. During this phase, Gnus is assumed to be
27182unstable and should not be used by casual users. Gnus alpha releases
27183have names like ``Oort Gnus'' and ``No Gnus''. @xref{Gnus Versions}.
27184
27185After futzing around for 10--100 alpha releases, Gnus is declared
27186@dfn{frozen}, and only bug fixes are applied. Gnus loses the prefix,
27187and is called things like ``Gnus 5.10.1'' instead. Normal people are
27188supposed to be able to use these, and these are mostly discussed on the
27189@samp{gnu.emacs.gnus} newsgroup. This newgroup is mirrored to the
27190mailing list @samp{info-gnus-english@@gnu.org} which is carried on Gmane
27191as @samp{gmane.emacs.gnus.user}. These releases are finally integrated
27192in Emacs.
27193
27194@cindex Incoming*
27195@vindex mail-source-delete-incoming
27196Some variable defaults differ between alpha Gnusae and released Gnusae,
27197in particular, @code{mail-source-delete-incoming}. This is to prevent
27198lossage of mail if an alpha release hiccups while handling the mail.
27199@xref{Mail Source Customization}.
27200
27201The division of discussion between the ding mailing list and the Gnus
27202newsgroup is not purely based on publicity concerns. It's true that
27203having people write about the horrible things that an alpha Gnus release
27204can do (sometimes) in a public forum may scare people off, but more
27205importantly, talking about new experimental features that have been
27206introduced may confuse casual users. New features are frequently
27207introduced, fiddled with, and judged to be found wanting, and then
27208either discarded or totally rewritten. People reading the mailing list
27209usually keep up with these rapid changes, while people on the newsgroup
27210can't be assumed to do so.
27211
27212So if you have problems with or questions about the alpha versions,
27213direct those to the ding mailing list @samp{ding@@gnus.org}. This list
27214is also available on Gmane as @samp{gmane.emacs.gnus.general}.
27215
27216@cindex Incoming*
27217@vindex mail-source-delete-incoming
27218Some variable defaults differ between alpha Gnusae and released Gnusae,
27219in particular, @code{mail-source-delete-incoming}. This is to prevent
27220lossage of mail if an alpha release hiccups while handling the mail.
27221@xref{Mail Source Customization}.
27222
27223@node Contributors 27123@node Contributors
27224@subsection Contributors 27124@subsection Contributors
27225@cindex contributors 27125@cindex contributors
diff --git a/doc/misc/htmlfontify.texi b/doc/misc/htmlfontify.texi
index 0ab000b70f1..fadc6a5cbe3 100644
--- a/doc/misc/htmlfontify.texi
+++ b/doc/misc/htmlfontify.texi
@@ -10,8 +10,7 @@
10This manual documents Htmlfontify, a source code -> crosslinked + 10This manual documents Htmlfontify, a source code -> crosslinked +
11formatted + syntax colorized html transformer. 11formatted + syntax colorized html transformer.
12 12
13Copyright @copyright{} 2002--2003, 2013--2022 Free Software Foundation, 13Copyright @copyright{} 2002--2022 Free Software Foundation, Inc.
14Inc.
15 14
16@quotation 15@quotation
17Permission is granted to copy, distribute and/or modify this document 16Permission is granted to copy, distribute and/or modify this document
@@ -1540,13 +1539,6 @@ Htmlfontify has a couple of external requirements:
1540@itemize @bullet 1539@itemize @bullet
1541 1540
1542@item 1541@item
1543GNU Emacs 20.7+ or 21.1+
1544
1545Other versions may work---these have been used successfully by the
1546author. If you intend to use Htmlfontify in batch mode, 21.1+ is
1547pretty much required.
1548
1549@item
1550A copy of etags (exuberant-ctags or GNU etags). Htmlfontify attempts 1542A copy of etags (exuberant-ctags or GNU etags). Htmlfontify attempts
1551to autodetect the version you have and customize itself accordingly, 1543to autodetect the version you have and customize itself accordingly,
1552but you should be able to override this. 1544but you should be able to override this.
diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi
index 6aaa4309a16..0ba87b2e58b 100644
--- a/doc/misc/idlwave.texi
+++ b/doc/misc/idlwave.texi
@@ -4116,17 +4116,6 @@ configuration files (e.g., @file{.cshrc}), but from the file
4116@file{~/.MacOSX/environment.plist}. Either include your path settings 4116@file{~/.MacOSX/environment.plist}. Either include your path settings
4117there, or start Emacs and IDLWAVE from the shell. 4117there, or start Emacs and IDLWAVE from the shell.
4118 4118
4119@item @strong{I'm getting errors like @samp{Symbol's value as variable is void:
4120cl-builtin-gethash} on completion or routine info.}
4121
4122This error arises if you upgraded Emacs from 20.x to 21.x without
4123re-installing IDLWAVE@. Old Emacs and new Emacs are not byte-compatible
4124in compiled lisp files. Presumably, you kept the original .elc files in
4125place, and this is the source of the error. If you recompile (or just
4126"make; make install") from source, it should resolve this problem.
4127Another option is to recompile the @file{idlw*.el} files by hand using
4128@kbd{M-x byte-compile-file}.
4129
4130@item @strong{@kbd{M-@key{TAB}} doesn't complete words, it switches 4119@item @strong{@kbd{M-@key{TAB}} doesn't complete words, it switches
4131windows on my desktop.} 4120windows on my desktop.}
4132 4121
diff --git a/doc/misc/message.texi b/doc/misc/message.texi
index 29fbdfe1786..49e3faed7b1 100644
--- a/doc/misc/message.texi
+++ b/doc/misc/message.texi
@@ -1152,12 +1152,11 @@ programs are required to make things work, and some small general hints.
1152@uref{https://www.gnupg.org/, GNU Privacy Guard} or 1152@uref{https://www.gnupg.org/, GNU Privacy Guard} or
1153@uref{https://www.openssl.org/, OpenSSL}. The default Emacs interface 1153@uref{https://www.openssl.org/, OpenSSL}. The default Emacs interface
1154to the S/MIME implementation is EasyPG (@pxref{Top,,EasyPG Assistant 1154to the S/MIME implementation is EasyPG (@pxref{Top,,EasyPG Assistant
1155User's Manual, epa, EasyPG Assistant User's Manual}), which has been 1155User's Manual, epa, EasyPG Assistant User's Manual}), which is
1156included in Emacs since version 23 and which relies on the command 1156included in Emacs and relies on the command line tool @command{gpgsm}
1157line tool @command{gpgsm} provided by @acronym{GnuPG}. That tool 1157provided by @acronym{GnuPG}. That tool implements certificate
1158implements certificate management, including certificate revocation 1158management, including certificate revocation and expiry, while such
1159and expiry, while such tasks need to be performed manually, if OpenSSL 1159tasks need to be performed manually, if OpenSSL is used.
1160is used.
1161 1160
1162The choice between EasyPG and OpenSSL is controlled by the variable 1161The choice between EasyPG and OpenSSL is controlled by the variable
1163@code{mml-smime-use}, which needs to be set to the value @code{epg} 1162@code{mml-smime-use}, which needs to be set to the value @code{epg}
diff --git a/doc/misc/mh-e.texi b/doc/misc/mh-e.texi
index 12841860d91..6a948ce2ca8 100644
--- a/doc/misc/mh-e.texi
+++ b/doc/misc/mh-e.texi
@@ -213,8 +213,8 @@ more niceties about GNU Emacs and MH@. Now I'm fully hooked on both of
213them. 213them.
214 214
215The MH-E package is distributed with Emacs@footnote{Version 215The MH-E package is distributed with Emacs@footnote{Version
216@value{VERSION} of MH-E appeared in Emacs 24.4. It is supported in GNU 216@value{VERSION} of MH-E appeared in Emacs 24.4.
217Emacs 23 and higher. It is compatible with MH versions 6.8.4 and 217It is compatible with MH versions 6.8.4 and
218higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you 218higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you
219shouldn't have to do anything special to use it. Gnus is also 219shouldn't have to do anything special to use it. Gnus is also
220required; version 5.10 or higher is recommended. This manual covers 220required; version 5.10 or higher is recommended. This manual covers
@@ -1488,7 +1488,7 @@ Binding} of @samp{m}.
1488@cindex Unix commands, @command{xbuffy} 1488@cindex Unix commands, @command{xbuffy}
1489 1489
1490You can use @command{xbuffy} to automate the incorporation of this 1490You can use @command{xbuffy} to automate the incorporation of this
1491mail using the Emacs 23 command @command{emacsclient} as follows: 1491mail using the Emacs command @command{emacsclient} as follows:
1492 1492
1493@smallexample 1493@smallexample
1494box ~/mail/mh-e 1494box ~/mail/mh-e
@@ -2553,13 +2553,6 @@ produces pretty nice output, and it highlights links. It renders
2553@samp{&ndash;} and @samp{&reg;} okay. It sometimes fails to wrap lines 2553@samp{&ndash;} and @samp{&reg;} okay. It sometimes fails to wrap lines
2554properly. It always downloads remote images. 2554properly. It always downloads remote images.
2555@c ------------------------- 2555@c -------------------------
2556@cindex browser, @samp{html2text}
2557@cindex @samp{html2text}
2558@item @samp{html2text}
2559The @samp{html2text} browser requires an external program. Some users
2560have reported problems with it, such as filling the entire message as
2561if it were one paragraph, or displaying chunks of raw HTML.
2562@c -------------------------
2563@cindex browser, @samp{links} 2556@cindex browser, @samp{links}
2564@cindex @samp{links} 2557@cindex @samp{links}
2565@item @samp{links} 2558@item @samp{links}
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index cfbc96f4692..924aa66d444 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -3383,7 +3383,7 @@ names. Beside the @code{default} value, @var{syntax} can be
3383@item @code{simplified} 3383@item @code{simplified}
3384@cindex simplified syntax 3384@cindex simplified syntax
3385 3385
3386The remote file name syntax is similar to the syntax used by Ange FTP@. 3386This remote file name syntax is similar to the syntax used by Ange FTP@.
3387A remote file name has the form 3387A remote file name has the form
3388@code{@value{prefix}user@@host@value{postfix}path/to/file}. The 3388@code{@value{prefix}user@@host@value{postfix}path/to/file}. The
3389@code{user@@} part is optional, and the method is determined by 3389@code{user@@} part is optional, and the method is determined by
@@ -3395,7 +3395,7 @@ A remote file name has the form
3395@clear unified 3395@clear unified
3396@set separate 3396@set separate
3397@include trampver.texi 3397@include trampver.texi
3398The remote file name syntax is similar to the syntax used by XEmacs. 3398This remote file name syntax originated in the XEmacs text editor.
3399A remote file name has the form 3399A remote file name has the form
3400@code{@trampfn{method,user@@host,path/to/file}}. The @code{method} 3400@code{@trampfn{method,user@@host,path/to/file}}. The @code{method}
3401and @code{user@@} parts are optional. 3401and @code{user@@} parts are optional.
diff --git a/doc/misc/viper.texi b/doc/misc/viper.texi
index b0deb31d108..0703667ecce 100644
--- a/doc/misc/viper.texi
+++ b/doc/misc/viper.texi
@@ -1842,7 +1842,7 @@ usually most effective:
1842(set-face-background viper-replace-overlay-face "yellow") 1842(set-face-background viper-replace-overlay-face "yellow")
1843@end smallexample 1843@end smallexample
1844For a complete list of colors available to you, evaluate the expression 1844For a complete list of colors available to you, evaluate the expression
1845@code{(x-defined-colors)}. (Type it in the buffer @file{*scratch*} and then 1845@code{(defined-colors)}. (Type it in the buffer @file{*scratch*} and then
1846hit the @kbd{C-j} key. 1846hit the @kbd{C-j} key.
1847 1847
1848@item viper-replace-overlay-cursor-color "Red" 1848@item viper-replace-overlay-cursor-color "Red"
@@ -2571,7 +2571,7 @@ The GNU Emacs Manual}, for more information on tags.
2571 2571
2572The following two commands are normally bound to a mouse click and are part 2572The following two commands are normally bound to a mouse click and are part
2573of Viper. They work only if Emacs runs as an application under X 2573of Viper. They work only if Emacs runs as an application under X
2574Windows (or under some other window system for which a port of GNU Emacs 20 2574Windows (or under some other window system for which a port of GNU Emacs
2575is available). Clicking the mouse when Emacs is invoked in an Xterm window 2575is available). Clicking the mouse when Emacs is invoked in an Xterm window
2576(using @code{emacs -nw}) will do no good. 2576(using @code{emacs -nw}) will do no good.
2577 2577