Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-220

Merge from gnus--rel--5.10

Patches applied:

 * gnus--rel--5.10  (patch 45-52)

   - Update from CVS
   - Update from CVS: texi Makefile.in CVS keyw cruft
   - Update from CVS: ChangeLog tweaks

2005-03-29  Reiner Steib  <Reiner.Steib@gmx.de>

   * etc/gnus-refcard.tex, etc/gnus-logo.eps: New files.

2005-03-25  Katsumi Yamaoka  <yamaoka@jpl.org>

   * lisp/gnus/message.el (message-resend): Bind rfc2047-encode-encoded-words.

   * lisp/gnus/mm-util.el (mm-replace-in-string): New function.
   (mm-xemacs-find-mime-charset-1): Ignore errors while loading
   latin-unity, which cannot be used with XEmacs 21.1.

   * lisp/gnus/rfc2047.el (rfc2047-encode-function-alist): Rename from
   rfc2047-encoding-function-alist in order to avoid conflicting with
   the old version.
   (rfc2047-encode-message-header): Remove useless goto-char.
   (rfc2047-encodable-p): Don't move point.
   (rfc2047-syntax-table): Treat `(' and `)' as is.
   (rfc2047-encode-region): Concatenate words containing non-ASCII
   characters in structured fields; don't encode space-delimited
   ASCII words even in unstructured fields; don't break words at
   char-category boundaries; encode encoded words in structured
   fields; treat text within parentheses as special; show the
   original text when error has occurred; move point to the end of
   the region after encoding, suggested by IRIE Tetsuya
   <irie@t.email.ne.jp>; treat backslash-quoted characters as
   non-special; check carefully whether to encode special characters;
   fix some kind of misconfigured headers; signal a real error if
   debug-on-quit or debug-on-error is non-nil; don't infloop,
   suggested by Hiroshi Fujishima <pooh@nature.tsukuba.ac.jp>; assume
   the close parenthesis may be included in the encoded word; encode
   bogus delimiters.
   (rfc2047-encode-string): Use mm-with-multibyte-buffer.
   (rfc2047-encode-max-chars): New variable.
   (rfc2047-encode-1): New function.
   (rfc2047-encode): Use it; encode text so that it occupies the
   maximum width within 76-column; work correctly on Q encoding for
   iso-2022-* charsets; fold the line before encoding; don't append a
   space if the encoded word includes close parenthesis.
   (rfc2047-fold-region): Use existing whitespace for LWSP; make it
   sure not to break a line just after the header name.
   (rfc2047-b-encode-region): Remove.
   (rfc2047-b-encode-string): New function.
   (rfc2047-q-encode-region): Remove.
   (rfc2047-q-encode-string): New function.
   (rfc2047-encode-parameter): New function.
   (rfc2047-encoded-word-regexp): Don't use shy group.
   (rfc2047-decode-region): Follow rfc2047-encoded-word-regexp change.
   (rfc2047-parse-and-decode): Ditto.
   (rfc2047-decode): Treat the ascii coding-system as raw-text by
   default.

2005-03-25  Lars Magne Ingebrigtsen  <larsi@gnus.org>

   * lisp/gnus/rfc2047.el (rfc2047-encode-encoded-words): New variable.
   (rfc2047-field-value): Strip props.
   (rfc2047-encode-message-header): Disabled header folding -- not
   all headers can be folded, and this should be done by the message
   composition mode.  Probably.  I think.
   (rfc2047-encodable-p): Say that =? needs encoding.
   (rfc2047-encode-region): Encode =? strings.

2005-03-25  Jesper Harder  <harder@ifa.au.dk>

   * lisp/gnus/rfc2047.el (rfc2047-encoded-word-regexp): Support RFC 2231
   language tags; remove unnecessary '+'.  Reported by Stefan Wiens
   <s.wi@gmx.net>.
   (rfc2047-decode-string): Don't cons a string unnecessarily.
   (rfc2047-parse-and-decode, rfc2047-decode): Use a character for
   the encoding to avoid consing a string.
   (rfc2047-decode): Use mm-subst-char-in-string instead of
   mm-replace-chars-in-string.

2005-03-25  TSUCHIYA Masatoshi  <tsuchiya@namazu.org>

   * lisp/gnus/rfc2047.el (rfc2047-encode): Use uppercase letters to specify
   encodings of MIME-encoded words, in order to improve
   interoperability with several broken MUAs.

