Add message-citation-line-format.
[gnus] / texi / gnus-news.texi
index 0670c45..7a45c9c 100644 (file)
@@ -17,8 +17,8 @@
 @c this file (see `gnus-news.el').
 
 @itemize @bullet
-\f
-@item Installation changes in No Gnus
+
+@item Installation changes
 
 @itemize @bullet
 @item Upgrading from previous (stable) version if you have used No Gnus.
@@ -32,28 +32,24 @@ 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 .../site-lisp/gnus/ by default.
-It defaulted to .../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 @samp{make remove-installed-shadows}.
+@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
 
-\f
-@item Major new features in No Gnus
+@item New packages and libraries within Gnus
 
 @itemize @bullet
-@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.
 
-@item Gnus includes an Emacs Lisp @acronym{SASL} library.
+@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}.
+@acronym{NTLM}.   @xref{Top, ,Emacs SASL, sasl, Emacs SASL}.
 
 @item ManageSieve connections uses the @acronym{SASL} library by default.
 
@@ -68,20 +64,28 @@ timeout of 16 seconds (see @code{password-cache-expiry}).  If
 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 The @file{all.SCORE} file can be edited from the group buffer
-using @kbd{W e}.
+@item Changes in summary and article mode
 
-@item Gnus now views DNS master files sent as text/dns using dns-mode.
+@itemize @bullet
+@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 supports the ``hashcash'' client puzzle anti-spam mechanism.
-See the Gnus manual, section Hashcash, for more information.  Use
-@code{(setq message-generate-hashcash t)} to enable.
+@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}.
@@ -89,11 +93,81 @@ 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 OpenPGP: headers are retrieved and imported to your
-PGP key ring when you click on them.
+@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
 
-\f
 @item Changes in back ends
 
 @itemize @bullet
@@ -121,58 +195,44 @@ 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.
-@end itemize
-
-\f
-@item Changes in Message
-
-@itemize @bullet
-@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)}.
 
 @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
 
-\f
-@item Other changes in No Gnus
+@item Appearance
+@c Maybe it's not worth to separate this from "Miscellaneous"?
 
 @itemize @bullet
-@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 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 Gnus now MIME decodes articles even when they lack "MIME-Version" header.
-This changes the default of @code{gnus-article-loose-mime}.
+@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 @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 You can change the location of XEmacs' toolbars in Gnus buffers.
+See @code{gnus-use-toolbar} and @code{message-use-toolbar}.
 
-@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}.
+@end itemize
 
-@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 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
@@ -180,29 +240,15 @@ which use the server in question.  For instance, if you change
 @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 You can change the location of XEmacs' toolbars in Gnus buffers.
-See @code{gnus-use-toolbar} and @code{message-use-toolbar}.
-
-@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 The @file{all.SCORE} file can be edited from the group buffer
+using @kbd{W e}.
 
-@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.
 @end itemize
 
 @end itemize
 
 @c gnus-news.texi ends here.
 
-@c Local Variables:
-@c page-delimiter: "^\f"
-@c End:
-
 @ignore
    arch-tag: 872c7569-4340-4d73-9d1d-7826d9f94a51
 @end ignore