aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorGnus developers2014-03-23 23:16:06 +0000
committerKatsumi Yamaoka2014-03-23 23:16:06 +0000
commitc1df18450b666614c802ab5c8045ce18e36798e8 (patch)
treeb90c7374d4262e2b5bf92015427fb128e310eab7 /doc
parent7a31038fd91fec168aa6ff5d09ce9bfc819d25d5 (diff)
downloademacs-c1df18450b666614c802ab5c8045ce18e36798e8.tar.gz
emacs-c1df18450b666614c802ab5c8045ce18e36798e8.zip
Merge from Gnus git master
2014-03-14 Katsumi Yamaoka <yamaoka@jpl.org> * gnus.texi (Ma Gnus): Mention header attachment buttons. 2014-03-05 Lars Ingebrigtsen <larsi@gnus.org> * emacs-mime.texi (MML Definition): Document recipient-filename. 2014-02-05 Katsumi Yamaoka <yamaoka@jpl.org> * gnus.texi (MIME Commands): Mention gnus-mime-buttonize-attachments-in-header and gnus-mime-display-attachment-buttons-in-header. 2014-02-01 Lars Ingebrigtsen <larsi@gnus.org> * message.texi (Forwarding): Mention `message-forward-included-headers'. 2014-01-31 Lars Ingebrigtsen <larsi@gnus.org> * gnus.texi: w3 is no longer supported by Gnus.
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/ChangeLog23
-rw-r--r--doc/misc/emacs-mime.texi18
-rw-r--r--doc/misc/gnus-faq.texi6
-rw-r--r--doc/misc/gnus.texi72
-rw-r--r--doc/misc/message.texi8
5 files changed, 72 insertions, 55 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 1660527ff42..e20fc9955e7 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,26 @@
12014-03-23 Katsumi Yamaoka <yamaoka@jpl.org>
2
3 * gnus.texi (Ma Gnus): Mention header attachment buttons.
4
52014-03-23 Lars Ingebrigtsen <larsi@gnus.org>
6
7 * emacs-mime.texi (MML Definition): Document recipient-filename.
8
92014-03-23 Katsumi Yamaoka <yamaoka@jpl.org>
10
11 * gnus.texi (MIME Commands): Mention
12 gnus-mime-buttonize-attachments-in-header and
13 gnus-mime-display-attachment-buttons-in-header.
14
152014-03-23 Lars Ingebrigtsen <larsi@gnus.org>
16
17 * message.texi (Forwarding): Mention
18 `message-forward-included-headers'.
19
202014-03-23 Lars Ingebrigtsen <larsi@gnus.org>
21
22 * gnus.texi: w3 is no longer supported by Gnus.
23
12014-03-22 Glenn Morris <rgm@gnu.org> 242014-03-22 Glenn Morris <rgm@gnu.org>
2 25
3 * efaq.texi (Informational files for Emacs): Do not mention etc/GNU. 26 * efaq.texi (Informational files for Emacs): Do not mention etc/GNU.
diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi
index 7931ab298f0..0f717d34096 100644
--- a/doc/misc/emacs-mime.texi
+++ b/doc/misc/emacs-mime.texi
@@ -405,7 +405,7 @@ variable will cause @samp{text/html} parts to be treated as attachments.
405@item mm-text-html-renderer 405@item mm-text-html-renderer
406@vindex mm-text-html-renderer 406@vindex mm-text-html-renderer
407This selects the function used to render @acronym{HTML}. The predefined 407This selects the function used to render @acronym{HTML}. The predefined
408renderers are selected by the symbols @code{gnus-article-html}, @code{w3}, 408renderers are selected by the symbols @code{gnus-article-html},
409@code{w3m}@footnote{See @uref{http://emacs-w3m.namazu.org/} for more 409@code{w3m}@footnote{See @uref{http://emacs-w3m.namazu.org/} for more
410information about emacs-w3m}, @code{links}, @code{lynx}, 410information about emacs-w3m}, @code{links}, @code{lynx},
411@code{w3m-standalone} or @code{html2text}. If @code{nil} use an 411@code{w3m-standalone} or @code{html2text}. If @code{nil} use an
@@ -418,11 +418,11 @@ Some @acronym{HTML} mails might have the trick of spammers using
418@samp{<img>} tags. It is likely to be intended to verify whether you 418@samp{<img>} tags. It is likely to be intended to verify whether you
419have read the mail. You can prevent your personal information from 419have read the mail. You can prevent your personal information from
420leaking by setting this option to @code{nil} (which is the default). 420leaking by setting this option to @code{nil} (which is the default).
421It is currently ignored by Emacs/w3. For emacs-w3m, you may use the 421For emacs-w3m, you may use the command @kbd{t} on the image anchor to
422command @kbd{t} on the image anchor to show an image even if it is 422show an image even if it is @code{nil}.@footnote{The command @kbd{T}
423@code{nil}.@footnote{The command @kbd{T} will load all images. If you 423will load all images. If you have set the option
424have set the option @code{w3m-key-binding} to @code{info}, use @kbd{i} 424@code{w3m-key-binding} to @code{info}, use @kbd{i} or @kbd{I}
425or @kbd{I} instead.} 425instead.}
426 426
427@item mm-w3m-safe-url-regexp 427@item mm-w3m-safe-url-regexp
428@vindex mm-w3m-safe-url-regexp 428@vindex mm-w3m-safe-url-regexp
@@ -648,6 +648,12 @@ The @acronym{MIME} type of the part (@code{Content-Type}).
648Use the contents of the file in the body of the part 648Use the contents of the file in the body of the part
649(@code{Content-Disposition}). 649(@code{Content-Disposition}).
650 650
651@item recipient-filename
652Use this as the file name in the generated @acronym{MIME} message for
653the recipient. That is, even if the file is called @file{foo.txt}
654locally, use this name instead in the @code{Content-Disposition} in
655the sent message.
656
651@item charset 657@item charset
652The contents of the body of the part are to be encoded in the character 658The contents of the body of the part are to be encoded in the character
653set specified (@code{Content-Type}). @xref{Charset Translation}. 659set specified (@code{Content-Type}). @xref{Charset Translation}.
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi
index 858ce8c2a50..a053164691f 100644
--- a/doc/misc/gnus-faq.texi
+++ b/doc/misc/gnus-faq.texi
@@ -723,7 +723,7 @@ POP3 mail source. See @pxref{Mail Source Specifiers} for VALUE.
723 the top of the article buffer? 723 the top of the article buffer?
724* FAQ 4-6:: I'd like Gnus NOT to render HTML-mails but show me the 724* FAQ 4-6:: I'd like Gnus NOT to render HTML-mails but show me the
725 text part if it's available. How to do it? 725 text part if it's available. How to do it?
726* FAQ 4-7:: Can I use some other browser than w3 to render my 726* FAQ 4-7:: Can I use some other browser than shr to render my
727 HTML-mails? 727 HTML-mails?
728* FAQ 4-8:: Is there anything I can do to make poorly formatted 728* FAQ 4-8:: Is there anything I can do to make poorly formatted
729 mails more readable? 729 mails more readable?
@@ -868,12 +868,12 @@ too.
868@node FAQ 4-7 868@node FAQ 4-7
869@subsubheading Question 4.7 869@subsubheading Question 4.7
870 870
871Can I use some other browser than w3 to render my HTML-mails? 871Can I use some other browser than w3m to render my HTML-mails?
872 872
873@subsubheading Answer 873@subsubheading Answer
874 874
875Only if you use Gnus 5.10 or younger. In this case you've got the 875Only if you use Gnus 5.10 or younger. In this case you've got the
876choice between w3, w3m, links, lynx and html2text, which 876choice between shr, w3m, links, lynx and html2text, which
877one is used can be specified in the variable 877one is used can be specified in the variable
878mm-text-html-renderer, so if you want links to render your 878mm-text-html-renderer, so if you want links to render your
879mail say 879mail say
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 10bc617734f..1749053a2a2 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -704,7 +704,6 @@ Browsing the Web
704* Archiving Mail:: 704* Archiving Mail::
705* Web Searches:: Creating groups from articles that match a string. 705* Web Searches:: Creating groups from articles that match a string.
706* RSS:: Reading RDF site summary. 706* RSS:: Reading RDF site summary.
707* Customizing W3:: Doing stuff to Emacs/W3 from Gnus.
708 707
709Other Sources 708Other Sources
710 709
@@ -9140,9 +9139,6 @@ Use Gnus simple html renderer.
9140@item gnus-w3m 9139@item gnus-w3m
9141Use Gnus rendered based on w3m. 9140Use Gnus rendered based on w3m.
9142 9141
9143@item w3
9144Use Emacs/W3.
9145
9146@item w3m 9142@item w3m
9147Use @uref{http://emacs-w3m.namazu.org/, emacs-w3m}. 9143Use @uref{http://emacs-w3m.namazu.org/, emacs-w3m}.
9148 9144
@@ -9805,6 +9801,19 @@ Make all the @acronym{MIME} parts have buttons in front of them. This is
9805mostly useful if you wish to save (or perform other actions) on inlined 9801mostly useful if you wish to save (or perform other actions) on inlined
9806parts. 9802parts.
9807 9803
9804@item W M h
9805@kindex W M h (Summary)
9806@findex gnus-mime-buttonize-attachments-in-header
9807@vindex gnus-mime-display-attachment-buttons-in-header
9808Display @acronym{MIME} part buttons in the end of the header of an
9809article (@code{gnus-mime-buttonize-attachments-in-header}). This
9810command toggles the display. Note that buttons to be added to the
9811header are only the ones that aren't inlined in the body. If you want
9812those buttons always to be displayed, set
9813@code{gnus-mime-display-attachment-buttons-in-header} to non-@code{nil}.
9814The default is @code{t}. To change the appearance of buttons, customize
9815@code{gnus-header-face-alist}.
9816
9808@item K m 9817@item K m
9809@kindex K m (Summary) 9818@kindex K m (Summary)
9810@findex gnus-summary-repair-multipart 9819@findex gnus-summary-repair-multipart
@@ -16841,12 +16850,8 @@ interfaces to these sources.
16841* Archiving Mail:: 16850* Archiving Mail::
16842* Web Searches:: Creating groups from articles that match a string. 16851* Web Searches:: Creating groups from articles that match a string.
16843* RSS:: Reading RDF site summary. 16852* RSS:: Reading RDF site summary.
16844* Customizing W3:: Doing stuff to Emacs/W3 from Gnus.
16845@end menu 16853@end menu
16846 16854
16847All the web sources require Emacs/W3 and the url library or those
16848alternatives to work.
16849
16850The main caveat with all these web sources is that they probably won't 16855The main caveat with all these web sources is that they probably won't
16851work for a very long time. Gleaning information from the @acronym{HTML} data 16856work for a very long time. Gleaning information from the @acronym{HTML} data
16852is guesswork at best, and when the layout is altered, the Gnus back end 16857is guesswork at best, and when the layout is altered, the Gnus back end
@@ -16922,10 +16927,6 @@ make money off of advertisements, not to provide services to the
16922community. Since @code{nnweb} washes the ads off all the articles, one 16927community. Since @code{nnweb} washes the ads off all the articles, one
16923might think that the providers might be somewhat miffed. We'll see. 16928might think that the providers might be somewhat miffed. We'll see.
16924 16929
16925You must have the @code{url} and @code{W3} package or those alternatives
16926(try @code{customize-group} on the @samp{mm-url} variable group)
16927installed to be able to use @code{nnweb}.
16928
16929Virtual server variables: 16930Virtual server variables:
16930 16931
16931@table @code 16932@table @code
@@ -17123,38 +17124,6 @@ Parameters}) in order to display @samp{text/html} parts only in
17123@end lisp 17124@end lisp
17124 17125
17125 17126
17126@node Customizing W3
17127@subsection Customizing W3
17128@cindex W3
17129@cindex html
17130@cindex url
17131@cindex Netscape
17132
17133Gnus uses the url library to fetch web pages and Emacs/W3 (or those
17134alternatives) to display web pages. Emacs/W3 is documented in its own
17135manual, but there are some things that may be more relevant for Gnus
17136users.
17137
17138For instance, a common question is how to make Emacs/W3 follow links
17139using the @code{browse-url} functions (which will call some external web
17140browser like Netscape). Here's one way:
17141
17142@lisp
17143(eval-after-load "w3"
17144 '(progn
17145 (fset 'w3-fetch-orig (symbol-function 'w3-fetch))
17146 (defun w3-fetch (&optional url target)
17147 (interactive (list (w3-read-url-with-default)))
17148 (if (eq major-mode 'gnus-article-mode)
17149 (browse-url url)
17150 (w3-fetch-orig url target)))))
17151@end lisp
17152
17153Put that in your @file{.emacs} file, and hitting links in W3-rendered
17154@acronym{HTML} in the Gnus article buffers will use @code{browse-url} to
17155follow the link.
17156
17157
17158@node Other Sources 17127@node Other Sources
17159@section Other Sources 17128@section Other Sources
17160 17129
@@ -26338,7 +26307,7 @@ XEmacs is distributed as a collection of packages. You should install
26338whatever packages the Gnus XEmacs package requires. The current 26307whatever packages the Gnus XEmacs package requires. The current
26339requirements are @samp{gnus}, @samp{mail-lib}, @samp{xemacs-base}, 26308requirements are @samp{gnus}, @samp{mail-lib}, @samp{xemacs-base},
26340@samp{eterm}, @samp{sh-script}, @samp{net-utils}, @samp{os-utils}, 26309@samp{eterm}, @samp{sh-script}, @samp{net-utils}, @samp{os-utils},
26341@samp{dired}, @samp{mh-e}, @samp{sieve}, @samp{ps-print}, @samp{W3}, 26310@samp{dired}, @samp{mh-e}, @samp{sieve}, @samp{ps-print},
26342@samp{pgg}, @samp{mailcrypt}, @samp{ecrypto}, and @samp{sasl}. 26311@samp{pgg}, @samp{mailcrypt}, @samp{ecrypto}, and @samp{sasl}.
26343 26312
26344 26313
@@ -28415,6 +28384,19 @@ New features in Ma Gnus:
28415 28384
28416@itemize @bullet 28385@itemize @bullet
28417 28386
28387@item Changes in summary and article mode
28388@c **************************************
28389
28390@itemize @bullet
28391
28392@item
28393By default, @acronym{MIME} part buttons for attachments (if any) will
28394appear in the end of the article header in addition to the bottom of the
28395article body, so you can easily find them without scrolling the article
28396again and again. @xref{MIME Commands}.
28397
28398@end itemize
28399
28418@item Changes in Message mode and related Gnus features 28400@item Changes in Message mode and related Gnus features
28419@c **************************************************** 28401@c ****************************************************
28420 28402
diff --git a/doc/misc/message.texi b/doc/misc/message.texi
index 9be8ca05620..6d5a00ba819 100644
--- a/doc/misc/message.texi
+++ b/doc/misc/message.texi
@@ -310,7 +310,13 @@ news.
310@table @code 310@table @code
311@item message-forward-ignored-headers 311@item message-forward-ignored-headers
312@vindex message-forward-ignored-headers 312@vindex message-forward-ignored-headers
313All headers that match this regexp will be deleted when forwarding a message. 313In non-@code{nil}, all headers that match this regexp will be deleted
314when forwarding a message.
315
316@item message-forward-included-headers
317@vindex message-forward-included-headers
318In non-@code{nil}, only headers that match this regexp will be kept
319when forwarding a message.
314 320
315@item message-make-forward-subject-function 321@item message-make-forward-subject-function
316@vindex message-make-forward-subject-function 322@vindex message-make-forward-subject-function