Mention that mm-text-html-renderer is the only HTML variable now.
[gnus] / texi / gnus-news.texi
1 @c -*-texinfo-*-
2
3 @c Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010 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' 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 has the same presedence 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 supports the ``hashcash'' client puzzle anti-spam mechanism.
228 Use @code{(setq message-generate-hashcash t)} to enable.
229 @xref{Hashcash}.
230
231 @item You can now drag and drop attachments to the Message buffer.
232 See @code{mml-dnd-protocol-alist} and @code{mml-dnd-attach-options}.
233 @xref{MIME, ,MIME, message, Message Manual}.
234
235 @item The option @code{message-yank-empty-prefix} now controls how
236 empty lines are prefixed in cited text.  @xref{Insertion Variables,
237 ,Insertion Variables, message, Message Manual}.
238
239 @item Gnus uses narrowing to hide headers in Message buffers.
240 The @code{References} header is hidden by default.  To make all
241 headers visible, use @code{(setq message-hidden-headers nil)}.
242 @xref{Message Headers, ,Message Headers, message, Message Manual}.
243
244 @item You can highlight different levels of citations like in the
245 article buffer.  See @code{gnus-message-highlight-citation}.
246
247 @item @code{auto-fill-mode} is enabled by default in Message mode.
248 See @code{message-fill-column}.  @xref{Various Message Variables, ,
249 Message Headers, message, Message Manual}.
250
251 @item You can now store signature files in a special directory
252 named @code{message-signature-directory}.
253
254 @item The option @code{message-citation-line-format} controls the format
255 of the "Whomever writes:" line.  You need to set
256 @code{message-citation-line-function} to
257 @code{message-insert-formatted-citation-line} as well.
258 @end itemize
259
260 @item Changes in Browse Server mode
261
262 @itemize @bullet
263 @item Gnus' sophisticated subscription methods are now available in
264 Browse Server buffers as well using the variable
265 @code{gnus-browse-subscribe-newsgroup-method}.
266
267 @end itemize
268
269
270 @item Changes in back ends
271
272 @itemize @bullet
273 @item The nntp back end stores article marks in @file{~/News/marks}.
274
275 The directory can be changed using the (customizable) variable
276 @code{nntp-marks-directory}, and marks can be disabled using the
277 (back end) variable @code{nntp-marks-is-evil}.  The advantage of this
278 is that you can copy @file{~/News/marks} (using rsync, scp or
279 whatever) to another Gnus installation, and it will realize what
280 articles you have read and marked.  The data in @file{~/News/marks}
281 has priority over the same data in @file{~/.newsrc.eld}.
282
283 @item
284 You can import and export your @acronym{RSS} subscriptions from
285 @acronym{OPML} files.  @xref{RSS}.
286
287 @item @acronym{IMAP} identity (@acronym{RFC} 2971) is supported.
288
289 By default, Gnus does not send any information about itself, but you can
290 customize it using the variable @code{nnimap-id}.
291
292 @item The @code{nnrss} back end now supports multilingual text.
293 Non-@acronym{ASCII} group names for the @code{nnrss} groups are also
294 supported.  @xref{RSS}.
295
296 @item Retrieving mail with @acronym{POP3} is supported over @acronym{SSL}/@acronym{TLS} and with StartTLS.
297
298 @item The nnml back end allows other compression programs beside @file{gzip}
299 for compressed message files.  @xref{Mail Spool}.
300
301 @item The nnml back end supports group compaction.
302
303 This feature, accessible via the functions
304 @code{gnus-group-compact-group} (@kbd{G z} in the group buffer) and
305 @code{gnus-server-compact-server} (@kbd{z} in the server buffer)
306 renumbers all articles in a group, starting from 1 and removing gaps.
307 As a consequence, you get a correct total article count (until
308 messages are deleted again).
309
310 @c @item nnmairix.el
311 @c FIXME
312
313 @c @item nnir.el
314 @c FIXME
315
316 @end itemize
317
318 @item Appearance
319 @c Maybe it's not worth to separate this from "Miscellaneous"?
320
321 @itemize @bullet
322
323 @item The tool bar has been updated to use GNOME icons.
324 You can also customize the tool bars: @kbd{M-x customize-apropos RET
325 -tool-bar$} should get you started.  (Only for Emacs, not in XEmacs.)
326 @c FIXME: Document this in the manual
327
328 @item The tool bar icons are now (de)activated correctly
329 in the group buffer, see the variable @code{gnus-group-update-tool-bar}.
330 Its default value depends on your Emacs version.
331 @c FIXME: Document this in the manual
332
333 @item You can change the location of XEmacs' toolbars in Gnus buffers.
334 See @code{gnus-use-toolbar} and @code{message-use-toolbar}.
335
336 @end itemize
337
338 @item Miscellaneous changes
339
340 @itemize @bullet
341 @item Having edited the select-method for the foreign server in the
342 server buffer is immediately reflected to the subscription of the groups
343 which use the server in question.  For instance, if you change
344 @code{nntp-via-address} into @samp{bar.example.com} from
345 @samp{foo.example.com}, Gnus will connect to the news host by way of the
346 intermediate host @samp{bar.example.com} from next time.
347
348 @item The @file{all.SCORE} file can be edited from the group buffer
349 using @kbd{W e}.
350
351 @item You can set @code{gnus-mark-copied-or-moved-articles-as-expirable}
352 to a non-@code{nil} value so that articles that have been read may be
353 marked as expirable automatically when copying or moving them to a group
354 that has auto-expire turned on.  The default is @code{nil} and copying
355 and moving of articles behave as before; i.e., the expirable marks will
356 be unchanged except that the marks will be removed when copying or
357 moving articles to a group that has not turned auto-expire on.
358 @xref{Expiring Mail}.
359
360 @item NoCeM support has been removed.
361
362 @item Carpal mode has been removed.
363
364 @end itemize
365
366 @end itemize
367
368 @c gnus-news.texi ends here.