(Saving Articles): Addition.

[gnus] / texi / gnus-news.texi

diff --git a/texi/gnus-news.texi b/texi/gnus-news.texi
index 56d7f9f..eac9414 100644 (file)
--- a/texi/gnus-news.texi
+++ b/texi/gnus-news.texi
@@ -1,6 +1,6 @@
 @c -*-texinfo-*-
 
 @c -*-texinfo-*-
 

-@c Copyright (C) 2004, 2005 Free Software Foundation, Inc.
+@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    Permission is granted to anyone to make or distribute verbatim copies
 @c    of this document as received, in any medium, provided that the


@@ -18,6 +18,9 @@
 
 @itemize @bullet
 
 
 @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
 @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


@@ -29,54 +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.
 
 for more information about nntp marks.  Note that downgrading isn't
 safe in general.
 

-@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
-Picons can be displayed right from the textual address, see
-@code{gnus-picon-style}.  @xref{Picons}.
-
-@item
-You can import and export your @acronym{RSS} subscriptions from
-@acronym{OPML} files.  @xref{RSS}.
-
-@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.
-
-@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{(message)Insertion Variables}.
-
-@item @acronym{ANSI} @acronym{SGR} control sequences can be transformed
-using @kbd{W A}.
+@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

 
 

-@acronym{ANSI} sequences are used in some Chinese hierarchies for
-highlighting articles (@code{gnus-article-treat-ansi-sequences}).
+@item New packages and libraries within Gnus

 
 

-@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.
+@itemize @bullet

 
 

-@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
 
 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.
 
 
 @item ManageSieve connections uses the @acronym{SASL} library by default.
 


@@ -91,23 +64,19 @@ 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.
 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 @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 @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 MIME decodes articles even when they lack "MIME-Version" header.
-This changes the default of @code{gnus-article-loose-mime}.
-
-@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 support the ``hashcash'' client puzzle anti-spam idea.
-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}
 
 @item Gnus supports new limiting commands in the Summary buffer:
 @kbd{/ r} (@code{gnus-summary-limit-to-replied}) and @kbd{/ R}


@@ -117,22 +86,28 @@ See the Gnus manual, section Hashcash, for more information.  Use
 @kbd{C-c C-s C-t} (@code{gnus-summary-sort-by-recipient}).  @xref{Summary
 Sorting}.
 
 @kbd{C-c C-s C-t} (@code{gnus-summary-sort-by-recipient}).  @xref{Summary
 Sorting}.
 

-@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 @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 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
+Picons can be displayed right from the textual address, see
+@code{gnus-picon-style}.  @xref{Picons}.

 
 

-@item @code{gnus-decay-scores} can be a regexp matching score files.
-This only adaptive score files to decay.  @xref{Score Decays}.
+@item @acronym{ANSI} @acronym{SGR} control sequences can be transformed
+using @kbd{W A}.

 
 

-@item @acronym{S/MIME} now features @acronym{LDAP} user certificate searches.
-You need to configure the server in @code{smime-ldap-host-list}.
+@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
 
 @item Strings prefixing to the @code{To} and @code{Newsgroup} headers in
 summary lines when using @code{gnus-ignored-from-addresses} can be


@@ -143,15 +118,105 @@ customized with @code{gnus-summary-to-prefix} and
 See @code{gnus-mime-replace-part} and @code{gnus-article-replace-part}.
 @xref{MIME Commands}, @ref{Using MIME}.
 
 See @code{gnus-mime-replace-part} and @code{gnus-article-replace-part}.
 @xref{MIME Commands}, @ref{Using MIME}.
 

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

+

 @c gnus-news.texi ends here.
 
 @ignore
 @c gnus-news.texi ends here.
 
 @ignore