X-Git-Url: http://cgit.sxemacs.org/?a=blobdiff_plain;f=texi%2Femacs-mime.texi;h=40886239bb6e995eb2f986ec7414a97e5323f8f3;hb=debc0d2f431d6d1a9aae0a7e54033be528b53ca2;hp=44042de8e0969b56748ab11588c9f507958b75b2;hpb=e9d1e12582c9e58f15a9b1382c771bea138bdbe4;p=gnus diff --git a/texi/emacs-mime.texi b/texi/emacs-mime.texi index 44042de8e..40886239b 100644 --- a/texi/emacs-mime.texi +++ b/texi/emacs-mime.texi @@ -18,7 +18,7 @@ This file documents the Emacs MIME interface functionality. -Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc. +Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -240,7 +240,20 @@ at the beginning of the narrowed buffer. @item mail-header-narrow-to-field @findex mail-header-narrow-to-field -Narrow the buffer to the header under point. +Narrow the buffer to the header under point. Understands continuation +headers. + +@item mail-header-fold-field +@findex mail-header-fold-field +Fold the header under point. + +@item mail-header-unfold-field +@findex mail-header-unfold-field +Unfold the header under point. + +@item mail-header-field-value +@findex mail-header-field-value +Return the value of the field under point. @item mail-encode-encoded-word-region @findex mail-encode-encoded-word-region @@ -634,7 +647,7 @@ Take a year number and say whether it's a leap year. @item time-to-day-in-year Take a time and return the day number within the year that the time is -in. +in. @end table @@ -988,9 +1001,27 @@ Prompt for a mailcap method to use to view the part. @table @code +@item mm-inline-text-html-renderer +@findex mm-inline-text-html-render-with-w3 +@findex mm-inline-text-html-render-with-w3m +This function will be used to convert the HTML to the text. There are +two pre-defined functions: @code{mm-inline-text-html-render-with-w3}, +which uses Emacs/w3; and @code{mm-inline-text-html-render-with-w3m}, +which uses emacs-w3m (see @uref{http://emacs-w3m.namazu.org/} for more +information about emacs-w3m). The function will be called with a MIME +handle as the argument. + +@item mm-inline-text-html-with-images +Some HTML mails might have the trick of spammers using @samp{} tags. +It is likely to be intended to verify whether you have read the mail. +You can prevent your personal informations from leaking by setting this +option to @code{nil} (which is the default). It is currently ignored by +Emacs/w3. For emacs-w3m, you may use the command @kbd{t} on the image +anchor to show an image even if it is @code{nil}. + @item mm-inline-media-tests This is an alist where the key is a @sc{mime} type, the second element -is a function to display the part @dfn{inline} (i.e., inside Emacs), and +is a function to display the part @dfn{inline} (i.e., inside Emacs), and the third element is a form to be @code{eval}ed to say whether the part can be displayed inline. @@ -1010,7 +1041,7 @@ be displayed automatically. @item mm-attachment-override-types Some @sc{mime} agents create parts that have a content-disposition of -@samp{attachment}. This variable allows overriding that disposition and +@samp{attachment}. This variable allows overriding that disposition and displaying the part inline. (Note that the disposition is only overridden if we are able to, and want to, display the part inline.) @@ -1021,10 +1052,13 @@ last possible part of a message, as that is supposed to be the richest. However, users may prefer other types instead, and this list says what types are most unwanted. If, for instance, @samp{text/html} parts are very unwanted, and @samp{text/richtech} parts are somewhat unwanted, -then the value of this variable should be set to: +you could say something like: @lisp -("text/html" "text/richtext") +(setq mm-discouraged-alternatives + '("text/html" "text/richtext") + mm-automatic-display + (remove "text/html" mm-automatic-display)) @end lisp @item mm-inline-large-images-p @@ -1037,7 +1071,7 @@ library will display it externally (e.g. with @samp{ImageMagick} or makes the library display all inline images as inline, regardless of their size. -@item mm-inline-override-p +@item mm-inline-override-type @code{mm-inlined-types} may include regular expressions, for example to specify that all @samp{text/.*} parts be displayed inline. If a user prefers to have a type that matches such a regular expression be treated @@ -1066,7 +1100,7 @@ Here's an example viewer for displaying @code{text/enriched} inline: @end lisp We see that the function takes a @sc{mime} handle as its parameter. It -then goes to a temporary buffer, inserts the text of the part, does some +then goes to a temporary buffer, inserts the text of the part, does some work on the text, stores the result, goes back to the buffer it was called from and inserts the result. @@ -1100,6 +1134,7 @@ string containing the @sc{mime} message. * Advanced MML Example:: Another example MML document. * Charset Translation:: How charsets are mapped from @sc{mule} to MIME. * Conversion:: Going from @sc{mime} to MML and vice versa. +* Flowed text:: Soft and hard newlines. @end menu @@ -1199,6 +1234,10 @@ RFC822 date when the part was modified (@code{Content-Disposition}). @item read-date RFC822 date when the part was read (@code{Content-Disposition}). +@item recipients +Who to encrypt/sign the part to. This field is used to override any +auto-detection based on the To/CC headers. + @item size The size (in octets) of the part (@code{Content-Disposition}). @@ -1360,7 +1399,7 @@ given by @code{mail-parse-charset} (a symbol) is used. (Never set this variable directly, though. If you want to change the default charset, please consult the documentation of the package which you use to process @sc{mime} messages. -@xref{Various Message Variables, , Various Message Variables, message, +@xref{Various Message Variables, , Various Message Variables, message, Message Manual}, for example.) If there are only ASCII characters, the @sc{mime} charset US-ASCII is used, of course. @@ -1412,6 +1451,27 @@ other. The resulting contents of the message should remain equivalent, if not identical. +@node Flowed text +@section Flowed text +@cindex format=flowed + +The Emacs @sc{mime} library will respect the @code{use-hard-newlines} +variable (@pxref{Hard and Soft Newlines, ,Hard and Soft Newlines, +emacs, Emacs Manual}) when encoding a message, and the +``format=flowed'' Content-Type parameter when decoding a message. + +On encoding text, lines terminated by soft newline characters are +filled together and wrapped after the column decided by +@code{fill-flowed-encode-column}. This variable controls how the text +will look in a client that does not support flowed text, the default +is to wrap after 66 characters. If hard newline characters are not +present in the buffer, no flow encoding occurs. + +On decoding flowed text, lines with soft newline characters are filled +together and wrapped after the column decided by +@code{fill-flowed-display-column}. The default is to wrap after +@code{fill-column}. + @node Standards @chapter Standards @@ -1465,6 +1525,9 @@ Administrative Messages Communicating Presentation Information in Internet Messages: The Content-Disposition Header Field +@item RFC2646 +Documentation of the text/plain format parameter for flowed text. + @end table @@ -1480,5 +1543,4 @@ Content-Disposition Header Field @c Local Variables: @c mode: texinfo @c coding: iso-8859-1 -@c buffer-file-coding-system: iso-8859-1 @c End: