diff options
Diffstat (limited to 'doc/misc')
| -rw-r--r-- | doc/misc/auth.texi | 10 | ||||
| -rw-r--r-- | doc/misc/calc.texi | 2 | ||||
| -rw-r--r-- | doc/misc/efaq-w32.texi | 6 | ||||
| -rw-r--r-- | doc/misc/efaq.texi | 28 | ||||
| -rw-r--r-- | doc/misc/emacs-mime.texi | 6 | ||||
| -rw-r--r-- | doc/misc/eshell.texi | 82 | ||||
| -rw-r--r-- | doc/misc/gnus-faq.texi | 217 | ||||
| -rw-r--r-- | doc/misc/gnus.texi | 102 | ||||
| -rw-r--r-- | doc/misc/htmlfontify.texi | 10 | ||||
| -rw-r--r-- | doc/misc/idlwave.texi | 11 | ||||
| -rw-r--r-- | doc/misc/message.texi | 11 | ||||
| -rw-r--r-- | doc/misc/mh-e.texi | 13 | ||||
| -rw-r--r-- | doc/misc/tramp.texi | 4 | ||||
| -rw-r--r-- | doc/misc/viper.texi | 4 |
14 files changed, 133 insertions, 373 deletions
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 | |||
| 652 | read the GnuPG encrypted @file{.gpg} file first, before | 652 | read the GnuPG encrypted @file{.gpg} file first, before |
| 653 | the unencrypted file. | 653 | the unencrypted file. |
| 654 | 654 | ||
| 655 | In Emacs 23 or later there is an option @code{auto-encryption-mode} to | 655 | There is an option @code{auto-encryption-mode} to automatically |
| 656 | automatically decrypt @file{*.gpg} files. It is enabled by default. | 656 | decrypt @file{*.gpg} files. It is enabled by default. |
| 657 | If 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 | ||
| 664 | If you want your GnuPG passwords to be cached, set up @code{gpg-agent} | 658 | If you want your GnuPG passwords to be cached, set up @code{gpg-agent} |
| 665 | or EasyPG Assistant | 659 | or 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) | |||
| 930 | based when fonts are listed, which may let you differentiate between two | 930 | based when fonts are listed, which may let you differentiate between two |
| 931 | fonts with the same name and different technologies. | 931 | fonts with the same name and different technologies. |
| 932 | 932 | ||
| 933 | Starting with Emacs 23, the preferred font name format will be moving | 933 | Starting with Emacs 23, the preferred font name format is the simpler |
| 934 | to the simpler and more flexible fontconfig format. XLFD names will | 934 | and more flexible fontconfig format. XLFD names will continue to be |
| 935 | continue to be supported for backward compatibility. | 935 | supported for backward compatibility. |
| 936 | 936 | ||
| 937 | @example | 937 | @example |
| 938 | XLFD: -*-Courier New-normal-r-*-*-13-*-*-*-c-*-iso8859-1 | 938 | XLFD: -*-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 | |||
| 2891 | work around this. | 2891 | work around this. |
| 2892 | 2892 | ||
| 2893 | @cindex Just-In-Time syntax highlighting | 2893 | @cindex Just-In-Time syntax highlighting |
| 2894 | In Emacs 21 and later, turning on @code{font-lock-mode} automatically | 2894 | Turning on @code{font-lock-mode} automatically activates |
| 2895 | activates 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 |
| 2897 | portions of buffer until you actually need to see them, and can also | 2897 | until you actually need to see them, and can also fontify while Emacs |
| 2898 | fontify while Emacs is idle. This makes display of the visible portion | 2898 | is idle. This makes display of the visible portion of a buffer almost |
| 2899 | of a buffer almost instantaneous. For details about customizing | 2899 | instantaneous. For details about customizing @code{jit-lock-mode}, |
| 2900 | @code{jit-lock-mode}, type @kbd{C-h f jit-lock-mode @key{RET}}. | 2900 | type @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} |
| 2904 | In versions of Emacs before 21, different levels of decoration are | 2904 | Different levels of decoration are available, from slight to gaudy. |
| 2905 | available, from slight to gaudy. More decoration means you need to wait | 2905 | More decoration means you need to wait more time for a buffer to be |
| 2906 | more time for a buffer to be fontified (or a faster machine). To | 2906 | fontified (or a faster machine). To control how decorated your |
| 2907 | control how decorated your buffers should become, set the value of | 2907 | buffers 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: | |||
| 2985 | In many systems, @code{ls} is aliased to @samp{ls --color}, which | 2985 | In many systems, @code{ls} is aliased to @samp{ls --color}, which |
| 2986 | prints using ANSI color escape sequences. Emacs includes the | 2986 | prints 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 |
| 2988 | escape sequences. In Emacs 23.2 and later, the package is enabled by | 2988 | escape sequences. It is enabled by default. |
| 2989 | default; in earlier versions you can enable it by typing @kbd{M-x | ||
| 2990 | ansi-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 | ||
| 2992 | your 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 | |||
| 403 | predefined renderers are selected by the symbols @code{shr}, | 403 | predefined 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 |
| 406 | emacs-w3m}, @code{links}, @code{lynx}, @code{w3m-standalone} or | 406 | emacs-w3m}, @code{links}, @code{lynx}, or @code{w3m-standalone}. You |
| 407 | @code{html2text}. You can also specify a function, which will be | 407 | can also specify a function, which will be called with a |
| 408 | called 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 | |||
| 219 | external command. | 219 | external command. |
| 220 | 220 | ||
| 221 | The semicolon (@code{;}) can be used to separate multiple command | 221 | The semicolon (@code{;}) can be used to separate multiple command |
| 222 | invocations on a single line. A command invocation followed by an | 222 | invocations on a single line. You can also separate commands with |
| 223 | ampersand (@code{&}) will be run in the background. Eshell has no job | 223 | @code{&&} or @code{||}. When using @code{&&}, Eshell will execute the |
| 224 | control, so you can not suspend or background the current process, or | 224 | second command only if the first succeeds (i.e.@: has an exit |
| 225 | bring a background process into the foreground. That said, background | 225 | status of 0); with @code{||}, Eshell will execute the second command |
| 226 | processes invoked from Eshell can be controlled the same way as any | 226 | only if the first fails. |
| 227 | other background process in Emacs. | 227 | |
| 228 | A command invocation followed by an ampersand (@code{&}) will be run | ||
| 229 | in the background. Eshell has no job control, so you can not suspend | ||
| 230 | or background the current process, or bring a background process into | ||
| 231 | the foreground. That said, background processes invoked from Eshell | ||
| 232 | can be controlled the same way as any other background process in | ||
| 233 | Emacs. | ||
| 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 $$ |
| 887 | This is the result of the last command. In case of an external | 893 | This is the result of the last command. For external commands, it is |
| 888 | command, 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 $? |
| 892 | This variable contains the exit code of the last command. If the last | 899 | This variable contains the exit code of the last command. If the last |
| 893 | command was a Lisp function, it is 0 for successful completion or 1 | 900 | command was a Lisp function, it is 0 for successful completion or 1 |
| 894 | otherwise. | 901 | otherwise. If @code{eshell-lisp-form-nil-is-failure} is |
| 902 | non-@code{nil}, then a command with a Lisp form, like | ||
| 903 | @samp{(@var{command} @var{args}@dots{})}, that returns @code{nil} will | ||
| 904 | set 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 | |||
| 1008 | the function @code{pcomplete/MAJOR-MODE/COMMAND} to define completions | 1018 | the function @code{pcomplete/MAJOR-MODE/COMMAND} to define completions |
| 1009 | for a specific major mode. | 1019 | for a specific major mode. |
| 1010 | 1020 | ||
| 1011 | @node for loop | 1021 | @node Control Flow |
| 1012 | @section @code{for} loop | 1022 | @section Control Flow |
| 1013 | Because Eshell commands can not (easily) be combined with lisp forms, | 1023 | Because Eshell commands can not (easily) be combined with lisp forms, |
| 1014 | Eshell provides a command-oriented @command{for}-loop for convenience. | 1024 | Eshell provides command-oriented control flow statements for |
| 1015 | The syntax is as follows: | 1025 | convenience. |
| 1016 | 1026 | ||
| 1017 | @example | 1027 | Most of Eshell's control flow statements accept a @var{conditional}. |
| 1018 | @code{for VAR in TOKENS @{ command invocation(s) @}} | 1028 | This can take a few different forms. If @var{conditional} is a dollar |
| 1019 | @end example | 1029 | expansion, the condition is satisfied if the result is a |
| 1030 | non-@code{nil} value. If @var{conditional} is a @samp{@{ | ||
| 1031 | @var{subcommand} @}} or @samp{(@var{lisp form})}, the condition is | ||
| 1032 | satisfied 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} @} | ||
| 1038 | Evaluate @var{true-commands} if @var{conditional} is satisfied; | ||
| 1039 | otherwise, evaluate @var{false-commands}. | ||
| 1040 | |||
| 1041 | @item unless @var{conditional} @{ @var{false-commands} @} | ||
| 1042 | @itemx unless @var{conditional} @{ @var{false-commands} @} @{ @var{true-commands} @} | ||
| 1043 | Evaluate @var{false-commands} if @var{conditional} is not satisfied; | ||
| 1044 | otherwise, evaluate @var{true-commands}. | ||
| 1020 | 1045 | ||
| 1021 | where @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 | 1047 | Repeatedly evaluate @var{commands} so long as @var{conditional} is |
| 1023 | command if @samp{TOKENS} is replaced with @samp{@{ command invocation @}}. | 1048 | satisfied. |
| 1049 | |||
| 1050 | @item until @var{conditional} @{ @var{commands} @} | ||
| 1051 | Repeatedly evaluate @var{commands} until @var{conditional} is | ||
| 1052 | satisfied. | ||
| 1053 | |||
| 1054 | @item for @var{var} in @var{list}@dots{} @{ @var{commands} @} | ||
| 1055 | Iterate 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, | ||
| 1057 | treat 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 | |||
| 1816 | This happened a few times in Emacs 21, but has been irreproducible | ||
| 1817 | since. | ||
| 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. | |||
| 41 | Please submit features and suggestions to the | 40 | Please 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 | ||
| 52 | 2008-06-15: Adjust for message-fill-column. Add x-face-file. | ||
| 53 | Clarify difference between ding and gnu.emacs.gnus. Remove | ||
| 54 | reference to discontinued service. | ||
| 55 | |||
| 56 | @item | ||
| 57 | 2006-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. | |||
| 63 | This is the Gnus Frequently Asked Questions list. | 47 | This is the Gnus Frequently Asked Questions list. |
| 64 | 48 | ||
| 65 | Gnus is a Usenet Newsreader and Electronic Mail User Agent implemented | 49 | Gnus is a Usenet Newsreader and Electronic Mail User Agent implemented |
| 66 | as a part of Emacs. It's been around in some form for almost a decade | 50 | as a part of Emacs. It's been around in some form since the early |
| 67 | now, and has been distributed as a standard part of Emacs for much of | 51 | 1990s, and has been distributed as a standard part of Emacs for much |
| 68 | that time. Gnus 5 is the latest (and greatest) incarnation. The | 52 | of that time. Gnus 5 is the latest (and greatest) incarnation. The |
| 69 | original version was called GNUS, and was written by Masanobu UMEDA@. | 53 | original version was called GNUS, and was written by Masanobu UMEDA@. |
| 70 | When autumn crept up in '94, Lars Magne Ingebrigtsen grew bored and | 54 | When autumn crept up in 1994, Lars Magne Ingebrigtsen grew bored and |
| 71 | decided to rewrite Gnus. | 55 | decided to rewrite Gnus. |
| 72 | 56 | ||
| 73 | Its biggest strength is the fact that it is extremely | 57 | Its 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 | |||
| 84 | job with this FAQ before him. We would like to do the same: thanks, | 68 | job with this FAQ before him. We would like to do the same: thanks, |
| 85 | Justin! | 69 | Justin! |
| 86 | 70 | ||
| 87 | This version is much nicer than the unofficial hypertext | ||
| 88 | versions that are archived at Utrecht, Oxford, Smart Pages, Ohio | ||
| 89 | State, and other FAQ archives. See the resources question below | ||
| 90 | if you want information on obtaining it in another format. | ||
| 91 | |||
| 92 | The information contained here was compiled with the assistance | 71 | The information contained here was compiled with the assistance |
| 93 | of the Gnus development mailing list, and any errors or | 72 | of the Gnus development mailing list, and any errors or |
| 94 | misprints are the Gnus team's fault, sorry. | 73 | misprints 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 | ||
| 115 | Jingle please: Gnus 5.10 is released, get it while it's | 92 | The latest version of Gnus is bundled with Emacs. |
| 116 | hot! As well as the step in version number is rather | ||
| 117 | small, Gnus 5.10 has tons of new features which you | ||
| 118 | shouldn't miss. The current release (5.13) should be at | ||
| 119 | least 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 | ||
| 124 | What's new in 5.10? | ||
| 125 | |||
| 126 | @subsubheading Answer | ||
| 127 | |||
| 128 | First of all, you should have a look into the file | ||
| 129 | GNUS-NEWS in the toplevel directory of the Gnus tarball, | ||
| 130 | there the most important changes are listed. Here's a | ||
| 131 | short list of the changes I find especially | ||
| 132 | important/interesting: | ||
| 133 | |||
| 134 | @itemize @bullet | ||
| 135 | |||
| 136 | @item | ||
| 137 | Major rewrite of the Gnus agent, Gnus agent is now | ||
| 138 | active by default. | ||
| 139 | |||
| 140 | @item | ||
| 141 | Many new article washing functions for dealing with | ||
| 142 | ugly formatted articles. | ||
| 143 | |||
| 144 | @item | ||
| 145 | Anti Spam features. | ||
| 146 | |||
| 147 | @item | ||
| 148 | Message-utils now included in Gnus. | ||
| 149 | |||
| 150 | @item | ||
| 151 | New format specifiers for summary lines, e.g., %B for | ||
| 152 | a complex trn-style thread tree. | ||
| 153 | @end itemize | ||
| 154 | |||
| 155 | @node FAQ 1-3 | ||
| 156 | @subsubheading Question 1.3 | ||
| 157 | |||
| 158 | Where and how to get Gnus? | 97 | Where and how to get Gnus? |
| 159 | 98 | ||
| 160 | @subsubheading Answer | 99 | @subsubheading Answer |
| 161 | 100 | ||
| 162 | Gnus is bundled with Emacs. | 101 | Gnus 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 | ||
| 167 | I sometimes read references to No Gnus and Oort Gnus, | 106 | I sometimes read references to No Gnus and Oort Gnus, |
| 168 | what are those? | 107 | what are those? |
| 169 | 108 | ||
| 170 | @subsubheading Answer | 109 | @subsubheading Answer |
| 171 | 110 | ||
| 172 | Oort Gnus was the name of the development version of | 111 | Oort Gnus was the name of the development version of Gnus, which |
| 173 | Gnus, which became Gnus 5.10 in autumn 2003. No Gnus is | 112 | became Gnus 5.10 in autumn 2003. No Gnus was the name of the |
| 174 | the name of the current development version which will | 113 | development version that became Gnus 5.12. |
| 175 | once become Gnus 5.12 or Gnus 6. (If you're wondering why | ||
| 176 | not 5.11, the odd version numbers are normally used for | ||
| 177 | the Gnus versions bundled with Emacs) | ||
| 178 | |||
| 179 | @node FAQ 1-5 | ||
| 180 | @subsubheading Question 1.5 | ||
| 181 | |||
| 182 | Which version of Emacs do I need? | ||
| 183 | |||
| 184 | @subsubheading Answer | ||
| 185 | |||
| 186 | Gnus 5.13 requires an Emacs version that is greater than or equal | ||
| 187 | to Emacs 23.1, although there are some features that | ||
| 188 | only 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 | |||
| 718 | all articles (Warning: Both settings enlarge the amount of data which is | 643 | all articles (Warning: Both settings enlarge the amount of data which is |
| 719 | fetched when you enter a group and slow down the process of entering a group). | 644 | fetched when you enter a group and slow down the process of entering a group). |
| 720 | 645 | ||
| 721 | If you already use Gnus 5.10, you can say | 646 | You can say @samp{/o N} in the summary buffer to load the last N |
| 722 | @samp{/o N} | 647 | messages. |
| 723 | In summary buffer to load the last N messages, this feature is not available in 5.8.8 | ||
| 724 | 648 | ||
| 725 | If you don't want all old messages, but the parent of the message you're just reading, | 649 | If you don't want all old messages, but the parent of the message you're just reading, |
| 726 | you can say @samp{^}, if you want to retrieve the whole thread | 650 | you 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 | ||
| 823 | Only if you use Gnus 5.10 or younger. In this case you've got the | 747 | You've got the choice between @samp{shr}, @samp{w3m}, @samp{links}, |
| 824 | choice between shr, w3m, links, lynx and html2text, which | 748 | and @samp{lynx}. Which one is used is specified in the variable |
| 825 | one is used can be specified in the variable | 749 | @code{mm-text-html-renderer}, so if you want links to render your |
| 826 | mm-text-html-renderer, so if you want links to render your | 750 | mail, say: |
| 827 | mail 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'' | |||
| 847 | the dumb quoting used by many users of Microsoft products | 770 | the 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. |
| 849 | See @samp{W Y C-h} or have a look at the menus for | 772 | See @samp{W Y C-h} or have a look at the menus for |
| 850 | other deuglifications). Outlook deuglify is only available since | 773 | other deuglifications). |
| 851 | Gnus 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 | |||
| 1038 | tabulators which allow you a summary in table form, but | 960 | tabulators which allow you a summary in table form, but |
| 1039 | sadly hard tabulators are broken in 5.8.8. | 961 | sadly hard tabulators are broken in 5.8.8. |
| 1040 | 962 | ||
| 1041 | Since 5.10, Gnus offers you some very nice new specifiers, | 963 | Gnus offers you some very nice new specifiers, |
| 1042 | e.g., %B which draws a thread-tree and %&user-date which | 964 | e.g., %B which draws a thread-tree and %&user-date which |
| 1043 | gives you a date where the details are dependent of the | 965 | gives you a date where the details are dependent of the |
| 1044 | articles age. Here's an example which uses both: | 966 | articles 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 | ||
| 1247 | There are other ways, but you should use posting styles | 1169 | There are other ways, but you should use posting styles |
| 1248 | for this. (See below why). | 1170 | for this. (See below why.) |
| 1249 | This example should make the syntax clear: | 1171 | This 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 | ||
| 1332 | You can use ispell.el to spell-check stuff in Emacs. So the | 1254 | You can use ispell.el to spell-check stuff in Emacs, and flyspell.el |
| 1333 | first thing to do is to make sure that you've got either | 1255 | for 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} | 1256 | sure that you've got either |
| 1335 | or @uref{http://aspell.net, aspell} | 1257 | @uref{https://hunspell.github.io/, hunspell}, |
| 1336 | installed and in your Path. Then you need | 1258 | @uref{https://www.cs.hmc.edu/~geoff/ispell.html, ispell} or |
| 1337 | ispell.el | 1259 | @uref{http://aspell.net, aspell} installed and in your Path. |
| 1338 | and for on-the-fly spell-checking | ||
| 1339 | @uref{https://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}. | ||
| 1340 | Ispell.el is shipped with Emacs, | ||
| 1341 | flyspell.el is shipped with Emacs, so there should be no need to install them | ||
| 1342 | manually. | ||
| 1343 | 1260 | ||
| 1344 | Ispell.el assumes you use ispell, if you choose aspell say | 1261 | Ispell.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 | ||
| 1497 | in @file{~/.gnus.el}. If you use Gnus 5.10, you can simply add an entry | 1414 | in @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 | ||
| 1504 | to gnus-posting-styles. | 1421 | to @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 | ||
| 1522 | if you already use Gnus 5.10, if you still use 5.8.8 or | ||
| 1523 | 5.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 | ||
| 1544 | Since 5.10 Gnus doesn't generate a sender header by | 1446 | Gnus doesn't generate a sender header by default. |
| 1545 | default. 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." | |||
| 1729 | You can now say @samp{M-x | 1624 | You can now say @samp{M-x |
| 1730 | my-archive-article} in summary buffer to | 1625 | my-archive-article} in summary buffer to |
| 1731 | archive the article under the cursor in a nnml | 1626 | archive the article under the cursor in a nnml |
| 1732 | group. (Change nnml to your preferred back end) | 1627 | group. (Change nnml to your preferred back end.) |
| 1733 | 1628 | ||
| 1734 | Of course you can also make sure the cache is enabled by saying | 1629 | Of 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 | |||
| 1756 | the raw message, look for the message-id, and say | 1651 | the 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 |
| 1758 | summary buffer. | 1653 | summary buffer. |
| 1759 | Since Gnus 5.10 there's also a Gnus interface for | 1654 | There's a Gnus interface for |
| 1760 | groups.google.com which you can call with | 1655 | groups.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 | |||
| 1770 | gnus-summary-limit-to-foo functions, which can help you, | 1665 | gnus-summary-limit-to-foo functions, which can help you, |
| 1771 | too. | 1666 | too. |
| 1772 | 1667 | ||
| 1773 | Of course you can also use grep to search through your | ||
| 1774 | local mail, but this is both slow for big archives and | ||
| 1775 | inconvenient since you are not displaying the found mail | ||
| 1776 | in Gnus. Here nnir comes into action. Nnir is a front end | ||
| 1777 | to search engines like swish-e or swish++ and | ||
| 1778 | others. You index your mail with one of those search | ||
| 1779 | engines and with the help of nnir you can search through | ||
| 1780 | the indexed mail and generate a temporary group with all | ||
| 1781 | messages which met your search criteria. If this sounds | ||
| 1782 | cool 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/} | ||
| 1787 | or | ||
| 1788 | @end ignore | ||
| 1789 | @uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}. | ||
| 1790 | Instructions 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? | |||
| 1937 | The Gnus agent is part of Gnus, it allows you to fetch | 1813 | The Gnus agent is part of Gnus, it allows you to fetch |
| 1938 | mail and news and store them on disk for reading them | 1814 | mail and news and store them on disk for reading them |
| 1939 | later when you're offline. It kind of mimics offline | 1815 | later when you're offline. It kind of mimics offline |
| 1940 | newsreaders like Forte Agent. If you want to use | 1816 | newsreaders like Forte Agent. It is enabled by default. |
| 1941 | the Agent place the following in @file{~/.gnus.el} if you are | ||
| 1942 | still using 5.8.8 or 5.9 (it's the default since 5.10): | ||
| 1943 | 1817 | ||
| 1944 | @example | 1818 | You've got to select the servers whose groups can be |
| 1945 | (setq gnus-agent t) | ||
| 1946 | @end example | ||
| 1947 | @noindent | ||
| 1948 | |||
| 1949 | Now you've got to select the servers whose groups can be | ||
| 1950 | stored locally. To do this, open the server buffer | 1819 | stored locally. To do this, open the server buffer |
| 1951 | (that is press @samp{^} while in the | 1820 | (that is press @samp{^} while in the |
| 1952 | group buffer). Now select a server by moving point to | 1821 | group 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 | ||
| 2164 | A speed killer is setting the variable | 2033 | A speed killer is setting the variable @code{gnus-fetch-old-headers} |
| 2165 | gnus-fetch-old-headers to anything different from @code{nil}, | 2034 | to anything different from @code{nil}, so don't do this if speed is an |
| 2166 | so don't do this if speed is an issue. | 2035 | issue. |
| 2167 | 2036 | ||
| 2168 | You could increase the value of gc-cons-threshold | 2037 | You could increase the value of @code{gc-cons-threshold} by saying |
| 2169 | by saying something like | 2038 | something 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 | |||
| 2204 | whatever-server which offers Gnus a standardized interface | 2073 | whatever-server which offers Gnus a standardized interface |
| 2205 | to functions like "get message", "get Headers" etc. | 2074 | to functions like "get message", "get Headers" etc. |
| 2206 | 2075 | ||
| 2207 | @item Emacs | ||
| 2208 | When the term Emacs is used in this FAQ, it means GNU | ||
| 2209 | Emacs. | ||
| 2210 | |||
| 2211 | @item Message | 2076 | @item Message |
| 2212 | In this FAQ message means either a mail or a posting to a | 2077 | In this FAQ message means either a mail or a posting to a |
| 2213 | Usenet Newsgroup or to some other fancy back end, no matter | 2078 | Usenet 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 |
| 8622 | Hook run before sending a message to @code{uudecode}. | 8620 | Hook 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 | ||
| 8627 | Non-@code{nil} means that @code{gnus-uu} will ignore the viewing | ||
| 8628 | commands defined by the rule variables and just fudge a @acronym{MIME} | ||
| 8629 | content 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 |
| 8634 | Non-@code{nil} means that @code{gnus-uu}, when asked to save without | 8624 | Non-@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 |
| 9365 | Use @uref{https://lynx.browser.org/, Lynx}. | 9355 | Use @uref{https://lynx.browser.org/, Lynx}. |
| 9366 | 9356 | ||
| 9367 | @item html2text | ||
| 9368 | Use 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 |
| 15441 | set @code{mail-source-delete-incoming} to @code{nil} and call | 15428 | set @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 | ||
| 15444 | and @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 |
| 21963 | files, so just change to MH or Maildir already... However, if you're | 21948 | files, so just change to MH or Maildir already... However, if you're |
| 21964 | really, really passionate about using mbox, you might want to look into | 21949 | really, really passionate about using mbox, you might want to look into |
| 21965 | the package @file{mairix.el}, which comes with Emacs 23. | 21950 | the 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 | |||
| 27035 | speeds up many functions), and changing the alist directly will lead to | 27018 | speeds up many functions), and changing the alist directly will lead to |
| 27036 | peculiar results. | 27019 | peculiar results. |
| 27037 | 27020 | ||
| 27038 | @cindex hilit19 | ||
| 27039 | @cindex highlighting | ||
| 27040 | Old hilit19 code does not work at all. In fact, you should probably | ||
| 27041 | remove all hilit code from all Gnus hooks | ||
| 27042 | (@code{gnus-group-prepare-hook} and @code{gnus-summary-prepare-hook}). | ||
| 27043 | Gnus provides various integrated functions for highlighting. These are | ||
| 27044 | faster and more accurate. To make life easier for everybody, Gnus will | ||
| 27045 | by default remove all hilit calls from all hilit hooks. Uncleanliness! | ||
| 27046 | Away! | ||
| 27047 | |||
| 27048 | Packages like @code{expire-kill} will no longer work. As a matter of | 27021 | Packages like @code{expire-kill} will no longer work. As a matter of |
| 27049 | fact, you should probably remove all old @sc{gnus} packages (and other | 27022 | fact, you should probably remove all old @sc{gnus} packages (and other |
| 27050 | code) when you start using Gnus. More likely than not, Gnus already | 27023 | code) 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 | |||
| 27147 | know. | 27120 | know. |
| 27148 | 27121 | ||
| 27149 | 27122 | ||
| 27150 | @node Emacsen | ||
| 27151 | @subsection Emacsen | ||
| 27152 | @cindex Emacsen | ||
| 27153 | @cindex Mule | ||
| 27154 | @cindex Emacs | ||
| 27155 | |||
| 27156 | This version of Gnus should work on: | ||
| 27157 | |||
| 27158 | @itemize @bullet | ||
| 27159 | |||
| 27160 | @item | ||
| 27161 | Emacs 23.1 and up. | ||
| 27162 | |||
| 27163 | @end itemize | ||
| 27164 | |||
| 27165 | This Gnus version will absolutely not work on any Emacsen older than | ||
| 27166 | that. Not reliably, at least. Older versions of Gnus may work on older | ||
| 27167 | Emacs versions. Particularly, Gnus 5.10.8 should also work on Emacs | ||
| 27168 | 20.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 | |||
| 27176 | Gnus is developed in a two-phased cycle. The first phase involves much | ||
| 27177 | discussion on the development mailing list @samp{ding@@gnus.org}, where people | ||
| 27178 | propose changes and new features, post patches and new back ends. This | ||
| 27179 | phase is called the @dfn{alpha} phase, since the Gnusae released in this | ||
| 27180 | phase are @dfn{alpha releases}, or (perhaps more commonly in other | ||
| 27181 | circles) @dfn{snapshots}. During this phase, Gnus is assumed to be | ||
| 27182 | unstable and should not be used by casual users. Gnus alpha releases | ||
| 27183 | have names like ``Oort Gnus'' and ``No Gnus''. @xref{Gnus Versions}. | ||
| 27184 | |||
| 27185 | After futzing around for 10--100 alpha releases, Gnus is declared | ||
| 27186 | @dfn{frozen}, and only bug fixes are applied. Gnus loses the prefix, | ||
| 27187 | and is called things like ``Gnus 5.10.1'' instead. Normal people are | ||
| 27188 | supposed 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 | ||
| 27190 | mailing list @samp{info-gnus-english@@gnu.org} which is carried on Gmane | ||
| 27191 | as @samp{gmane.emacs.gnus.user}. These releases are finally integrated | ||
| 27192 | in Emacs. | ||
| 27193 | |||
| 27194 | @cindex Incoming* | ||
| 27195 | @vindex mail-source-delete-incoming | ||
| 27196 | Some variable defaults differ between alpha Gnusae and released Gnusae, | ||
| 27197 | in particular, @code{mail-source-delete-incoming}. This is to prevent | ||
| 27198 | lossage of mail if an alpha release hiccups while handling the mail. | ||
| 27199 | @xref{Mail Source Customization}. | ||
| 27200 | |||
| 27201 | The division of discussion between the ding mailing list and the Gnus | ||
| 27202 | newsgroup is not purely based on publicity concerns. It's true that | ||
| 27203 | having people write about the horrible things that an alpha Gnus release | ||
| 27204 | can do (sometimes) in a public forum may scare people off, but more | ||
| 27205 | importantly, talking about new experimental features that have been | ||
| 27206 | introduced may confuse casual users. New features are frequently | ||
| 27207 | introduced, fiddled with, and judged to be found wanting, and then | ||
| 27208 | either discarded or totally rewritten. People reading the mailing list | ||
| 27209 | usually keep up with these rapid changes, while people on the newsgroup | ||
| 27210 | can't be assumed to do so. | ||
| 27211 | |||
| 27212 | So if you have problems with or questions about the alpha versions, | ||
| 27213 | direct those to the ding mailing list @samp{ding@@gnus.org}. This list | ||
| 27214 | is also available on Gmane as @samp{gmane.emacs.gnus.general}. | ||
| 27215 | |||
| 27216 | @cindex Incoming* | ||
| 27217 | @vindex mail-source-delete-incoming | ||
| 27218 | Some variable defaults differ between alpha Gnusae and released Gnusae, | ||
| 27219 | in particular, @code{mail-source-delete-incoming}. This is to prevent | ||
| 27220 | lossage 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 @@ | |||
| 10 | This manual documents Htmlfontify, a source code -> crosslinked + | 10 | This manual documents Htmlfontify, a source code -> crosslinked + |
| 11 | formatted + syntax colorized html transformer. | 11 | formatted + syntax colorized html transformer. |
| 12 | 12 | ||
| 13 | Copyright @copyright{} 2002--2003, 2013--2022 Free Software Foundation, | 13 | Copyright @copyright{} 2002--2022 Free Software Foundation, Inc. |
| 14 | Inc. | ||
| 15 | 14 | ||
| 16 | @quotation | 15 | @quotation |
| 17 | Permission is granted to copy, distribute and/or modify this document | 16 | Permission 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 |
| 1543 | GNU Emacs 20.7+ or 21.1+ | ||
| 1544 | |||
| 1545 | Other versions may work---these have been used successfully by the | ||
| 1546 | author. If you intend to use Htmlfontify in batch mode, 21.1+ is | ||
| 1547 | pretty much required. | ||
| 1548 | |||
| 1549 | @item | ||
| 1550 | A copy of etags (exuberant-ctags or GNU etags). Htmlfontify attempts | 1542 | A copy of etags (exuberant-ctags or GNU etags). Htmlfontify attempts |
| 1551 | to autodetect the version you have and customize itself accordingly, | 1543 | to autodetect the version you have and customize itself accordingly, |
| 1552 | but you should be able to override this. | 1544 | but 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 |
| 4117 | there, or start Emacs and IDLWAVE from the shell. | 4117 | there, 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: | ||
| 4120 | cl-builtin-gethash} on completion or routine info.} | ||
| 4121 | |||
| 4122 | This error arises if you upgraded Emacs from 20.x to 21.x without | ||
| 4123 | re-installing IDLWAVE@. Old Emacs and new Emacs are not byte-compatible | ||
| 4124 | in compiled lisp files. Presumably, you kept the original .elc files in | ||
| 4125 | place, and this is the source of the error. If you recompile (or just | ||
| 4126 | "make; make install") from source, it should resolve this problem. | ||
| 4127 | Another 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 |
| 4131 | windows on my desktop.} | 4120 | windows 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 |
| 1154 | to the S/MIME implementation is EasyPG (@pxref{Top,,EasyPG Assistant | 1154 | to the S/MIME implementation is EasyPG (@pxref{Top,,EasyPG Assistant |
| 1155 | User's Manual, epa, EasyPG Assistant User's Manual}), which has been | 1155 | User's Manual, epa, EasyPG Assistant User's Manual}), which is |
| 1156 | included in Emacs since version 23 and which relies on the command | 1156 | included in Emacs and relies on the command line tool @command{gpgsm} |
| 1157 | line tool @command{gpgsm} provided by @acronym{GnuPG}. That tool | 1157 | provided by @acronym{GnuPG}. That tool implements certificate |
| 1158 | implements certificate management, including certificate revocation | 1158 | management, including certificate revocation and expiry, while such |
| 1159 | and expiry, while such tasks need to be performed manually, if OpenSSL | 1159 | tasks need to be performed manually, if OpenSSL is used. |
| 1160 | is used. | ||
| 1161 | 1160 | ||
| 1162 | The choice between EasyPG and OpenSSL is controlled by the variable | 1161 | The 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 | |||
| 213 | them. | 213 | them. |
| 214 | 214 | ||
| 215 | The MH-E package is distributed with Emacs@footnote{Version | 215 | The 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. |
| 217 | Emacs 23 and higher. It is compatible with MH versions 6.8.4 and | 217 | It is compatible with MH versions 6.8.4 and |
| 218 | higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you | 218 | higher, all versions of nmh, and GNU mailutils 1.0 and higher}, so you |
| 219 | shouldn't have to do anything special to use it. Gnus is also | 219 | shouldn't have to do anything special to use it. Gnus is also |
| 220 | required; version 5.10 or higher is recommended. This manual covers | 220 | required; 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 | ||
| 1490 | You can use @command{xbuffy} to automate the incorporation of this | 1490 | You can use @command{xbuffy} to automate the incorporation of this |
| 1491 | mail using the Emacs 23 command @command{emacsclient} as follows: | 1491 | mail using the Emacs command @command{emacsclient} as follows: |
| 1492 | 1492 | ||
| 1493 | @smallexample | 1493 | @smallexample |
| 1494 | box ~/mail/mh-e | 1494 | box ~/mail/mh-e |
| @@ -2553,13 +2553,6 @@ produces pretty nice output, and it highlights links. It renders | |||
| 2553 | @samp{–} and @samp{®} okay. It sometimes fails to wrap lines | 2553 | @samp{–} and @samp{®} okay. It sometimes fails to wrap lines |
| 2554 | properly. It always downloads remote images. | 2554 | properly. It always downloads remote images. |
| 2555 | @c ------------------------- | 2555 | @c ------------------------- |
| 2556 | @cindex browser, @samp{html2text} | ||
| 2557 | @cindex @samp{html2text} | ||
| 2558 | @item @samp{html2text} | ||
| 2559 | The @samp{html2text} browser requires an external program. Some users | ||
| 2560 | have reported problems with it, such as filling the entire message as | ||
| 2561 | if 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 | ||
| 3386 | The remote file name syntax is similar to the syntax used by Ange FTP@. | 3386 | This remote file name syntax is similar to the syntax used by Ange FTP@. |
| 3387 | A remote file name has the form | 3387 | A 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 |
| 3398 | The remote file name syntax is similar to the syntax used by XEmacs. | 3398 | This remote file name syntax originated in the XEmacs text editor. |
| 3399 | A remote file name has the form | 3399 | A 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} |
| 3401 | and @code{user@@} parts are optional. | 3401 | and @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 |
| 1844 | For a complete list of colors available to you, evaluate the expression | 1844 | For 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 |
| 1846 | hit the @kbd{C-j} key. | 1846 | hit 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 | ||
| 2572 | The following two commands are normally bound to a mouse click and are part | 2572 | The following two commands are normally bound to a mouse click and are part |
| 2573 | of Viper. They work only if Emacs runs as an application under X | 2573 | of Viper. They work only if Emacs runs as an application under X |
| 2574 | Windows (or under some other window system for which a port of GNU Emacs 20 | 2574 | Windows (or under some other window system for which a port of GNU Emacs |
| 2575 | is available). Clicking the mouse when Emacs is invoked in an Xterm window | 2575 | is 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 | ||