Changes committed gnus/texi (8 files)

"Miles Bader" <[email protected]> Fri, 27 Feb 2009 00:35:58 +0100
Newsgroups gmane.emacs.gnus.commits
Message-ID <[email protected]>
Modified: ChangeLog emacs-mime.texi gnus-coding.texi gnus.texi
          message.texi pgg.texi sasl.texi sieve.texi

Merge from emacs--devo--0

Patches applied:

 * emacs--devo--0  (patch 1542, 1547-1548, 1550-1552, 1554)

   - Update from CVS
   - Merge from gnus--devo--0

2009-02-26  Tobias C. Rittweiler  <[email protected]>  (tiny change)

   * contrib/sendmail.el (sendmail-send-it): `call-process-region' can return a
   string.  (Bug#2428)

2009-02-07  Glenn Morris  <[email protected]>

   * contrib/sendmail.el (mail-bury-selects-summary, mail-yank-original): Doc fix.
   (rmail-output-to-rmail-buffer): Autoload it.
   (mail-do-fcc): Give it a doc string.  Update for mbox Rmail, simplify.

2009-02-25  Katsumi Yamaoka  <[email protected]>

   * lisp/gnus-dired.el: Remove autoload for gnus-setup-message.
   (gnus-dired-attach): Fake this-command value to prevent Gnus from
   displaying Gnus logo; always use compose-mail.

2009-02-23  Katsumi Yamaoka  <[email protected]>

   * lisp/gnus-dired.el: Tell autoload that gnus-setup-message is a macro.

2009-02-15  Glenn Morris  <[email protected]>

   * lisp/gnus-util.el (rmail-insert-rmail-file-header)
   (rmail-count-new-messages, rmail-show-message): Remove unnecessary
   autoloads.
   (rmail-default-rmail-file): Remove unnecessary declaration.
   (gnus-output-to-rmail): Handle mbox Rmail as well as Babyl Rmail.

2009-02-14  Glenn Morris  <[email protected]>

   * lisp/gnus.el (rmail-default-rmail-file): Remove declaration of deleted
   variable (only used in gnus-util, which declares it anyway).
   (rmail-output-to-rmail-file): Remove autoload of deleted function,
   which was only needed by gnus-art (changed to not use it any more).
   (rmail-insert-rmail-file-header): Remove autoload of deleted function,
   only used in gnus-util, which autoloads it itself.
   (rmail-update-summary): Fix autoload.

   * lisp/gnus-art.el (gnus-summary-save-in-mail): Use gnus-output-to-rmail
   rather than rmail-output-to-rmail-file.

2009-02-07  Glenn Morris  <[email protected]>

   * lisp/message.el (rmail-msg-restore-non-pruned-header): Remove unneeded
   autoload of function that no longer exists.
   (rmail-toggle-header): Declare.
   (message-forward-rmail-make-body): Handle mbox Rmail.

2009-02-26  Glenn Morris  <[email protected]>

   * texi/gnus.texi: Minor updates for mbox Rmail.

2009-02-26  Karl Berry  <[email protected]>

   * texi/gnus-coding.texi,
   * texi/gnus.texi,
   * texi/message.texi,
   * texi/pgg.texi,
   * texi/sasl.texi,
   * texi/sieve.texi: Consistently use @insertcopying in the Top node,
   @contents at the front (after @end titlepage),
   and @direntry after @copying.
   (Bug#1988)

Revision: [email protected]/gnus--devo--0--patch-581


Index: ChangeLog
diff -u gnus/texi/ChangeLog:7.441 gnus/texi/ChangeLog:7.442
--- ChangeLog:7.441	Fri Feb 20 20:10:02 2009
+++ ChangeLog	Fri Feb 27 00:35:58 2009
@@ -1,3 +1,19 @@
+2009-02-26  Glenn Morris  <[email protected]>
+
+	* gnus.texi: Minor updates for mbox Rmail.
+
+2009-02-26  Karl Berry  <[email protected]>
+
+	* gnus-coding.texi,
+	* gnus.texi,
+	* message.texi,
+	* pgg.texi,
+	* sasl.texi,
+	* sieve.texi: Consistently use @insertcopying in the Top node,
+	@contents at the front (after @end titlepage),
+	and @direntry after @copying.
+	(Bug#1988)
+
 2009-02-20  Teodor Zlatanov  <[email protected]>
 
 	* dir: Add auth.texi.
@@ -6284,7 +6300,7 @@
 	* gnus.texi (Mail Folders): Addition.
 
     Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-    2007, 2008 Free Software Foundation, Inc.
+    2007, 2008, 2009 Free Software Foundation, Inc.
 
   This file is part of GNU Emacs.
 
Index: emacs-mime.texi
diff -u gnus/texi/emacs-mime.texi:7.41 gnus/texi/emacs-mime.texi:7.42
--- emacs-mime.texi:7.41	Thu Jan 22 08:02:17 2009
+++ emacs-mime.texi	Fri Feb 27 00:35:58 2009
@@ -47,6 +47,8 @@
 @insertcopying
 @end titlepage
 
+@contents
+
 @node Top
 @top Emacs MIME
 
@@ -66,6 +68,10 @@
 recommended that anyone who intends writing @acronym{MIME}-compliant software
 read at least RFC2045 and RFC2047.
 
+@ifnottex
+@insertcopying
+@end ifnottex
+
 @menu
 * Decoding and Viewing::  A framework for decoding and viewing.
 * Composing::             @acronym{MML}; a language for describing @acronym{MIME} parts.
@@ -1873,8 +1879,6 @@
 @chapter Index
 @printindex cp
 
-@summarycontents
-@contents
 @bye
 
 
Index: gnus-coding.texi
diff -u gnus/texi/gnus-coding.texi:1.17 gnus/texi/gnus-coding.texi:1.18
--- gnus-coding.texi:1.17	Thu Jan 22 08:02:17 2009
+++ gnus-coding.texi	Fri Feb 27 00:35:58 2009
@@ -7,7 +7,8 @@
 @syncodeindex pg cp
 
 @copying
-Copyright (C) 2004, 2005, 2007, 2008, 2009  Free Software Foundation, Inc.
+Copyright @copyright{} 2004, 2005, 2007, 2008, 2009  Free Software
+Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -42,9 +43,14 @@
 @c anyway hoping that it might annoy someone enough to fix it.  ;-)
 @c Fixing only a paragraph also is appreciated.
 
+@ifnottex
 @node Top
 @top Gnus Coding Style and Maintainance Guide
 This manual describes @dots{}
+
+@insertcopying 
+@end ifnottex
+
 @menu
 * Gnus Coding Style:: Gnus Coding Style
 * Gnus Maintainance Guide:: Gnus Maintainance Guide
Index: gnus.texi
diff -u gnus/texi/gnus.texi:7.318 gnus/texi/gnus.texi:7.319
--- gnus.texi:7.318	Thu Feb 19 12:04:30 2009
+++ gnus.texi	Fri Feb 27 00:35:58 2009
@@ -320,10 +320,6 @@
 @end iflatex
 @end iftex
 
-@ifnottex
-@insertcopying
-@end ifnottex
-
 @dircategory Emacs
 @direntry
 * Gnus: (gnus).         The newsreader Gnus.
@@ -331,8 +327,6 @@
 @iftex
 @finalout
 @end iftex
-@setchapternewpage odd
-
 
 
 @titlepage
@@ -344,6 +338,8 @@
 @insertcopying
 @end titlepage
 
+@summarycontents
+@contents
 
 @node Top
 @top The Gnus Newsreader
@@ -358,6 +354,10 @@
 @c Adjust ../Makefile.in if you change the following line:
 This manual corresponds to No Gnus v0.11.
 
+@ifnottex
+@insertcopying
+@end ifnottex
+
 @end ifinfo
 
 @iftex
@@ -684,7 +684,7 @@
 Choosing a Mail Back End
 
 * Unix Mail Box::               Using the (quite) standard Un*x mbox.
-* Rmail Babyl::                 Emacs programs use the Rmail Babyl format.
+* Babyl::                       Babyl was used by older versions of Rmail.
 * Mail Spool::                  Store your mail in a private spool?
 * MH Spool::                    An mhspool-like back end.
 * Maildir::                     Another one-file-per-message format.
@@ -2208,7 +2208,7 @@
 @vindex gnus-auto-select-subject
 If @code{gnus-auto-select-first} is non-@code{nil}, select an article
 automatically when entering a group with the @kbd{SPACE} command.
-Which article this is is controlled by the
+Which article this is controlled by the
 @code{gnus-auto-select-subject} variable.  Valid values for this
 variable are:
 
@@ -4390,7 +4390,7 @@
 @node nnmairix
 @subsection nnmairix
 
-@cindex mairix 
+@cindex mairix
 @cindex nnmairix
 This paragraph describes how to set up mairix and the back end
 @code{nnmairix} for indexing and searching your mail from within
@@ -4480,7 +4480,7 @@
 containing mails from a certain sender, with a certain subject line or
 even for one specific thread based on the Message-ID.  If you check for
 new mail in these folders (e.g. by pressing @kbd{g} or @kbd{M-g}), they
-automatically update themselves by calling mairix. 
+automatically update themselves by calling mairix.
 
 You might ask why you need @code{nnmairix} at all, since mairix already
 creates the group, populates it with links to the mails so that you can
@@ -8524,7 +8524,8 @@
 @kindex O r (Summary)
 @findex gnus-summary-save-article-rmail
 Save the current article in Rmail format
-(@code{gnus-summary-save-article-rmail}).
+(@code{gnus-summary-save-article-rmail}).  This is mbox since Emacs 23,
+Babyl in older versions.
 
 @item O f
 @kindex O f (Summary)
@@ -8610,7 +8611,11 @@
 @findex gnus-summary-save-in-rmail
 @vindex gnus-rmail-save-name
 @findex gnus-plain-save-name
-This is the default format, @dfn{Babyl}.  Uses the function in the
+This is the default format, that used by the Rmail package.  Since Emacs
+23, Rmail uses standard mbox format.  Before this, it used the
+@dfn{Babyl} format.  Accordingly, this command writes mbox format since
+Emacs 23, unless appending to an existing Babyl file.  In older versions
+of Emacs, it always uses Babyl format.  Uses the function in the
 @code{gnus-rmail-save-name} variable to get a file name to save the
 article in.  The default is @code{gnus-plain-save-name}.
 
@@ -14470,7 +14475,7 @@
 Does essentially the same, but uses @code{telnet} instead of @samp{netcat}
 to connect to the real @acronym{NNTP} server from the intermediate host.
 @code{telnet} is a bit less robust because of things like
-line-end-conversion, but sometimes @code{netcat} is simply not available.  
+line-end-conversion, but sometimes @code{netcat} is simply not available.
 
 @code{nntp-open-via-rlogin-and-telnet}-specific variables:
 
@@ -16473,8 +16478,8 @@
 @vindex nnmh-get-new-mail
 @vindex nnfolder-get-new-mail
 This might be too much, if, for instance, you are reading mail quite
-happily with @code{nnml} and just want to peek at some old Rmail
-file you have stashed away with @code{nnbabyl}.  All back ends have
+happily with @code{nnml} and just want to peek at some old (pre-Emacs
+23) Rmail file you have stashed away with @code{nnbabyl}.  All back ends have
 variables called back-end-@code{get-new-mail}.  If you want to disable
 the @code{nnbabyl} mail reading, you edit the virtual server for the
 group to have a setting where @code{nnbabyl-get-new-mail} to @code{nil}.
@@ -16498,7 +16503,7 @@
 
 @menu
 * Unix Mail Box::               Using the (quite) standard Un*x mbox.
-* Rmail Babyl::                 Emacs programs use the Rmail Babyl format.
+* Babyl::                       Babyl was used by older versions of Rmail.
 * Mail Spool::                  Store your mail in a private spool?
 * MH Spool::                    An mhspool-like back end.
 * Maildir::                     Another one-file-per-message format.
@@ -16538,27 +16543,26 @@
 @end table
 
 
-@node Rmail Babyl
-@subsubsection Rmail Babyl
+@node Babyl
+@subsubsection Babyl
 @cindex nnbabyl
-@cindex Rmail mbox
 
 @vindex nnbabyl-active-file
 @vindex nnbabyl-mbox-file
-The @dfn{nnbabyl} back end will use a Babyl mail box (aka. @dfn{Rmail
-mbox}) to store mail.  @code{nnbabyl} will add extra headers to each
-mail article to say which group it belongs in.
+The @dfn{nnbabyl} back end will use a Babyl mail box to store mail.
+@code{nnbabyl} will add extra headers to each mail article to say which
+group it belongs in.
 
 Virtual server settings:
 
 @table @code
 @item nnbabyl-mbox-file
 @vindex nnbabyl-mbox-file
-The name of the Rmail mbox file.  The default is @file{~/RMAIL}
+The name of the Babyl file.  The default is @file{~/RMAIL}
 
 @item nnbabyl-active-file
 @vindex nnbabyl-active-file
-The name of the active file for the rmail box.  The default is
+The name of the active file for the Babyl file.  The default is
 @file{~/.rmail-active}
 
 @item nnbabyl-get-new-mail
@@ -17154,7 +17158,8 @@
 VM, for that matter) continue to support this format because it's
 perceived as having some good qualities in those mailer-specific
 headers/status bits stuff.  Rmail itself still exists as well, of
-course, and is still maintained by Stallman.
+course, and is still maintained within Emacs.  Since Emacs 23, it
+uses standard mbox format rather than Babyl.
 
 Both of the above forms leave your mail in a single file on your
 file system, and they must parse that entire file each time you take a
@@ -18640,9 +18645,8 @@
 
 @table @code
 @cindex Babyl
-@cindex Rmail mbox
 @item babyl
-The Babyl (Rmail) mail box.
+The Babyl format.
 
 @cindex mbox
 @cindex Unix mbox
@@ -25036,7 +25040,7 @@
 @vindex nnimap-split-download-body
 Note for IMAP users: if you use the @code{spam-check-bogofilter},
 @code{spam-check-ifile}, and @code{spam-check-stat} spam back ends,
-you should also set set the variable @code{nnimap-split-download-body}
+you should also set the variable @code{nnimap-split-download-body}
 to @code{t}.  These spam back ends are most useful when they can
 ``scan'' the full message body.  By default, the nnimap back end only
 retrieves the message headers; @code{nnimap-split-download-body} tells
@@ -26594,10 +26598,10 @@
 @end enumerate
 
 @menu
-* Setup::                       
-* Fancy splitting to parent::   
-* Store custom flags and keywords::  
-* Store arbitrary data::        
+* Setup::
+* Fancy splitting to parent::
+* Store custom flags and keywords::
+* Store arbitrary data::
 @end menu
 
 @node Setup
@@ -28830,6 +28834,7 @@
 @item
 @code{message-insinuate-rmail}
 
+@c FIXME should that not be 'message-user-agent?
 Adding @code{(message-insinuate-rmail)} and @code{(setq
 mail-user-agent 'gnus-user-agent)} in @file{.emacs} convinces Rmail to
 compose, reply and forward messages in message-mode, where you can
@@ -30516,7 +30521,7 @@
 
 @lisp
 ;;; @r{nndir.el --- single directory newsgroup access for Gnus}
-;; @r{Copyright (C) 1995,96 Free Software Foundation, Inc.}
+;; @r{Copyright (C) 1995,1996 Free Software Foundation, Inc.}
 
 ;;; @r{Code:}
 
@@ -31276,8 +31281,6 @@
 @chapter Key Index
 @printindex ky
 
-@summarycontents
-@contents
 @bye
 
 @iftex
Index: message.texi
diff -u gnus/texi/message.texi:7.62 gnus/texi/message.texi:7.63
--- message.texi:7.62	Thu Jan 22 08:02:17 2009
+++ message.texi	Fri Feb 27 00:35:58 2009
@@ -32,7 +32,6 @@
 @iftex
 @finalout
 @end iftex
-@setchapternewpage odd
 
 @titlepage
 @title Message Manual
@@ -43,11 +42,17 @@
 @vskip 0pt plus 1filll
 @insertcopying
 @end titlepage
-@page
+
+@summarycontents
+@contents
 
 @node Top
 @top Message
 
+@ifnottex
+@insertcopying
+@end ifnottex
+
 All message composition from Gnus (both mail and news) takes place in
 Message mode buffers.
 
@@ -2432,8 +2437,6 @@
 @chapter Key Index
 @printindex ky
 
-@summarycontents
-@contents
 @bye
 
 @c End:
Index: pgg.texi
diff -u gnus/texi/pgg.texi:7.25 gnus/texi/pgg.texi:7.26
--- pgg.texi:7.25	Thu Jan 22 08:02:17 2009
+++ pgg.texi	Fri Feb 27 00:35:58 2009
@@ -1,12 +1,13 @@
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename pgg
+@settitle PGG @value{VERSION}
 
 @set VERSION 0.1
 
-
 @copying
-This file describes PGG, an Emacs interface to various PGP implementations.
+This file describes PGG @value{VERSION}, an Emacs interface to various
+PGP implementations.
 
 Copyright @copyright{} 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009
 Free Software Foundation, Inc.
@@ -30,9 +31,6 @@
 * PGG: (pgg).   Emacs interface to various PGP implementations.
 @end direntry
 
-@settitle PGG @value{VERSION}
-
-
 @titlepage
 @title PGG
 
@@ -42,14 +40,20 @@
 @vskip 0pt plus 1filll
 @insertcopying
 @end titlepage
-@page
+
+@contents
 
 @node Top
 @top PGG
-This manual describes PGG.  PGG is an interface library between Emacs
+
+PGG is an interface library between Emacs
 and various tools for secure communication.  PGG also provides a simple
 user interface to encrypt, decrypt, sign, and verify MIME messages.
 
+@ifnottex
+@insertcopying 
+@end ifnottex
+
 @menu
 * Overview::                    What PGG is.
 * Prerequisites::               Complicated stuff you may have to do.
@@ -491,8 +495,6 @@
 @unnumbered Variable Index
 @printindex vr
 
-@summarycontents
-@contents
 @bye
 
 @c End:
Index: sasl.texi
diff -u gnus/texi/sasl.texi:7.11 gnus/texi/sasl.texi:7.12
--- sasl.texi:7.11	Thu Jan 22 08:02:17 2009
+++ sasl.texi	Fri Feb 27 00:35:58 2009
@@ -3,16 +3,10 @@
 @setfilename sasl.info
 
 @set VERSION 0.2
-
-@dircategory Emacs
-@direntry
-* SASL: (sasl).   The Emacs SASL library.
-@end direntry
-
 @settitle Emacs SASL Library @value{VERSION}
 
 @copying
-This file describes the Emacs SASL library.
+This file describes the Emacs SASL library, version @value{VERSION}.
 
 Copyright @copyright{} 2000, 2004, 2005, 2006, 2007, 2008, 2009
 Free Software Foundation, Inc.
@@ -37,10 +31,14 @@
 @end quotation
 @end copying
 
-@tex
+@dircategory Emacs
+@direntry
+* SASL: (sasl).   The Emacs SASL library.
+@end direntry
+
 
 @titlepage
-@title Emacs SASL Library
+@title Emacs SASL Library @value{VERSION}
 
 @author by Daiki Ueno
 @page
@@ -48,17 +46,18 @@
 @vskip 0pt plus 1filll
 @insertcopying
 @end titlepage
-@page
 
-@end tex
 
 @node Top
 @top Emacs SASL
-This manual describes the Emacs SASL library.
 
-A common interface to share several authentication mechanisms between
+SASL is a common interface to share several authentication mechanisms between
 applications using different protocols.
 
+@ifnottex
+@insertcopying 
+@end ifnottex
+
 @menu
 * Overview::                    What Emacs SASL library is.
 * How to use::                  Adding authentication support to your applications.
Index: sieve.texi
diff -u gnus/texi/sieve.texi:7.16 gnus/texi/sieve.texi:7.17
--- sieve.texi:7.16	Thu Jan 22 08:02:17 2009
+++ sieve.texi	Fri Feb 27 00:35:58 2009
@@ -44,13 +44,13 @@
 @insertcopying
 @end titlepage
 
+@summarycontents
+@contents
 
 @node Top
 @top Sieve Support for Emacs
 
-This manual documents the Emacs Sieve package.
-
-It is intended as a users manual for Sieve Mode and Manage Sieve, and
+This is intended as a users manual for Sieve Mode and Manage Sieve, and
 as a reference manual for the @samp{sieve-manage} protocol Emacs Lisp
 API.
 
@@ -58,7 +58,9 @@
 is documented in RFC 3028.  This manual does not attempt to document
 the language, so keep RFC 3028 around.
 
-A good online Sieve resources is @uref{http://www.cyrusoft.com/sieve/}.
+@ifnottex
+@insertcopying
+@end ifnottex
 
 @menu
 * Installation::          Getting ready to use the package.
@@ -352,8 +354,6 @@
 @unnumbered Index
 @printindex cp
 
-@summarycontents
-@contents
 @bye
 
 @c End: