Merge from emacs--devo--0
[gnus] / texi / gnus-coding.texi
index fde0536..324cba4 100644 (file)
@@ -7,20 +7,20 @@
 @syncodeindex pg cp
 
 @copying
-Copyright (c) 2004, 2005, 2007  Free Software Foundation, Inc.
+Copyright (C) 2004, 2005, 2007, 2008, 2009  Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
+under the terms of the GNU Free Documentation License, Version 1.3 or
 any later version published by the Free Software Foundation; with no
 Invariant Sections, with the Front-Cover texts being ``A GNU
 Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
 license is included in the section entitled ``GNU Free Documentation
-License'' in the Emacs manual.
+License'' in the Gnus manual.
 
-(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
-this GNU Manual, like GNU software.  Copies published by the Free
-Software Foundation raise funds for GNU development.''
+(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
+modify this GNU manual.  Buying copies from the FSF supports it in
+developing GNU and promoting software freedom.''
 
 This document is part of a collection distributed under the GNU Free
 Documentation License.  If you want to distribute this document
@@ -76,6 +76,10 @@ Functions for formatting arbitrary formatting strings.
 @c As of 2005-10-21...
 There are no Gnus dependencies in this file.
 
+@item hex-util.el
+Functions to encode/decode hexadecimal string.
+@c As of 2007-08-25...
+There are no Gnus dependencies in these files.
 @end table
 
 @subsection Encryption and security
@@ -101,6 +105,10 @@ Glue for the various PGP implementations.
 @c As of 2005-10-21...
 There are no Gnus dependencies in these files.
 
+@item sha1.el
+SHA1 Secure Hash Algorithm.
+@c As of 2007-08-25...
+There are no Gnus dependencies in these files.
 @end table
 
 @subsection Networking
@@ -112,7 +120,7 @@ Domain Name System dig interface.
 There are no serious Gnus dependencies in this file.  Uses
 @code{gnus-run-mode-hooks} (a wrapper function).
 
-@item dns*.el
+@item dns.el, dns-mode.el
 Domain Name Service lookups.
 @c As of 2005-10-21...
 There are no Gnus dependencies in these files.
@@ -147,15 +155,25 @@ using an optional argument to @code{rfc1843-decode-article-body}.
 
 @item rfc2045.el
 Functions for decoding rfc2045 headers
+@c As of 2007-08-25...
+There are no Gnus dependencies in these files.
 
 @item rfc2047.el
 Functions for encoding and decoding rfc2047 messages
+@c As of 2007-08-25...
+There are no Gnus dependencies in these files.
+@c
+Only a couple of tests for gnusy symbols.
 
 @item rfc2104.el
 RFC2104 Hashed Message Authentication Codes
+@c As of 2007-08-25...
+There are no Gnus dependencies in these files.
 
 @item rfc2231.el
 Functions for decoding rfc2231 headers
+@c As of 2007-08-25...
+There are no Gnus dependencies in these files.
 
 @item flow-fill.el
 Interpret RFC2646 "flowed" text.
@@ -167,6 +185,15 @@ Elisp native uudecode.
 @c As of 2005-12-06...
 There are no Gnus dependencies in this file.
 @c ... but the custom group is gnus-extract.
+
+@item canlock.el
+Functions for Cancel-Lock feature
+@c Cf. draft-ietf-usefor-cancel-lock-01.txt
+@c Although this draft has expired, Canlock-Lock revived in 2007 when
+@c major news providers (e.g. news.individual.org) started to use it.
+@c As of 2007-08-25...
+There are no Gnus dependencies in these files.
+
 @end table
 
 @subsection message
@@ -174,7 +201,10 @@ There are no Gnus dependencies in this file.
 All message composition from Gnus (both mail and news) takes place in
 Message mode buffers.  Message mode is intended to be a replacement for
 Emacs mail mode.  There should be no Gnus dependencies in
-@file{message.el}.
+@file{message.el}.  Alas it is not anymore.  Patches and suggestions to
+remove the dependencies are welcome.
+
+@c message.el requires nnheader which requires gnus-util.
 
 @subsection Emacs @acronym{MIME}
 
@@ -182,8 +212,8 @@ The files @file{mml*.el} and @file{mm-*.el} provide @acronym{MIME}
 functionality for Emacs.
 
 @acronym{MML} (@acronym{MIME} Meta Language) is supposed to be
-independent from Gnus.  Alas it is not anymore.
-
+independent from Gnus.  Alas it is not anymore.  Patches and suggestions
+to remove the dependencies are welcome.
 
 @subsection Gnus backends
 
@@ -192,27 +222,13 @@ The files @file{nn*.el} provide functionality for accessing NNTP
 ends (probably @file{nnml.el}, @file{nnfolder.el} and
 @file{nnmaildir.el} are the most widely used mail back ends).
 
-
-
 @c mm-uu requires nnheader which requires gnus-util.  message.el also
 @c requires nnheader.
 
-@c message / gnus
-@c 
-@c nn*
-@c 
-@c mm*
-@c
-@c rfc*
-@c 
-@c pgg*
-@c tla netrc pop3 dig dns ...
-@c format-spec.el
-
 
 @section Compatibility
 
-No Gnus should work on:
+No Gnus and Gnus 5.10.10 and up should work on:
 @itemize @bullet
 @item
 Emacs 21.1 and up.
@@ -220,7 +236,7 @@ Emacs 21.1 and up.
 XEmacs 21.4 and up.
 @end itemize
 
-Gnus 5.10 should work on:
+Gnus 5.10.8 and below should work on:
 @itemize @bullet
 @item
 Emacs 20.7 and up.
@@ -240,7 +256,7 @@ changes.  Only after a new major release, e.g. 5.10.1, there's usually a
 feature period of several months.  After the release of Gnus 5.10.6 the
 development of new features started again on the trunk while the 5.10
 series is continued on the stable branch (v5-10) from which more stable
-releases will be done when needed (5.10.7, @dots{}).
+releases will be done when needed (5.10.8, @dots{}).
 @ref{Gnus Development, ,Gnus Development, gnus, The Gnus Newsreader}
 
 Stable releases of Gnus finally become part of Emacs.  E.g. Gnus 5.8
@@ -346,10 +362,14 @@ Starting from No Gnus, the @file{GNUS-NEWS} is created from
 @heading Conventions for version information in defcustoms
 
 For new customizable variables introduced in Oort Gnus (including the
-v5-10 branch) use @code{:version "22.1" ;; Oort Gnus} including the
-comment.
+v5-10 branch) use @code{:version "22.1" ;; Oort Gnus} (including the
+comment) or e.g. @code{:version "22.2" ;; Gnus 5.10.10} if the feature
+was added for Emacs 22.2 and Gnus 5.10.10.
 @c
-If the variable is new in No Gnus use @code{:version "23.0" ;; No Gnus}.
+If the variable is new in No Gnus use @code{:version "23.1" ;; No Gnus}.
+
+The same applies for customizable variables when its default value was
+changed.
 
 @c Local Variables:
 @c mode: texinfo