summaryrefslogtreecommitdiff
path: root/doc/misc/gnus-news.texi
blob: d1e83a79038747a07c8220bba916293b9632fa6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
@c -*-texinfo-*-

@c Copyright (C) 2004-2016 Free Software Foundation, Inc.

@c    Permission is granted to anyone to make or distribute verbatim copies
@c    of this document as received, in any medium, provided that the
@c    copyright notice and this permission notice are preserved,
@c    thus giving the recipient permission to redistribute in turn.

@c    Permission is granted to distribute modified versions
@c    of this document, or of portions of it,
@c    under the above conditions, provided also that they
@c    carry prominent notices stating who last changed them.

@c This file contains a list of news features Gnus.  It is supposed to be
@c included in 'gnus.texi'.  'GNUS-NEWS' is automatically generated from
@c this file (see 'gnus-news.el').

@itemize @bullet

@item Supported Emacs versions
The following Emacs versions are supported by No Gnus:
@itemize @bullet

@item Emacs 22 and up
@item XEmacs 21.4
@item XEmacs 21.5
@item SXEmacs

@end itemize

@item Installation changes

@itemize @bullet
@item Upgrading from previous (stable) version if you have used No Gnus.

If you have tried No Gnus (the unstable Gnus branch leading to this
release) but went back to a stable version, be careful when upgrading
to this version.  In particular, you will probably want to remove the
@file{~/News/marks} directory (perhaps selectively), so that flags are
read from your @file{~/.newsrc.eld} instead of from the stale marks
file, where this release will store flags for nntp.  See a later entry
for more information about nntp marks.  Note that downgrading isn't
safe in general.

@item Incompatibility when switching from Emacs 23 to Emacs 22 
In Emacs 23, Gnus uses Emacs's new internal coding system @code{utf-8-emacs}
for saving articles drafts and @file{~/.newsrc.eld}.  These files may not
be read correctly in Emacs 22 and below.  If you want to use Gnus across
different Emacs versions, you may set @code{mm-auto-save-coding-system}
to @code{emacs-mule}.
@c FIXME: Untested.  (Or did anyone test it?)
@c Cf. http://thread.gmane.org/gmane.emacs.gnus.general/66251/focus=66344

@item Lisp files are now installed in @file{.../site-lisp/gnus/} by default.
It defaulted to @file{.../site-lisp/} formerly.  In addition to this,
the new installer issues a warning if other Gnus installations which
will shadow the latest one are detected.  You can then remove those
shadows manually or remove them using @code{make
remove-installed-shadows}.

@item The installation directory name is allowed to have spaces and/or tabs.
@end itemize

@item New packages and libraries within Gnus

@itemize @bullet

@item New version of @code{nnimap}

@code{nnimap} has been reimplemented in a mostly-compatible way.  See
the Gnus manual for a description of the new interface.  In
particular, @code{nnimap-inbox} and the client side split method has
changed.

@item Gnus includes the Emacs Lisp @acronym{SASL} library.

This provides a clean @acronym{API} to @acronym{SASL} mechanisms from
within Emacs.  The user visible aspects of this, compared to the earlier
situation, include support for @acronym{DIGEST}-@acronym{MD5} and
@acronym{NTLM}.   @xref{Top, ,Emacs SASL, sasl, Emacs SASL}.

@item ManageSieve connections uses the @acronym{SASL} library by default.

The primary change this brings is support for @acronym{DIGEST-MD5} and
@acronym{NTLM}, when the server supports it.

@item Gnus includes a password cache mechanism in password.el.

It is enabled by default (see @code{password-cache}), with a short
timeout of 16 seconds (see @code{password-cache-expiry}).  If
@acronym{PGG} is used as the @acronym{PGP} back end, the @acronym{PGP}
passphrase is managed by this mechanism.  Passwords for ManageSieve
connections are managed by this mechanism, after querying the user
about whether to do so.

@item Using EasyPG with Gnus
When EasyPG, is available, Gnus will use it instead of @acronym{PGG}.
EasyPG is an Emacs user interface to GNU Privacy Guard.  @xref{Top,
,EasyPG Assistant user's manual, epa, EasyPG Assistant user's manual}.
EasyPG is included in Emacs 23 and available separately as well.
@end itemize

@item Changes in group mode
@c ************************

@itemize @bullet

@item
Symbols like @code{gcc-self} now have the same precedence rules in
@code{gnus-parameters} as other ``real'' variables: The last match
wins instead of the first match.

@item
Old intermediate incoming mail files (@file{Incoming*}) are deleted
after a couple of days, not immediately.  @xref{Mail Source
Customization}.
(New in Gnus 5.10.10 / No Gnus 0.8)
@c This entry is also present in the node "Oort Gnus".

