* gnus-news.texi: Mention non-@acronym{ASCII} group names; move new

[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}.

@item
New @file{make.bat} for compiling and installing Gnus under MS Windows.

Use @file{make.bat} if you want to install Gnus under MS Windows, the
first argument to the batch-program should be the directory where
@file{xemacs.exe} respectively @file{emacs.exe} is located, if you want
to install Gnus after compiling it, give @file{make.bat} @code{/copy} as
the second parameter.

@file{make.bat} has been rewritten from scratch, it now features
automatic recognition of XEmacs and GNU Emacs, generates
@file{gnus-load.el}, checks if errors occur while compilation and
generation of info files and reports them at the end of the build
process.  It now uses @code{makeinfo} if it is available and falls
back to @file{infohack.el} otherwise.  @file{make.bat} should now
install all files which are necessary to run Gnus and be generally a
complete replacement for the @code{configure; make; make install}
cycle used under Unix systems.

The new @file{make.bat} makes @file{make-x.bat} and @file{xemacs.mak}
superfluous, so they have been removed.

@item @file{~/News/overview/} not used.

As a result of the following change, the @file{~/News/overview/}
directory is not used any more.  You can safely delete the entire
hierarchy.

@c FIXME: `gnus-load' is mentioned in README, which is not included in
@c CVS.  We should find a better place for this item.
@item
@code{(require 'gnus-load)}

If you use a stand-alone Gnus distribution, you'd better add
@code{(require 'gnus-load)} into your @file{~/.emacs} after adding the Gnus
lisp directory into load-path.

File @file{gnus-load.el} contains autoload commands, functions and variables,
some of which may not be included in distributions of Emacsen.
@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 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".

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

@item
Gnus no longer generate the Sender: header automatically.

Earlier it was generated when the user configurable email address was
different from the Gnus guessed default user address.  As the guessing
algorithm is rarely correct these days, and (more controversially) the
only use of the Sender: header was to check if you are entitled to
cancel/supersede news (which is now solved by Cancel Locks instead,
see another entry), generation of the header has been disabled by
default.  See the variables @code{message-required-headers},
@code{message-required-news-headers}, and
@code{message-required-mail-headers}.
@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