Update copyright year to 2016
[gnus] / texi / gnus-news.texi
1 @c -*-texinfo-*-
2
3 @c Copyright (C) 2004-2016 Free Software Foundation, Inc.
4
5 @c    Permission is granted to anyone to make or distribute verbatim copies
6 @c    of this document as received, in any medium, provided that the
7 @c    copyright notice and this permission notice are preserved,
8 @c    thus giving the recipient permission to redistribute in turn.
9
10 @c    Permission is granted to distribute modified versions
11 @c    of this document, or of portions of it,
12 @c    under the above conditions, provided also that they
13 @c    carry prominent notices stating who last changed them.
14
15 @c This file contains a list of news features Gnus.  It is supposed to be
16 @c included in 'gnus.texi'.  'GNUS-NEWS' is automatically generated from
17 @c this file (see 'gnus-news.el').
18
19 @itemize @bullet
20
21 @item Supported Emacs versions
22 The following Emacs versions are supported by No Gnus:
23 @itemize @bullet
24
25 @item Emacs 22 and up
26 @item XEmacs 21.4
27 @item XEmacs 21.5
28 @item SXEmacs
29
30 @end itemize
31
32 @item Installation changes
33
34 @itemize @bullet
35 @item Upgrading from previous (stable) version if you have used No Gnus.
36
37 If you have tried No Gnus (the unstable Gnus branch leading to this
38 release) but went back to a stable version, be careful when upgrading
39 to this version.  In particular, you will probably want to remove the
40 @file{~/News/marks} directory (perhaps selectively), so that flags are
41 read from your @file{~/.newsrc.eld} instead of from the stale marks
42 file, where this release will store flags for nntp.  See a later entry
43 for more information about nntp marks.  Note that downgrading isn't
44 safe in general.
45
46 @item Incompatibility when switching from Emacs 23 to Emacs 22 
47 In Emacs 23, Gnus uses Emacs's new internal coding system @code{utf-8-emacs}
48 for saving articles drafts and @file{~/.newsrc.eld}.  These files may not
49 be read correctly in Emacs 22 and below.  If you want to use Gnus across
50 different Emacs versions, you may set @code{mm-auto-save-coding-system}
51 to @code{emacs-mule}.
52 @c FIXME: Untested.  (Or did anyone test it?)
53 @c Cf. http://thread.gmane.org/gmane.emacs.gnus.general/66251/focus=66344
54
55 @item Lisp files are now installed in @file{.../site-lisp/gnus/} by default.
56 It defaulted to @file{.../site-lisp/} formerly.  In addition to this,
57 the new installer issues a warning if other Gnus installations which
58 will shadow the latest one are detected.  You can then remove those
59 shadows manually or remove them using @code{make
60 remove-installed-shadows}.
61
62 @item The installation directory name is allowed to have spaces and/or tabs.
63 @end itemize
64
65 @item New packages and libraries within Gnus
66
67 @itemize @bullet
68
69 @item New version of @code{nnimap}
70
71 @code{nnimap} has been reimplemented in a mostly-compatible way.  See
72 the Gnus manual for a description of the new interface.  In
73 particular, @code{nnimap-inbox} and the client side split method has
74 changed.
75
76 @item Gnus includes the Emacs Lisp @acronym{SASL} library.
77
78 This provides a clean @acronym{API} to @acronym{SASL} mechanisms from
79 within Emacs.  The user visible aspects of this, compared to the earlier
80 situation, include support for @acronym{DIGEST}-@acronym{MD5} and
81 @acronym{NTLM}.   @xref{Top, ,Emacs SASL, sasl, Emacs SASL}.
82
83 @item ManageSieve connections uses the @acronym{SASL} library by default.
84
85 The primary change this brings is support for @acronym{DIGEST-MD5} and
86 @acronym{NTLM}, when the server supports it.
87
88 @item Gnus includes a password cache mechanism in password.el.
89
90 It is enabled by default (see @code{password-cache}), with a short
91 timeout of 16 seconds (see @code{password-cache-expiry}).  If
92 @acronym{PGG} is used as the @acronym{PGP} back end, the @acronym{PGP}
93 passphrase is managed by this mechanism.  Passwords for ManageSieve
94 connections are managed by this mechanism, after querying the user
95 about whether to do so.
96
97 @item Using EasyPG with Gnus
98 When EasyPG, is available, Gnus will use it instead of @acronym{PGG}.
99 EasyPG is an Emacs user interface to GNU Privacy Guard.  @xref{Top,
100 ,EasyPG Assistant user's manual, epa, EasyPG Assistant user's manual}.
101 EasyPG is included in Emacs 23 and available separately as well.
102 @end itemize
103
104 @item Changes in group mode
105 @c ************************
106
107 @itemize @bullet
108
109 @item
110 Symbols like @code{gcc-self} now have the same precedence rules in
111 @code{gnus-parameters} as other ``real'' variables: The last match
112 wins instead of the first match.
113
114 @item
115 Old intermediate incoming mail files (@file{Incoming*}) are deleted
116 after a couple of days, not immediately.  @xref{Mail Source
117 Customization}.
118 (New in Gnus 5.10.10 / No Gnus 0.8)
119 @c This entry is also present in the node "Oort Gnus".
120
121 @end itemize
122
123 @item Changes in summary and article mode
124
125 @itemize @bullet
126
127 @item There's now only one variable that determines how @acronym{HTML}
128 is rendered: @code{mm-text-html-renderer}.
129
130 @item Gnus now supports sticky article buffers.  Those are article buffers
131 that are not reused when you select another article.  @xref{Sticky
132 Articles}.
133
134 @c @item Bookmarks
135 @c FIXME: To be added
136
137 @item Gnus can selectively display @samp{text/html} articles
138 with a WWW browser with @kbd{K H}.  @xref{MIME Commands}.
139
140 @c gnus-registry-marks
141 @c FIXME: To be added
142
143 @item International host names (@acronym{IDNA}) can now be decoded
144 inside article bodies using @kbd{W i}
145 (@code{gnus-summary-idna-message}).  This requires that GNU Libidn
146 (@url{http://www.gnu.org/software/libidn/}) has been installed.
147 @c FIXME: Also mention @code{message-use-idna}?
148
149 @item The non-@acronym{ASCII} group names handling has been much
150 improved.  The back ends that fully support non-@acronym{ASCII} group
151 names are now @code{nntp}, @code{nnml}, and @code{nnrss}.  Also the
152 agent, the cache, and the marks features work with those back ends.
153 @xref{Non-ASCII Group Names}.
154
155 @item Gnus now displays @acronym{DNS} master files sent as text/dns
156 using dns-mode.
157
158 @item Gnus supports new limiting commands in the Summary buffer:
159 @kbd{/ r} (@code{gnus-summary-limit-to-replied}) and @kbd{/ R}
160 (@code{gnus-summary-limit-to-recipient}).  @xref{Limiting}.
161
162 @item You can now fetch all ticked articles from the server using
163 @kbd{Y t} (@code{gnus-summary-insert-ticked-articles}).  @xref{Summary
164 Generation Commands}.
165
166 @item Gnus supports a new sort command in the Summary buffer:
167 @kbd{C-c C-s C-t} (@code{gnus-summary-sort-by-recipient}).  @xref{Summary
168 Sorting}.
169
170 @item @acronym{S/MIME} now features @acronym{LDAP} user certificate searches.
171 You need to configure the server in @code{smime-ldap-host-list}.
172
173 @item URLs inside Open@acronym{PGP} headers are retrieved and imported
174 to your PGP key ring when you click on them.
175
176 @item
177 Picons can be displayed right from the textual address, see
178 @code{gnus-picon-style}.  @xref{Picons}.
179
180 @item @acronym{ANSI} @acronym{SGR} control sequences can be transformed
181 using @kbd{W A}.
182
183 @acronym{ANSI} sequences are used in some Chinese hierarchies for
184 highlighting articles (@code{gnus-article-treat-ansi-sequences}).
185
186 @item Gnus now MIME decodes articles even when they lack "MIME-Version" header.
187 This changes the default of @code{gnus-article-loose-mime}.
188
189 @item @code{gnus-decay-scores} can be a regexp matching score files.
190 For example, set it to @samp{\\.ADAPT\\'} and only adaptive score files
191 will be decayed.  @xref{Score Decays}.
192
193 @item Strings prefixing to the @code{To} and @code{Newsgroup} headers in
194 summary lines when using @code{gnus-ignored-from-addresses} can be
195 customized with @code{gnus-summary-to-prefix} and
196 @code{gnus-summary-newsgroup-prefix}.  @xref{To From Newsgroups}.
197
198 @item You can replace @acronym{MIME} parts with external bodies.
199 See @code{gnus-mime-replace-part} and @code{gnus-article-replace-part}.
200 @xref{MIME Commands}, @ref{Using MIME}.
201
202 @item
203 The option @code{mm-fill-flowed} can be used to disable treatment of
204 format=flowed messages.  Also, flowed text is disabled when sending
205 inline @acronym{PGP} signed messages.  @xref{Flowed text, ,Flowed text,
206 emacs-mime, The Emacs MIME Manual}.  (New in Gnus 5.10.7)
207 @c This entry is also present in the node "Oort Gnus".
208
209 @item Now the new command @kbd{S W}
210 (@code{gnus-article-wide-reply-with-original}) for a wide reply in the
211 article buffer yanks a text that is in the active region, if it is set,
212 as well as the @kbd{R} (@code{gnus-article-reply-with-original}) command.
213 Note that the @kbd{R} command in the article buffer no longer accepts a
214 prefix argument, which was used to make it do a wide reply.
215 @xref{Article Keymap}.
216
217 @item The new command @kbd{C-h b}
218 (@code{gnus-article-describe-bindings}) used in the article buffer now
219 shows not only the article commands but also the real summary commands
220 that are accessible from the article buffer.
221
222 @end itemize
223
224 @item Changes in Message mode
225
226 @itemize @bullet
227 @item Gnus now defaults to saving all outgoing messages in per-month
228 nnfolder archives.
229
230 @item Gnus now supports the ``hashcash'' client puzzle anti-spam mechanism.
231 Use @code{(setq message-generate-hashcash t)} to enable.
232 @xref{Hashcash}.
233
234 @item You can now drag and drop attachments to the Message buffer.
235 See @code{mml-dnd-protocol-alist} and @code{mml-dnd-attach-options}.
236 @xref{MIME, ,MIME, message, Message Manual}.
237
238 @item The option @code{message-yank-empty-prefix} now controls how
239 empty lines are prefixed in cited text.  @xref{Insertion Variables,
240 ,Insertion Variables, message, Message Manual}.
241
242 @item Gnus uses narrowing to hide headers in Message buffers.
243 The @code{References} header is hidden by default.  To make all
244 headers visible, use @code{(setq message-hidden-headers nil)}.
245 @xref{Message Headers, ,Message Headers, message, Message Manual}.
246
247 @item You can highlight different levels of citations like in the
248 article buffer.  See @code{gnus-message-highlight-citation}.
249
250 @item @code{auto-fill-mode} is enabled by default in Message mode.
251 See @code{message-fill-column}.  @xref{Various Message Variables, ,
252 Message Headers, message, Message Manual}.
253
254 @item You can now store signature files in a special directory
255 named @code{message-signature-directory}.
256
257 @item The option @code{message-citation-line-format} controls the format
258 of the "Whomever writes:" line.  You need to set
259 @code{message-citation-line-function} to
260 @code{message-insert-formatted-citation-line} as well.
261 @end itemize
262
263 @item Changes in Browse Server mode
264
265 @itemize @bullet
266 @item Gnus' sophisticated subscription methods are now available in
267 Browse Server buffers as well using the variable
268 @code{gnus-browse-subscribe-newsgroup-method}.
269
270 @end itemize
271
272
273 @item Changes in back ends
274
275 @itemize @bullet
276 @item The nntp back end stores article marks in @file{~/News/marks}.
277
278 The directory can be changed using the (customizable) variable
279 @code{nntp-marks-directory}, and marks can be disabled using the
280 (back end) variable @code{nntp-marks-is-evil}.  The advantage of this
281 is that you can copy @file{~/News/marks} (using rsync, scp or
282 whatever) to another Gnus installation, and it will realize what
283 articles you have read and marked.  The data in @file{~/News/marks}
284 has priority over the same data in @file{~/.newsrc.eld}.
285
286 @item
287 You can import and export your @acronym{RSS} subscriptions from
288 @acronym{OPML} files.  @xref{RSS}.
289
290 @item @acronym{IMAP} identity (@acronym{RFC} 2971) is supported.
291
292 By default, Gnus does not send any information about itself, but you can
293 customize it using the variable @code{nnimap-id}.
294
295 @item The @code{nnrss} back end now supports multilingual text.
296 Non-@acronym{ASCII} group names for the @code{nnrss} groups are also
297 supported.  @xref{RSS}.
298
299 @item Retrieving mail with @acronym{POP3} is supported over @acronym{SSL}/@acronym{TLS} and with StartTLS.
300
301 @item The nnml back end allows other compression programs beside @file{gzip}
302 for compressed message files.  @xref{Mail Spool}.
303
304 @item The nnml back end supports group compaction.
305
306 This feature, accessible via the functions
307 @code{gnus-group-compact-group} (@kbd{G z} in the group buffer) and
308 @code{gnus-server-compact-server} (@kbd{z} in the server buffer)
309 renumbers all articles in a group, starting from 1 and removing gaps.
310 As a consequence, you get a correct total article count (until
311 messages are deleted again).
312
313 @c @item nnmairix.el
314 @c FIXME
315
316 @c @item nnir.el
317 @c FIXME
318
319 @end itemize
320
321 @item Appearance
322 @c Maybe it's not worth to separate this from "Miscellaneous"?
323
324 @itemize @bullet
325
326 @item The tool bar has been updated to use GNOME icons.
327 You can also customize the tool bars: @kbd{M-x customize-apropos RET
328 -tool-bar$} should get you started.  (Only for Emacs, not in XEmacs.)
329 @c FIXME: Document this in the manual
330
331 @item The tool bar icons are now (de)activated correctly
332 in the group buffer, see the variable @code{gnus-group-update-tool-bar}.
333 Its default value depends on your Emacs version.
334 @c FIXME: Document this in the manual
335
336 @item You can change the location of XEmacs's toolbars in Gnus buffers.
337 See @code{gnus-use-toolbar} and @code{message-use-toolbar}.
338
339 @end itemize
340
341 @item Miscellaneous changes
342
343 @itemize @bullet
344 @item Having edited the select-method for the foreign server in the
345 server buffer is immediately reflected to the subscription of the groups
346 which use the server in question.  For instance, if you change
347 @code{nntp-via-address} into @samp{bar.example.com} from
348 @samp{foo.example.com}, Gnus will connect to the news host by way of the
349 intermediate host @samp{bar.example.com} from next time.
350
351 @item The @file{all.SCORE} file can be edited from the group buffer
352 using @kbd{W e}.
353
354 @item You can set @code{gnus-mark-copied-or-moved-articles-as-expirable}
355 to a non-@code{nil} value so that articles that have been read may be
356 marked as expirable automatically when copying or moving them to a group
357 that has auto-expire turned on.  The default is @code{nil} and copying
358 and moving of articles behave as before; i.e., the expirable marks will
359 be unchanged except that the marks will be removed when copying or
360 moving articles to a group that has not turned auto-expire on.
361 @xref{Expiring Mail}.
362
363 @item NoCeM support has been removed.
364
365 @item Carpal mode has been removed.
366
367 @end itemize
368
369 @end itemize
370
371 @c gnus-news.texi ends here.