@end itemize

@item Changes in summary and article mode

@itemize @bullet

@item There's now only one variable that determines how @acronym{HTML}
is rendered: @code{mm-text-html-renderer}.

@item Gnus now supports sticky article buffers.  Those are article buffers
that are not reused when you select another article.  @xref{Sticky
Articles}.

@c @item Bookmarks
@c FIXME: To be added

@item Gnus can selectively display @samp{text/html} articles
with a WWW browser with @kbd{K H}.  @xref{MIME Commands}.

@c gnus-registry-marks
@c FIXME: To be added

@item International host names (@acronym{IDNA}) can now be decoded
inside article bodies using @kbd{W i}
(@code{gnus-summary-idna-message}).  This requires that GNU Libidn
(@url{http://www.gnu.org/software/libidn/}) has been installed.
@c FIXME: Also mention @code{message-use-idna}?

@item The non-@acronym{ASCII} group names handling has been much
improved.  The back ends that fully support non-@acronym{ASCII} group
names are now @code{nntp}, @code{nnml}, and @code{nnrss}.  Also the
agent, the cache, and the marks features work with those back ends.
@xref{Non-ASCII Group Names}.

@item Gnus now displays @acronym{DNS} master files sent as text/dns
using dns-mode.

@item Gnus supports new limiting commands in the Summary buffer:
@kbd{/ r} (@code{gnus-summary-limit-to-replied}) and @kbd{/ R}
(@code{gnus-summary-limit-to-recipient}).  @xref{Limiting}.

@item You can now fetch all ticked articles from the server using
@kbd{Y t} (@code{gnus-summary-insert-ticked-articles}).  @xref{Summary
Generation Commands}.

@item Gnus supports a new sort command in the Summary buffer:
@kbd{C-c C-s C-t} (@code{gnus-summary-sort-by-recipient}).  @xref{Summary
Sorting}.

@item @acronym{S/MIME} now features @acronym{LDAP} user certificate searches.
You need to configure the server in @code{smime-ldap-host-list}.

@item URLs inside Open@acronym{PGP} headers are retrieved and imported
to your PGP key ring when you click on them.

@item
Picons can be displayed right from the textual address, see
@code{gnus-picon-style}.  @xref{Picons}.

@item @acronym{ANSI} @acronym{SGR} control sequences can be transformed
using @kbd{W A}.

@acronym{ANSI} sequences are used in some Chinese hierarchies for
highlighting articles (@code{gnus-article-treat-ansi-sequences}).

@item Gnus now MIME decodes articles even when they lack "MIME-Version" header.
This changes the default of @code{gnus-article-loose-mime}.

@item @code{gnus-decay-scores} can be a regexp matching score files.
For example, set it to @samp{\\.ADAPT\\'} and only adaptive score files
will be decayed.  @xref{Score Decays}.

@item Strings prefixing to the @code{To} and @code{Newsgroup} headers in
summary lines when using @code{gnus-ignored-from-addresses} can be
customized with @code{gnus-summary-to-prefix} and
@code{gnus-summary-newsgroup-prefix}.  @xref{To From Newsgroups}.

@item You can replace @acronym{MIME} parts with external bodies.
See @code{gnus-mime-replace-part} and @code{gnus-article-replace-part}.
@xref{MIME Commands}, @ref{Using MIME}.

@item
The option @code{mm-fill-flowed} can be used to disable treatment of
format=flowed messages.  Also, flowed text is disabled when sending
inline @acronym{PGP} signed messages.  @xref{Flowed text, ,Flowed text,
emacs-mime, The Emacs MIME Manual}.  (New in Gnus 5.10.7)
@c This entry is also present in the node "Oort Gnus".

@item Now the new command @kbd{S W}
(@code{gnus-article-wide-reply-with-original}) for a wide reply in the
article buffer yanks a text that is in the active region, if it is set,
as well as the @kbd{R} (@code{gnus-article-reply-with-original}) command.
Note that the @kbd{R} command in the article buffer no longer accepts a
prefix argument, which was used to make it do a wide reply.
@xref{Article Keymap}.

@item The new command @kbd{C-h b}
(@code{gnus-article-describe-bindings}) used in the article buffer now
shows not only the article commands but also the real summary commands
that are accessible from the article buffer.

@end itemize

@item Changes in Message mode

@itemize @bullet
@item Gnus now defaults to saving all outgoing messages in per-month
nnfolder archives.

@item Gnus now supports the ``hashcash'' client puzzle anti-spam mechanism.
Use @code{(setq message-generate-hashcash t)} to enable.
@xref{Hashcash}.

@item You can now drag and drop attachments to the Message buffer.
See @code{mml-dnd-protocol-alist} and @code{mml-dnd-attach-options}.
@xref{MIME, ,MIME, message, Message Manual}.

@item The option @code{message-yank-empty-prefix} now controls how
empty lines are prefixed in cited text.  @xref{Insertion Variables,
,Insertion Variables, message, Message Manual}.

@item Gnus uses narrowing to hide headers in Message buffers.
The @code{References} header is hidden by default.  To make all
headers visible, use @code{(setq message-hidden-headers nil)}.
@xref{Message Headers, ,Message Headers, message, Message Manual}.

@item You can highlight different levels of citations like in the
article buffer.  See @code{gnus-message-highlight-citation}.

@item @code{auto-fill-mode} is enabled by default in Message mode.
See @code{message-fill-column}.  @xref{Various Message Variables, ,
Message Headers, message, Message Manual}.

@item You can now store signature files in a special directory
named @code{message-signature-directory}.

@item The option @code{message-citation-line-format} controls the format
of the "Whomever writes:" line.  You need to set
@code{message-citation-line-function} to
@code{message-insert-formatted-citation-line} as well.
@end itemize

@item Changes in Browse Server mode

@itemize @bullet
@item Gnus' sophisticated subscription methods are now available in
Browse Server buffers as well using the variable
@code{gnus-browse-subscribe-newsgroup-method}.

@end itemize


@item Changes in back ends

@itemize @bullet
@item The nntp back end stores article marks in @file{~/News/marks}.

The directory can be changed using the (customizable) variable
@code{nntp-marks-directory}, and marks can be disabled using the
(back end) variable @code{nntp-marks-is-evil}.  The advantage of this
is that you can copy @file{~/News/marks} (using rsync, scp or
whatever) to another Gnus installation, and it will realize what
articles you have read and marked.  The data in @file{~/News/marks}
has priority over the same data in @file{~/.newsrc.eld}.

@item
You can import and export your @acronym{RSS} subscriptions from
@acronym{OPML} files.  @xref{RSS}.

@item @acronym{IMAP} identity (@acronym{RFC} 2971) is supported.

By default, Gnus does not send any information about itself, but you can
customize it using the variable @code{nnimap-id}.

@item The @code{nnrss} back end now supports multilingual text.
Non-@acronym{ASCII} group names for the @code{nnrss} groups are also
supported.  @xref{RSS}.

@item Retrieving mail with @acronym{POP3} is supported over @acronym{SSL}/@acronym{TLS} and with StartTLS.

@item The nnml back end allows other compression programs beside @file{gzip}
for compressed message files.  @xref{Mail Spool}.

@item The nnml back end supports group compaction.

This feature, accessible via the functions
@code{gnus-group-compact-group} (@kbd{G z} in the group buffer) and
@code{gnus-server-compact-server} (@kbd{z} in the server buffer)
renumbers all articles in a group, starting from 1 and removing gaps.
As a consequence, you get a correct total article count (until
messages are deleted again).

@c @item nnmairix.el
@c FIXME

@c @item nnir.el
@c FIXME

@end itemize

@item Appearance
@c Maybe it's not worth to separate this from "Miscellaneous"?

@itemize @bullet

@item The tool bar has been updated to use GNOME icons.
You can also customize the tool bars: @kbd{M-x customize-apropos RET
-tool-bar$} should get you started.  (Only for Emacs, not in XEmacs.)
@c FIXME: Document this in the manual

@item The tool bar icons are now (de)activated correctly
in the group buffer, see the variable @code{gnus-group-update-tool-bar}.
Its default value depends on your Emacs version.
@c FIXME: Document this in the manual

@item You can change the location of XEmacs's toolbars in Gnus buffers.
See @code{gnus-use-toolbar} and @code{message-use-toolbar}.

@end itemize

@item Miscellaneous changes

@itemize @bullet
@item Having edited the select-method for the foreign server in the
server buffer is immediately reflected to the subscription of the groups
which use the server in question.  For instance, if you change
@code{nntp-via-address} into @samp{bar.example.com} from
@samp{foo.example.com}, Gnus will connect to the news host by way of the
intermediate host @samp{bar.example.com} from next time.

@item The @file{all.SCORE} file can be edited from the group buffer
using @kbd{W e}.

@item You can set @code{gnus-mark-copied-or-moved-articles-as-expirable}
to a non-@code{nil} value so that articles that have been read may be
marked as expirable automatically when copying or moving them to a group
that has auto-expire turned on.  The default is @code{nil} and copying
and moving of articles behave as before; i.e., the expirable marks will
be unchanged except that the marks will be removed when copying or
moving articles to a group that has not turned auto-expire on.
@xref{Expiring Mail}.

@item NoCeM support has been removed.

@item Carpal mode has been removed.

@end itemize

@end itemize

@c gnus-news.texi ends here.