remove redundant format call in message
[elisp/gnus.git-] / GNUS-NEWS
index 83e5448..79b7cf7 100644 (file)
--- a/GNUS-NEWS
+++ b/GNUS-NEWS
@@ -1,5 +1,5 @@
 GNUS NEWS -- history of user-visible changes.
-Copyright (C) 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
+Copyright (C) 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
 See the end for copying conditions.
 
 Please send Gnus bug reports to bugs@gnus.org.
@@ -8,6 +8,257 @@ For older news, see Gnus info node "New Features".
 \f
 * Changes in Oort Gnus
 
+** The revised Gnus FAQ is included in the manual.
+See the info node "Frequently Asked Questions".
+
+** Upgrading from previous (stable) version if you have used Oort.
+
+If you have tried Oort (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 all
+.marks (nnml) and .mrk (nnfolder) files, so that flags are read from
+your ~/.newsrc.eld instead of from the .marks/.mrk file where this
+release store flags.  See a later entry for more information about
+marks.  Note that downgrading isn't save in general.
+
+** Article Buttons
+
+More buttons for URLs, mail addresses, Message-IDs, Info links, man pages and
+Emacs or Gnus related references, see the info node "Article Buttons".  The
+variables `gnus-button-*-level' can be used to control the appearance of all
+article buttons, see the info node "Article Button Levels".
+
+** Dired integration
+`gnus-dired-minor-mode' installs key bindings in dired buffers to send
+a file as an attachment (`C-c C-a'), open a file using the approriate
+mailcap entry (`C-c C-l'), and print a file using the mailcap entry
+(`C-c P').  It is enabled with 
+
+      (add-hook 'dired-mode-hook 'turn-on-gnus-dired-mode)
+
+** Gnus can display RSS newsfeeds as a newsgroup.  To get started do `B
+nnrss RET RET' in the Group buffer.
+
+** Single-part yenc encoded attachments can be decoded.
+
+** Picons
+The picons code has been reimplemented to work in GNU Emacs -- some of
+the previous options have been removed or renamed.
+
+Picons are small "personal icons" representing users, domain and
+newsgroups, which can be displayed in the Article buffer.  To enable
+picons, install the picons database from
+
+      http://www.cs.indiana.edu/picons/ftp/index.html
+
+and point `gnus-picon-databases' to that location.
+
+** If the new option `gnus-treat-body-boundary' is `head', a boundary 
+line is drawn at the end of the headers.
+
+** Retrieval of charters and control messages
+There are new commands for fetching newsgroup charters (`H c') and
+control messages (`H C').
+
+** Delayed articles
+You can delay the sending of a message with `C-c C-j' in the Message
+buffer.  The messages are delivered at specified time.  This is useful
+for sending yourself reminders.  Setup with (gnus-delay-initialize).
+
+** If `auto-compression-mode' is enabled, attachments are automatically
+decompressed when activated.
+
+** If the new option `nnml-use-compressed-files' is non-nil, 
+the nnml back end allows compressed message files.
+
+** Signed article headers (X-PGP-Sig) can be verified with `W p'.
+
+** The Summary Buffer uses an arrow in the fringe to indicate the current 
+article.  Use (setq gnus-summary-display-arrow nil) to disable it.
+
+** Warn about email replies to news
+Do you often find yourself replying to news by email by mistake?  Then
+the new option `gnus-confirm-mail-reply-to-news' is just the thing for
+you.
+
+** If the new option `gnus-summary-display-while-building' is non-nil, 
+the summary buffer is shown and updated as it's being built.
+
+** The new `recent' mark "." indicates newly arrived messages (as
+opposed to old but unread messages).
+
+** The new option `gnus-gcc-mark-as-read' automatically marks 
+Gcc articles as read.
+
+** The nndoc back end now supports mailman digests and exim bounces.
+
+** Gnus supports RFC 2369 mailing list headers, and adds a number of 
+related commands in mailing list groups.
+
+** The Date header can be displayed in a format that can be read aloud
+in English, see `gnus-treat-date-english'.
+
+** The envelope sender address can be customized when using Sendmail, see 
+`message-sendmail-envelope-from'.
+
+** diffs are automatically highlighted in groups matching
+`mm-uu-diff-groups-regexp'
+
+** TLS wrapper shipped with Gnus
+
+TLS/SSL is now supported in IMAP and NNTP via tls.el and GNUTLS.  The
+old TLS/SSL support via (external third party) ssl.el and OpenSSL
+still works.
+
+** New make.bat for compiling and installing Gnus under MS Windows
+
+Use make.bat if you want to install Gnus under MS Windows, the first
+argument to the batch-program should be the directory where xemacs.exe
+respectively emacs.exe is located, iff you want to install Gnus after
+compiling it, give make.bat /copy as the second parameter.
+
+Make.bat has been rewritten from scratch, it now features automatic
+recognition of XEmacs and GNU Emacs, generates 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 makeinfo if it is
+available and falls back to infohack.el otherwise. Make.bat should now
+install all files which are necessary to run Gnus and be generally a
+complete replacement for the "configure; make; make install" cycle used
+under Unix systems.
+
+The new make.bat makes make-x.bat superfluous, so it has been removed.
+
+** Support for non-ASCII domain names
+
+Message supports non-ASCII domain names in From:, To: and Cc: and will
+query you whether to perform encoding when you try to send a message.
+The variable `message-use-idna' controls this.  Gnus will also decode
+non-ASCII domain names in From:, To: and Cc: when you view a message.
+The variable `gnus-use-idna' controls this.
+
+** Better handling of Microsoft citation styles
+
+Gnus now tries to recognize the mangled header block that some Microsoft
+mailers use to indicate that the rest of the message is a citation, even
+though it is not quoted in any way.  The variable
+`gnus-cite-unsightly-citation-regexp' matches the start of these
+citations.
+
+** gnus-article-skip-boring
+
+If you set `gnus-article-skip-boring' to t, then Gnus will not scroll
+down to show you a page that contains only boring text, which by
+default means cited text and signature.  You can customize what is
+skippable using `gnus-article-boring-faces'.
+
+This feature is especially useful if you read many articles that
+consist of a little new content at the top with a long, untrimmed
+message cited below.
+
+** The format spec %C for positioning point has changed to %*.
+
+** The new variable `gnus-parameters' can be used to set group parameters.
+
+Earlier this was done only via `G p' (or `G c'), which stored the
+parameters in ~/.newsrc.eld, but via this variable you can enjoy the
+powers of customize, and simplified backups since you set the variable
+in ~/.emacs instead of ~/.newsrc.eld.  The variable maps regular
+expressions matching group names to group parameters, a'la:
+
+     (setq gnus-parameters
+           '(("mail\\..*"
+              (gnus-show-threads nil)
+              (gnus-use-scoring nil))
+             ("^nnimap:\\(foo.bar\\)$"
+              (to-group . "\\1"))))
+
+** Smileys (":-)", ";-)" etc) are now iconized for Emacs too.
+
+Put (setq gnus-treat-display-smileys nil) in ~/.emacs to disable it.
+
+** Gnus no longer generate the Sender: header automatically.
+
+Earlier it was generated iff 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 controversally) 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 `message-required-headers',
+`message-required-news-headers', and `message-required-mail-headers'.
+
+** Features from third party message-utils.el added to message.el.
+
+Message now asks if you wish to remove "(was: <old subject>)" from
+subject lines (see `message-subject-trailing-was-query').  C-c M-m and
+C-c M-f inserts markers indicating included text.  C-c C-f a adds a
+X-No-Archive: header.  C-c C-f x inserts appropriate headers and a
+note in the body for cross-postings and followups (see the variables
+`message-cross-post-*').
+
+** References and X-Draft-Headers are no longer generated when you
+   start composing messages and `message-generate-headers-first' is nil.
+
+** Improved anti-spam features.
+
+Gnus is now able to take out spam from your mail and news streams
+using a wide variety of programs and filter rules. Among the supported
+methods are RBL blocklists, bogofilter and white/blacklists.  Hooks
+for easy use of external packages such as SpamAssassin and Hashcash
+are also new.
+
+** Easy inclusion of X-Faces headers.
+
+** In the summary buffer, the new command / N inserts new messages and
+/ o inserts old messages.
+
+** Gnus decodes morse encoded messages if you press W m.
+
+** Unread count correct in nnimap groups.
+
+The estimated number of unread articles in the group buffer should now
+be correct for nnimap groups.  This is achieved by calling
+`nnimap-fixup-unread-after-getting-new-news' from the
+`gnus-setup-news-hook' (called on startup) and
+gnus-after-getting-new-news-hook. (called after getting new mail).  If
+you have modified those variables from the default, you may want to
+add n-f-u-a-g-n-n again.  If you were happy with the estimate and want
+to save some (minimal) time when getting new mail, remove the
+function.
+
+** Group Carbon Copy (GCC) quoting
+
+To support groups that contains SPC and other weird characters, groups
+are quoted before they are placed in the Gcc: header.  This means
+variables such as `gnus-message-archive-group' should no longer
+contain quote characters to make groups containing SPC work.  Also, if
+you are using the string "nnml:foo, nnml:bar" (indicating Gcc into two
+groups) you must change it to return the list ("nnml:foo" "nnml:bar"),
+otherwise the Gcc: line will be quoted incorrectly.  Note that
+returning the string "nnml:foo, nnml:bar" was incorrect earlier, it
+just didn't generate any problems since it was inserted directly.
+
+** ~/News/overview/ not used.
+
+As a result of the following change, the ~/News/overview/ directory is
+not used any more.  You can safely delete the entire hierarchy.
+
+** gnus-agent
+
+The Gnus Agent has seen a major updated and is now enabled by default,
+and all nntp and nnimap servers from gnus-select-method and
+gnus-secondary-select-method are agentized by default. Earlier only
+the server in gnus-select-method was agentized by the default, and the
+agent was disabled by default.  When the agent is enabled, headers are
+now also retrieved from the Agent cache instead of the backends when
+possible. Earlier this only happened in the unplugged state.  You can
+enroll or remove servers with `J a' and `J r' in the server buffer.
+Gnus will not download articles into the Agent cache, unless you
+instruct it to do so, though, by using `J u' or `J s' from the Group
+buffer.  You revert to the old behaviour of having the Agent disabled
+with `(setq gnus-agent nil)'.  Note that putting (gnus-agentize) in
+~/.gnus is not needed any more.
+
 ** gnus-summary-line-format
 
 The default value changed to "%U%R%z%I%(%[%4L: %-23,23f%]%) %s\n".
@@ -37,7 +288,7 @@ A new command which starts gnus offline in slave mode.
 ** message-insinuate-rmail
 
 Adding (message-insinuate-rmail) and (setq mail-user-agent
-'gnus-user-agent) in .emacs convinces RMAIL to compose, reply and
+'gnus-user-agent) in .emacs convinces Rmail to compose, reply and
 forward messages in message-mode, where you can enjoy the power of
 MML.
 
@@ -47,15 +298,16 @@ The line below enables BBDB in resending a message:
 
 (define-key message-minibuffer-local-map [(tab)] 'bbdb-complete-name)
 
-** Externalize attachments.
+** Externalizing and deleting of attachments.
 
 If gnus-gcc-externalize-attachments (or
 message-fcc-externalize-attachments) is non-nil, attach local files as
 external parts.
 
-Command gnus-mime-save-part-and-strip (bound to \C-o on MIME buttons)
-saves a part and replaces the part with an external one. It works only
-on back ends that support editing.
+The command gnus-mime-save-part-and-strip (bound to `C-o' on MIME
+buttons) saves a part and replaces the part with an external one.
+gnus-mime-delete-part (bound to `d' on MIME buttons) removes a part.
+It works only on back ends that support editing.
 
 ** gnus-default-charset
 
@@ -70,7 +322,7 @@ Add a new format of match like
         ((header "to" "larsi.*org")
          (Organization "Somewhere, Inc."))
 
-The old format like the lines below is obsolete.
+The old format like the lines below is obsolete, but still accepted.
 
         (header "to" "larsi.*org"
          (Organization "Somewhere, Inc."))
@@ -106,17 +358,21 @@ Gnus supports Muttprint natively with O P from the Summary and Article
 buffers.  Also, each individual MIME part can be printed using p on
 the MIME button.
 
-** Message supports the Importance: header.
+** Message supports the Importance: (RFC 2156) header.
 
-In the message buffer, C-c C-f C-i or C-c C-u cycles through the valid
-values.
+In the message buffer, `C-c C-f C-i' or `C-c C-u' cycles through the
+valid values.
 
 ** Gnus supports Cancel Locks in News.
 
-This means a header "Cancel-Lock" is inserted in news posting. It is
-used to determine if you wrote a article or not (for
-cancelling/superseding).  The behaviour can be changed by customizing
-`message-insert-canlock'.
+This means a header "Cancel-Lock" is inserted in news posting.  It is
+used to determine if you wrote a article or not (for cancelling and
+superseding).  Gnus generates a random password string the first time
+you post a message, and saves it in your ~/.emacs using the Custom
+system.  While the variable is called `canlock-password', it is not
+security sensitive data.  Publishing your canlock string on the web
+will not allow anyone to be able to anything she could not already do.
+The behaviour can be changed by customizing `message-insert-canlock'.
 
 ** Gnus supports server-side mail filtering using Sieve.
 
@@ -140,30 +396,38 @@ longer supported.
 It was aliased to `Y c' (gnus-summary-insert-cached-articles). The new
 function filters out other articles.
 
+** Some limiting commands accept a C-u prefix to negate the match.
+
+If C-u is used on subject, author or extra headers, i.e., `/ s', `/
+a', and `/ x' (gnus-summary-limit-to-{subject,author,extra})
+respectively, the result will be to display all articles that do not
+match the expression.
+
 ** Group names are treated as UTF-8 by default.
 
-This is supposedly what USEFOR wants to migrate to.  See
+This is supposedly what USEFOR wanted to migrate to.  See
 `gnus-group-name-charset-group-alist' and
 `gnus-group-name-charset-method-alist' for customization.
 
 ** The nnml and nnfolder backends store marks for each groups.
 
 This makes it possible to take backup of nnml/nnfolder servers/groups
-separately of .newsrc.eld, while preserving marks.  It also makes it
+separately of ~/.newsrc.eld, while preserving marks.  It also makes it
 possible to share articles and marks between users (without sharing
-the .newsrc.eld file) within e.g. a department.  It works by storing
-the marks stored in .newsrc.eld in a per-group file ".marks" (for
+the ~/.newsrc.eld file) within e.g. a department.  It works by storing
+the marks stored in ~/.newsrc.eld in a per-group file ".marks" (for
 nnml) and "groupname.mrk" (for nnfolder, named "groupname").  If the
 nnml/nnfolder is moved to another machine, Gnus will automatically use
-the .marks or .mrk file instead of the information in .newsrc.eld.
+the .marks or .mrk file instead of the information in ~/.newsrc.eld.
 The new server variables `nnml-marks-is-evil' and
 `nnfolder-marks-is-evil' can be used to disable this feature.
 
-** The menu bar (in Group and Summary buffer) named "Misc" has been
-renamed to "Gnus".
+** The menu bar item (in Group and Summary buffer) named "Misc" has
+been renamed to "Gnus".
 
-** The menu bar (in Message mode) named "MML" has been renamed to
-"Attachments".
+** The menu bar item (in Message mode) named "MML" has been renamed to
+"Attachments".  Note that this menu also contains security related
+stuff, like signing and encryption.
 
 ** gnus-group-charset-alist and gnus-group-ignored-charsets-alist.
 
@@ -173,8 +437,12 @@ variables should change those regexps accordingly. For example:
 
    ("^han\\>" euc-kr) -> ("\\(^\\|:\\)han\\>" euc-kr)
 
-** Gnus supports PGP (RFC 1991/2440), PGP-MIME (RFC 2015/3156) and
-SMIME.
+** Gnus supports PGP (RFC 1991/2440), PGP/MIME (RFC 2015/3156) and
+** S/MIME (RFC 2630-2633).
+It needs an external S/MIME and OpenPGP implementation, but no
+additional lisp libraries.  This add several menu items to the
+Attachments menu, and C-c RET key bindings, when composing messages.
+This also obsoletes `gnus-article-hide-pgp-hook'.
 
 ** Gnus inlines external parts (message/external).
 
@@ -183,6 +451,8 @@ SMIME.
 This change was made to avoid conflict with the standard binding of
 `back-to-indentation', which is also useful in message mode.
 
+** Bug fixes.
+
 \f
 * Changes in Pterodactyl Gnus (5.8/5.9)