2005-03-21  Reiner Steib  <Reiner.Steib@gmx.de>

   * lisp/gnus/gnus-srvr.el (gnus-browse-select-group): Add NUMBER argument and
   pass it to `gnus-browse-read-group'.
   (gnus-browse-read-group): Add NUMBER argument and pass it to
   `gnus-group-read-ephemeral-group'.

   * lisp/gnus/gnus-group.el (gnus-group-read-ephemeral-group): Add NUMBER
   argument and pass it to `gnus-group-read-group'.

2005-03-19  Aidan Kehoe  <kehoea@parhasard.net>

   * lisp/gnus/mm-util.el (mm-xemacs-find-mime-charset): Only call
   mm-xemacs-find-mime-charset-1 if we have the mule feature
   available at runtime.

2005-03-25  Katsumi Yamaoka  <yamaoka@jpl.org>

   * man/emacs-mime.texi (Display Customization): Markup fixes.
   (rfc2047): Update.

2005-03-23  Reiner Steib  <Reiner.Steib@gmx.de>

   * man/gnus-faq.texi: Replaced with auto-generated version.

1 files changed, 28 insertions, 5 deletions

diff --git a/man/emacs-mime.texi b/man/emacs-mime.texi
index c128ed096c3..11a07df5361 100644
--- a/man/emacs-mime.texi
+++ b/man/emacs-mime.texi
@@ -387,15 +387,15 @@ The program used to start an external terminal.
 
 @item mm-enable-external
 @vindex mm-enable-external
-Indicate whether external MIME handlers should be used.
+Indicate whether external @acronym{MIME} handlers should be used.
 
-If @code{t}, all defined external MIME handlers are used.  If
+If @code{t}, all defined external @acronym{MIME} handlers are used.  If
 @code{nil}, files are saved to disk (@code{mailcap-save-binary-file}).
 If it is the symbol @code{ask}, you are prompted before the external
 @acronym{MIME} handler is invoked.
 
 When you launch an attachment through mailcap (@pxref{mailcap}) an
-attempt is made to use a safe viewer with the safest options--this isn't
+attempt is made to use a safe viewer with the safest options---this isn't
 the case if you save it to disk and launch it in a different way
 (command line or double-clicking).  Anyhow, if you want to be sure not
 to launch any external programs, set this variable to @code{nil} or
@@ -1327,8 +1327,8 @@ RFC2047 specifies two forms of encoding---@code{Q} (a
 Quoted-Printable-like encoding) and @code{B} (base64).  This alist
 specifies which charset should use which encoding.
 
-@item rfc2047-encoding-function-alist
-@vindex rfc2047-encoding-function-alist
+@item rfc2047-encode-function-alist
+@vindex rfc2047-encode-function-alist
 This is an alist of encoding / function pairs.  The encodings are
 @code{Q}, @code{B} and @code{nil}.
 
@@ -1336,6 +1336,11 @@ This is an alist of encoding / function pairs.  The encodings are
 @vindex rfc2047-encoded-word-regexp
 When decoding words, this library looks for matches to this regexp.
 
+@item rfc2047-encode-encoded-words
+@vindex rfc2047-encode-encoded-words
+The boolean variable specifies whether encoded words
+(e.g. @samp{=?hello?=}) should be encoded again.
+
 @end table
 
 Those were the variables, and these are this functions:
@@ -1366,6 +1371,24 @@ Decode the encoded words in the region.
 @findex rfc2047-decode-string
 Decode a string and return the results.
 
+@item rfc2047-encode-parameter
+@findex rfc2047-encode-parameter
+Encode a parameter in the RFC2047-like style.  This is a replacement for
+the @code{rfc2231-encode-string} function.  @xref{rfc2231}.
+
+When attaching files as @acronym{MIME} parts, we should use the RFC2231
+encoding to specify the file names containing non-@acronym{ASCII}
+characters.  However, many mail softwares don't support it in practice
+and recipients won't be able to extract files with correct names.
+Instead, the RFC2047-like encoding is acceptable generally.  This
+function provides the very RFC2047-like encoding, resigning to such a
+regrettable trend.  To use it, put the following line in your
+@file{~/.gnus.el} file:
+
+@lisp
+(defalias 'mail-header-encode-parameter 'rfc2047-encode-parameter)
+@end lisp
+
 @end table