(Mail Source Specifiers, IMAP): Add a notice on the need to clean the

[gnus] / texi / gnus-news.texi

@c -*-texinfo-*-

@c Copyright (C) 2004, 2005, 2006 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 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 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}.
@end itemize

@item New packages and libraries within Gnus

@itemize @bullet

@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.
@end itemize

@item Changes in summary and article mode

@itemize @bullet

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

@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 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".

@end itemize

@item Changes in Message mode

@itemize @bullet
@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-formated-citation-line} as well.

@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).
@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 bar.  There's no documentation in the
manual yet, but @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' 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}.

@end itemize

@end itemize

@c gnus-news.texi ends here.

@ignore
   arch-tag: 872c7569-4340-4d73-9d1d-7826d9f94a51
@end ignore