ChangeLog fixes
[bpt/emacs.git] / lisp / gnus / gnus-art.el
CommitLineData
eec82323 1;;; gnus-art.el --- article mode commands for Gnus
e84b4b86 2
ba318903 3;; Copyright (C) 1996-2014 Free Software Foundation, Inc.
eec82323 4
6748645f 5;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
eec82323
LMI
6;; Keywords: news
7
8;; This file is part of GNU Emacs.
9
5e809f55 10;; GNU Emacs is free software: you can redistribute it and/or modify
eec82323 11;; it under the terms of the GNU General Public License as published by
5e809f55
GM
12;; the Free Software Foundation, either version 3 of the License, or
13;; (at your option) any later version.
eec82323
LMI
14
15;; GNU Emacs is distributed in the hope that it will be useful,
16;; but WITHOUT ANY WARRANTY; without even the implied warranty of
2ff9f5b4 17;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
eec82323
LMI
18;; GNU General Public License for more details.
19
20;; You should have received a copy of the GNU General Public License
5e809f55 21;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
eec82323
LMI
22
23;;; Commentary:
24
25;;; Code:
26
f0b7f5a8 27;; For Emacs <22.2 and XEmacs.
9640c3bc
GM
28(eval-and-compile
29 (unless (fboundp 'declare-function) (defmacro declare-function (&rest r))))
23f87bed 30(eval-when-compile
9efa445f
DN
31 (require 'cl))
32(defvar tool-bar-map)
33(defvar w3m-minor-mode-map)
5ab7173c 34
eec82323 35(require 'gnus)
5843126b 36(require 'gnus-sum)
eec82323
LMI
37(require 'gnus-spec)
38(require 'gnus-int)
23f87bed 39(require 'gnus-win)
16409b0b
GM
40(require 'mm-bodies)
41(require 'mail-parse)
42(require 'mm-decode)
43(require 'mm-view)
44(require 'wid-edit)
45(require 'mm-uu)
23f87bed 46(require 'message)
1518e4f0 47(require 'mouse)
23f87bed
MB
48
49(autoload 'gnus-msg-mail "gnus-msg" nil t)
50(autoload 'gnus-button-mailto "gnus-msg")
51(autoload 'gnus-button-reply "gnus-msg" nil t)
498063ec 52(autoload 'parse-time-string "parse-time" nil nil)
01c52d31
MB
53(autoload 'ansi-color-apply-on-region "ansi-color")
54(autoload 'mm-url-insert-file-contents-external "mm-url")
531bedc3 55(autoload 'mm-extern-cache-contents "mm-extern")
eec82323
LMI
56
57(defgroup gnus-article nil
58 "Article display."
23f87bed 59 :link '(custom-manual "(gnus)Article Buffer")
eec82323
LMI
60 :group 'gnus)
61
16409b0b
GM
62(defgroup gnus-article-treat nil
63 "Treating article parts."
64 :link '(custom-manual "(gnus)Article Hiding")
65 :group 'gnus-article)
66
eec82323
LMI
67(defgroup gnus-article-hiding nil
68 "Hiding article parts."
69 :link '(custom-manual "(gnus)Article Hiding")
70 :group 'gnus-article)
71
72(defgroup gnus-article-highlight nil
73 "Article highlighting."
74 :link '(custom-manual "(gnus)Article Highlighting")
75 :group 'gnus-article
76 :group 'gnus-visual)
77
78(defgroup gnus-article-signature nil
79 "Article signatures."
80 :link '(custom-manual "(gnus)Article Signature")
81 :group 'gnus-article)
82
83(defgroup gnus-article-headers nil
84 "Article headers."
85 :link '(custom-manual "(gnus)Hiding Headers")
86 :group 'gnus-article)
87
88(defgroup gnus-article-washing nil
89 "Special commands on articles."
90 :link '(custom-manual "(gnus)Article Washing")
91 :group 'gnus-article)
92
93(defgroup gnus-article-emphasis nil
94 "Fontisizing articles."
95 :link '(custom-manual "(gnus)Article Fontisizing")
96 :group 'gnus-article)
97
98(defgroup gnus-article-saving nil
99 "Saving articles."
100 :link '(custom-manual "(gnus)Saving Articles")
101 :group 'gnus-article)
102
103(defgroup gnus-article-mime nil
104 "Worshiping the MIME wonder."
105 :link '(custom-manual "(gnus)Using MIME")
106 :group 'gnus-article)
107
108(defgroup gnus-article-buttons nil
109 "Pushable buttons in the article buffer."
110 :link '(custom-manual "(gnus)Article Buttons")
111 :group 'gnus-article)
112
113(defgroup gnus-article-various nil
114 "Other article options."
115 :link '(custom-manual "(gnus)Misc Article")
116 :group 'gnus-article)
117
118(defcustom gnus-ignored-headers
23f87bed
MB
119 (mapcar
120 (lambda (header)
121 (concat "^" header ":"))
122 '("Path" "Expires" "Date-Received" "References" "Xref" "Lines"
123 "Relay-Version" "Message-ID" "Approved" "Sender" "Received"
124 "X-UIDL" "MIME-Version" "Return-Path" "In-Reply-To"
125 "Content-Type" "Content-Transfer-Encoding" "X-WebTV-Signature"
126 "X-MimeOLE" "X-MSMail-Priority" "X-Priority" "X-Loop"
127 "X-Authentication-Warning" "X-MIME-Autoconverted" "X-Face"
128 "X-Attribution" "X-Originating-IP" "Delivered-To"
129 "NNTP-[-A-Za-z]+" "Distribution" "X-no-archive" "X-Trace"
130 "X-Complaints-To" "X-NNTP-Posting-Host" "X-Orig.*"
131 "Abuse-Reports-To" "Cache-Post-Path" "X-Article-Creation-Date"
132 "X-Poster" "X-Mail2News-Path" "X-Server-Date" "X-Cache"
133 "Originator" "X-Problems-To" "X-Auth-User" "X-Post-Time"
134 "X-Admin" "X-UID" "Resent-[-A-Za-z]+" "X-Mailing-List"
135 "Precedence" "Original-[-A-Za-z]+" "X-filename" "X-Orcpt"
136 "Old-Received" "X-Pgp" "X-Auth" "X-From-Line"
137 "X-Gnus-Article-Number" "X-Majordomo" "X-Url" "X-Sender"
138 "MBOX-Line" "Priority" "X400-[-A-Za-z]+"
139 "Status" "X-Gnus-Mail-Source" "Cancel-Lock"
140 "X-FTN" "X-EXP32-SerialNo" "Encoding" "Importance"
141 "Autoforwarded" "Original-Encoded-Information-Types" "X-Ya-Pop3"
142 "X-Face-Version" "X-Vms-To" "X-ML-NAME" "X-ML-COUNT"
143 "Mailing-List" "X-finfo" "X-md5sum" "X-md5sum-Origin"
144 "X-Sun-Charset" "X-Accept-Language" "X-Envelope-Sender"
145 "List-[A-Za-z]+" "X-Listprocessor-Version"
146 "X-Received" "X-Distribute" "X-Sequence" "X-Juno-Line-Breaks"
147 "X-Notes-Item" "X-MS-TNEF-Correlator" "x-uunet-gateway"
148 "X-Received" "Content-length" "X-precedence"
149 "X-Authenticated-User" "X-Comment" "X-Report" "X-Abuse-Info"
150 "X-HTTP-Proxy" "X-Mydeja-Info" "X-Copyright" "X-No-Markup"
151 "X-Abuse-Info" "X-From_" "X-Accept-Language" "Errors-To"
152 "X-BeenThere" "X-Mailman-Version" "List-Help" "List-Post"
153 "List-Subscribe" "List-Id" "List-Unsubscribe" "List-Archive"
154 "X-Content-length" "X-Posting-Agent" "Original-Received"
155 "X-Request-PGP" "X-Fingerprint" "X-WRIEnvto" "X-WRIEnvfrom"
156 "X-Virus-Scanned" "X-Delivery-Agent" "Posted-Date" "X-Gateway"
157 "X-Local-Origin" "X-Local-Destination" "X-UserInfo1"
158 "X-Received-Date" "X-Hashcash" "Face" "X-DMCA-Notifications"
01c52d31
MB
159 "X-Abuse-and-DMCA-Info" "X-Postfilter" "X-Gpg-.*" "X-Disclaimer"
160 "Envelope-To" "X-Spam-Score" "System-Type" "X-Injected-Via-Gmane"
161 "X-Gmane-NNTP-Posting-Host" "Jabber-ID" "Archived-At"
162 "Envelope-Sender" "Envelope-Recipients"))
6748645f 163 "*All headers that start with this regexp will be hidden.
eec82323
LMI
164This variable can also be a list of regexps of headers to be ignored.
165If `gnus-visible-headers' is non-nil, this variable will be ignored."
72aba33f 166 :type '(choice regexp
eec82323
LMI
167 (repeat regexp))
168 :group 'gnus-article-hiding)
169
170(defcustom gnus-visible-headers
12e3ca0a 171 "^From:\\|^Newsgroups:\\|^Subject:\\|^Date:\\|^Followup-To:\\|^Reply-To:\\|^Organization:\\|^Summary:\\|^Keywords:\\|^To:\\|^[BGF]?Cc:\\|^Posted-To:\\|^Mail-Copies-To:\\|^Mail-Followup-To:\\|^Apparently-To:\\|^Gnus-Warning:\\|^Resent-From:"
6748645f 172 "*All headers that do not match this regexp will be hidden.
eec82323
LMI
173This variable can also be a list of regexp of headers to remain visible.
174If this variable is non-nil, `gnus-ignored-headers' will be ignored."
9b3ebcb6
MB
175 :type '(choice
176 (repeat :value-to-internal (lambda (widget value)
177 (custom-split-regexp-maybe value))
178 :match (lambda (widget value)
179 (or (stringp value)
180 (widget-editable-list-match widget value)))
181 regexp)
182 (const :tag "Use gnus-ignored-headers" nil)
183 regexp)
eec82323
LMI
184 :group 'gnus-article-hiding)
185
186(defcustom gnus-sorted-header-list
187 '("^From:" "^Subject:" "^Summary:" "^Keywords:" "^Newsgroups:"
188 "^Followup-To:" "^To:" "^Cc:" "^Date:" "^Organization:")
6748645f 189 "*This variable is a list of regular expressions.
eec82323
LMI
190If it is non-nil, headers that match the regular expressions will
191be placed first in the article buffer in the sequence specified by
192this list."
193 :type '(repeat regexp)
194 :group 'gnus-article-hiding)
195
196(defcustom gnus-boring-article-headers '(empty followup-to reply-to)
197 "Headers that are only to be displayed if they have interesting data.
23f87bed
MB
198Possible values in this list are:
199
200 'empty Headers with no content.
201 'newsgroups Newsgroup identical to Gnus group.
202 'to-address To identical to To-address.
203 'to-list To identical to To-list.
204 'cc-list CC identical to To-list.
205 'followup-to Followup-to identical to Newsgroups.
206 'reply-to Reply-to identical to From.
207 'date Date less than four days old.
208 'long-to To and/or Cc longer than 1024 characters.
209 'many-to Multiple To and/or Cc."
eec82323 210 :type '(set (const :tag "Headers with no content." empty)
23f87bed
MB
211 (const :tag "Newsgroups identical to Gnus group." newsgroups)
212 (const :tag "To identical to To-address." to-address)
213 (const :tag "To identical to To-list." to-list)
214 (const :tag "CC identical to To-list." cc-list)
215 (const :tag "Followup-to identical to Newsgroups." followup-to)
216 (const :tag "Reply-to identical to From." reply-to)
6748645f 217 (const :tag "Date less than four days old." date)
23f87bed 218 (const :tag "To and/or Cc longer than 1024 characters." long-to)
16409b0b 219 (const :tag "Multiple To and/or Cc headers." many-to))
eec82323
LMI
220 :group 'gnus-article-hiding)
221
23f87bed
MB
222(defcustom gnus-article-skip-boring nil
223 "Skip over text that is not worth reading.
224By default, if you set this t, then Gnus will display citations and
225signatures, but will never scroll down to show you a page consisting
226only of boring text. Boring text is controlled by
227`gnus-article-boring-faces'."
bf247b6e 228 :version "22.1"
23f87bed
MB
229 :type 'boolean
230 :group 'gnus-article-hiding)
231
eec82323
LMI
232(defcustom gnus-signature-separator '("^-- $" "^-- *$")
233 "Regexp matching signature separator.
234This can also be a list of regexps. In that case, it will be checked
235from head to tail looking for a separator. Searches will be done from
236the end of the buffer."
3031d8b0
MB
237 :type '(choice :format "%{%t%}: %[Value Menu%]\n%v"
238 (regexp)
239 (repeat :tag "List of regexp" regexp))
eec82323
LMI
240 :group 'gnus-article-signature)
241
242(defcustom gnus-signature-limit nil
16409b0b 243 "Provide a limit to what is considered a signature.
eec82323
LMI
244If it is a number, no signature may not be longer (in characters) than
245that number. If it is a floating point number, no signature may be
246longer (in lines) than that number. If it is a function, the function
247will be called without any parameters, and if it returns nil, there is
248no signature in the buffer. If it is a string, it will be used as a
01c52d31
MB
249regexp. If it matches, the text in question is not a signature.
250
251This can also be a list of the above values."
4a2358e9
MB
252 :type '(choice (const nil)
253 (integer :value 200)
6748645f 254 (number :value 4.0)
b28080e3 255 function
6748645f 256 (regexp :value ".*"))
eec82323
LMI
257 :group 'gnus-article-signature)
258
259(defcustom gnus-hidden-properties '(invisible t intangible t)
260 "Property list to use for hiding text."
261 :type 'sexp
262 :group 'gnus-article-hiding)
263
23f87bed
MB
264;; Fixme: This isn't the right thing for mixed graphical and non-graphical
265;; frames in a session.
eec82323 266(defcustom gnus-article-x-face-command
23f87bed
MB
267 (if (featurep 'xemacs)
268 (if (or (gnus-image-type-available-p 'xface)
269 (gnus-image-type-available-p 'pbm))
270 'gnus-display-x-face-in-from
71c90957
KY
271 "{ echo \
272'/* Format_version=1, Width=48, Height=48, Depth=1, Valid_bits_per_item=16 */'\
273; uncompface; } | icontopbm | ee -")
23f87bed
MB
274 (if (gnus-image-type-available-p 'pbm)
275 'gnus-display-x-face-in-from
71c90957
KY
276 "{ echo \
277'/* Format_version=1, Width=48, Height=48, Depth=1, Valid_bits_per_item=16 */'\
278; uncompface; } | icontopbm | display -"))
6748645f 279 "*String or function to be executed to display an X-Face header.
eec82323 280If it is a string, the command will be executed in a sub-shell
2ff9f5b4 281asynchronously. The compressed face will be piped to this command."
23f87bed
MB
282 :type `(choice string
283 (function-item gnus-display-x-face-in-from)
16409b0b 284 function)
b5a206e7 285 :version "21.1"
23f87bed 286 :group 'gnus-picon
eec82323
LMI
287 :group 'gnus-article-washing)
288
289(defcustom gnus-article-x-face-too-ugly nil
290 "Regexp matching posters whose face shouldn't be shown automatically."
4bb6a3a6 291 :type '(choice regexp (const nil))
eec82323
LMI
292 :group 'gnus-article-washing)
293
e0bad764
DL
294(defcustom gnus-article-banner-alist nil
295 "Banner alist for stripping.
a1506d29 296For example,
23f87bed 297 ((egroups . \"^[ \\t\\n]*-------------------+\\\\( \\\\(e\\\\|Yahoo! \\\\)Groups Sponsor -+\\\\)?....\\n\\\\(.+\\n\\\\)+\"))"
fc2c2db8 298 :version "21.1"
e0bad764
DL
299 :type '(repeat (cons symbol regexp))
300 :group 'gnus-article-washing)
301
23f87bed
MB
302(gnus-define-group-parameter
303 banner
304 :variable-document
305 "Alist of regexps (to match group names) and banner."
306 :variable-group gnus-article-washing
307 :parameter-type
308 '(choice :tag "Banner"
309 :value nil
310 (const :tag "Remove signature" signature)
311 (symbol :tag "Item in `gnus-article-banner-alist'" none)
312 regexp
313 (const :tag "None" nil))
314 :parameter-document
315 "If non-nil, specify how to remove `banners' from articles.
316
317Symbol `signature' means to remove signatures delimited by
318`gnus-signature-separator'. Any other symbol is used to look up a
319regular expression to match the banner in `gnus-article-banner-alist'.
320A string is used as a regular expression to match the banner
321directly.")
322
323(defcustom gnus-article-address-banner-alist nil
324 "Alist of mail addresses and banners.
325Each element has the form (ADDRESS . BANNER), where ADDRESS is a regexp
326to match a mail address in the From: header, BANNER is one of a symbol
327`signature', an item in `gnus-article-banner-alist', a regexp and nil.
328If ADDRESS matches author's mail address, it will remove things like
329advertisements. For example:
330
331\((\"@yoo-hoo\\\\.co\\\\.jp\\\\'\" . \"\\n_+\\nDo You Yoo-hoo!\\\\?\\n.*\\n.*\\n\"))
332"
333 :type '(repeat
334 (cons
335 (regexp :tag "Address")
336 (choice :tag "Banner" :value nil
337 (const :tag "Remove signature" signature)
338 (symbol :tag "Item in `gnus-article-banner-alist'" none)
339 regexp
340 (const :tag "None" nil))))
bf247b6e 341 :version "22.1"
23f87bed
MB
342 :group 'gnus-article-washing)
343
ae465fa7
MB
344(defmacro gnus-emphasis-custom-with-format (&rest body)
345 `(let ((format "\
346\\(\\s-\\|^\\|\\=\\|[-\"]\\|\\s(\\)\\(%s\\(\\w+\\(\\s-+\\w+\\)*[.,]?\\)%s\\)\
347\\(\\([-,.;:!?\"]\\|\\s)\\)+\\s-\\|[?!.]\\s-\\|\\s)\\|\\s-\\)"))
348 ,@body))
349
350(defun gnus-emphasis-custom-value-to-external (value)
351 (gnus-emphasis-custom-with-format
352 (if (consp (car value))
353 (list (format format (car (car value)) (cdr (car value)))
354 2
355 (if (nth 1 value) 2 3)
356 (nth 2 value))
357 value)))
358
359(defun gnus-emphasis-custom-value-to-internal (value)
360 (gnus-emphasis-custom-with-format
361 (let ((regexp (concat "\\`"
362 (format (regexp-quote format)
363 "\\([^()]+\\)" "\\([^()]+\\)")
364 "\\'"))
365 pattern)
366 (if (string-match regexp (setq pattern (car value)))
367 (list (cons (match-string 1 pattern) (match-string 2 pattern))
368 (= (nth 2 value) 2)
369 (nth 3 value))
370 value))))
371
eec82323 372(defcustom gnus-emphasis-alist
ae465fa7
MB
373 (let ((types
374 '(("\\*" "\\*" bold nil 2)
23f87bed 375 ("_" "_" underline)
eec82323 376 ("/" "/" italic)
eec82323
LMI
377 ("_/" "/_" underline-italic)
378 ("_\\*" "\\*_" underline-bold)
379 ("\\*/" "/\\*" bold-italic)
380 ("_\\*/" "/\\*_" underline-bold-italic))))
ae465fa7
MB
381 (nconc
382 (gnus-emphasis-custom-with-format
383 (mapcar (lambda (spec)
384 (list (format format (car spec) (cadr spec))
385 (or (nth 3 spec) 2)
386 (or (nth 4 spec) 3)
387 (intern (format "gnus-emphasis-%s" (nth 2 spec)))))
388 types))
95f75c75
SM
389 '(;; I've never seen anyone use this strikethru convention whereas I've
390 ;; several times seen it triggered by normal text. --Stef
391 ;; Miles suggests that this form is sometimes used but for italics,
392 ;; so maybe we should map it to `italic'.
393 ;; ("\\(\\s-\\|^\\)\\(-\\(\\(\\w\\|-[^-]\\)+\\)-\\)\\(\\s-\\|[?!.,;]\\)"
394 ;; 2 3 gnus-emphasis-strikethru)
ae465fa7
MB
395 ("\\(\\s-\\|^\\)\\(_\\(\\(\\w\\|_[^_]\\)+\\)_\\)\\(\\s-\\|[?!.,;]\\)"
396 2 3 gnus-emphasis-underline))))
6748645f 397 "*Alist that says how to fontify certain phrases.
eec82323
LMI
398Each item looks like this:
399
400 (\"_\\\\(\\\\w+\\\\)_\" 0 1 'underline)
401
402The first element is a regular expression to be matched. The second
403is a number that says what regular expression grouping used to find
404the entire emphasized word. The third is a number that says what
405regexp grouping should be displayed and highlighted. The fourth
406is the face used for highlighting."
ae465fa7
MB
407 :type
408 '(repeat
409 (menu-choice
410 :format "%[Customizing Style%]\n%v"
411 :indent 2
412 (group :tag "Default"
413 :value ("" 0 0 default)
414 :value-create
415 (lambda (widget)
416 (let ((value (widget-get
417 (cadr (widget-get (widget-get widget :parent)
418 :args))
419 :value)))
420 (if (not (eq (nth 2 value) 'default))
421 (widget-put
422 widget
423 :value
424 (gnus-emphasis-custom-value-to-external value))))
425 (widget-group-value-create widget))
ad136a7c
MB
426 regexp
427 (integer :format "Match group: %v")
01c52d31 428 (integer :format "Emphasize group: %v")
ae465fa7
MB
429 face)
430 (group :tag "Simple"
431 :value (("_" . "_") nil default)
432 (cons :format "%v"
ad136a7c
MB
433 (regexp :format "Start regexp: %v")
434 (regexp :format "End regexp: %v"))
ae465fa7
MB
435 (boolean :format "Show start and end patterns: %[%v%]\n"
436 :on " On " :off " Off ")
437 face)))
438 :get (lambda (symbol)
439 (mapcar 'gnus-emphasis-custom-value-to-internal
440 (default-value symbol)))
441 :set (lambda (symbol value)
442 (set-default symbol (mapcar 'gnus-emphasis-custom-value-to-external
443 value)))
eec82323
LMI
444 :group 'gnus-article-emphasis)
445
16409b0b
GM
446(defcustom gnus-emphasize-whitespace-regexp "^[ \t]+\\|[ \t]*\n"
447 "A regexp to describe whitespace which should not be emphasized.
448Typical values are \"^[ \\t]+\\\\|[ \\t]*\\n\" and \"[ \\t]+\\\\|[ \\t]*\\n\".
449The former avoids underlining of leading and trailing whitespace,
450and the latter avoids underlining any whitespace at all."
fc2c2db8 451 :version "21.1"
16409b0b
GM
452 :group 'gnus-article-emphasis
453 :type 'regexp)
454
23f87bed 455(defface gnus-emphasis-bold '((t (:bold t)))
eec82323
LMI
456 "Face used for displaying strong emphasized text (*word*)."
457 :group 'gnus-article-emphasis)
458
23f87bed 459(defface gnus-emphasis-italic '((t (:italic t)))
eec82323
LMI
460 "Face used for displaying italic emphasized text (/word/)."
461 :group 'gnus-article-emphasis)
462
463(defface gnus-emphasis-underline '((t (:underline t)))
464 "Face used for displaying underlined emphasized text (_word_)."
465 :group 'gnus-article-emphasis)
466
23f87bed 467(defface gnus-emphasis-underline-bold '((t (:bold t :underline t)))
eec82323
LMI
468 "Face used for displaying underlined bold emphasized text (_*word*_)."
469 :group 'gnus-article-emphasis)
470
23f87bed 471(defface gnus-emphasis-underline-italic '((t (:italic t :underline t)))
8de38c21 472 "Face used for displaying underlined italic emphasized text (_/word/_)."
eec82323
LMI
473 :group 'gnus-article-emphasis)
474
23f87bed 475(defface gnus-emphasis-bold-italic '((t (:bold t :italic t)))
eec82323
LMI
476 "Face used for displaying bold italic emphasized text (/*word*/)."
477 :group 'gnus-article-emphasis)
478
479(defface gnus-emphasis-underline-bold-italic
23f87bed 480 '((t (:bold t :italic t :underline t)))
eec82323 481 "Face used for displaying underlined bold italic emphasized text.
8f688cb0 482Example: (_/*word*/_)."
eec82323
LMI
483 :group 'gnus-article-emphasis)
484
23f87bed
MB
485(defface gnus-emphasis-strikethru (if (featurep 'xemacs)
486 '((t (:strikethru t)))
487 '((t (:strike-through t))))
488 "Face used for displaying strike-through text (-word-)."
489 :group 'gnus-article-emphasis)
490
16409b0b
GM
491(defface gnus-emphasis-highlight-words
492 '((t (:background "black" :foreground "yellow")))
493 "Face used for displaying highlighted words."
494 :group 'gnus-article-emphasis)
495
01c52d31 496(defcustom gnus-article-time-format "%a, %d %b %Y %T %Z"
eec82323 497 "Format for display of Date headers in article bodies.
6748645f
LMI
498See `format-time-string' for the possible values.
499
500The variable can also be function, which should return a complete Date
501header. The function is called with one argument, the time, which can
502be fed to `format-time-string'."
01c52d31 503 :type '(choice string function)
eec82323
LMI
504 :link '(custom-manual "(gnus)Article Date")
505 :group 'gnus-article-washing)
506
eec82323 507(defcustom gnus-save-all-headers t
26c9afc3
MB
508 "*If non-nil, don't remove any headers before saving.
509This will be overridden by the `:headers' property that the symbol of
510the saver function, which is specified by `gnus-default-article-saver',
511might have."
eec82323
LMI
512 :group 'gnus-article-saving
513 :type 'boolean)
514
515(defcustom gnus-prompt-before-saving 'always
516 "*This variable says how much prompting is to be done when saving articles.
517If it is nil, no prompting will be done, and the articles will be
518saved to the default files. If this variable is `always', each and
519every article that is saved will be preceded by a prompt, even when
520saving large batches of articles. If this variable is neither nil not
521`always', there the user will be prompted once for a file name for
522each invocation of the saving commands."
523 :group 'gnus-article-saving
524 :type '(choice (item always)
525 (item :tag "never" nil)
6748645f 526 (sexp :tag "once" :format "%t\n" :value t)))
eec82323
LMI
527
528(defcustom gnus-saved-headers gnus-visible-headers
529 "Headers to keep if `gnus-save-all-headers' is nil.
530If `gnus-save-all-headers' is non-nil, this variable will be ignored.
531If that variable is nil, however, all headers that match this regexp
26c9afc3
MB
532will be kept while the rest will be deleted before saving. This and
533`gnus-save-all-headers' will be overridden by the `:headers' property
534that the symbol of the saver function, which is specified by
535`gnus-default-article-saver', might have."
eec82323 536 :group 'gnus-article-saving
4bb6a3a6 537 :type 'regexp)
eec82323 538
fef8d38e 539;; Note that "Rmail format" is mbox since Emacs 23, but Babyl before.
eec82323 540(defcustom gnus-default-article-saver 'gnus-summary-save-in-rmail
c5e87d10 541 "A function to save articles in your favorite format.
26c9afc3
MB
542The function will be called by way of the `gnus-summary-save-article'
543command, and friends such as `gnus-summary-save-article-rmail'.
eec82323
LMI
544
545Gnus provides the following functions:
546
547* gnus-summary-save-in-rmail (Rmail format)
548* gnus-summary-save-in-mail (Unix mail format)
549* gnus-summary-save-in-folder (MH folder)
550* gnus-summary-save-in-file (article format)
23f87bed 551* gnus-summary-save-body-in-file (article body)
eec82323 552* gnus-summary-save-in-vm (use VM's folder format)
26c9afc3
MB
553* gnus-summary-write-to-file (article format -- overwrite)
554* gnus-summary-write-body-to-file (article body -- overwrite)
89167438 555* gnus-summary-save-in-pipe (article format)
26c9afc3
MB
556
557The symbol of each function may have the following properties:
558
559* :decode
560The value non-nil means save decoded articles. This is meaningful
561only with `gnus-summary-save-in-file', `gnus-summary-save-body-in-file',
89167438
MB
562`gnus-summary-write-to-file', `gnus-summary-write-body-to-file', and
563`gnus-summary-save-in-pipe'.
26c9afc3
MB
564
565* :function
566The value specifies an alternative function which appends, not
567overwrites, articles to a file. This implies that when saving many
568articles at a time, `gnus-prompt-before-saving' is bound to t and all
569articles are saved in a single file. This is meaningful only with
570`gnus-summary-write-to-file' and `gnus-summary-write-body-to-file'.
571
572* :headers
573The value specifies the symbol of a variable of which the value
574specifies headers to be saved. If it is omitted,
575`gnus-save-all-headers' and `gnus-saved-headers' control what
576headers should be saved."
eec82323
LMI
577 :group 'gnus-article-saving
578 :type '(radio (function-item gnus-summary-save-in-rmail)
579 (function-item gnus-summary-save-in-mail)
580 (function-item gnus-summary-save-in-folder)
581 (function-item gnus-summary-save-in-file)
23f87bed 582 (function-item gnus-summary-save-body-in-file)
eec82323 583 (function-item gnus-summary-save-in-vm)
58090a8d 584 (function-item gnus-summary-write-to-file)
26c9afc3 585 (function-item gnus-summary-write-body-to-file)
89167438 586 (function-item gnus-summary-save-in-pipe)
58090a8d 587 (function)))
eec82323 588
26c9afc3
MB
589(defcustom gnus-article-save-coding-system
590 (or (and (mm-coding-system-p 'utf-8) 'utf-8)
591 (and (mm-coding-system-p 'iso-2022-7bit) 'iso-2022-7bit)
592 (and (mm-coding-system-p 'emacs-mule) 'emacs-mule)
593 (and (mm-coding-system-p 'escape-quoted) 'escape-quoted))
594 "Coding system used to save decoded articles to a file.
595
596The recommended coding systems are `utf-8', `iso-2022-7bit' and so on,
597which can safely encode any characters in text. This is used by the
598commands including:
599
600* gnus-summary-save-article-file
601* gnus-summary-save-article-body-file
602* gnus-summary-write-article-file
603* gnus-summary-write-article-body-file
604
605and the functions to which you may set `gnus-default-article-saver':
606
607* gnus-summary-save-in-file
608* gnus-summary-save-body-in-file
609* gnus-summary-write-to-file
610* gnus-summary-write-body-to-file
611
612Those commands and functions save just text displayed in the article
613buffer to a file if the value of this variable is non-nil. Note that
614buttonized MIME parts will be lost in a saved file in that case.
615Otherwise, raw articles will be saved."
616 :group 'gnus-article-saving
617 :type `(choice
618 :format "%{%t%}:\n %[Value Menu%] %v"
619 (const :tag "Save raw articles" nil)
620 ,@(delq nil
621 (mapcar
622 (lambda (arg) (if (mm-coding-system-p (nth 3 arg)) arg))
623 '((const :tag "UTF-8" utf-8)
624 (const :tag "iso-2022-7bit" iso-2022-7bit)
625 (const :tag "Emacs internal" emacs-mule)
626 (const :tag "escape-quoted" escape-quoted))))
627 (symbol :tag "Coding system")))
628
eec82323
LMI
629(defcustom gnus-rmail-save-name 'gnus-plain-save-name
630 "A function generating a file name to save articles in Rmail format.
631The function is called with NEWSGROUP, HEADERS, and optional LAST-FILE."
632 :group 'gnus-article-saving
633 :type 'function)
634
635(defcustom gnus-mail-save-name 'gnus-plain-save-name
636 "A function generating a file name to save articles in Unix mail format.
637The function is called with NEWSGROUP, HEADERS, and optional LAST-FILE."
638 :group 'gnus-article-saving
639 :type 'function)
640
641(defcustom gnus-folder-save-name 'gnus-folder-save-name
642 "A function generating a file name to save articles in MH folder.
643The function is called with NEWSGROUP, HEADERS, and optional LAST-FOLDER."
644 :group 'gnus-article-saving
645 :type 'function)
646
647(defcustom gnus-file-save-name 'gnus-numeric-save-name
648 "A function generating a file name to save articles in article format.
649The function is called with NEWSGROUP, HEADERS, and optional
650LAST-FILE."
651 :group 'gnus-article-saving
652 :type 'function)
653
654(defcustom gnus-split-methods
655 '((gnus-article-archive-name)
656 (gnus-article-nndoc-name))
6748645f 657 "*Variable used to suggest where articles are to be saved.
eec82323
LMI
658For instance, if you would like to save articles related to Gnus in
659the file \"gnus-stuff\", and articles related to VM in \"vm-stuff\",
660you could set this variable to something like:
661
662 '((\"^Subject:.*gnus\\|^Newsgroups:.*gnus\" \"gnus-stuff\")
663 (\"^Subject:.*vm\\|^Xref:.*vm\" \"vm-stuff\"))
664
01c52d31
MB
665This variable is an alist where the key is the match and the
666value is a list of possible files to save in if the match is
667non-nil.
eec82323
LMI
668
669If the match is a string, it is used as a regexp match on the
670article. If the match is a symbol, that symbol will be funcalled
671from the buffer of the article to be saved with the newsgroup as the
99d99081 672parameter. If it is a list, it will be evalled in the same buffer.
eec82323 673
01c52d31
MB
674If this form or function returns a string, this string will be used as a
675possible file name; and if it returns a non-nil list, that list will be
676used as possible file names."
eec82323 677 :group 'gnus-article-saving
6748645f
LMI
678 :type '(repeat (choice (list :value (fun) function)
679 (cons :value ("" "") regexp (repeat string))
680 (sexp :value nil))))
eec82323 681
eec82323
LMI
682(defcustom gnus-page-delimiter "^\^L"
683 "*Regexp describing what to use as article page delimiters.
684The default value is \"^\^L\", which is a form linefeed at the
685beginning of a line."
686 :type 'regexp
687 :group 'gnus-article-various)
688
12295c5d 689(defcustom gnus-article-mode-line-format "Gnus: %g %S%m"
eec82323 690 "*The format specification for the article mode line.
16409b0b
GM
691See `gnus-summary-mode-line-format' for a closer description.
692
693The following additional specs are available:
694
695%w The article washing status.
696%m The number of MIME parts in the article."
12295c5d 697 :version "24.1"
eec82323
LMI
698 :type 'string
699 :group 'gnus-article-various)
700
701(defcustom gnus-article-mode-hook nil
702 "*A hook for Gnus article mode."
703 :type 'hook
704 :group 'gnus-article-various)
705
23f87bed
MB
706(when (featurep 'xemacs)
707 ;; Extracted from gnus-xmas-define in order to preserve user settings
708 (when (fboundp 'turn-off-scroll-in-place)
709 (add-hook 'gnus-article-mode-hook 'turn-off-scroll-in-place))
710 ;; Extracted from gnus-xmas-redefine in order to preserve user settings
711 (add-hook 'gnus-article-mode-hook 'gnus-xmas-article-menu-add))
712
eec82323
LMI
713(defcustom gnus-article-menu-hook nil
714 "*Hook run after the creation of the article mode menu."
715 :type 'hook
716 :group 'gnus-article-various)
717
718(defcustom gnus-article-prepare-hook nil
16409b0b 719 "*A hook called after an article has been prepared in the article buffer."
eec82323
LMI
720 :type 'hook
721 :group 'gnus-article-various)
722
01c52d31
MB
723(defcustom gnus-copy-article-ignored-headers nil
724 "List of headers to be removed when copying an article.
725Each element is a regular expression."
330f707b 726 :version "23.1" ;; No Gnus
01c52d31
MB
727 :type '(repeat regexp)
728 :group 'gnus-article-various)
729
265ac10b 730(make-obsolete-variable 'gnus-article-hide-pgp-hook nil
6b958814 731 "Gnus 5.10 (Emacs 22.1)")
a8151ef7 732
01c52d31
MB
733(defface gnus-button
734 '((t (:weight bold)))
735 "Face used for highlighting a button in the article buffer."
736 :group 'gnus-article-buttons)
737
738(defcustom gnus-article-button-face 'gnus-button
eec82323
LMI
739 "Face used for highlighting buttons in the article buffer.
740
741An article button is a piece of text that you can activate by pressing
742`RET' or `mouse-2' above it."
743 :type 'face
744 :group 'gnus-article-buttons)
745
746(defcustom gnus-article-mouse-face 'highlight
747 "Face used for mouse highlighting in the article buffer.
748
749Article buttons will be displayed in this face when the cursor is
750above them."
751 :type 'face
752 :group 'gnus-article-buttons)
753
0f49874b 754(defcustom gnus-signature-face 'gnus-signature
a8151ef7 755 "Face used for highlighting a signature in the article buffer.
0f49874b 756Obsolete; use the face `gnus-signature' for customizations instead."
eec82323
LMI
757 :type 'face
758 :group 'gnus-article-highlight
759 :group 'gnus-article-signature)
760
0f49874b 761(defface gnus-signature
f59a3415 762 '((t
23f87bed 763 (:italic t)))
a8151ef7
LMI
764 "Face used for highlighting a signature in the article buffer."
765 :group 'gnus-article-highlight
766 :group 'gnus-article-signature)
0f49874b
MB
767;; backward-compatibility alias
768(put 'gnus-signature-face 'face-alias 'gnus-signature)
3d493bef 769(put 'gnus-signature-face 'obsolete-face "22.1")
a8151ef7 770
0f49874b 771(defface gnus-header-from
eec82323
LMI
772 '((((class color)
773 (background dark))
01c52d31 774 (:foreground "PaleGreen1"))
eec82323
LMI
775 (((class color)
776 (background light))
6748645f 777 (:foreground "red3"))
eec82323 778 (t
23f87bed 779 (:italic t)))
eec82323
LMI
780 "Face used for displaying from headers."
781 :group 'gnus-article-headers
782 :group 'gnus-article-highlight)
0f49874b
MB
783;; backward-compatibility alias
784(put 'gnus-header-from-face 'face-alias 'gnus-header-from)
3d493bef 785(put 'gnus-header-from-face 'obsolete-face "22.1")
eec82323 786
0f49874b 787(defface gnus-header-subject
eec82323
LMI
788 '((((class color)
789 (background dark))
01c52d31 790 (:foreground "SeaGreen1"))
eec82323
LMI
791 (((class color)
792 (background light))
6748645f 793 (:foreground "red4"))
eec82323 794 (t
23f87bed 795 (:bold t :italic t)))
eec82323
LMI
796 "Face used for displaying subject headers."
797 :group 'gnus-article-headers
798 :group 'gnus-article-highlight)
0f49874b
MB
799;; backward-compatibility alias
800(put 'gnus-header-subject-face 'face-alias 'gnus-header-subject)
3d493bef 801(put 'gnus-header-subject-face 'obsolete-face "22.1")
eec82323 802
0f49874b 803(defface gnus-header-newsgroups
eec82323
LMI
804 '((((class color)
805 (background dark))
23f87bed 806 (:foreground "yellow" :italic t))
eec82323
LMI
807 (((class color)
808 (background light))
23f87bed 809 (:foreground "MidnightBlue" :italic t))
eec82323 810 (t
23f87bed
MB
811 (:italic t)))
812 "Face used for displaying newsgroups headers.
813In the default setup this face is only used for crossposted
814articles."
eec82323
LMI
815 :group 'gnus-article-headers
816 :group 'gnus-article-highlight)
0f49874b
MB
817;; backward-compatibility alias
818(put 'gnus-header-newsgroups-face 'face-alias 'gnus-header-newsgroups)
3d493bef 819(put 'gnus-header-newsgroups-face 'obsolete-face "22.1")
eec82323 820
0f49874b 821(defface gnus-header-name
eec82323
LMI
822 '((((class color)
823 (background dark))
01c52d31 824 (:foreground "SpringGreen2"))
eec82323
LMI
825 (((class color)
826 (background light))
827 (:foreground "maroon"))
828 (t
23f87bed 829 (:bold t)))
eec82323
LMI
830 "Face used for displaying header names."
831 :group 'gnus-article-headers
832 :group 'gnus-article-highlight)
0f49874b
MB
833;; backward-compatibility alias
834(put 'gnus-header-name-face 'face-alias 'gnus-header-name)
3d493bef 835(put 'gnus-header-name-face 'obsolete-face "22.1")
eec82323 836
0f49874b 837(defface gnus-header-content
eec82323
LMI
838 '((((class color)
839 (background dark))
01c52d31 840 (:foreground "SpringGreen1" :italic t))
eec82323
LMI
841 (((class color)
842 (background light))
23f87bed 843 (:foreground "indianred4" :italic t))
eec82323 844 (t
23f87bed 845 (:italic t))) "Face used for displaying header content."
eec82323
LMI
846 :group 'gnus-article-headers
847 :group 'gnus-article-highlight)
0f49874b
MB
848;; backward-compatibility alias
849(put 'gnus-header-content-face 'face-alias 'gnus-header-content)
3d493bef 850(put 'gnus-header-content-face 'obsolete-face "22.1")
eec82323
LMI
851
852(defcustom gnus-header-face-alist
0f49874b
MB
853 '(("From" nil gnus-header-from)
854 ("Subject" nil gnus-header-subject)
855 ("Newsgroups:.*," nil gnus-header-newsgroups)
856 ("" gnus-header-name gnus-header-content))
23f87bed 857 "*Controls highlighting of article headers.
eec82323
LMI
858
859An alist of the form (HEADER NAME CONTENT).
860
23f87bed
MB
861HEADER is a regular expression which should match the name of a
862header and NAME and CONTENT are either face names or nil.
eec82323
LMI
863
864The name of each header field will be displayed using the face
23f87bed
MB
865specified by the first element in the list where HEADER matches
866the header name and NAME is non-nil. Similarly, the content will
867be displayed by the first non-nil matching CONTENT face."
eec82323
LMI
868 :group 'gnus-article-headers
869 :group 'gnus-article-highlight
870 :type '(repeat (list (regexp :tag "Header")
871 (choice :tag "Name"
872 (item :tag "skip" nil)
873 (face :value default))
874 (choice :tag "Content"
875 (item :tag "skip" nil)
876 (face :value default)))))
877
01c52d31
MB
878(defcustom gnus-face-properties-alist (if (featurep 'xemacs)
879 '((xface . (:face gnus-x-face)))
880 '((pbm . (:face gnus-x-face))
881 (png . nil)))
882 "Alist of image types and properties applied to Face and X-Face images.
883Here are examples:
884
885;; Specify the altitude of Face images in the From header.
886\(setq gnus-face-properties-alist
887 '((pbm . (:face gnus-x-face :ascent 80))
888 (png . (:ascent 80))))
889
890;; Show Face images as pressed buttons.
891\(setq gnus-face-properties-alist
892 '((pbm . (:face gnus-x-face :relief -2))
893 (png . (:relief -2))))
894
895See the manual for the valid properties for various image types.
896Currently, `pbm' is used for X-Face images and `png' is used for Face
897images in Emacs. Only the `:face' property is effective on the `xface'
898image type in XEmacs if it is built with the libcompface library."
330f707b 899 :version "23.1" ;; No Gnus
01c52d31
MB
900 :group 'gnus-article-headers
901 :type '(repeat (cons :format "%v" (symbol :tag "Image type") plist)))
902
16409b0b 903(defcustom gnus-article-decode-hook
23f87bed
MB
904 '(article-decode-charset article-decode-encoded-words
905 article-decode-group-name article-decode-idna-rhs)
16409b0b
GM
906 "*Hook run to decode charsets in articles."
907 :group 'gnus-article-headers
908 :type 'hook)
909
910(defcustom gnus-display-mime-function 'gnus-display-mime
911 "Function to display MIME articles."
912 :group 'gnus-article-mime
913 :type 'function)
914
915(defvar gnus-decode-header-function 'mail-decode-encoded-word-region
916 "Function used to decode headers.")
917
343d6628
MB
918(defvar gnus-decode-address-function 'mail-decode-encoded-address-region
919 "Function used to decode addresses.")
920
16409b0b 921(defvar gnus-article-dumbquotes-map
7cad71ad
G
922 '((?\200 "EUR")
923 (?\202 ",")
924 (?\203 "f")
925 (?\204 ",,")
926 (?\205 "...")
927 (?\213 "<")
928 (?\214 "OE")
929 (?\221 "`")
930 (?\222 "'")
931 (?\223 "``")
932 (?\224 "\"")
933 (?\225 "*")
934 (?\226 "-")
935 (?\227 "--")
936 (?\230 "~")
937 (?\231 "(TM)")
938 (?\233 ">")
939 (?\234 "oe")
940 (?\264 "'"))
16409b0b
GM
941 "Table for MS-to-Latin1 translation.")
942
943(defcustom gnus-ignored-mime-types nil
944 "List of MIME types that should be ignored by Gnus."
fc2c2db8 945 :version "21.1"
16409b0b
GM
946 :group 'gnus-article-mime
947 :type '(repeat regexp))
948
949(defcustom gnus-unbuttonized-mime-types '(".*/.*")
23f87bed
MB
950 "List of MIME types that should not be given buttons when rendered inline.
951See also `gnus-buttonized-mime-types' which may override this variable.
952This variable is only used when `gnus-inhibit-mime-unbuttonizing' is nil."
953 :version "21.1"
954 :group 'gnus-article-mime
955 :type '(repeat regexp))
956
957(defcustom gnus-buttonized-mime-types nil
958 "List of MIME types that should be given buttons when rendered inline.
959If set, this variable overrides `gnus-unbuttonized-mime-types'.
960To see e.g. security buttons you could set this to
3031d8b0
MB
961`(\"multipart/signed\")'. You could also add \"multipart/alternative\" to
962this list to display radio buttons that allow you to choose one of two
963media types those mails include. See also `mm-discouraged-alternatives'.
23f87bed 964This variable is only used when `gnus-inhibit-mime-unbuttonizing' is nil."
bf247b6e 965 :version "22.1"
16409b0b
GM
966 :group 'gnus-article-mime
967 :type '(repeat regexp))
968
23f87bed
MB
969(defcustom gnus-inhibit-mime-unbuttonizing nil
970 "If non-nil, all MIME parts get buttons.
971When nil (the default value), then some MIME parts do not get buttons,
972as described by the variables `gnus-buttonized-mime-types' and
973`gnus-unbuttonized-mime-types'."
bf247b6e 974 :version "22.1"
d0859c9a 975 :group 'gnus-article-mime
23f87bed
MB
976 :type 'boolean)
977
978(defcustom gnus-body-boundary-delimiter "_"
979 "String used to delimit header and body.
980This variable is used by `gnus-article-treat-body-boundary' which can
981be controlled by `gnus-treat-body-boundary'."
bf247b6e 982 :version "22.1"
23f87bed
MB
983 :group 'gnus-article-various
984 :type '(choice (item :tag "None" :value nil)
985 string))
986
97f78c9b
MB
987(defcustom gnus-picon-databases '("/usr/lib/picon" "/usr/local/faces"
988 "/usr/share/picons")
23f87bed
MB
989 "Defines the location of the faces database.
990For information on obtaining this database of pretty pictures, please
991see http://www.cs.indiana.edu/picons/ftp/index.html"
bf247b6e 992 :version "22.1"
23f87bed
MB
993 :type '(repeat directory)
994 :link '(url-link :tag "download"
995 "http://www.cs.indiana.edu/picons/ftp/index.html")
996 :link '(custom-manual "(gnus)Picons")
997 :group 'gnus-picon)
998
999(defun gnus-picons-installed-p ()
1000 "Say whether picons are installed on your machine."
1001 (let ((installed nil))
1002 (dolist (database gnus-picon-databases)
1003 (when (file-exists-p database)
1004 (setq installed t)))
1005 installed))
1006
16409b0b
GM
1007(defcustom gnus-article-mime-part-function nil
1008 "Function called with a MIME handle as the argument.
1009This is meant for people who want to do something automatic based
1010on parts -- for instance, adding Vcard info to a database."
1011 :group 'gnus-article-mime
4a2358e9
MB
1012 :type '(choice (const nil)
1013 function))
16409b0b
GM
1014
1015(defcustom gnus-mime-multipart-functions nil
fc2c2db8
DL
1016 "An alist of MIME types to functions to display them."
1017 :version "21.1"
1018 :group 'gnus-article-mime
01c52d31 1019 :type '(repeat (cons :format "%v" (string :tag "MIME type") function)))
16409b0b 1020
c61a8b44 1021(defcustom gnus-article-date-headers '(combined-lapsed)
12e3ca0a
LI
1022 "A list of Date header formats to display.
1023Valid formats are `ut' (universal time), `local' (local time
1024zone), `english' (readable English), `lapsed' (elapsed time),
1025`combined-lapsed' (both the original date and the elapsed time),
1026`original' (the original date header), `iso8601' (ISO8601
1027format), and `user-defined' (a user-defined format defined by the
1028`gnus-article-time-format' variable).
1029
1030You have as many date headers as you want in the article buffer.
1031Some of these headers are updated automatically. See
1032`gnus-article-update-date-headers' for details."
1033 :version "24.1"
16409b0b 1034 :group 'gnus-article-headers
a931698a
GM
1035 :type '(set
1036 (const :tag "Universal time (UT)" ut)
1037 (const :tag "Local time zone" local)
1038 (const :tag "Readable English" english)
1039 (const :tag "Elapsed time" lapsed)
1040 (const :tag "Original and elapsed time" combined-lapsed)
1041 (const :tag "Original date header" original)
1042 (const :tag "ISO8601 format" iso8601)
1043 (const :tag "User-defined" user-defined)))
12e3ca0a 1044
138c0212 1045(defcustom gnus-article-update-date-headers nil
8e22bee0 1046 "A number that says how often to update the date header (in seconds).
647559c2
LI
1047If nil, don't update it at all."
1048 :version "24.1"
1049 :group 'gnus-article-headers
1050 :type '(choice
1051 (item :tag "Don't update" :value nil)
1052 integer))
1053
16409b0b
GM
1054(defcustom gnus-article-mime-match-handle-function 'undisplayed-alternative
1055 "Function called with a MIME handle as the argument.
1056This is meant for people who want to view first matched part.
a1506d29
JB
1057For `undisplayed-alternative' (default), the first undisplayed
1058part or alternative part is used. For `undisplayed', the first
1059undisplayed part is used. For a function, the first part which
f20b2f5c 1060the function return t is used. For nil, the first part is
16409b0b 1061used."
fc2c2db8 1062 :version "21.1"
16409b0b 1063 :group 'gnus-article-mime
a1506d29 1064 :type '(choice
16409b0b
GM
1065 (item :tag "first" :value nil)
1066 (item :tag "undisplayed" :value undisplayed)
a1506d29 1067 (item :tag "undisplayed or alternative"
16409b0b
GM
1068 :value undisplayed-alternative)
1069 (function)))
1070
e0bad764
DL
1071(defcustom gnus-mime-action-alist
1072 '(("save to file" . gnus-mime-save-part)
23f87bed 1073 ("save and strip" . gnus-mime-save-part-and-strip)
01c52d31 1074 ("replace with file" . gnus-mime-replace-part)
23f87bed 1075 ("delete part" . gnus-mime-delete-part)
e0bad764
DL
1076 ("display as text" . gnus-mime-inline-part)
1077 ("view the part" . gnus-mime-view-part)
1078 ("pipe to command" . gnus-mime-pipe-part)
1079 ("toggle display" . gnus-article-press-button)
23f87bed 1080 ("toggle display" . gnus-article-view-part-as-charset)
e0bad764 1081 ("view as type" . gnus-mime-view-part-as-type)
23f87bed
MB
1082 ("view internally" . gnus-mime-view-part-internally)
1083 ("view externally" . gnus-mime-view-part-externally))
e0bad764
DL
1084 "An alist of actions that run on the MIME attachment."
1085 :group 'gnus-article-mime
1086 :type '(repeat (cons (string :tag "name")
1087 (function))))
1088
01c52d31
MB
1089(defcustom gnus-auto-select-part 1
1090 "Advance to next MIME part when deleting or stripping parts.
1091
1092When 0, point will be placed on the same part as before. When
1093positive (negative), move point forward (backwards) this many
1094parts. When nil, redisplay article."
330f707b 1095 :version "23.1" ;; No Gnus
01c52d31
MB
1096 :group 'gnus-article-mime
1097 :type '(choice (const nil :tag "Redisplay article.")
1098 (const 1 :tag "Next part.")
1099 (const 0 :tag "Current part.")
1100 integer))
1101
16409b0b
GM
1102;;;
1103;;; The treatment variables
1104;;;
1105
1106(defvar gnus-part-display-hook nil
1107 "Hook called on parts that are to receive treatment.")
1108
1109(defvar gnus-article-treat-custom
1110 '(choice (const :tag "Off" nil)
1111 (const :tag "On" t)
1112 (const :tag "Header" head)
01c52d31 1113 (const :tag "First" first)
16409b0b
GM
1114 (const :tag "Last" last)
1115 (integer :tag "Less")
1116 (repeat :tag "Groups" regexp)
1117 (sexp :tag "Predicate")))
1118
1119(defvar gnus-article-treat-head-custom
1120 '(choice (const :tag "Off" nil)
1121 (const :tag "Header" head)))
1122
01c52d31 1123(defvar gnus-article-treat-types '("text/plain" "text/x-verbatim"
da42d41a
G
1124 "text/x-patch" "text/html")
1125 "Part types eligible for treatment.")
16409b0b
GM
1126
1127(defvar gnus-inhibit-treatment nil
1128 "Whether to inhibit treatment.")
1129
23f87bed 1130(defcustom gnus-treat-highlight-signature '(or t (typep "text/x-vcard"))
16409b0b 1131 "Highlight the signature.
01c52d31
MB
1132Valid values are nil, t, `head', `first', `last', an integer or a
1133predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1134 :group 'gnus-article-treat
23f87bed 1135 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1136 :type gnus-article-treat-custom)
1137(put 'gnus-treat-highlight-signature 'highlight t)
1138
1139(defcustom gnus-treat-buttonize 100000
1140 "Add buttons.
01c52d31
MB
1141Valid values are nil, t, `head', `first', `last', an integer or a
1142predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1143 :group 'gnus-article-treat
23f87bed 1144 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1145 :type gnus-article-treat-custom)
1146(put 'gnus-treat-buttonize 'highlight t)
1147
1148(defcustom gnus-treat-buttonize-head 'head
1149 "Add buttons to the head.
01c52d31
MB
1150Valid values are nil, t, `head', `first', `last', an integer or a
1151predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1152 :group 'gnus-article-treat
23f87bed 1153 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1154 :type gnus-article-treat-head-custom)
1155(put 'gnus-treat-buttonize-head 'highlight t)
1156
12e3ca0a
LI
1157(defcustom gnus-treat-date 'head
1158 "Display dates according to the `gnus-article-date-headers' variable.
1159Valid values are nil, t, `head', `first', `last', an integer or a
1160predicate. See Info node `(gnus)Customizing Articles'."
1161 :version "24.1"
1162 :group 'gnus-article-treat
1163 :link '(custom-manual "(gnus)Customizing Articles")
1164 :type gnus-article-treat-head-custom)
1165
437ce4be 1166(defcustom gnus-treat-emphasize 50000
16409b0b 1167 "Emphasize text.
01c52d31
MB
1168Valid values are nil, t, `head', `first', `last', an integer or a
1169predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1170 :group 'gnus-article-treat
23f87bed 1171 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1172 :type gnus-article-treat-custom)
1173(put 'gnus-treat-emphasize 'highlight t)
1174
1175(defcustom gnus-treat-strip-cr nil
1176 "Remove carriage returns.
01c52d31
MB
1177Valid values are nil, t, `head', `first', `last', an integer or a
1178predicate. See Info node `(gnus)Customizing Articles'."
bf247b6e 1179 :version "22.1"
16409b0b 1180 :group 'gnus-article-treat
23f87bed
MB
1181 :link '(custom-manual "(gnus)Customizing Articles")
1182 :type gnus-article-treat-custom)
1183
1184(defcustom gnus-treat-unsplit-urls nil
1185 "Remove newlines from within URLs.
01c52d31
MB
1186Valid values are nil, t, `head', `first', `last', an integer or a
1187predicate. See Info node `(gnus)Customizing Articles'."
bf247b6e 1188 :version "22.1"
23f87bed
MB
1189 :group 'gnus-article-treat
1190 :link '(custom-manual "(gnus)Customizing Articles")
1191 :type gnus-article-treat-custom)
1192
1193(defcustom gnus-treat-leading-whitespace nil
1194 "Remove leading whitespace in headers.
01c52d31
MB
1195Valid values are nil, t, `head', `first', `last', an integer or a
1196predicate. See Info node `(gnus)Customizing Articles'."
bf247b6e 1197 :version "22.1"
23f87bed
MB
1198 :group 'gnus-article-treat
1199 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1200 :type gnus-article-treat-custom)
1201
1202(defcustom gnus-treat-hide-headers 'head
1203 "Hide headers.
01c52d31
MB
1204Valid values are nil, t, `head', `first', `last', an integer or a
1205predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1206 :group 'gnus-article-treat
23f87bed 1207 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1208 :type gnus-article-treat-head-custom)
1209
1210(defcustom gnus-treat-hide-boring-headers nil
1211 "Hide boring headers.
01c52d31
MB
1212Valid values are nil, t, `head', `first', `last', an integer or a
1213predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1214 :group 'gnus-article-treat
23f87bed 1215 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1216 :type gnus-article-treat-head-custom)
1217
1218(defcustom gnus-treat-hide-signature nil
1219 "Hide the signature.
01c52d31
MB
1220Valid values are nil, t, `head', `first', `last', an integer or a
1221predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1222 :group 'gnus-article-treat
23f87bed 1223 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1224 :type gnus-article-treat-custom)
1225
1226(defcustom gnus-treat-fill-article nil
1227 "Fill the article.
01c52d31
MB
1228Valid values are nil, t, `head', `first', `last', an integer or a
1229predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1230 :group 'gnus-article-treat
23f87bed 1231 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1232 :type gnus-article-treat-custom)
1233
1234(defcustom gnus-treat-hide-citation nil
1235 "Hide cited text.
01c52d31 1236Valid values are nil, t, `head', `first', `last', an integer or a
a5166359
LMI
1237predicate. See Info node `(gnus)Customizing Articles'.
1238
1239See `gnus-article-highlight-citation' for variables used to
1240control what it hides."
16409b0b 1241 :group 'gnus-article-treat
23f87bed 1242 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1243 :type gnus-article-treat-custom)
1244
e0bad764 1245(defcustom gnus-treat-hide-citation-maybe nil
e21bac42 1246 "Hide cited text according to certain conditions.
01c52d31 1247Valid values are nil, t, `head', `first', `last', an integer or a
e21bac42
G
1248predicate. See Info node `(gnus)Customizing Articles'.
1249
1250See `gnus-cite-hide-percentage' and `gnus-cite-hide-absolute' for
1251how to control what it hides."
e0bad764 1252 :group 'gnus-article-treat
23f87bed 1253 :link '(custom-manual "(gnus)Customizing Articles")
e0bad764
DL
1254 :type gnus-article-treat-custom)
1255
16409b0b
GM
1256(defcustom gnus-treat-strip-list-identifiers 'head
1257 "Strip list identifiers from `gnus-list-identifiers`.
01c52d31
MB
1258Valid values are nil, t, `head', `first', `last', an integer or a
1259predicate. See Info node `(gnus)Customizing Articles'."
fc2c2db8 1260 :version "21.1"
16409b0b 1261 :group 'gnus-article-treat
23f87bed 1262 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1263 :type gnus-article-treat-custom)
1264
fb9b91be
JD
1265(gnus-define-group-parameter
1266 list-identifier
1267 :variable-document
1268 "Alist of regexps and correspondent identifiers."
1269 :variable-group gnus-article-washing
1270 :parameter-type
1271 '(choice :tag "Identifier"
1272 :value nil
1273 (symbol :tag "Item in `gnus-list-identifiers'" none)
1274 regexp
1275 (const :tag "None" nil))
1276 :parameter-document
1277 "If non-nil, specify how to remove `identifiers' from articles' subject.
1278
1279Any symbol is used to look up a regular expression to match the
1280banner in `gnus-list-identifiers'. A string is used as a regular
1281expression to match the identifier directly.")
1282
265ac10b
SM
1283(make-obsolete-variable 'gnus-treat-strip-pgp nil
1284 "Gnus 5.10 (Emacs 22.1)")
16409b0b
GM
1285
1286(defcustom gnus-treat-strip-pem nil
1287 "Strip PEM signatures.
01c52d31
MB
1288Valid values are nil, t, `head', `first', `last', an integer or a
1289predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1290 :group 'gnus-article-treat
23f87bed 1291 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1292 :type gnus-article-treat-custom)
1293
1294(defcustom gnus-treat-strip-banner t
1295 "Strip banners from articles.
1296The banner to be stripped is specified in the `banner' group parameter.
01c52d31
MB
1297Valid values are nil, t, `head', `first', `last', an integer or a
1298predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1299 :group 'gnus-article-treat
23f87bed 1300 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1301 :type gnus-article-treat-custom)
1302
1303(defcustom gnus-treat-highlight-headers 'head
1304 "Highlight the headers.
01c52d31
MB
1305Valid values are nil, t, `head', `first', `last', an integer or a
1306predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1307 :group 'gnus-article-treat
23f87bed 1308 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1309 :type gnus-article-treat-head-custom)
1310(put 'gnus-treat-highlight-headers 'highlight t)
1311
1312(defcustom gnus-treat-highlight-citation t
1313 "Highlight cited text.
01c52d31
MB
1314Valid values are nil, t, `head', `first', `last', an integer or a
1315predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1316 :group 'gnus-article-treat
23f87bed 1317 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1318 :type gnus-article-treat-custom)
1319(put 'gnus-treat-highlight-citation 'highlight t)
1320
16409b0b
GM
1321(defcustom gnus-treat-strip-headers-in-body t
1322 "Strip the X-No-Archive header line from the beginning of the body.
01c52d31
MB
1323Valid values are nil, t, `head', `first', `last', an integer or a
1324predicate. See Info node `(gnus)Customizing Articles'."
fc2c2db8 1325 :version "21.1"
16409b0b 1326 :group 'gnus-article-treat
23f87bed 1327 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1328 :type gnus-article-treat-custom)
1329
1330(defcustom gnus-treat-strip-trailing-blank-lines nil
1331 "Strip trailing blank lines.
01c52d31
MB
1332Valid values are nil, t, `head', `first', `last', an integer or a
1333predicate. See Info node `(gnus)Customizing Articles'.
292f71fe
MB
1334
1335When set to t, it also strips trailing blanks in all MIME parts.
1336Consider to use `last' instead."
16409b0b 1337 :group 'gnus-article-treat
23f87bed 1338 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1339 :type gnus-article-treat-custom)
1340
1341(defcustom gnus-treat-strip-leading-blank-lines nil
1342 "Strip leading blank lines.
01c52d31
MB
1343Valid values are nil, t, `head', `first', `last', an integer or a
1344predicate. See Info node `(gnus)Customizing Articles'.
292f71fe
MB
1345
1346When set to t, it also strips trailing blanks in all MIME parts."
16409b0b 1347 :group 'gnus-article-treat
23f87bed 1348 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1349 :type gnus-article-treat-custom)
1350
1351(defcustom gnus-treat-strip-multiple-blank-lines nil
1352 "Strip multiple blank lines.
01c52d31
MB
1353Valid values are nil, t, `head', `first', `last', an integer or a
1354predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1355 :group 'gnus-article-treat
23f87bed
MB
1356 :link '(custom-manual "(gnus)Customizing Articles")
1357 :type gnus-article-treat-custom)
1358
1359(defcustom gnus-treat-unfold-headers 'head
1360 "Unfold folded header lines.
01c52d31
MB
1361Valid values are nil, t, `head', `first', `last', an integer or a
1362predicate. See Info node `(gnus)Customizing Articles'."
bf247b6e 1363 :version "22.1"
23f87bed
MB
1364 :group 'gnus-article-treat
1365 :link '(custom-manual "(gnus)Customizing Articles")
1366 :type gnus-article-treat-custom)
1367
01c52d31
MB
1368(defcustom gnus-article-unfold-long-headers nil
1369 "If non-nil, allow unfolding headers even if the header is long.
1370If it is a regexp, only long headers matching this regexp are unfolded.
1371If it is t, all long headers are unfolded.
1372
1373This variable has no effect if `gnus-treat-unfold-headers' is nil."
330f707b 1374 :version "23.1" ;; No Gnus
01c52d31
MB
1375 :group 'gnus-article-treat
1376 :type '(choice (const nil)
1377 (const :tag "all" t)
1378 (regexp)))
1379
23f87bed
MB
1380(defcustom gnus-treat-fold-headers nil
1381 "Fold headers.
01c52d31
MB
1382Valid values are nil, t, `head', `first', `last', an integer or a
1383predicate. See Info node `(gnus)Customizing Articles'."
bf247b6e 1384 :version "22.1"
23f87bed
MB
1385 :group 'gnus-article-treat
1386 :link '(custom-manual "(gnus)Customizing Articles")
1387 :type gnus-article-treat-custom)
1388
1389(defcustom gnus-treat-fold-newsgroups 'head
1390 "Fold the Newsgroups and Followup-To headers.
01c52d31
MB
1391Valid values are nil, t, `head', `first', `last', an integer or a
1392predicate. See Info node `(gnus)Customizing Articles'."
bf247b6e 1393 :version "22.1"
23f87bed
MB
1394 :group 'gnus-article-treat
1395 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1396 :type gnus-article-treat-custom)
1397
1398(defcustom gnus-treat-overstrike t
1399 "Treat overstrike highlighting.
01c52d31
MB
1400Valid values are nil, t, `head', `first', `last', an integer or a
1401predicate. See Info node `(gnus)Customizing Articles'."
16409b0b 1402 :group 'gnus-article-treat
23f87bed 1403 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1404 :type gnus-article-treat-custom)
1405(put 'gnus-treat-overstrike 'highlight t)
1406
01c52d31
MB
1407(defcustom gnus-treat-ansi-sequences (if (locate-library "ansi-color") t)
1408 "Treat ANSI SGR control sequences.
1409Valid values are nil, t, `head', `first', `last', an integer or a
1410predicate. See Info node `(gnus)Customizing Articles'."
1411 :group 'gnus-article-treat
1412 :link '(custom-manual "(gnus)Customizing Articles")
1413 :type gnus-article-treat-custom)
1414
23f87bed 1415(make-obsolete-variable 'gnus-treat-display-xface
6b958814 1416 'gnus-treat-display-x-face "Emacs 22.1")
23f87bed
MB
1417
1418(defcustom gnus-treat-display-x-face
1419 (and (not noninteractive)
11e95b02
MB
1420 (gnus-image-type-available-p 'xbm)
1421 (if (featurep 'xemacs)
1422 (featurep 'xface)
86f5c034
SM
1423 (condition-case nil
1424 (and (string-match "^0x" (shell-command-to-string "uncompface"))
1425 (executable-find "icontopbm"))
1426 ;; shell-command-to-string may signal an error, e.g. if
1427 ;; shell-file-name is not found.
1428 (error nil)))
8b93df01 1429 'head)
16409b0b 1430 "Display X-Face headers.
87ba2830 1431Valid values are nil and `head'.
23f87bed
MB
1432See Info node `(gnus)Customizing Articles' and Info node
1433`(gnus)X-Face' for details."
1434 :group 'gnus-article-treat
1435 :version "21.1"
1436 :link '(custom-manual "(gnus)Customizing Articles")
1437 :link '(custom-manual "(gnus)X-Face")
1438 :type gnus-article-treat-head-custom
1439 :set (lambda (symbol value)
1440 (set-default
1441 symbol
1442 (cond ((or (boundp symbol) (get symbol 'saved-value))
1443 value)
1444 ((boundp 'gnus-treat-display-xface)
1445 (message "\
1446** gnus-treat-display-xface is an obsolete variable;\
1447 use gnus-treat-display-x-face instead")
1448 (default-value 'gnus-treat-display-xface))
1449 ((get 'gnus-treat-display-xface 'saved-value)
1450 (message "\
1451** gnus-treat-display-xface is an obsolete variable;\
1452 use gnus-treat-display-x-face instead")
1453 (eval (car (get 'gnus-treat-display-xface 'saved-value))))
1454 (t
1455 value)))))
1456(put 'gnus-treat-display-x-face 'highlight t)
1457
1458(defcustom gnus-treat-display-face
1459 (and (not noninteractive)
11e95b02 1460 (gnus-image-type-available-p 'png)
23f87bed
MB
1461 'head)
1462 "Display Face headers.
01c52d31
MB
1463Valid values are nil, t, `head', `first', `last', an integer or a
1464predicate. See Info node `(gnus)Customizing Articles' and Info
41ec3f54 1465node `(gnus)Face' for details."
16409b0b 1466 :group 'gnus-article-treat
bf247b6e 1467 :version "22.1"
23f87bed
MB
1468 :link '(custom-manual "(gnus)Customizing Articles")
1469 :link '(custom-manual "(gnus)X-Face")
16409b0b 1470 :type gnus-article-treat-head-custom)
23f87bed 1471(put 'gnus-treat-display-face 'highlight t)
16409b0b 1472
11e95b02 1473(defcustom gnus-treat-display-smileys (gnus-image-type-available-p 'xpm)
16409b0b 1474 "Display smileys.
01c52d31
MB
1475Valid values are nil, t, `head', `first', `last', an integer or a
1476predicate. See Info node `(gnus)Customizing Articles' and Info
1477node `(gnus)Smileys' for details."
16409b0b 1478 :group 'gnus-article-treat
b5a206e7 1479 :version "21.1"
23f87bed
MB
1480 :link '(custom-manual "(gnus)Customizing Articles")
1481 :link '(custom-manual "(gnus)Smileys")
16409b0b
GM
1482 :type gnus-article-treat-custom)
1483(put 'gnus-treat-display-smileys 'highlight t)
1484
23f87bed
MB
1485(defcustom gnus-treat-from-picon
1486 (if (and (gnus-image-type-available-p 'xpm)
1487 (gnus-picons-installed-p))
1488 'head nil)
1489 "Display picons in the From header.
01c52d31
MB
1490Valid values are nil, t, `head', `first', `last', an integer or a
1491predicate. See Info node `(gnus)Customizing Articles' and Info
1492node `(gnus)Picons' for details."
bf247b6e 1493 :version "22.1"
16409b0b 1494 :group 'gnus-article-treat
23f87bed
MB
1495 :group 'gnus-picon
1496 :link '(custom-manual "(gnus)Customizing Articles")
1497 :link '(custom-manual "(gnus)Picons")
1498 :type gnus-article-treat-head-custom)
1499(put 'gnus-treat-from-picon 'highlight t)
1500
1501(defcustom gnus-treat-mail-picon
1502 (if (and (gnus-image-type-available-p 'xpm)
1503 (gnus-picons-installed-p))
1504 'head nil)
1505 "Display picons in To and Cc headers.
01c52d31
MB
1506Valid values are nil, t, `head', `first', `last', an integer or a
1507predicate. See Info node `(gnus)Customizing Articles' and Info
1508node `(gnus)Picons' for details."
bf247b6e 1509 :version "22.1"
23f87bed
MB
1510 :group 'gnus-article-treat
1511 :group 'gnus-picon
1512 :link '(custom-manual "(gnus)Customizing Articles")
1513 :link '(custom-manual "(gnus)Picons")
1514 :type gnus-article-treat-head-custom)
1515(put 'gnus-treat-mail-picon 'highlight t)
1516
1517(defcustom gnus-treat-newsgroups-picon
1518 (if (and (gnus-image-type-available-p 'xpm)
1519 (gnus-picons-installed-p))
1520 'head nil)
1521 "Display picons in the Newsgroups and Followup-To headers.
01c52d31
MB
1522Valid values are nil, t, `head', `first', `last', an integer or a
1523predicate. See Info node `(gnus)Customizing Articles' and Info
1524node `(gnus)Picons' for details."
bf247b6e 1525 :version "22.1"
23f87bed
MB
1526 :group 'gnus-article-treat
1527 :group 'gnus-picon
1528 :link '(custom-manual "(gnus)Customizing Articles")
1529 :link '(custom-manual "(gnus)Picons")
1530 :type gnus-article-treat-head-custom)
1531(put 'gnus-treat-newsgroups-picon 'highlight t)
1532
6688abe0 1533(defcustom gnus-treat-from-gravatar nil
61b1af82
G
1534 "Display gravatars in the From header.
1535Valid values are nil, t, `head', `first', `last', an integer or a
1536predicate. See Info node `(gnus)Customizing Articles' and Info
1537node `(gnus)Gravatars' for details."
1538 :version "24.1"
1539 :group 'gnus-article-treat
1540 :group 'gnus-gravatar
1541 :link '(custom-manual "(gnus)Customizing Articles")
1542 :link '(custom-manual "(gnus)Gravatars")
1543 :type gnus-article-treat-head-custom)
1544(put 'gnus-treat-from-gravatar 'highlight t)
1545
6688abe0 1546(defcustom gnus-treat-mail-gravatar nil
61b1af82
G
1547 "Display gravatars in To and Cc headers.
1548Valid values are nil, t, `head', `first', `last', an integer or a
1549predicate. See Info node `(gnus)Customizing Articles' and Info
1550node `(gnus)Gravatars' for details."
1551 :version "24.1"
1552 :group 'gnus-article-treat
1553 :group 'gnus-gravatar
1554 :link '(custom-manual "(gnus)Customizing Articles")
1555 :link '(custom-manual "(gnus)Gravatars")
1556 :type gnus-article-treat-head-custom)
1557(put 'gnus-treat-mail-gravatar 'highlight t)
1558
23f87bed 1559(defcustom gnus-treat-body-boundary
437ce4be
MB
1560 (if (or gnus-treat-newsgroups-picon
1561 gnus-treat-mail-picon
61b1af82
G
1562 gnus-treat-from-picon
1563 gnus-treat-from-gravatar
1564 gnus-treat-mail-gravatar)
91af3942 1565 ;; If there's much decoration, the user might prefer a boundary.
437ce4be
MB
1566 'head
1567 nil)
23f87bed
MB
1568 "Draw a boundary at the end of the headers.
1569Valid values are nil and `head'.
1570See Info node `(gnus)Customizing Articles' for details."
bf247b6e 1571 :version "22.1"
23f87bed
MB
1572 :group 'gnus-article-treat
1573 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b 1574 :type gnus-article-treat-head-custom)
16409b0b
GM
1575
1576(defcustom gnus-treat-capitalize-sentences nil
1577 "Capitalize sentence-starting words.
01c52d31
MB
1578Valid values are nil, t, `head', `first', `last', an integer or a
1579predicate. See Info node `(gnus)Customizing Articles'."
fc2c2db8 1580 :version "21.1"
16409b0b 1581 :group 'gnus-article-treat
23f87bed
MB
1582 :link '(custom-manual "(gnus)Customizing Articles")
1583 :type gnus-article-treat-custom)
1584
1585(defcustom gnus-treat-wash-html nil
1586 "Format as HTML.
01c52d31
MB
1587Valid values are nil, t, `head', `first', `last', an integer or a
1588predicate. See Info node `(gnus)Customizing Articles'."
bf247b6e 1589 :version "22.1"
23f87bed
MB
1590 :group 'gnus-article-treat
1591 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1592 :type gnus-article-treat-custom)
1593
389b76fa 1594(defcustom gnus-treat-fill-long-lines '(typep "text/plain")
16409b0b 1595 "Fill long lines.
01c52d31
MB
1596Valid values are nil, t, `head', `first', `last', an integer or a
1597predicate. See Info node `(gnus)Customizing Articles'."
37657cbd 1598 :version "24.1"
16409b0b 1599 :group 'gnus-article-treat
23f87bed 1600 :link '(custom-manual "(gnus)Customizing Articles")
16409b0b
GM
1601 :type gnus-article-treat-custom)
1602
23f87bed
MB
1603(defcustom gnus-treat-x-pgp-sig nil
1604 "Verify X-PGP-Sig.
1605To automatically treat X-PGP-Sig, set it to head.
01c52d31
MB
1606Valid values are nil, t, `head', `first', `last', an integer or a
1607predicate. See Info node `(gnus)Customizing Articles'."
bf247b6e 1608 :version "22.1"
23f87bed
MB
1609 :group 'gnus-article-treat
1610 :group 'mime-security
1611 :link '(custom-manual "(gnus)Customizing Articles")
1612 :type gnus-article-treat-custom)
1613
1614(defvar gnus-article-encrypt-protocol-alist
1615 '(("PGP" . mml2015-self-encrypt)))
1616
1617;; Set to nil if more than one protocol added to
1618;; gnus-article-encrypt-protocol-alist.
1619(defcustom gnus-article-encrypt-protocol "PGP"
1620 "The protocol used for encrypt articles.
1621It is a string, such as \"PGP\". If nil, ask user."
bf247b6e 1622 :version "22.1"
23f87bed
MB
1623 :type 'string
1624 :group 'mime-security)
1625
23f87bed
MB
1626(defcustom gnus-use-idna (and (condition-case nil (require 'idna) (file-error))
1627 (mm-coding-system-p 'utf-8)
1628 (executable-find idna-program))
1629 "Whether IDNA decoding of headers is used when viewing messages.
1630This requires GNU Libidn, and by default only enabled if it is found."
bf247b6e 1631 :version "22.1"
23f87bed
MB
1632 :group 'gnus-article-headers
1633 :type 'boolean)
1634
1635(defcustom gnus-article-over-scroll nil
1636 "If non-nil, allow scrolling the article buffer even when there no more text."
bf247b6e 1637 :version "22.1"
23f87bed
MB
1638 :group 'gnus-article
1639 :type 'boolean)
1640
40de2c6d
KY
1641(defcustom gnus-inhibit-images nil
1642 "Non-nil means inhibit displaying of images inline in the article body."
1643 :version "24.1"
1644 :group 'gnus-article
1645 :type 'boolean)
1646
2526f423
G
1647(defcustom gnus-blocked-images 'gnus-block-private-groups
1648 "Images that have URLs matching this regexp will be blocked.
1649This can also be a function to be evaluated. If so, it will be
1650called with the group name as the parameter, and should return a
1651regexp."
130e977f
LMI
1652 :version "24.1"
1653 :group 'gnus-art
a931698a 1654 :type '(choice regexp function))
130e977f 1655
eec82323
LMI
1656;;; Internal variables
1657
23f87bed
MB
1658(defvar gnus-english-month-names
1659 '("January" "February" "March" "April" "May" "June" "July" "August"
1660 "September" "October" "November" "December"))
1661
16409b0b
GM
1662(defvar article-goto-body-goes-to-point-min-p nil)
1663(defvar gnus-article-wash-types nil)
1664(defvar gnus-article-emphasis-alist nil)
23f87bed 1665(defvar gnus-article-image-alist nil)
16409b0b
GM
1666
1667(defvar gnus-article-mime-handle-alist-1 nil)
1668(defvar gnus-treatment-function-alist
052bd38a
LMI
1669 '((gnus-treat-strip-cr gnus-article-remove-cr)
1670 (gnus-treat-x-pgp-sig gnus-article-verify-x-pgp-sig)
23f87bed 1671 (gnus-treat-strip-banner gnus-article-strip-banner)
16409b0b
GM
1672 (gnus-treat-strip-headers-in-body gnus-article-strip-headers-in-body)
1673 (gnus-treat-highlight-signature gnus-article-highlight-signature)
1674 (gnus-treat-buttonize gnus-article-add-buttons)
1675 (gnus-treat-fill-article gnus-article-fill-cited-article)
389b76fa 1676 (gnus-treat-fill-long-lines gnus-article-fill-cited-long-lines)
23f87bed 1677 (gnus-treat-unsplit-urls gnus-article-unsplit-urls)
23f87bed
MB
1678 (gnus-treat-display-x-face gnus-article-display-x-face)
1679 (gnus-treat-display-face gnus-article-display-face)
16409b0b
GM
1680 (gnus-treat-hide-headers gnus-article-maybe-hide-headers)
1681 (gnus-treat-hide-boring-headers gnus-article-hide-boring-headers)
1682 (gnus-treat-hide-signature gnus-article-hide-signature)
16409b0b 1683 (gnus-treat-strip-list-identifiers gnus-article-hide-list-identifiers)
23f87bed 1684 (gnus-treat-leading-whitespace gnus-article-remove-leading-whitespace)
2696d88f
G
1685 (gnus-treat-from-picon gnus-treat-from-picon)
1686 (gnus-treat-mail-picon gnus-treat-mail-picon)
1687 (gnus-treat-newsgroups-picon gnus-treat-newsgroups-picon)
16409b0b 1688 (gnus-treat-strip-pem gnus-article-hide-pem)
12e3ca0a 1689 (gnus-treat-date gnus-article-treat-date)
61b1af82
G
1690 (gnus-treat-from-gravatar gnus-treat-from-gravatar)
1691 (gnus-treat-mail-gravatar gnus-treat-mail-gravatar)
16409b0b 1692 (gnus-treat-highlight-headers gnus-article-highlight-headers)
16409b0b 1693 (gnus-treat-highlight-signature gnus-article-highlight-signature)
16409b0b
GM
1694 (gnus-treat-strip-trailing-blank-lines
1695 gnus-article-remove-trailing-blank-lines)
1696 (gnus-treat-strip-leading-blank-lines
1697 gnus-article-strip-leading-blank-lines)
1698 (gnus-treat-strip-multiple-blank-lines
1699 gnus-article-strip-multiple-blank-lines)
1700 (gnus-treat-overstrike gnus-article-treat-overstrike)
01c52d31 1701 (gnus-treat-ansi-sequences gnus-article-treat-ansi-sequences)
23f87bed 1702 (gnus-treat-unfold-headers gnus-article-treat-unfold-headers)
23f87bed 1703 (gnus-treat-fold-newsgroups gnus-article-treat-fold-newsgroups)
01c52d31 1704 (gnus-treat-fold-headers gnus-article-treat-fold-headers)
16409b0b 1705 (gnus-treat-buttonize-head gnus-article-add-buttons-to-head)
23f87bed 1706 (gnus-treat-display-smileys gnus-treat-smiley)
16409b0b 1707 (gnus-treat-capitalize-sentences gnus-article-capitalize-sentences)
23f87bed
MB
1708 (gnus-treat-wash-html gnus-article-wash-html)
1709 (gnus-treat-emphasize gnus-article-emphasize)
1710 (gnus-treat-hide-citation gnus-article-hide-citation)
1711 (gnus-treat-hide-citation-maybe gnus-article-hide-citation-maybe)
1712 (gnus-treat-highlight-citation gnus-article-highlight-citation)
8ccbef23 1713 (gnus-treat-body-boundary gnus-article-treat-body-boundary)))
16409b0b
GM
1714
1715(defvar gnus-article-mime-handle-alist nil)
6748645f
LMI
1716(defvar article-lapsed-timer nil)
1717(defvar gnus-article-current-summary nil)
1718
eec82323
LMI
1719(defvar gnus-article-mode-syntax-table
1720 (let ((table (copy-syntax-table text-mode-syntax-table)))
23f87bed
MB
1721 ;; This causes the citation match run O(2^n).
1722 ;; (modify-syntax-entry ?- "w" table)
1723 (modify-syntax-entry ?> ")<" table)
1724 (modify-syntax-entry ?< "(>" table)
1725 ;; make M-. in article buffers work for `foo' strings
1726 (modify-syntax-entry ?' " " table)
1727 (modify-syntax-entry ?` " " table)
eec82323
LMI
1728 table)
1729 "Syntax table used in article mode buffers.
1730Initialized from `text-mode-syntax-table.")
1731
1732(defvar gnus-save-article-buffer nil)
1733
eec82323
LMI
1734(defvar gnus-number-of-articles-to-be-saved nil)
1735
1736(defvar gnus-inhibit-hiding nil)
1737
c1d7d285
MB
1738(defvar gnus-article-edit-mode nil)
1739
23f87bed
MB
1740;;; Macros for dealing with the article buffer.
1741
1742(defmacro gnus-with-article-headers (&rest forms)
80de1778 1743 `(with-current-buffer gnus-article-buffer
23f87bed
MB
1744 (save-restriction
1745 (let ((inhibit-read-only t)
1746 (inhibit-point-motion-hooks t)
1747 (case-fold-search t))
1748 (article-narrow-to-head)
1749 ,@forms))))
1750
1751(put 'gnus-with-article-headers 'lisp-indent-function 0)
1752(put 'gnus-with-article-headers 'edebug-form-spec '(body))
1753
1754(defmacro gnus-with-article-buffer (&rest forms)
e1a135a9 1755 `(when (buffer-live-p (get-buffer gnus-article-buffer))
3b0468c4
JD
1756 (with-current-buffer gnus-article-buffer
1757 (let ((inhibit-read-only t))
1758 ,@forms))))
23f87bed
MB
1759
1760(put 'gnus-with-article-buffer 'lisp-indent-function 0)
1761(put 'gnus-with-article-buffer 'edebug-form-spec '(body))
1762
1763(defun gnus-article-goto-header (header)
1764 "Go to HEADER, which is a regular expression."
1765 (re-search-forward (concat "^\\(" header "\\):") nil t))
1766
eec82323
LMI
1767(defsubst gnus-article-hide-text (b e props)
1768 "Set text PROPS on the B to E region, extending `intangible' 1 past B."
520aa572 1769 (gnus-add-text-properties-when 'article-type nil b e props)
eec82323
LMI
1770 (when (memq 'intangible props)
1771 (put-text-property
1772 (max (1- b) (point-min))
1773 b 'intangible (cddr (memq 'intangible props)))))
520aa572 1774
eec82323
LMI
1775(defsubst gnus-article-unhide-text (b e)
1776 "Remove hidden text properties from region between B and E."
1777 (remove-text-properties b e gnus-hidden-properties)
1778 (when (memq 'intangible gnus-hidden-properties)
1779 (put-text-property (max (1- b) (point-min))
1780 b 'intangible nil)))
1781
1782(defun gnus-article-hide-text-type (b e type)
1783 "Hide text of TYPE between B and E."
23f87bed 1784 (gnus-add-wash-type type)
eec82323
LMI
1785 (gnus-article-hide-text
1786 b e (cons 'article-type (cons type gnus-hidden-properties))))
1787
1788(defun gnus-article-unhide-text-type (b e type)
6748645f 1789 "Unhide text of TYPE between B and E."
23f87bed 1790 (gnus-delete-wash-type type)
eec82323
LMI
1791 (remove-text-properties
1792 b e (cons 'article-type (cons type gnus-hidden-properties)))
1793 (when (memq 'intangible gnus-hidden-properties)
1794 (put-text-property (max (1- b) (point-min))
1795 b 'intangible nil)))
1796
eec82323
LMI
1797(defun gnus-article-delete-text-of-type (type)
1798 "Delete text of TYPE in the current buffer."
1799 (save-excursion
a8151ef7 1800 (let ((b (point-min)))
7dafe00b
MB
1801 (if (eq type 'multipart)
1802 ;; Remove MIME buttons associated with multipart/alternative parts.
1803 (progn
1804 (goto-char b)
1805 (while (if (get-text-property (point) 'gnus-part)
1806 (setq b (point))
1807 (when (setq b (next-single-property-change (point)
1808 'gnus-part))
1809 (goto-char b)
1810 t))
1811 (end-of-line)
1812 (skip-chars-forward "\n")
1813 (when (eq (get-text-property b 'article-type) 'multipart)
1814 (delete-region b (point)))))
1815 (while (setq b (text-property-any b (point-max) 'article-type type))
1816 (delete-region
1817 b (or (text-property-not-all b (point-max) 'article-type type)
1818 (point-max))))))))
eec82323
LMI
1819
1820(defun gnus-article-delete-invisible-text ()
1821 "Delete all invisible text in the current buffer."
1822 (save-excursion
a8151ef7
LMI
1823 (let ((b (point-min)))
1824 (while (setq b (text-property-any b (point-max) 'invisible t))
1825 (delete-region
1826 b (or (text-property-not-all b (point-max) 'invisible t)
1827 (point-max)))))))
eec82323 1828
eec82323
LMI
1829(defsubst gnus-article-header-rank ()
1830 "Give the rank of the string HEADER as given by `gnus-sorted-header-list'."
1831 (let ((list gnus-sorted-header-list)
23f87bed 1832 (i 1))
eec82323 1833 (while list
23f87bed
MB
1834 (if (looking-at (car list))
1835 (setq list nil)
1836 (setq list (cdr list))
1837 (incf i)))
1838 i))
eec82323
LMI
1839
1840(defun article-hide-headers (&optional arg delete)
16409b0b
GM
1841 "Hide unwanted headers and possibly sort them as well."
1842 (interactive)
1843 ;; This function might be inhibited.
1844 (unless gnus-inhibit-hiding
37cc095b 1845 (let ((inhibit-read-only t)
23f87bed
MB
1846 (case-fold-search t)
1847 (max (1+ (length gnus-sorted-header-list)))
1848 (inhibit-point-motion-hooks t)
1849 (cur (current-buffer))
1850 ignored visible beg)
1851 (save-excursion
1852 ;; `gnus-ignored-headers' and `gnus-visible-headers' may be
1853 ;; group parameters, so we should go to the summary buffer.
1854 (when (prog1
1855 (condition-case nil
1856 (progn (set-buffer gnus-summary-buffer) t)
1857 (error nil))
1858 (setq ignored (when (not gnus-visible-headers)
1859 (cond ((stringp gnus-ignored-headers)
1860 gnus-ignored-headers)
1861 ((listp gnus-ignored-headers)
1862 (mapconcat 'identity
1863 gnus-ignored-headers
1864 "\\|"))))
1865 visible (cond ((stringp gnus-visible-headers)
1866 gnus-visible-headers)
1867 ((and gnus-visible-headers
1868 (listp gnus-visible-headers))
1869 (mapconcat 'identity
1870 gnus-visible-headers
1871 "\\|")))))
1872 (set-buffer cur))
1873 (save-restriction
16409b0b
GM
1874 ;; First we narrow to just the headers.
1875 (article-narrow-to-head)
1876 ;; Hide any "From " lines at the beginning of (mail) articles.
1877 (while (looking-at "From ")
1878 (forward-line 1))
1879 (unless (bobp)
1880 (delete-region (point-min) (point)))
1881 ;; Then treat the rest of the header lines.
1882 ;; Then we use the two regular expressions
1883 ;; `gnus-ignored-headers' and `gnus-visible-headers' to
1884 ;; select which header lines is to remain visible in the
1885 ;; article buffer.
23f87bed 1886 (while (re-search-forward "^[^ \t:]*:" nil t)
16409b0b
GM
1887 (beginning-of-line)
1888 ;; Mark the rank of the header.
1889 (put-text-property
1890 (point) (1+ (point)) 'message-rank
1891 (if (or (and visible (looking-at visible))
1892 (and ignored
1893 (not (looking-at ignored))))
1894 (gnus-article-header-rank)
1895 (+ 2 max)))
1896 (forward-line 1))
1897 (message-sort-headers-1)
1898 (when (setq beg (text-property-any
1899 (point-min) (point-max) 'message-rank (+ 2 max)))
1900 ;; We delete the unwanted headers.
23f87bed 1901 (gnus-add-wash-type 'headers)
16409b0b
GM
1902 (add-text-properties (point-min) (+ 5 (point-min))
1903 '(article-type headers dummy-invisible t))
1904 (delete-region beg (point-max))))))))
eec82323
LMI
1905
1906(defun article-hide-boring-headers (&optional arg)
1907 "Toggle hiding of headers that aren't very interesting.
1908If given a negative prefix, always show; if given a positive prefix,
1909always hide."
1910 (interactive (gnus-article-hidden-arg))
1911 (when (and (not (gnus-article-check-hidden-text 'boring-headers arg))
1912 (not gnus-show-all-headers))
1913 (save-excursion
1914 (save-restriction
4e7d0221 1915 (let ((inhibit-read-only t)
01c52d31 1916 (inhibit-point-motion-hooks t))
16409b0b 1917 (article-narrow-to-head)
01c52d31 1918 (dolist (elem gnus-boring-article-headers)
eec82323
LMI
1919 (goto-char (point-min))
1920 (cond
1921 ;; Hide empty headers.
1922 ((eq elem 'empty)
16409b0b 1923 (while (re-search-forward "^[^: \t]+:[ \t]*\n[^ \t]" nil t)
eec82323
LMI
1924 (forward-line -1)
1925 (gnus-article-hide-text-type
01c52d31 1926 (point-at-bol)
eec82323
LMI
1927 (progn
1928 (end-of-line)
1929 (if (re-search-forward "^[^ \t]" nil t)
1930 (match-beginning 0)
1931 (point-max)))
1932 'boring-headers)))
1933 ;; Hide boring Newsgroups header.
1934 ((eq elem 'newsgroups)
23f87bed
MB
1935 (when (gnus-string-equal
1936 (gnus-fetch-field "newsgroups")
1937 (gnus-group-real-name
1938 (if (boundp 'gnus-newsgroup-name)
1939 gnus-newsgroup-name
1940 "")))
eec82323 1941 (gnus-article-hide-header "newsgroups")))
23f87bed
MB
1942 ((eq elem 'to-address)
1943 (let ((to (message-fetch-field "to"))
1944 (to-address
1945 (gnus-parameter-to-address
1946 (if (boundp 'gnus-newsgroup-name)
1947 gnus-newsgroup-name ""))))
1948 (when (and to to-address
1949 (ignore-errors
1950 (gnus-string-equal
1951 ;; only one address in To
1952 (nth 1 (mail-extract-address-components to))
1953 to-address)))
1954 (gnus-article-hide-header "to"))))
1955 ((eq elem 'to-list)
1956 (let ((to (message-fetch-field "to"))
1957 (to-list
1958 (gnus-parameter-to-list
1959 (if (boundp 'gnus-newsgroup-name)
1960 gnus-newsgroup-name ""))))
1961 (when (and to to-list
1962 (ignore-errors
1963 (gnus-string-equal
1964 ;; only one address in To
1965 (nth 1 (mail-extract-address-components to))
1966 to-list)))
1967 (gnus-article-hide-header "to"))))
1968 ((eq elem 'cc-list)
1969 (let ((cc (message-fetch-field "cc"))
1970 (to-list
1971 (gnus-parameter-to-list
1972 (if (boundp 'gnus-newsgroup-name)
1973 gnus-newsgroup-name ""))))
1974 (when (and cc to-list
1975 (ignore-errors
1976 (gnus-string-equal
1977 ;; only one address in CC
1978 (nth 1 (mail-extract-address-components cc))
1979 to-list)))
1980 (gnus-article-hide-header "cc"))))
eec82323 1981 ((eq elem 'followup-to)
23f87bed
MB
1982 (when (gnus-string-equal
1983 (message-fetch-field "followup-to")
1984 (message-fetch-field "newsgroups"))
eec82323
LMI
1985 (gnus-article-hide-header "followup-to")))
1986 ((eq elem 'reply-to)
23f87bed
MB
1987 (if (gnus-group-find-parameter
1988 gnus-newsgroup-name 'broken-reply-to)
1989 (gnus-article-hide-header "reply-to")
1990 (let ((from (message-fetch-field "from"))
1991 (reply-to (message-fetch-field "reply-to")))
1992 (when
1993 (and
eec82323
LMI
1994 from reply-to
1995 (ignore-errors
1996 (equal
23f87bed
MB
1997 (sort (mapcar
1998 (lambda (x) (downcase (cadr x)))
1999 (mail-extract-address-components from t))
2000 'string<)
2001 (sort (mapcar
2002 (lambda (x) (downcase (cadr x)))
2003 (mail-extract-address-components reply-to t))
2004 'string<))))
2005 (gnus-article-hide-header "reply-to")))))
eec82323 2006 ((eq elem 'date)
b193caa3
MB
2007 (let ((date (with-current-buffer gnus-original-article-buffer
2008 ;; If date in `gnus-article-buffer' is localized
2009 ;; (`gnus-treat-date-user-defined'),
2010 ;; `days-between' might fail.
2011 (message-fetch-field "date"))))
eec82323 2012 (when (and date
16409b0b 2013 (< (days-between (current-time-string) date)
eec82323 2014 4))
6748645f
LMI
2015 (gnus-article-hide-header "date"))))
2016 ((eq elem 'long-to)
16409b0b
GM
2017 (let ((to (message-fetch-field "to"))
2018 (cc (message-fetch-field "cc")))
6748645f 2019 (when (> (length to) 1024)
16409b0b
GM
2020 (gnus-article-hide-header "to"))
2021 (when (> (length cc) 1024)
2022 (gnus-article-hide-header "cc"))))
6748645f 2023 ((eq elem 'many-to)
16409b0b
GM
2024 (let ((to-count 0)
2025 (cc-count 0))
6748645f
LMI
2026 (goto-char (point-min))
2027 (while (re-search-forward "^to:" nil t)
2028 (setq to-count (1+ to-count)))
2029 (when (> to-count 1)
2030 (while (> to-count 0)
2031 (goto-char (point-min))
2032 (save-restriction
2033 (re-search-forward "^to:" nil nil to-count)
2034 (forward-line -1)
2035 (narrow-to-region (point) (point-max))
2036 (gnus-article-hide-header "to"))
16409b0b
GM
2037 (setq to-count (1- to-count))))
2038 (goto-char (point-min))
2039 (while (re-search-forward "^cc:" nil t)
2040 (setq cc-count (1+ cc-count)))
2041 (when (> cc-count 1)
2042 (while (> cc-count 0)
2043 (goto-char (point-min))
2044 (save-restriction
2045 (re-search-forward "^cc:" nil nil cc-count)
2046 (forward-line -1)
2047 (narrow-to-region (point) (point-max))
2048 (gnus-article-hide-header "cc"))
2049 (setq cc-count (1- cc-count)))))))))))))
eec82323
LMI
2050
2051(defun gnus-article-hide-header (header)
2052 (save-excursion
2053 (goto-char (point-min))
2054 (when (re-search-forward (concat "^" header ":") nil t)
2055 (gnus-article-hide-text-type
01c52d31 2056 (point-at-bol)
eec82323
LMI
2057 (progn
2058 (end-of-line)
2059 (if (re-search-forward "^[^ \t]" nil t)
2060 (match-beginning 0)
2061 (point-max)))
2062 'boring-headers))))
2063
16409b0b
GM
2064(defvar gnus-article-normalized-header-length 40
2065 "Length of normalized headers.")
2066
2067(defun article-normalize-headers ()
2068 "Make all header lines 40 characters long."
2069 (interactive)
4e7d0221 2070 (let ((inhibit-read-only t)
16409b0b
GM
2071 column)
2072 (save-excursion
2073 (save-restriction
2074 (article-narrow-to-head)
2075 (while (not (eobp))
2076 (cond
01c52d31 2077 ((< (setq column (- (point-at-eol) (point)))
16409b0b
GM
2078 gnus-article-normalized-header-length)
2079 (end-of-line)
2080 (insert (make-string
2081 (- gnus-article-normalized-header-length column)
2082 ? )))
2083 ((> column gnus-article-normalized-header-length)
2084 (gnus-put-text-property
2085 (progn
2086 (forward-char gnus-article-normalized-header-length)
2087 (point))
01c52d31 2088 (point-at-eol)
16409b0b
GM
2089 'invisible t))
2090 (t
2091 ;; Do nothing.
2092 ))
2093 (forward-line 1))))))
2094
6748645f 2095(defun article-treat-dumbquotes ()
23f87bed 2096 "Translate M****s*** sm*rtq**t*s and other symbols into proper text.
16409b0b 2097Note that this function guesses whether a character is a sm*rtq**t* or
74dd1b0d
SZ
2098not, so it should only be used interactively.
2099
23f87bed
MB
2100Sm*rtq**t*s are M****s***'s unilateral extension to the
2101iso-8859-1 character map in an attempt to provide more quoting
2102characters. If you see something like \\222 or \\264 where
2103you're expecting some kind of apostrophe or quotation mark, then
2104try this wash."
6748645f 2105 (interactive)
16409b0b 2106 (article-translate-strings gnus-article-dumbquotes-map))
6748645f 2107
16c1b3bc
KY
2108(defvar org-entities)
2109
be3c11b3
LMI
2110(defun article-treat-non-ascii ()
2111 "Translate many Unicode characters into their ASCII equivalents."
2112 (interactive)
2113 (require 'org-entities)
9c1d3f98 2114 (let ((table (make-char-table (if (featurep 'xemacs) 'generic))))
be3c11b3
LMI
2115 (dolist (elem org-entities)
2116 (when (and (listp elem)
2117 (= (length (nth 6 elem)) 1))
fdf14191
KY
2118 (if (featurep 'xemacs)
2119 (put-char-table (aref (nth 6 elem) 0) (nth 4 elem) table)
2120 (set-char-table-range table (aref (nth 6 elem) 0) (nth 4 elem)))))
be3c11b3
LMI
2121 (save-excursion
2122 (when (article-goto-body)
2123 (let ((inhibit-read-only t)
2f0e0dc8 2124 replace props)
be3c11b3 2125 (while (not (eobp))
9c1d3f98
KY
2126 (if (not (setq replace (if (featurep 'xemacs)
2127 (get-char-table (following-char) table)
2128 (aref table (following-char)))))
be3c11b3 2129 (forward-char 1)
2f0e0dc8
KY
2130 (if (prog1
2131 (setq props (text-properties-at (point)))
2132 (delete-char 1))
2133 (add-text-properties (point) (progn (insert replace) (point))
2134 props)
2135 (insert replace)))))))))
be3c11b3 2136
16409b0b
GM
2137(defun article-translate-strings (map)
2138 "Translate all string in the body of the article according to MAP.
2139MAP is an alist where the elements are on the form (\"from\" \"to\")."
2140 (save-excursion
2141 (when (article-goto-body)
01c52d31
MB
2142 (let ((inhibit-read-only t))
2143 (dolist (elem map)
7cad71ad
G
2144 (let ((from (car elem))
2145 (to (cadr elem)))
2146 (save-excursion
2147 (if (stringp from)
2148 (while (search-forward from nil t)
2149 (replace-match to))
2150 (while (not (eobp))
2151 (if (eq (following-char) from)
2152 (progn
2153 (delete-char 1)
2154 (insert to))
2155 (forward-char 1)))))))))))
16409b0b 2156
eec82323
LMI
2157(defun article-treat-overstrike ()
2158 "Translate overstrikes into bold text."
2159 (interactive)
2160 (save-excursion
16409b0b 2161 (when (article-goto-body)
4e7d0221 2162 (let ((inhibit-read-only t))
eec82323 2163 (while (search-forward "\b" nil t)
16409b0b 2164 (let ((next (char-after))
eec82323
LMI
2165 (previous (char-after (- (point) 2))))
2166 ;; We do the boldification/underlining by hiding the
2167 ;; overstrikes and putting the proper text property
2168 ;; on the letters.
2169 (cond
2170 ((eq next previous)
2171 (gnus-article-hide-text-type (- (point) 2) (point) 'overstrike)
2172 (put-text-property (point) (1+ (point)) 'face 'bold))
2173 ((eq next ?_)
2174 (gnus-article-hide-text-type
2175 (1- (point)) (1+ (point)) 'overstrike)
2176 (put-text-property
2177 (- (point) 2) (1- (point)) 'face 'underline))
2178 ((eq previous ?_)
2179 (gnus-article-hide-text-type (- (point) 2) (point) 'overstrike)
2180 (put-text-property
2181 (point) (1+ (point)) 'face 'underline)))))))))
2182
01c52d31
MB
2183(defun article-treat-ansi-sequences ()
2184 "Translate ANSI SGR control sequences into overlays or extents."
2185 (interactive)
2186 (save-excursion
2187 (when (article-goto-body)
2188 (let ((inhibit-read-only t))
2189 (ansi-color-apply-on-region (point) (point-max))))))
2190
23f87bed
MB
2191(defun gnus-article-treat-unfold-headers ()
2192 "Unfold folded message headers.
2193Only the headers that fit into the current window width will be
2194unfolded."
2195 (interactive)
2196 (gnus-with-article-headers
2197 (let (length)
2198 (while (not (eobp))
2199 (save-restriction
2200 (mail-header-narrow-to-field)
01c52d31
MB
2201 (let* ((header (buffer-string))
2202 (unfoldable
2203 (or (equal gnus-article-unfold-long-headers t)
2204 (and (stringp gnus-article-unfold-long-headers)
89b163db
G
2205 (string-match gnus-article-unfold-long-headers
2206 header)))))
23f87bed
MB
2207 (with-temp-buffer
2208 (insert header)
2209 (goto-char (point-min))
2210 (while (re-search-forward "\n[\t ]" nil t)
2211 (replace-match " " t t)))
01c52d31
MB
2212 (setq length (- (point-max) (point-min) 1))
2213 (when (or unfoldable
2214 (< length (window-width)))
2215 (while (re-search-forward "\n[\t ]" nil t)
2216 (replace-match " " t t))))
23f87bed
MB
2217 (goto-char (point-max)))))))
2218
2219(defun gnus-article-treat-fold-headers ()
2220 "Fold message headers."
2221 (interactive)
2222 (gnus-with-article-headers
2223 (while (not (eobp))
2224 (save-restriction
2225 (mail-header-narrow-to-field)
2226 (mail-header-fold-field)
2227 (goto-char (point-max))))))
2228
2229(defun gnus-treat-smiley ()
2230 "Toggle display of textual emoticons (\"smileys\") as small graphical icons."
2231 (interactive)
2232 (gnus-with-article-buffer
2233 (if (memq 'smiley gnus-article-wash-types)
2234 (gnus-delete-images 'smiley)
2235 (article-goto-body)
2236 (let ((images (smiley-region (point) (point-max))))
2237 (when images
2238 (gnus-add-wash-type 'smiley)
2239 (dolist (image images)
2240 (gnus-add-image 'smiley image)))))))
2241
2242(defun gnus-article-remove-images ()
2243 "Remove all images from the article buffer."
2244 (interactive)
2245 (gnus-with-article-buffer
9695908d
KY
2246 (save-restriction
2247 (widen)
2248 (dolist (elem gnus-article-image-alist)
2249 (gnus-delete-images (car elem))))))
23f87bed 2250
ae97e645
G
2251(autoload 'w3m-toggle-inline-images "w3m")
2252
8b6f6573
LMI
2253(defun gnus-article-show-images ()
2254 "Show any images that are in the HTML-rendered article buffer.
2255This only works if the article in question is HTML."
2256 (interactive)
2257 (gnus-with-article-buffer
9695908d
KY
2258 (save-restriction
2259 (widen)
ae97e645
G
2260 (if (eq mm-text-html-renderer 'w3m)
2261 (let ((mm-inline-text-html-with-images nil))
2262 (w3m-toggle-inline-images))
2263 (dolist (region (gnus-find-text-property-region (point-min) (point-max)
2264 'image-displayer))
2265 (destructuring-bind (start end function) region
2266 (funcall function (get-text-property start 'image-url)
2267 start end)))))))
8b6f6573 2268
23f87bed
MB
2269(defun gnus-article-treat-fold-newsgroups ()
2270 "Unfold folded message headers.
2271Only the headers that fit into the current window width will be
2272unfolded."
2273 (interactive)
2274 (gnus-with-article-headers
2275 (while (gnus-article-goto-header "newsgroups\\|followup-to")
2276 (save-restriction
2277 (mail-header-narrow-to-field)
2278 (while (re-search-forward ", *" nil t)
2279 (replace-match ", " t t))
2280 (mail-header-fold-field)
2281 (goto-char (point-max))))))
2282
b7b80032 2283(defcustom gnus-article-truncate-lines (default-value 'truncate-lines)
01c52d31
MB
2284 "Value of `truncate-lines' in Gnus Article buffer.
2285Valid values are nil, t, `head', `first', `last', an integer or a
2286predicate. See Info node `(gnus)Customizing Articles'."
330f707b 2287 :version "23.1" ;; No Gnus
01c52d31
MB
2288 :group 'gnus-article
2289 ;; :link '(custom-manual "(gnus)Customizing Articles")
2290 :type 'boolean)
2291
2292(defun gnus-article-toggle-truncate-lines (&optional arg)
2293 "Toggle whether to fold or truncate long lines in article the buffer.
2294If ARG is non-nil and not a number, toggle
2295`gnus-article-truncate-lines' too. If ARG is a number, truncate
5229211e 2296long lines if and only if arg is positive."
01c52d31
MB
2297 (interactive "P")
2298 (cond
2299 ((and (numberp arg) (> arg 0))
2300 (setq gnus-article-truncate-lines t))
2301 ((numberp arg)
2302 (setq gnus-article-truncate-lines nil))
2303 (arg
2304 (setq gnus-article-truncate-lines
2305 (not gnus-article-truncate-lines))))
2306 (gnus-with-article-buffer
2307 (cond
2308 ((and (numberp arg) (> arg 0))
2309 (setq truncate-lines nil))
2310 ((numberp arg)
2311 (setq truncate-lines t)))
2312 ;; In versions of Emacs 22 (CVS) before 2006-05-26,
2313 ;; `toggle-truncate-lines' needs an argument.
2314 (toggle-truncate-lines)))
2315
23f87bed
MB
2316(defun gnus-article-treat-body-boundary ()
2317 "Place a boundary line at the end of the headers."
2318 (interactive)
2319 (when (and gnus-body-boundary-delimiter
2320 (> (length gnus-body-boundary-delimiter) 0))
2321 (gnus-with-article-headers
2322 (goto-char (point-max))
2323 (let ((start (point)))
2324 (insert "X-Boundary: ")
2325 (gnus-add-text-properties start (point) '(invisible t intangible t))
a123622d
G
2326 (insert (let (str (max (window-width)))
2327 (if (featurep 'xemacs)
2328 (setq max (1- max)))
2329 (while (>= max (length str))
23f87bed 2330 (setq str (concat str gnus-body-boundary-delimiter)))
a123622d 2331 (substring str 0 max))
23f87bed
MB
2332 "\n")
2333 (gnus-put-text-property start (point) 'gnus-decoration 'header)))))
2334
16409b0b
GM
2335(defun article-fill-long-lines ()
2336 "Fill lines that are wider than the window width."
eec82323
LMI
2337 (interactive)
2338 (save-excursion
4e7d0221 2339 (let ((inhibit-read-only t)
16409b0b
GM
2340 (width (window-width (get-buffer-window (current-buffer)))))
2341 (save-restriction
2342 (article-goto-body)
80b47379 2343 (let ((adaptive-fill-mode nil)) ;Why? -sm
16409b0b
GM
2344 (while (not (eobp))
2345 (end-of-line)
2346 (when (>= (current-column) (min fill-column width))
23f87bed 2347 (narrow-to-region (min (1+ (point)) (point-max))
01c52d31 2348 (point-at-bol))
23f87bed
MB
2349 (let ((goback (point-marker)))
2350 (fill-paragraph nil)
2351 (goto-char (marker-position goback)))
16409b0b
GM
2352 (widen))
2353 (forward-line 1)))))))
2354
2355(defun article-capitalize-sentences ()
2356 "Capitalize the first word in each sentence."
2357 (interactive)
2358 (save-excursion
4e7d0221 2359 (let ((inhibit-read-only t)
16409b0b
GM
2360 (paragraph-start "^[\n\^L]"))
2361 (article-goto-body)
2362 (while (not (eobp))
2363 (capitalize-word 1)
2364 (forward-sentence)))))
eec82323
LMI
2365
2366(defun article-remove-cr ()
16409b0b 2367 "Remove trailing CRs and then translate remaining CRs into LFs."
eec82323
LMI
2368 (interactive)
2369 (save-excursion
4e7d0221 2370 (let ((inhibit-read-only t))
eec82323 2371 (goto-char (point-min))
16409b0b
GM
2372 (while (re-search-forward "\r+$" nil t)
2373 (replace-match "" t t))
2374 (goto-char (point-min))
eec82323 2375 (while (search-forward "\r" nil t)
16409b0b 2376 (replace-match "\n" t t)))))
eec82323
LMI
2377
2378(defun article-remove-trailing-blank-lines ()
2379 "Remove all trailing blank lines from the article."
2380 (interactive)
2381 (save-excursion
4e7d0221 2382 (let ((inhibit-read-only t))
eec82323
LMI
2383 (goto-char (point-max))
2384 (delete-region
2385 (point)
2386 (progn
2387 (while (and (not (bobp))
16409b0b
GM
2388 (looking-at "^[ \t]*$")
2389 (not (gnus-annotation-in-region-p
01c52d31 2390 (point) (point-at-eol))))
eec82323
LMI
2391 (forward-line -1))
2392 (forward-line 1)
2393 (point))))))
2394
9efa445f 2395(defvar gnus-face-properties-alist)
01c52d31 2396
b890d447 2397(defun article-display-face (&optional force)
23f87bed 2398 "Display any Face headers in the header."
b890d447 2399 (interactive (list 'force))
23f87bed
MB
2400 (let ((wash-face-p buffer-read-only))
2401 (gnus-with-article-headers
2402 ;; When displaying parts, this function can be called several times on
2403 ;; the same article, without any intended toggle semantic (as typing `W
2404 ;; D d' would have). So face deletion must occur only when we come from
2405 ;; an interactive command, that is when the *Article* buffer is
2406 ;; read-only.
2407 (if (and wash-face-p (memq 'face gnus-article-wash-types))
2408 (gnus-delete-images 'face)
b890d447
MB
2409 (let ((from (message-fetch-field "from"))
2410 face faces)
7d0c69be 2411 (save-current-buffer
23f87bed 2412 (when (and wash-face-p
7d0c69be
MB
2413 (gnus-buffer-live-p gnus-original-article-buffer)
2414 (not (re-search-forward "^Face:[\t ]*" nil t)))
23f87bed
MB
2415 (set-buffer gnus-original-article-buffer))
2416 (save-restriction
2417 (mail-narrow-to-head)
b890d447
MB
2418 (when (or force
2419 ;; Check whether this face is censored.
2420 (not (and gnus-article-x-face-too-ugly
2421 (or from
2422 (setq from (message-fetch-field "from")))
2423 (string-match gnus-article-x-face-too-ugly
2424 from))))
2425 (while (gnus-article-goto-header "Face")
2426 (push (mail-header-field-value) faces)))))
d6697c02 2427 (when faces
7d0c69be 2428 (goto-char (point-min))
b890d447
MB
2429 (let (png image)
2430 (unless (setq from (gnus-article-goto-header "from"))
7d0c69be
MB
2431 (insert "From:")
2432 (setq from (point))
b890d447 2433 (insert " [no `from' set]\n"))
7d0c69be
MB
2434 (while faces
2435 (when (setq png (gnus-convert-face-to-png (pop faces)))
01c52d31
MB
2436 (setq image
2437 (apply 'gnus-create-image png 'png t
2438 (cdr (assq 'png gnus-face-properties-alist))))
d6697c02 2439 (goto-char from)
b4599732
CY
2440 (when image
2441 (gnus-add-wash-type 'face)
2442 (gnus-add-image 'face image)
2443 (gnus-put-image image nil 'face)))))))))))
23f87bed 2444
eec82323
LMI
2445(defun article-display-x-face (&optional force)
2446 "Look for an X-Face header and display it if present."
2447 (interactive (list 'force))
23f87bed
MB
2448 (let ((wash-face-p buffer-read-only)) ;; When type `W f'
2449 (gnus-with-article-headers
2450 ;; Delete the old process, if any.
2451 (when (process-status "article-x-face")
2452 (delete-process "article-x-face"))
2453 ;; See the comment in `article-display-face'.
2454 (if (and wash-face-p (memq 'xface gnus-article-wash-types))
2455 ;; We have already displayed X-Faces, so we remove them
2456 ;; instead.
2457 (gnus-delete-images 'xface)
2458 ;; Display X-Faces.
b890d447
MB
2459 (let ((from (message-fetch-field "from"))
2460 x-faces face)
7d0c69be 2461 (save-current-buffer
23f87bed 2462 (when (and wash-face-p
7d0c69be
MB
2463 (gnus-buffer-live-p gnus-original-article-buffer)
2464 (not (re-search-forward "^X-Face:[\t ]*" nil t)))
23f87bed
MB
2465 ;; If type `W f', use gnus-original-article-buffer,
2466 ;; otherwise use the current buffer because displaying
2467 ;; RFC822 parts calls this function too.
2468 (set-buffer gnus-original-article-buffer))
2469 (save-restriction
2470 (mail-narrow-to-head)
b890d447
MB
2471 (and gnus-article-x-face-command
2472 (or force
2473 ;; Check whether this face is censored.
2474 (not (and gnus-article-x-face-too-ugly
2475 (or from
2476 (setq from (message-fetch-field "from")))
2477 (string-match gnus-article-x-face-too-ugly
2478 from))))
2479 (while (gnus-article-goto-header "X-Face")
2480 (push (mail-header-field-value) x-faces)))))
2481 (when x-faces
2482 ;; We display the face.
2483 (cond ((functionp gnus-article-x-face-command)
2484 ;; The command is a lisp function, so we call it.
2485 (mapc gnus-article-x-face-command x-faces))
2486 ((stringp gnus-article-x-face-command)
2487 ;; The command is a string, so we interpret the command
2488 ;; as a, well, command, and fork it off.
2489 (let ((process-connection-type nil))
2490 (gnus-set-process-query-on-exit-flag
2491 (start-process
2492 "article-x-face" nil shell-file-name
2493 shell-command-switch gnus-article-x-face-command)
2494 nil)
2495 ;; Sending multiple EOFs to xv doesn't work,
2496 ;; so we only do a single external face.
2497 (with-temp-buffer
2498 (insert (car x-faces))
2499 (process-send-region "article-x-face"
2500 (point-min) (point-max)))
2501 (process-send-eof "article-x-face")))
2502 (t
2503 (error "`%s' set to `%s' is not a function"
2504 gnus-article-x-face-command
2505 'gnus-article-x-face-command)))))))))
a8151ef7 2506
16409b0b
GM
2507(defun article-decode-mime-words ()
2508 "Decode all MIME-encoded words in the article."
2509 (interactive)
01c52d31 2510 (gnus-with-article-buffer
16409b0b 2511 (let ((inhibit-point-motion-hooks t)
16409b0b 2512 (mail-parse-charset gnus-newsgroup-charset)
a1506d29 2513 (mail-parse-ignored-charsets
01c52d31
MB
2514 (with-current-buffer gnus-summary-buffer
2515 gnus-newsgroup-ignored-charsets)))
16409b0b
GM
2516 (mail-decode-encoded-word-region (point-min) (point-max)))))
2517
2518(defun article-decode-charset (&optional prompt)
2519 "Decode charset-encoded text in the article.
2520If PROMPT (the prefix), prompt for a coding system to use."
2521 (interactive "P")
2522 (let ((inhibit-point-motion-hooks t) (case-fold-search t)
23f87bed 2523 (inhibit-read-only t)
16409b0b 2524 (mail-parse-charset gnus-newsgroup-charset)
a1506d29 2525 (mail-parse-ignored-charsets
16409b0b
GM
2526 (save-excursion (condition-case nil
2527 (set-buffer gnus-summary-buffer)
2528 (error))
2529 gnus-newsgroup-ignored-charsets))
2530 ct cte ctl charset format)
c96ec15a
MB
2531 (save-excursion
2532 (save-restriction
2533 (article-narrow-to-head)
2534 (setq ct (message-fetch-field "Content-Type" t)
2535 cte (message-fetch-field "Content-Transfer-Encoding" t)
2536 ctl (and ct (mail-header-parse-content-type ct))
2537 charset (cond
2538 (prompt
2539 (mm-read-coding-system "Charset to decode: "))
2540 (ctl
2541 (mail-content-type-get ctl 'charset)))
2542 format (and ctl (mail-content-type-get ctl 'format)))
2543 (when cte
2544 (setq cte (mail-header-strip cte)))
2545 (if (and ctl (not (string-match "/" (car ctl))))
2546 (setq ctl nil))
2547 (goto-char (point-max)))
2548 (forward-line 1)
2549 (save-restriction
2550 (narrow-to-region (point) (point-max))
2551 (when (and (eq mail-parse-charset 'gnus-decoded)
2552 (eq (mm-body-7-or-8) '8bit))
2553 ;; The text code could have been decoded.
2554 (setq charset mail-parse-charset))
2555 (when (and (or (not ctl)
2556 (equal (car ctl) "text/plain"))
2557 (not format)) ;; article with format will decode later.
2558 (mm-decode-body
2559 charset (and cte (intern (downcase
2560 (gnus-strip-whitespace cte))))
2561 (car ctl)))))))
16409b0b
GM
2562
2563(defun article-decode-encoded-words ()
2564 "Remove encoded-word encoding from headers."
2565 (let ((inhibit-point-motion-hooks t)
2566 (mail-parse-charset gnus-newsgroup-charset)
a1506d29 2567 (mail-parse-ignored-charsets
16409b0b
GM
2568 (save-excursion (condition-case nil
2569 (set-buffer gnus-summary-buffer)
2570 (error))
2571 gnus-newsgroup-ignored-charsets))
343d6628 2572 (inhibit-read-only t)
8fbdffe5
MB
2573 end start)
2574 (goto-char (point-min))
2575 (when (search-forward "\n\n" nil 'move)
2576 (forward-line -1))
2577 (setq end (point))
2578 (while (not (bobp))
2579 (while (progn
2580 (forward-line -1)
2581 (and (not (bobp))
2582 (memq (char-after) '(?\t ? )))))
2583 (setq start (point))
2584 (if (looking-at "\
343d6628
MB
2585\\(?:Resent-\\)?\\(?:From\\|Cc\\|To\\|Bcc\\|\\(?:In-\\)?Reply-To\\|Sender\
2586\\|Mail-Followup-To\\|Mail-Copies-To\\|Approved\\):")
8fbdffe5
MB
2587 (funcall gnus-decode-address-function start end)
2588 (funcall gnus-decode-header-function start end))
2589 (goto-char (setq end start)))))
eec82323 2590
23f87bed 2591(defun article-decode-group-name ()
01c52d31 2592 "Decode group names in Newsgroups, Followup-To and Xref headers."
23f87bed
MB
2593 (let ((inhibit-point-motion-hooks t)
2594 (inhibit-read-only t)
01c52d31
MB
2595 (method (gnus-find-method-for-group gnus-newsgroup-name))
2596 regexp)
23f87bed
MB
2597 (when (and (or gnus-group-name-charset-method-alist
2598 gnus-group-name-charset-group-alist)
2599 (gnus-buffer-live-p gnus-original-article-buffer))
2600 (save-restriction
2601 (article-narrow-to-head)
01c52d31
MB
2602 (dolist (header '("Newsgroups" "Followup-To" "Xref"))
2603 (with-current-buffer gnus-original-article-buffer
2604 (goto-char (point-min)))
2605 (setq regexp (concat "^" header
2606 ":\\([^\n]*\\(?:\n[\t ]+[^\n]+\\)*\\)\n"))
2607 (while (re-search-forward regexp nil t)
2608 (replace-match (save-match-data
2609 (gnus-decode-newsgroups
2610 ;; XXX how to use data in article buffer?
2611 (with-current-buffer gnus-original-article-buffer
2612 (re-search-forward regexp nil t)
2613 (match-string 1))
2614 gnus-newsgroup-name method))
2615 t t nil 1))
2616 (goto-char (point-min)))))))
23f87bed
MB
2617
2618(autoload 'idna-to-unicode "idna")
2619
2620(defun article-decode-idna-rhs ()
53cfefc8
MB
2621 "Decode IDNA strings in RHS in various headers in current buffer.
2622The following headers are decoded: From:, To:, Cc:, Reply-To:,
2623Mail-Reply-To: and Mail-Followup-To:."
23f87bed
MB
2624 (when gnus-use-idna
2625 (save-restriction
2626 (let ((inhibit-point-motion-hooks t)
2627 (inhibit-read-only t))
2628 (article-narrow-to-head)
2629 (goto-char (point-min))
53cfefc8 2630 (while (re-search-forward "@[^ \t\n\r,>]*\\(xn--[-A-Za-z0-9.]*\\)[ \t\n\r,>]" nil t)
23f87bed
MB
2631 (let (ace unicode)
2632 (when (save-match-data
2633 (and (setq ace (match-string 1))
2634 (save-excursion
2635 (and (re-search-backward "^[^ \t]" nil t)
53cfefc8 2636 (looking-at "From\\|To\\|Cc\\|Reply-To\\|Mail-Reply-To\\|Mail-Followup-To")))
23f87bed
MB
2637 (setq unicode (idna-to-unicode ace))))
2638 (unless (string= ace unicode)
2639 (replace-match unicode nil nil nil 1)))))))))
2640
2641(defun article-de-quoted-unreadable (&optional force read-charset)
16409b0b 2642 "Translate a quoted-printable-encoded article.
eec82323 2643If FORCE, decode the article whether it is marked as quoted-printable
23f87bed
MB
2644or not.
2645If READ-CHARSET, ask for a coding system."
2646 (interactive (list 'force current-prefix-arg))
eec82323 2647 (save-excursion
4e7d0221 2648 (let ((inhibit-read-only t) type charset)
8b93df01
DL
2649 (if (gnus-buffer-live-p gnus-original-article-buffer)
2650 (with-current-buffer gnus-original-article-buffer
2651 (setq type
2652 (gnus-fetch-field "content-transfer-encoding"))
2653 (let* ((ct (gnus-fetch-field "content-type"))
c96ec15a 2654 (ctl (and ct (mail-header-parse-content-type ct))))
8b93df01
DL
2655 (setq charset (and ctl
2656 (mail-content-type-get ctl 'charset)))
2657 (if (stringp charset)
2658 (setq charset (intern (downcase charset)))))))
23f87bed
MB
2659 (if read-charset
2660 (setq charset (mm-read-coding-system "Charset: " charset)))
a1506d29 2661 (unless charset
8b93df01 2662 (setq charset gnus-newsgroup-charset))
eec82323 2663 (when (or force
eb806ef3
DL
2664 (and type (let ((case-fold-search t))
2665 (string-match "quoted-printable" type))))
16409b0b 2666 (article-goto-body)
eb806ef3 2667 (quoted-printable-decode-region
07178229 2668 (point) (point-max) (mm-charset-to-coding-system charset nil t))))))
16409b0b 2669
23f87bed 2670(defun article-de-base64-unreadable (&optional force read-charset)
16409b0b 2671 "Translate a base64 article.
23f87bed
MB
2672If FORCE, decode the article whether it is marked as base64 not.
2673If READ-CHARSET, ask for a coding system."
2674 (interactive (list 'force current-prefix-arg))
16409b0b 2675 (save-excursion
4e7d0221 2676 (let ((inhibit-read-only t) type charset)
8b93df01
DL
2677 (if (gnus-buffer-live-p gnus-original-article-buffer)
2678 (with-current-buffer gnus-original-article-buffer
2679 (setq type
2680 (gnus-fetch-field "content-transfer-encoding"))
2681 (let* ((ct (gnus-fetch-field "content-type"))
c96ec15a 2682 (ctl (and ct (mail-header-parse-content-type ct))))
8b93df01
DL
2683 (setq charset (and ctl
2684 (mail-content-type-get ctl 'charset)))
2685 (if (stringp charset)
2686 (setq charset (intern (downcase charset)))))))
23f87bed
MB
2687 (if read-charset
2688 (setq charset (mm-read-coding-system "Charset: " charset)))
a1506d29 2689 (unless charset
8b93df01 2690 (setq charset gnus-newsgroup-charset))
16409b0b 2691 (when (or force
eb806ef3
DL
2692 (and type (let ((case-fold-search t))
2693 (string-match "base64" type))))
16409b0b
GM
2694 (article-goto-body)
2695 (save-restriction
2696 (narrow-to-region (point) (point-max))
2697 (base64-decode-region (point-min) (point-max))
eb806ef3 2698 (mm-decode-coding-region
07178229
KY
2699 (point-min) (point-max)
2700 (mm-charset-to-coding-system charset nil t)))))))
16409b0b
GM
2701
2702(eval-when-compile
2703 (require 'rfc1843))
2704
2705(defun article-decode-HZ ()
2706 "Translate a HZ-encoded article."
2707 (interactive)
2708 (require 'rfc1843)
2709 (save-excursion
4e7d0221 2710 (let ((inhibit-read-only t))
16409b0b
GM
2711 (rfc1843-decode-region (point-min) (point-max)))))
2712
23f87bed
MB
2713(defun article-unsplit-urls ()
2714 "Remove the newlines that some other mailers insert into URLs."
16409b0b 2715 (interactive)
23f87bed
MB
2716 (save-excursion
2717 (let ((inhibit-read-only t))
2718 (goto-char (point-min))
2719 (while (re-search-forward
97f78c9b 2720 "\\(\\(https?\\|ftp\\)://\\S-+\\) *\n\\(\\S-+\\)" nil t)
23f87bed 2721 (replace-match "\\1\\3" t)))
da946239 2722 (when (gmm-called-interactively-p 'any)
23f87bed
MB
2723 (gnus-treat-article nil))))
2724
2526f423
G
2725(defun article-wash-html ()
2726 "Format an HTML article."
2727 (interactive)
2728 (let ((handles nil)
2729 (buffer-read-only nil))
2730 (when (gnus-buffer-live-p gnus-original-article-buffer)
dc2ab667
LMI
2731 (with-current-buffer gnus-original-article-buffer
2732 (setq handles (mm-dissect-buffer t t))))
2526f423
G
2733 (article-goto-body)
2734 (delete-region (point) (point-max))
dc2ab667 2735 (mm-enable-multibyte)
2526f423 2736 (mm-inline-text-html handles)))
73043f7d 2737
01c52d31
MB
2738(defvar gnus-article-browse-html-temp-list nil
2739 "List of temporary files created by `gnus-article-browse-html-parts'.
2740Internal variable.")
2741
2742(defcustom gnus-article-browse-delete-temp 'ask
2743 "What to do with temporary files from `gnus-article-browse-html-parts'.
2744If nil, don't delete temporary files. If it is t, delete them on
2745exit from the summary buffer. If it is the symbol `file', query
2746on each file, if it is `ask' ask once when exiting from the
2747summary buffer."
2748 :group 'gnus-article
330f707b 2749 :version "23.1" ;; No Gnus
01c52d31
MB
2750 :type '(choice (const :tag "Don't delete" nil)
2751 (const :tag "Don't ask" t)
2752 (const :tag "Ask" ask)
2753 (const :tag "Ask for each file" file)))
2754
2755;; Cf. mm-postponed-undisplay-list / mm-destroy-postponed-undisplay-list.
2756
2757(defun gnus-article-browse-delete-temp-files (&optional how)
2758 "Delete temp-files created by `gnus-article-browse-html-parts'."
2759 (when (and gnus-article-browse-html-temp-list
3aeb9402
KY
2760 (progn
2761 (or how (setq how gnus-article-browse-delete-temp))
2762 (if (eq how 'ask)
5c11868c
KY
2763 (let ((files (length gnus-article-browse-html-temp-list)))
2764 (or (gnus-y-or-n-p
2765 (if (= files 1)
2766 "Delete the temporary HTML file? "
2767 (format "Delete all %s temporary HTML files? "
2768 files)))
2eff54ba 2769 (setq gnus-article-browse-html-temp-list nil)))
3aeb9402 2770 how)))
01c52d31 2771 (dolist (file gnus-article-browse-html-temp-list)
3aeb9402
KY
2772 (cond ((file-directory-p file)
2773 (when (or (not (eq how 'file))
2774 (gnus-y-or-n-p
2775 (format
2776 "Delete temporary HTML file(s) in directory `%s'? "
2777 (file-name-as-directory file))))
2778 (gnus-delete-directory file)))
2779 ((file-exists-p file)
2780 (when (or (not (eq how 'file))
2781 (gnus-y-or-n-p
2782 (format "Delete temporary HTML file `%s'? " file)))
2783 (delete-file file)))))
01c52d31
MB
2784 ;; Also remove file from the list when not deleted or if file doesn't
2785 ;; exist anymore.
2786 (setq gnus-article-browse-html-temp-list nil))
2787 gnus-article-browse-html-temp-list)
2788
d40d713a
KY
2789(defun gnus-article-browse-html-save-cid-content (cid handles directory)
2790 "Find CID content in HANDLES and save it in a file in DIRECTORY.
2791Return file name."
20c0b2ce 2792 (save-match-data
d40d713a
KY
2793 (let (file type)
2794 (catch 'found
2795 (dolist (handle handles)
2796 (cond
2797 ((not (listp handle)))
0b575a33
KY
2798 ;; Exclude broken handles that `gnus-summary-enter-digest-group'
2799 ;; may create.
2800 ((not (or (bufferp (car handle)) (stringp (car handle)))))
d40d713a
KY
2801 ((equal (mm-handle-media-supertype handle) "multipart")
2802 (when (setq file (gnus-article-browse-html-save-cid-content
2803 cid handle directory))
2804 (throw 'found file)))
2805 ((equal (concat "<" cid ">") (mm-handle-id handle))
2806 (setq file
2807 (expand-file-name
0b575a33
KY
2808 (or (mm-handle-filename handle)
2809 (concat
2810 (make-temp-name "cid")
2811 (car (rassoc (car (mm-handle-type handle))
2812 mailcap-mime-extensions))))
2813 directory))
d40d713a
KY
2814 (mm-save-part-to-file handle file)
2815 (throw 'found file))))))))
20c0b2ce 2816
87035689 2817(defun gnus-article-browse-html-parts (list &optional header)
01c52d31 2818 "View all \"text/html\" parts from LIST.
87035689
MB
2819Recurse into multiparts. The optional HEADER that should be a decoded
2820message header will be added to the bodies of the \"text/html\" parts."
01c52d31 2821 ;; Internal function used by `gnus-article-browse-html-article'.
d40d713a 2822 (let (type file charset content cid-dir tmp-file showed)
01c52d31
MB
2823 ;; Find and show the html-parts.
2824 (dolist (handle list)
2825 ;; If HTML, show it:
bbbe940b
MB
2826 (cond ((not (listp handle)))
2827 ((or (equal (car (setq type (mm-handle-type handle))) "text/html")
2828 (and (equal (car type) "message/external-body")
87035689 2829 (or header
247c22e1 2830 (setq file (mm-handle-filename handle)))
bbbe940b
MB
2831 (or (mm-handle-cache handle)
2832 (condition-case code
2833 (progn (mm-extern-cache-contents handle) t)
2834 (error
2835 (gnus-message 3 "%s" (error-message-string code))
2836 (when (>= gnus-verbose 3) (sit-for 2))
2837 nil)))
2838 (progn
2839 (setq handle (mm-handle-cache handle)
2840 type (mm-handle-type handle))
2841 (equal (car type) "text/html"))))
d40d713a
KY
2842 (setq charset (mail-content-type-get type 'charset)
2843 content (mm-get-part handle))
2844 (with-temp-buffer
2845 (if (eq charset 'gnus-decoded)
2846 (mm-enable-multibyte)
2847 (mm-disable-multibyte))
2848 (insert content)
2849 ;; resolve cid contents
2850 (let ((case-fold-search t)
2851 cid-file)
2852 (goto-char (point-min))
2853 (while (re-search-forward "\
2854<img[\t\n ]+\\(?:[^\t\n >]+[\t\n ]+\\)*src=\"\\(cid:\\([^\"]+\\)\\)\""
2855 nil t)
2856 (unless cid-dir
765d4319 2857 (setq cid-dir (mm-make-temp-file "cid" t))
d40d713a
KY
2858 (add-to-list 'gnus-article-browse-html-temp-list cid-dir))
2859 (setq file nil
2860 content nil)
2861 (when (setq cid-file
2862 (gnus-article-browse-html-save-cid-content
2863 (match-string 2)
2864 (with-current-buffer gnus-article-buffer
2865 gnus-article-mime-handles)
2866 cid-dir))
df103ffb 2867 (when (eq system-type 'cygwin)
dfdbf7af
KY
2868 (setq cid-file
2869 (concat "/" (substring
2870 (with-output-to-string
2871 (call-process "cygpath" nil
2872 standard-output
2873 nil "-m" cid-file))
2874 0 -1))))
d40d713a
KY
2875 (replace-match (concat "file://" cid-file)
2876 nil nil nil 1))))
2877 (unless content (setq content (buffer-string))))
2878 (when (or charset header (not file))
bbbe940b
MB
2879 (setq tmp-file (mm-make-temp-file
2880 ;; Do we need to care for 8.3 filenames?
2881 "mm-" nil ".html")))
87035689
MB
2882 ;; Add a meta html tag to specify charset and a header.
2883 (cond
2884 (header
c01f0213 2885 (let (title eheader body hcharset coding)
87035689
MB
2886 (with-temp-buffer
2887 (mm-enable-multibyte)
2888 (setq case-fold-search t)
2889 (insert header "\n")
2890 (setq title (message-fetch-field "subject"))
2891 (goto-char (point-min))
5ea1a8d1
KY
2892 (while (re-search-forward "\\(<\\)\\|\\(>\\)\\|\\(&\\)\\|\n"
2893 nil t)
87035689
MB
2894 (replace-match (cond ((match-beginning 1) "&lt;")
2895 ((match-beginning 2) "&gt;")
5ea1a8d1
KY
2896 ((match-beginning 3) "&amp;")
2897 (t "<br>\n"))))
87035689 2898 (goto-char (point-min))
4cbac8e9
KY
2899 (while (re-search-forward "^[\t ]+" nil t)
2900 (dotimes (i (prog1
2901 (current-column)
2902 (delete-region (match-beginning 0)
2903 (match-end 0))))
2904 (insert "&nbsp;")))
2905 (goto-char (point-min))
5ea1a8d1 2906 (insert "<div align=\"left\">\n")
87035689 2907 (goto-char (point-max))
5ea1a8d1 2908 (insert "</div>\n<hr>\n")
87035689
MB
2909 ;; We have to examine charset one by one since
2910 ;; charset specified in parts might be different.
2911 (if (eq charset 'gnus-decoded)
2912 (setq charset 'utf-8
2913 eheader (mm-encode-coding-string (buffer-string)
2914 charset)
2915 title (when title
2916 (mm-encode-coding-string title charset))
c01f0213 2917 body (mm-encode-coding-string content charset))
87035689
MB
2918 (setq hcharset (mm-find-mime-charset-region (point-min)
2919 (point-max)))
2920 (cond ((= (length hcharset) 1)
2921 (setq hcharset (car hcharset)
2922 coding (mm-charset-to-coding-system
0b575a33 2923 hcharset nil t)))
87035689
MB
2924 ((> (length hcharset) 1)
2925 (setq hcharset 'utf-8
2926 coding hcharset)))
2927 (if coding
2928 (if charset
2929 (progn
2930 (setq body
0b575a33
KY
2931 (mm-charset-to-coding-system charset
2932 nil t))
87035689
MB
2933 (if (eq coding body)
2934 (setq eheader (mm-encode-coding-string
2935 (buffer-string) coding)
2936 title (when title
2937 (mm-encode-coding-string
2938 title coding))
d40d713a 2939 body content)
87035689
MB
2940 (setq charset 'utf-8
2941 eheader (mm-encode-coding-string
2942 (buffer-string) charset)
2943 title (when title
2944 (mm-encode-coding-string
2945 title charset))
2946 body (mm-encode-coding-string
2947 (mm-decode-coding-string
d40d713a 2948 content body)
c01f0213 2949 charset))))
87035689
MB
2950 (setq charset hcharset
2951 eheader (mm-encode-coding-string
2952 (buffer-string) coding)
2953 title (when title
2954 (mm-encode-coding-string
2955 title coding))
d40d713a 2956 body content))
87035689 2957 (setq eheader (mm-string-as-unibyte (buffer-string))
d40d713a 2958 body content)))
87035689
MB
2959 (erase-buffer)
2960 (mm-disable-multibyte)
2961 (insert body)
2962 (when charset
c01f0213 2963 (mm-add-meta-html-tag handle charset t))
87035689
MB
2964 (when title
2965 (goto-char (point-min))
2966 (unless (search-forward "<title>" nil t)
2967 (re-search-forward "<head>\\s-*" nil t)
2968 (insert "<title>" title "</title>\n")))
2969 (goto-char (point-min))
2970 (or (re-search-forward
2971 "<body\\(?:\\s-+[^>]+\\|\\s-*\\)>\\s-*" nil t)
2972 (re-search-forward
2973 "</head\\(?:\\s-+[^>]+\\|\\s-*\\)>\\s-*" nil t))
2974 (insert eheader)
2975 (mm-write-region (point-min) (point-max)
2976 tmp-file nil nil nil 'binary t))))
2977 (charset
2978 (mm-with-unibyte-buffer
2979 (insert (if (eq charset 'gnus-decoded)
d40d713a
KY
2980 (mm-encode-coding-string content
2981 (setq charset 'utf-8))
2982 content))
87035689
MB
2983 (if (or (mm-add-meta-html-tag handle charset)
2984 (not file))
2985 (mm-write-region (point-min) (point-max)
2986 tmp-file nil nil nil 'binary t)
2987 (setq tmp-file nil))))
2988 (tmp-file
2989 (mm-save-part-to-file handle tmp-file)))
bbbe940b
MB
2990 (when tmp-file
2991 (add-to-list 'gnus-article-browse-html-temp-list tmp-file))
2992 (add-hook 'gnus-summary-prepare-exit-hook
2993 'gnus-article-browse-delete-temp-files)
2994 (add-hook 'gnus-exit-gnus-hook
2995 (lambda ()
2996 (gnus-article-browse-delete-temp-files t)))
2997 ;; FIXME: Warn if there's an <img> tag?
2998 (browse-url-of-file (or tmp-file (expand-file-name file)))
2999 (setq showed t))
3000 ;; If multipart, recurse
87035689
MB
3001 ((equal (mm-handle-media-supertype handle) "multipart")
3002 (when (gnus-article-browse-html-parts handle header)
3003 (setq showed t)))
3004 ((equal (mm-handle-media-type handle) "message/rfc822")
3005 (mm-with-multibyte-buffer
3006 (mm-insert-part handle)
3007 (setq handle (mm-dissect-buffer t t))
3008 (when (and (bufferp (car handle))
3009 (stringp (car (mm-handle-type handle))))
3010 (setq handle (list handle)))
3011 (when header
3012 (article-decode-encoded-words)
3013 (let ((gnus-visible-headers
3014 (or (get 'gnus-visible-headers 'standard-value)
3015 gnus-visible-headers)))
3016 (article-hide-headers))
3017 (goto-char (point-min))
3018 (search-forward "\n\n" nil 'move)
3019 (skip-chars-backward "\t\n ")
3020 (setq header (buffer-substring (point-min) (point)))))
3021 (when (prog1
3022 (gnus-article-browse-html-parts handle header)
3023 (mm-destroy-parts handle))
3024 (setq showed t)))))
01c52d31
MB
3025 showed))
3026
87035689 3027(defun gnus-article-browse-html-article (&optional arg)
01c52d31 3028 "View \"text/html\" parts of the current article with a WWW browser.
d40d713a
KY
3029Inline images embedded in a message using the cid scheme, as they are
3030generally considered to be safe, will be processed properly.
87035689
MB
3031The message header is added to the beginning of every html part unless
3032the prefix argument ARG is given.
01c52d31 3033
d40d713a
KY
3034Warning: Spammers use links to images (using the http scheme) in HTML
3035articles to verify whether you have read the message. As
9b3ebcb6
MB
3036`gnus-article-browse-html-article' passes the HTML content to the
3037browser without eliminating these \"web bugs\" you should only
3038use it for mails from trusted senders.
b890d447 3039
9b3ebcb6 3040If you always want to display HTML parts in the browser, set
d40d713a
KY
3041`mm-text-html-renderer' to nil.
3042
3043This command creates temporary files to pass HTML contents including
3044images if any to the browser, and deletes them when exiting the group
3045\(if you want)."
01c52d31 3046 ;; Cf. `mm-w3m-safe-url-regexp'
87035689
MB
3047 (interactive "P")
3048 (if arg
3049 (gnus-summary-show-article)
3050 (let ((gnus-visible-headers (or (get 'gnus-visible-headers 'standard-value)
9b3ebcb6
MB
3051 gnus-visible-headers))
3052 ;; As we insert a <hr>, there's no need for the body boundary.
3053 (gnus-treat-body-boundary nil))
87035689
MB
3054 (gnus-summary-show-article)))
3055 (with-current-buffer gnus-article-buffer
3056 (let ((header (unless arg
3057 (save-restriction
3058 (widen)
3059 (buffer-substring-no-properties
3060 (goto-char (point-min))
3061 (if (search-forward "\n\n" nil t)
3062 (match-beginning 0)
3063 (goto-char (point-max))
3064 (skip-chars-backward "\t\n ")
3065 (point))))))
3066 parts)
3067 (set-buffer gnus-original-article-buffer)
3068 (setq parts (mm-dissect-buffer t t))
01c52d31
MB
3069 ;; If singlepart, enforce a list.
3070 (when (and (bufferp (car parts))
3071 (stringp (car (mm-handle-type parts))))
3072 (setq parts (list parts)))
3073 ;; Process the list
87035689 3074 (unless (gnus-article-browse-html-parts parts header)
01c52d31 3075 (gnus-error 3 "Mail doesn't contain a \"text/html\" part!"))
87035689
MB
3076 (mm-destroy-parts parts)
3077 (unless arg
3078 (gnus-summary-show-article)))))
01c52d31 3079
16409b0b
GM
3080(defun article-hide-list-identifiers ()
3081 "Remove list identifies from the Subject header.
3082The `gnus-list-identifiers' variable specifies what to do."
3083 (interactive)
23f87bed 3084 (let ((inhibit-point-motion-hooks t)
d6cd56f1 3085 (regexp (gnus-group-get-list-identifiers gnus-newsgroup-name))
fb9b91be 3086 (inhibit-read-only t))
23f87bed
MB
3087 (when regexp
3088 (save-excursion
3089 (save-restriction
3090 (article-narrow-to-head)
3091 (goto-char (point-min))
3092 (while (re-search-forward
3093 (concat "^Subject: +\\(R[Ee]: +\\)*\\(" regexp " *\\)")
3094 nil t)
3095 (delete-region (match-beginning 2) (match-end 0))
3096 (beginning-of-line))
3097 (when (re-search-forward
3098 "^Subject: +\\(\\(R[Ee]: +\\)+\\)R[Ee]: +" nil t)
3099 (delete-region (match-beginning 1) (match-end 1))))))))
eec82323
LMI
3100
3101(defun article-hide-pem (&optional arg)
3102 "Toggle hiding of any PEM headers and signatures in the current article.
3103If given a negative prefix, always show; if given a positive prefix,
3104always hide."
3105 (interactive (gnus-article-hidden-arg))
3106 (unless (gnus-article-check-hidden-text 'pem arg)
3107 (save-excursion
23f87bed 3108 (let ((inhibit-read-only t) end)
eec82323 3109 (goto-char (point-min))
16409b0b
GM
3110 ;; Hide the horrendously ugly "header".
3111 (when (and (search-forward
3112 "\n-----BEGIN PRIVACY-ENHANCED MESSAGE-----\n"
3113 nil t)
3114 (setq end (1+ (match-beginning 0))))
23f87bed 3115 (gnus-add-wash-type 'pem)
16409b0b
GM
3116 (gnus-article-hide-text-type
3117 end
3118 (if (search-forward "\n\n" nil t)
3119 (match-end 0)
3120 (point-max))
3121 'pem)
3122 ;; Hide the trailer as well
3123 (when (search-forward "\n-----END PRIVACY-ENHANCED MESSAGE-----\n"
3124 nil t)
3125 (gnus-article-hide-text-type
3126 (match-beginning 0) (match-end 0) 'pem)))))))
3127
3128(defun article-strip-banner ()
23f87bed
MB
3129 "Strip the banners specified by the `banner' group parameter and by
3130`gnus-article-address-banner-alist'."
16409b0b 3131 (interactive)
23f87bed
MB
3132 (save-excursion
3133 (save-restriction
3134 (let ((inhibit-point-motion-hooks t))
3135 (when (gnus-parameter-banner gnus-newsgroup-name)
3136 (article-really-strip-banner
3137 (gnus-parameter-banner gnus-newsgroup-name)))
3138 (when gnus-article-address-banner-alist
cf5a5c38
MB
3139 ;; Note that the From header is decoded here, so it is
3140 ;; required that the *-extract-address-components function
3141 ;; supports non-ASCII text.
d71c0855
MB
3142 (let ((from (save-restriction
3143 (widen)
3144 (article-narrow-to-head)
3145 (mail-fetch-field "from"))))
3146 (when (and from
3147 (setq from
3148 (cadr (funcall gnus-extract-address-components
3149 from))))
3150 (catch 'found
3151 (dolist (pair gnus-article-address-banner-alist)
3152 (when (string-match (car pair) from)
3153 (throw 'found
3154 (article-really-strip-banner (cdr pair)))))))))))))
23f87bed
MB
3155
3156(defun article-really-strip-banner (banner)
3157 "Strip the banner specified by the argument."
16409b0b
GM
3158 (save-excursion
3159 (save-restriction
3160 (let ((inhibit-point-motion-hooks t)
16409b0b 3161 (gnus-signature-limit nil)
23f87bed
MB
3162 (inhibit-read-only t))
3163 (article-goto-body)
3164 (cond
3165 ((eq banner 'signature)
3166 (when (gnus-article-narrow-to-signature)
3167 (widen)
3168 (forward-line -1)
3169 (delete-region (point) (point-max))))
3170 ((symbolp banner)
3171 (if (setq banner (cdr (assq banner gnus-article-banner-alist)))
3172 (while (re-search-forward banner nil t)
3173 (delete-region (match-beginning 0) (match-end 0)))))
3174 ((stringp banner)
3175 (while (re-search-forward banner nil t)
3176 (delete-region (match-beginning 0) (match-end 0)))))))))
16409b0b
GM
3177
3178(defun article-babel ()
3179 "Translate article using an online translation service."
3180 (interactive)
3181 (require 'babel)
01c52d31 3182 (gnus-with-article-buffer
16409b0b 3183 (when (article-goto-body)
01c52d31 3184 (let* ((start (point))
16409b0b
GM
3185 (end (point-max))
3186 (orig (buffer-substring start end))
23f87bed 3187 (trans (babel-as-string orig)))
16409b0b
GM
3188 (save-restriction
3189 (narrow-to-region start end)
3190 (delete-region start end)
23f87bed 3191 (insert trans))))))
eec82323
LMI
3192
3193(defun article-hide-signature (&optional arg)
3194 "Hide the signature in the current article.
3195If given a negative prefix, always show; if given a positive prefix,
3196always hide."
3197 (interactive (gnus-article-hidden-arg))
3198 (unless (gnus-article-check-hidden-text 'signature arg)
3199 (save-excursion
3200 (save-restriction
4e7d0221 3201 (let ((inhibit-read-only t))
eec82323
LMI
3202 (when (gnus-article-narrow-to-signature)
3203 (gnus-article-hide-text-type
23f87bed
MB
3204 (point-min) (point-max) 'signature))))))
3205 (gnus-set-mode-line 'article))
eec82323 3206
16409b0b
GM
3207(defun article-strip-headers-in-body ()
3208 "Strip offensive headers from bodies."
3209 (interactive)
3210 (save-excursion
3211 (article-goto-body)
3212 (let ((case-fold-search t))
3213 (when (looking-at "x-no-archive:")
3214 (gnus-delete-line)))))
3215
eec82323
LMI
3216(defun article-strip-leading-blank-lines ()
3217 "Remove all blank lines from the beginning of the article."
3218 (interactive)
3219 (save-excursion
3220 (let ((inhibit-point-motion-hooks t)
23f87bed 3221 (inhibit-read-only t))
16409b0b 3222 (when (article-goto-body)
eec82323
LMI
3223 (while (and (not (eobp))
3224 (looking-at "[ \t]*$"))
3225 (gnus-delete-line))))))
3226
16409b0b
GM
3227(defun article-narrow-to-head ()
3228 "Narrow the buffer to the head of the message.
3229Point is left at the beginning of the narrowed-to region."
3230 (narrow-to-region
3231 (goto-char (point-min))
e7719ea1
G
3232 (cond
3233 ;; Absolutely no headers displayed.
3234 ((looking-at "\n")
3235 (point))
3236 ;; Normal headers.
3237 ((search-forward "\n\n" nil 1)
3238 (1- (point)))
3239 ;; Nothing but headers.
3240 (t
3241 (point-max))))
16409b0b
GM
3242 (goto-char (point-min)))
3243
3244(defun article-goto-body ()
3245 "Place point at the start of the body."
3246 (goto-char (point-min))
3247 (cond
3248 ;; This variable is only bound when dealing with separate
3249 ;; MIME body parts.
3250 (article-goto-body-goes-to-point-min-p
3251 t)
3252 ((search-forward "\n\n" nil t)
3253 t)
3254 (t
3255 (goto-char (point-max))
3256 nil)))
3257
eec82323
LMI
3258(defun article-strip-multiple-blank-lines ()
3259 "Replace consecutive blank lines with one empty line."
3260 (interactive)
3261 (save-excursion
3262 (let ((inhibit-point-motion-hooks t)
23f87bed 3263 (inhibit-read-only t))
eec82323 3264 ;; First make all blank lines empty.
16409b0b 3265 (article-goto-body)
eec82323 3266 (while (re-search-forward "^[ \t]+$" nil t)
16409b0b
GM
3267 (unless (gnus-annotation-in-region-p
3268 (match-beginning 0) (match-end 0))
3269 (replace-match "" nil t)))
eec82323 3270 ;; Then replace multiple empty lines with a single empty line.
16409b0b 3271 (article-goto-body)
23f87bed 3272 (while (re-search-forward "\n\n\\(\n+\\)" nil t)
16409b0b
GM
3273 (unless (gnus-annotation-in-region-p
3274 (match-beginning 0) (match-end 0))
23f87bed 3275 (delete-region (match-beginning 1) (match-end 1)))))))
eec82323
LMI
3276
3277(defun article-strip-leading-space ()
3278 "Remove all white space from the beginning of the lines in the article."
3279 (interactive)
3280 (save-excursion
3281 (let ((inhibit-point-motion-hooks t)
23f87bed 3282 (inhibit-read-only t))
16409b0b 3283 (article-goto-body)
eec82323
LMI
3284 (while (re-search-forward "^[ \t]+" nil t)
3285 (replace-match "" t t)))))
3286
16409b0b
GM
3287(defun article-strip-trailing-space ()
3288 "Remove all white space from the end of the lines in the article."
3289 (interactive)
3290 (save-excursion
3291 (let ((inhibit-point-motion-hooks t)
23f87bed 3292 (inhibit-read-only t))
16409b0b
GM
3293 (article-goto-body)
3294 (while (re-search-forward "[ \t]+$" nil t)
3295 (replace-match "" t t)))))
3296
eec82323
LMI
3297(defun article-strip-blank-lines ()
3298 "Strip leading, trailing and multiple blank lines."
3299 (interactive)
3300 (article-strip-leading-blank-lines)
3301 (article-remove-trailing-blank-lines)
3302 (article-strip-multiple-blank-lines))
3303
6748645f
LMI
3304(defun article-strip-all-blank-lines ()
3305 "Strip all blank lines."
3306 (interactive)
3307 (save-excursion
3308 (let ((inhibit-point-motion-hooks t)
23f87bed 3309 (inhibit-read-only t))
16409b0b 3310 (article-goto-body)
6748645f
LMI
3311 (while (re-search-forward "^[ \t]*\n" nil t)
3312 (replace-match "" t t)))))
3313
eec82323
LMI
3314(defun gnus-article-narrow-to-signature ()
3315 "Narrow to the signature; return t if a signature is found, else nil."
6748645f 3316 (let ((inhibit-point-motion-hooks t))
6748645f
LMI
3317 (when (gnus-article-search-signature)
3318 (forward-line 1)
3319 ;; Check whether we have some limits to what we consider
3320 ;; to be a signature.
3321 (let ((limits (if (listp gnus-signature-limit) gnus-signature-limit
3322 (list gnus-signature-limit)))
3323 limit limited)
3324 (while (setq limit (pop limits))
3325 (if (or (and (integerp limit)
3326 (< (- (point-max) (point)) limit))
3327 (and (floatp limit)
3328 (< (count-lines (point) (point-max)) limit))
23f87bed 3329 (and (functionp limit)
6748645f
LMI
3330 (funcall limit))
3331 (and (stringp limit)
3332 (not (re-search-forward limit nil t))))
3333 () ; This limit did not succeed.
3334 (setq limited t
3335 limits nil)))
3336 (unless limited
3337 (narrow-to-region (point) (point-max))
3338 t)))))
eec82323
LMI
3339
3340(defun gnus-article-search-signature ()
3341 "Search the current buffer for the signature separator.
3342Put point at the beginning of the signature separator."
3343 (let ((cur (point)))
3344 (goto-char (point-max))
3345 (if (if (stringp gnus-signature-separator)
3346 (re-search-backward gnus-signature-separator nil t)
3347 (let ((seps gnus-signature-separator))
3348 (while (and seps
3349 (not (re-search-backward (car seps) nil t)))
3350 (pop seps))
3351 seps))
3352 t
3353 (goto-char cur)
3354 nil)))
3355
eec82323
LMI
3356(defun gnus-article-hidden-arg ()
3357 "Return the current prefix arg as a number, or 0 if no prefix."
3358 (list (if current-prefix-arg
3359 (prefix-numeric-value current-prefix-arg)
3360 0)))
3361
3362(defun gnus-article-check-hidden-text (type arg)
3363 "Return nil if hiding is necessary.
f0529b5b 3364Arg can be nil or a number. nil and positive means hide, negative
eec82323
LMI
3365means show, 0 means toggle."
3366 (save-excursion
3367 (save-restriction
eec82323
LMI
3368 (let ((hide (gnus-article-hidden-text-p type)))
3369 (cond
3370 ((or (null arg)
3371 (> arg 0))
3372 nil)
3373 ((< arg 0)
4481aa98
SZ
3374 (gnus-article-show-hidden-text type)
3375 t)
eec82323
LMI
3376 (t
3377 (if (eq hide 'hidden)
4481aa98
SZ
3378 (progn
3379 (gnus-article-show-hidden-text type)
3380 t)
eec82323
LMI
3381 nil)))))))
3382
3383(defun gnus-article-hidden-text-p (type)
3384 "Say whether the current buffer contains hidden text of type TYPE."
6748645f 3385 (let ((pos (text-property-any (point-min) (point-max) 'article-type type)))
eec82323 3386 (while (and pos
16409b0b
GM
3387 (not (get-text-property pos 'invisible))
3388 (not (get-text-property pos 'dummy-invisible)))
eec82323
LMI
3389 (setq pos
3390 (text-property-any (1+ pos) (point-max) 'article-type type)))
3391 (if pos
3392 'hidden
16409b0b 3393 nil)))
eec82323 3394
520aa572 3395(defun gnus-article-show-hidden-text (type &optional dummy)
eec82323 3396 "Show all hidden text of type TYPE.
520aa572 3397Originally it is hide instead of DUMMY."
4e7d0221 3398 (let ((inhibit-read-only t)
520aa572 3399 (inhibit-point-motion-hooks t))
a1506d29 3400 (gnus-remove-text-properties-when
520aa572 3401 'article-type type
a1506d29 3402 (point-min) (point-max)
520aa572 3403 (cons 'article-type (cons type
23f87bed
MB
3404 gnus-hidden-properties)))
3405 (gnus-delete-wash-type type)))
eec82323
LMI
3406
3407(defconst article-time-units
3408 `((year . ,(* 365.25 24 60 60))
3409 (week . ,(* 7 24 60 60))
3410 (day . ,(* 24 60 60))
3411 (hour . ,(* 60 60))
3412 (minute . 60)
3413 (second . 1))
3414 "Mapping from time units to seconds.")
3415
23f87bed
MB
3416(defun gnus-article-forward-header ()
3417 "Move point to the start of the next header.
3418If the current header is a continuation header, this can be several
3419lines forward."
3420 (let ((ended nil))
3421 (while (not ended)
3422 (forward-line 1)
3423 (if (looking-at "[ \t]+[^ \t]")
3424 (forward-line 1)
3425 (setq ended t)))))
3426
12e3ca0a 3427(defun article-treat-date ()
f8342cf5
KY
3428 (article-date-ut (if (gnus-buffer-live-p gnus-summary-buffer)
3429 (with-current-buffer gnus-summary-buffer
3430 gnus-article-date-headers)
3431 gnus-article-date-headers)
3432 t))
12e3ca0a
LI
3433
3434(defun article-date-ut (&optional type highlight date-position)
3435 "Convert DATE date to TYPE in the current article.
3436The default type is `ut'. See `gnus-article-date-headers' for
3437possible values."
eec82323 3438 (interactive (list 'ut t))
12e3ca0a 3439 (let* ((case-fold-search t)
31640842 3440 (inhibit-read-only t)
eec82323 3441 (inhibit-point-motion-hooks t)
12e3ca0a 3442 (first t)
d5e9a4e9 3443 (visible-date (mail-fetch-field "Date"))
31640842 3444 pos date bface eface)
16409b0b 3445 (save-excursion
0861eb2e
KY
3446 (if date-position
3447 (progn
3448 (goto-char date-position)
3449 (setq date (get-text-property (point) 'original-date))
923c1bfc
KY
3450 (when (looking-at "[^:]+:[\t ]*")
3451 (setq bface (get-text-property (match-beginning 0) 'face)
3452 eface (get-text-property (match-end 0) 'face)))
0861eb2e
KY
3453 (delete-region (point)
3454 (progn
3455 (gnus-article-forward-header)
3456 (point)))
3457 (article-transform-date date type bface eface))
3458 (save-restriction
3459 (widen)
3460 (goto-char (point-min))
3461 (while (or (get-text-property (setq pos (point)) 'original-date)
3462 (and (setq pos (next-single-property-change
3463 (point) 'original-date))
3464 (goto-char pos)))
3465 (narrow-to-region pos (if (search-forward "\n\n" nil t)
3466 (1+ (match-beginning 0))
3467 (point-max)))
923c1bfc
KY
3468 (while (setq pos (text-property-not-all pos (point-max)
3469 'gnus-date-type nil))
3470 (setq date (get-text-property pos 'original-date))
3471 (goto-char pos)
3472 (when (looking-at "[^:]+:[\t ]*")
3473 (setq bface (get-text-property (match-beginning 0) 'face)
3474 eface (get-text-property (match-end 0) 'face)))
3475 (delete-region pos (or (text-property-any pos (point-max)
3476 'gnus-date-type nil)
3477 (point-max))))
3478 (unless date ;; the 1st time
3479 (goto-char (point-min))
3480 (while (re-search-forward "^Date:[\t ]*" nil t)
3481 (setq date (get-text-property (match-beginning 0)
3482 'original-date)
3483 bface (get-text-property (match-beginning 0) 'face)
3484 eface (get-text-property (match-end 0) 'face))
3485 (delete-region (point-at-bol) (progn
3486 (gnus-article-forward-header)
3487 (point)))))
0861eb2e
KY
3488 (when (and (not date)
3489 visible-date)
3490 (setq date visible-date))
3491 (when date
32a400d4 3492 (article-transform-date date type bface eface))
0861eb2e
KY
3493 (goto-char (point-max))
3494 (widen)))))))
32a400d4
LI
3495
3496(defun article-transform-date (date type bface eface)
3497 (dolist (this-type (cond
3498 ((null type)
3499 (list 'ut))
3500 ((atom type)
3501 (list type))
3502 (t
3503 type)))
923c1bfc
KY
3504 (goto-char
3505 (prog1
3506 (point)
3507 (add-text-properties
3508 (point)
3509 (progn
3510 (insert (article-make-date-line date (or this-type 'ut)) "\n")
3511 (point))
3512 (list 'original-date date 'gnus-date-type this-type))))
32a400d4 3513 ;; Do highlighting.
923c1bfc
KY
3514 (when (looking-at
3515 "\\([^:]+:\\)[\t ]*\\(\\(?:[^\t\n ]+[\t ]+\\)*[^\t\n ]+\\)?")
3516 (put-text-property (match-beginning 1) (match-end 1) 'face bface)
3517 (when (match-beginning 2)
3518 (put-text-property (match-beginning 2) (match-end 2) 'face eface))
3519 (while (and (zerop (forward-line 1))
3520 (looking-at "[\t ]+\\(\\(?:[^\t\n ]+[\t ]+\\)*[^\t\n ]+\\)?"))
3521 (when (match-beginning 1)
3522 (put-text-property (match-beginning 1) (match-end 1) 'face eface))))))
eec82323
LMI
3523
3524(defun article-make-date-line (date type)
3525 "Return a DATE line of TYPE."
5fe18311
KY
3526 (unless (memq type '(local ut original user-defined iso8601 lapsed english
3527 combined-lapsed))
23f87bed
MB
3528 (error "Unknown conversion type: %s" type))
3529 (condition-case ()
fa41748c 3530 (let ((time (ignore-errors (date-to-time date))))
16409b0b 3531 (cond
23f87bed
MB
3532 ;; Convert to the local timezone.
3533 ((eq type 'local)
01c52d31 3534 (concat "Date: " (message-make-date time)))
23f87bed
MB
3535 ;; Convert to Universal Time.
3536 ((eq type 'ut)
3537 (concat "Date: "
01c52d31
MB
3538 (substring
3539 (message-make-date
3540 (let* ((e (parse-time-string date))
3541 (tm (apply 'encode-time e))
3542 (ms (car tm))
3543 (ls (- (cadr tm) (car (current-time-zone time)))))
3544 (cond ((< ls 0) (list (1- ms) (+ ls 65536)))
3545 ((> ls 65535) (list (1+ ms) (- ls 65536)))
3546 (t (list ms ls)))))
3547 0 -5)
3548 "UT"))
23f87bed
MB
3549 ;; Get the original date from the article.
3550 ((eq type 'original)
3551 (concat "Date: " (if (string-match "\n+$" date)
3552 (substring date 0 (match-beginning 0))
3553 date)))
3554 ;; Let the user define the format.
c4753373 3555 ((eq type 'user-defined)
23f87bed
MB
3556 (let ((format (or (condition-case nil
3557 (with-current-buffer gnus-summary-buffer
3558 gnus-article-time-format)
3559 (error nil))
3560 gnus-article-time-format)))
3561 (if (functionp format)
3562 (funcall format time)
3563 (concat "Date: " (format-time-string format time)))))
3564 ;; ISO 8601.
3565 ((eq type 'iso8601)
3566 (let ((tz (car (current-time-zone time))))
3567 (concat
3568 "Date: "
3569 (format-time-string "%Y%m%dT%H%M%S" time)
3570 (format "%s%02d%02d"
3571 (if (> tz 0) "+" "-") (/ (abs tz) 3600)
3572 (/ (% (abs tz) 3600) 60)))))
12e3ca0a 3573 ;; Do a lapsed format.
23f87bed 3574 ((eq type 'lapsed)
12e3ca0a 3575 (concat "Date: " (article-lapsed-string time)))
647559c2
LI
3576 ;; A combined date/lapsed format.
3577 ((eq type 'combined-lapsed)
19cc6697
G
3578 (let ((date-string (article-make-date-line date 'original))
3579 (segments 3)
3580 lapsed-string)
3581 (while (and
fa41748c 3582 time
19cc6697
G
3583 (setq lapsed-string
3584 (concat " (" (article-lapsed-string time segments) ")"))
3585 (> (+ (length date-string)
3586 (length lapsed-string))
d6f13ac8 3587 (+ fill-column 6))
19cc6697
G
3588 (> segments 0))
3589 (setq segments (1- segments)))
3590 (if (> segments 0)
3591 (concat date-string lapsed-string)
3592 date-string)))
23f87bed
MB
3593 ;; Display the date in proper English
3594 ((eq type 'english)
3595 (let ((dtime (decode-time time)))
3596 (concat
3597 "Date: the "
3598 (number-to-string (nth 3 dtime))
3599 (let ((digit (% (nth 3 dtime) 10)))
3600 (cond
3601 ((memq (nth 3 dtime) '(11 12 13)) "th")
3602 ((= digit 1) "st")
3603 ((= digit 2) "nd")
3604 ((= digit 3) "rd")
3605 (t "th")))
3606 " of "
3607 (nth (1- (nth 4 dtime)) gnus-english-month-names)
3608 " "
3609 (number-to-string (nth 5 dtime))
3610 " at "
3611 (format "%02d" (nth 2 dtime))
3612 ":"
3613 (format "%02d" (nth 1 dtime)))))))
647559c2 3614 (foo
a601fb74 3615 (format "Date: %s (from Gnus)" date))))
eec82323 3616
647559c2
LI
3617(defun article-lapsed-string (time &optional max-segments)
3618 ;; If the date is seriously mangled, the timezone functions are
3619 ;; liable to bug out, so we ignore all errors.
3620 (let* ((now (current-time))
3621 (real-time (subtract-time now time))
3622 (real-sec (and real-time
3623 (+ (* (float (car real-time)) 65536)
3624 (cadr real-time))))
3625 (sec (and real-time (abs real-sec)))
3626 (segments 0)
3627 num prev)
3628 (unless max-segments
3629 (setq max-segments (length article-time-units)))
3630 (cond
3631 ((null real-time)
3632 "Unknown")
3633 ((zerop sec)
3634 "Now")
3635 (t
3636 (concat
3637 ;; This is a bit convoluted, but basically we go
3638 ;; through the time units for years, weeks, etc,
3639 ;; and divide things to see whether that results
3640 ;; in positive answers.
3641 (mapconcat
3642 (lambda (unit)
3643 (if (or (zerop (setq num (ffloor (/ sec (cdr unit)))))
3644 (>= segments max-segments))
3645 ;; The (remaining) seconds are too few to
3646 ;; be divided into this time unit.
3647 ""
3648 ;; It's big enough, so we output it.
3649 (setq sec (- sec (* num (cdr unit))))
3650 (prog1
3651 (concat (if prev ", " "") (int-to-string
3652 (floor num))
3653 " " (symbol-name (car unit))
3654 (if (> num 1) "s" ""))
3655 (setq prev t
3656 segments (1+ segments)))))
3657 article-time-units "")
3658 ;; If dates are odd, then it might appear like the
3659 ;; article was sent in the future.
3660 (if (> real-sec 0)
3661 " ago"
3662 " in the future"))))))
3663
eec82323
LMI
3664(defun article-date-local (&optional highlight)
3665 "Convert the current article date to the local timezone."
3666 (interactive (list t))
3667 (article-date-ut 'local highlight))
3668
23f87bed
MB
3669(defun article-date-english (&optional highlight)
3670 "Convert the current article date to something that is proper English."
3671 (interactive (list t))
3672 (article-date-ut 'english highlight))
3673
eec82323
LMI
3674(defun article-date-original (&optional highlight)
3675 "Convert the current article date to what it was originally.
3676This is only useful if you have used some other date conversion
3677function and want to see what the date was before converting."
3678 (interactive (list t))
3679 (article-date-ut 'original highlight))
3680
3681(defun article-date-lapsed (&optional highlight)
3682 "Convert the current article date to time lapsed since it was sent."
3683 (interactive (list t))
3684 (article-date-ut 'lapsed highlight))
3685
647559c2
LI
3686(defun article-date-combined-lapsed (&optional highlight)
3687 "Convert the current article date to time lapsed since it was sent."
3688 (interactive (list t))
3689 (article-date-ut 'combined-lapsed highlight))
3690
6748645f
LMI
3691(defun article-update-date-lapsed ()
3692 "Function to be run from a timer to update the lapsed time line."
e0a8aa09 3693 (save-match-data
0832490d
LI
3694 (let ((buffer (current-buffer)))
3695 (ignore-errors
3696 (walk-windows
3697 (lambda (w)
3698 (set-buffer (window-buffer w))
1b3b87df 3699 (when (derived-mode-p 'gnus-article-mode)
0832490d 3700 (let ((old-line (count-lines (point-min) (point)))
c61a8b44 3701 (old-column (- (point) (line-beginning-position)))
923c1bfc
KY
3702 (window-start (window-start w))
3703 (pos (point-min))
3704 type next end)
3705 (while (setq pos (text-property-not-all pos (point-max)
3706 'gnus-date-type nil))
3707 (setq next (or (next-single-property-change pos
3708 'gnus-date-type)
3709 (point-max)))
3710 (setq type (get-text-property pos 'gnus-date-type))
3711 (when (memq type '(lapsed combined-lapsed user-defined))
3712 (article-date-ut type t pos)
3713 (setq end (or (next-single-property-change pos
3714 'gnus-date-type)
3715 (point-max)))
3716 (when window-start
3717 (if (/= window-start next)
3718 (setq window-start nil)
3719 (set-window-start w end)))
3720 (setq next end))
3721 (setq pos next))
0832490d
LI
3722 (goto-char (point-min))
3723 (when (> old-column 0)
3724 (setq old-line (1- old-line)))
3725 (forward-line old-line)
3726 (end-of-line)
3727 (when (> (current-column) old-column)
3728 (beginning-of-line)
3729 (forward-char old-column)))))
3730 nil 'visible))
3731 (set-buffer buffer))))
6748645f
LMI
3732
3733(defun gnus-start-date-timer (&optional n)
12e3ca0a 3734 "Start a timer to update the Date headers in the article buffers.
6748645f
LMI
3735The numerical prefix says how frequently (in seconds) the function
3736is to run."
3737 (interactive "p")
3738 (unless n
3739 (setq n 1))
3740 (gnus-stop-date-timer)
3741 (setq article-lapsed-timer
01c52d31 3742 (run-at-time 1 n 'article-update-date-lapsed)))
6748645f
LMI
3743
3744(defun gnus-stop-date-timer ()
12e3ca0a 3745 "Stop the Date timer."
6748645f
LMI
3746 (interactive)
3747 (when article-lapsed-timer
3748 (nnheader-cancel-timer article-lapsed-timer)
3749 (setq article-lapsed-timer nil)))
3750
eec82323
LMI
3751(defun article-date-user (&optional highlight)
3752 "Convert the current article date to the user-defined format.
3753This format is defined by the `gnus-article-time-format' variable."
3754 (interactive (list t))
3755 (article-date-ut 'user highlight))
3756
6748645f
LMI
3757(defun article-date-iso8601 (&optional highlight)
3758 "Convert the current article date to ISO8601."
3759 (interactive (list t))
3760 (article-date-ut 'iso8601 highlight))
3761
31640842
MB
3762(defmacro gnus-article-save-original-date (&rest forms)
3763 "Save the original date as a text property and evaluate FORMS."
3764 `(let* ((case-fold-search t)
3765 (start (progn
3766 (goto-char (point-min))
3767 (when (and (re-search-forward "^date:[\t\n ]+" nil t)
3768 (not (bolp)))
3769 (match-end 0))))
3770 (date (when (and start
01c52d31 3771 (re-search-forward "[\t ]*\n\\(?:[^\t ]\\|\\'\\)"
31640842
MB
3772 nil t))
3773 (buffer-substring-no-properties start
3774 (match-beginning 0)))))
3775 (goto-char (point-max))
3776 (skip-chars-backward "\n")
3777 (put-text-property (point-min) (point) 'original-date date)
3778 ,@forms
3779 (goto-char (point-max))
3780 (skip-chars-backward "\n")
3781 (put-text-property (point-min) (point) 'original-date date)))
3782
23f87bed
MB
3783;; (defun article-show-all ()
3784;; "Show all hidden text in the article buffer."
3785;; (interactive)
3786;; (save-excursion
3787;; (let ((inhibit-read-only t))
3788;; (gnus-article-unhide-text (point-min) (point-max)))))
3789
3790(defun article-remove-leading-whitespace ()
3791 "Remove excessive whitespace from all headers."
eec82323
LMI
3792 (interactive)
3793 (save-excursion
23f87bed
MB
3794 (save-restriction
3795 (let ((inhibit-read-only t))
3796 (article-narrow-to-head)
3797 (goto-char (point-min))
3798 (while (re-search-forward "^[^ :]+: \\([ \t]+\\)" nil t)
3799 (delete-region (match-beginning 1) (match-end 1)))))))
eec82323
LMI
3800
3801(defun article-emphasize (&optional arg)
3802 "Emphasize text according to `gnus-emphasis-alist'."
3803 (interactive (gnus-article-hidden-arg))
3804 (unless (gnus-article-check-hidden-text 'emphasis arg)
3805 (save-excursion
a1506d29 3806 (let ((alist (or
16409b0b 3807 (condition-case nil
a1506d29
JB
3808 (with-current-buffer gnus-summary-buffer
3809 gnus-article-emphasis-alist)
16409b0b
GM
3810 (error))
3811 gnus-emphasis-alist))
4e7d0221 3812 (inhibit-read-only t)
eec82323
LMI
3813 (props (append '(article-type emphasis)
3814 gnus-hidden-properties))
3815 regexp elem beg invisible visible face)
16409b0b 3816 (article-goto-body)
eec82323
LMI
3817 (setq beg (point))
3818 (while (setq elem (pop alist))
3819 (goto-char beg)
3820 (setq regexp (car elem)
3821 invisible (nth 1 elem)
3822 visible (nth 2 elem)
3823 face (nth 3 elem))
3824 (while (re-search-forward regexp nil t)
23f87bed
MB
3825 (when (and (match-beginning visible) (match-beginning invisible))
3826 (gnus-article-hide-text
3827 (match-beginning invisible) (match-end invisible) props)
3828 (gnus-article-unhide-text-type
3829 (match-beginning visible) (match-end visible) 'emphasis)
3830 (gnus-put-overlay-excluding-newlines
3831 (match-beginning visible) (match-end visible) 'face face)
3832 (gnus-add-wash-type 'emphasis)
3833 (goto-char (match-end invisible)))))))))
eec82323 3834
16409b0b
GM
3835(defun gnus-article-setup-highlight-words (&optional highlight-words)
3836 "Setup newsgroup emphasis alist."
3837 (unless gnus-article-emphasis-alist
3838 (let ((name (and gnus-newsgroup-name
3839 (gnus-group-real-name gnus-newsgroup-name))))
3840 (make-local-variable 'gnus-article-emphasis-alist)
a1506d29
JB
3841 (setq gnus-article-emphasis-alist
3842 (nconc
16409b0b
GM
3843 (let ((alist gnus-group-highlight-words-alist) elem highlight)
3844 (while (setq elem (pop alist))
3845 (when (and name (string-match (car elem) name))
3846 (setq alist nil
3847 highlight (copy-sequence (cdr elem)))))
3848 highlight)
3849 (copy-sequence highlight-words)
3850 (if gnus-newsgroup-name
a1506d29 3851 (copy-sequence (gnus-group-find-parameter
16409b0b
GM
3852 gnus-newsgroup-name 'highlight-words t)))
3853 gnus-emphasis-alist)))))
3854
9efa445f
DN
3855(defvar gnus-summary-article-menu)
3856(defvar gnus-summary-post-menu)
eec82323
LMI
3857
3858;;; Saving functions.
3859
3860(defun gnus-article-save (save-buffer file &optional num)
3861 "Save the currently selected article."
26c9afc3
MB
3862 (when (or (get gnus-default-article-saver :headers)
3863 (not gnus-save-all-headers))
3864 ;; Remove headers according to `gnus-saved-headers' or the value
3865 ;; of the `:headers' property that the saver function might have.
eec82323 3866 (let ((gnus-visible-headers
26c9afc3
MB
3867 (or (symbol-value (get gnus-default-article-saver :headers))
3868 gnus-saved-headers gnus-visible-headers))
16c85f26
MB
3869 ;; Ignore group parameter. See `article-hide-headers'.
3870 (gnus-summary-buffer nil))
80de1778 3871 (with-current-buffer save-buffer
6748645f 3872 (article-hide-headers 1 t))))
eec82323
LMI
3873 (save-window-excursion
3874 (if (not gnus-default-article-saver)
a8151ef7 3875 (error "No default saver is defined")
eec82323 3876 ;; !!! Magic! The saving functions all save
16409b0b 3877 ;; `gnus-save-article-buffer' (or so they think), but we
eec82323
LMI
3878 ;; bind that variable to our save-buffer.
3879 (set-buffer gnus-article-buffer)
3880 (let* ((gnus-save-article-buffer save-buffer)
3881 (filename
3882 (cond
3883 ((not gnus-prompt-before-saving) 'default)
3884 ((eq gnus-prompt-before-saving 'always) nil)
3885 (t file)))
3886 (gnus-number-of-articles-to-be-saved
3887 (when (eq gnus-prompt-before-saving t)
3888 num))) ; Magic
6748645f 3889 (set-buffer gnus-article-current-summary)
eec82323
LMI
3890 (funcall gnus-default-article-saver filename)))))
3891
3892(defun gnus-read-save-file-name (prompt &optional filename
26c9afc3
MB
3893 function group headers variable
3894 dir-var)
eec82323
LMI
3895 (let ((default-name
3896 (funcall function group headers (symbol-value variable)))
3897 result)
4325195c 3898 (setq result
a1506d29 3899 (expand-file-name
4325195c
DL
3900 (cond
3901 ((eq filename 'default)
3902 default-name)
3903 ((eq filename t)
3904 default-name)
3905 (filename filename)
3906 (t
26c9afc3
MB
3907 (when (symbol-value dir-var)
3908 (setq default-name (expand-file-name
3909 (file-name-nondirectory default-name)
3910 (symbol-value dir-var))))
4325195c
DL
3911 (let* ((split-name (gnus-get-split-value gnus-split-methods))
3912 (prompt
3913 (format prompt
3914 (if (and gnus-number-of-articles-to-be-saved
3915 (> gnus-number-of-articles-to-be-saved 1))
3916 (format "these %d articles"
3917 gnus-number-of-articles-to-be-saved)
3918 "this article")))
3919 (file
3920 ;; Let the split methods have their say.
3921 (cond
3922 ;; No split name was found.
3923 ((null split-name)
3924 (read-file-name
3925 (concat prompt " (default "
81df110a 3926 (file-name-nondirectory default-name) "): ")
4325195c
DL
3927 (file-name-directory default-name)
3928 default-name))
3929 ;; A single group name is returned.
3930 ((stringp split-name)
3931 (setq default-name
3932 (funcall function split-name headers
3933 (symbol-value variable)))
3934 (read-file-name
3935 (concat prompt " (default "
81df110a 3936 (file-name-nondirectory default-name) "): ")
4325195c
DL
3937 (file-name-directory default-name)
3938 default-name))
3939 ;; A single split name was found
3940 ((= 1 (length split-name))
3941 (let* ((name (expand-file-name
23f87bed
MB
3942 (car split-name)
3943 gnus-article-save-directory))
4325195c
DL
3944 (dir (cond ((file-directory-p name)
3945 (file-name-as-directory name))
3946 ((file-exists-p name) name)
3947 (t gnus-article-save-directory))))
3948 (read-file-name
81df110a 3949 (concat prompt " (default " name "): ")
4325195c
DL
3950 dir name)))
3951 ;; A list of splits was found.
3952 (t
3953 (setq split-name (nreverse split-name))
3954 (let (result)
3955 (let ((file-name-history
3956 (nconc split-name file-name-history)))
3957 (setq result
3958 (expand-file-name
3959 (read-file-name
81df110a 3960 (concat prompt " (`M-p' for defaults): ")
4325195c
DL
3961 gnus-article-save-directory
3962 (car split-name))
3963 gnus-article-save-directory)))
3964 (car (push result file-name-history)))))))
3965 ;; Create the directory.
3966 (gnus-make-directory (file-name-directory file))
23f87bed 3967 ;; If we have read a directory, we append the default file name.
4325195c 3968 (when (file-directory-p file)
23f87bed
MB
3969 (setq file (expand-file-name (file-name-nondirectory
3970 default-name)
4325195c
DL
3971 (file-name-as-directory file))))
3972 ;; Possibly translate some characters.
3973 (nnheader-translate-file-chars file))))))
eec82323 3974 (gnus-make-directory (file-name-directory result))
26c9afc3
MB
3975 (when variable
3976 (set variable result))
3977 (when dir-var
3978 (set dir-var (file-name-directory result)))
3979 result))
eec82323
LMI
3980
3981(defun gnus-article-archive-name (group)
3982 "Return the first instance of an \"Archive-name\" in the current buffer."
3983 (let ((case-fold-search t))
3984 (when (re-search-forward "archive-name: *\\([^ \n\t]+\\)[ \t]*$" nil t)
3985 (nnheader-concat gnus-article-save-directory
3986 (match-string 1)))))
3987
3988(defun gnus-article-nndoc-name (group)
3989 "If GROUP is an nndoc group, return the name of the parent group."
3990 (when (eq (car (gnus-find-method-for-group group)) 'nndoc)
3991 (gnus-group-get-parameter group 'save-article-group)))
3992
3993(defun gnus-summary-save-in-rmail (&optional filename)
3994 "Append this article to Rmail file.
3995Optional argument FILENAME specifies file name.
3996Directory to save to is default to `gnus-article-save-directory'."
eec82323 3997 (setq filename (gnus-read-save-file-name
81df110a 3998 "Save %s in rmail file" filename
eec82323
LMI
3999 gnus-rmail-save-name gnus-newsgroup-name
4000 gnus-current-headers 'gnus-newsgroup-last-rmail))
a3f57c41 4001 (with-current-buffer gnus-save-article-buffer
eec82323
LMI
4002 (save-excursion
4003 (save-restriction
4004 (widen)
fef8d38e
GM
4005 ;; Note that unlike gnus-summary-save-in-mail, there is no
4006 ;; check to see if filename is Babyl. Rmail in Emacs 23 does
4007 ;; not use Babyl.
6748645f
LMI
4008 (gnus-output-to-rmail filename))))
4009 filename)
eec82323
LMI
4010
4011(defun gnus-summary-save-in-mail (&optional filename)
4012 "Append this article to Unix mail file.
4013Optional argument FILENAME specifies file name.
4014Directory to save to is default to `gnus-article-save-directory'."
eec82323 4015 (setq filename (gnus-read-save-file-name
81df110a 4016 "Save %s in Unix mail file" filename
eec82323
LMI
4017 gnus-mail-save-name gnus-newsgroup-name
4018 gnus-current-headers 'gnus-newsgroup-last-mail))
a3f57c41 4019 (with-current-buffer gnus-save-article-buffer
eec82323
LMI
4020 (save-excursion
4021 (save-restriction
4022 (widen)
4023 (if (and (file-readable-p filename)
23f87bed 4024 (file-regular-p filename)
eec82323 4025 (mail-file-babyl-p filename))
fef8d38e 4026 (gnus-output-to-rmail filename)
6748645f
LMI
4027 (gnus-output-to-mail filename)))))
4028 filename)
eec82323 4029
26c9afc3
MB
4030(put 'gnus-summary-save-in-file :decode t)
4031(put 'gnus-summary-save-in-file :headers 'gnus-saved-headers)
eec82323
LMI
4032(defun gnus-summary-save-in-file (&optional filename overwrite)
4033 "Append this article to file.
4034Optional argument FILENAME specifies file name.
4035Directory to save to is default to `gnus-article-save-directory'."
eec82323 4036 (setq filename (gnus-read-save-file-name
81df110a 4037 "Save %s in file" filename
eec82323
LMI
4038 gnus-file-save-name gnus-newsgroup-name
4039 gnus-current-headers 'gnus-newsgroup-last-file))
a3f57c41 4040 (with-current-buffer gnus-save-article-buffer
eec82323
LMI
4041 (save-excursion
4042 (save-restriction
4043 (widen)
4044 (when (and overwrite
4045 (file-exists-p filename))
4046 (delete-file filename))
6748645f
LMI
4047 (gnus-output-to-file filename))))
4048 filename)
eec82323 4049
26c9afc3
MB
4050(put 'gnus-summary-write-to-file :decode t)
4051(put 'gnus-summary-write-to-file :function 'gnus-summary-save-in-file)
4052(put 'gnus-summary-write-to-file :headers 'gnus-saved-headers)
eec82323 4053(defun gnus-summary-write-to-file (&optional filename)
23f87bed 4054 "Write this article to a file, overwriting it if the file exists.
eec82323
LMI
4055Optional argument FILENAME specifies file name.
4056The directory to save in defaults to `gnus-article-save-directory'."
26c9afc3
MB
4057 (setq filename (gnus-read-save-file-name
4058 "Save %s in file" filename
4059 gnus-file-save-name gnus-newsgroup-name
4060 gnus-current-headers nil 'gnus-newsgroup-last-directory))
4061 (gnus-summary-save-in-file filename t))
eec82323 4062
26c9afc3
MB
4063(put 'gnus-summary-save-body-in-file :decode t)
4064(defun gnus-summary-save-body-in-file (&optional filename overwrite)
eec82323
LMI
4065 "Append this article body to a file.
4066Optional argument FILENAME specifies file name.
4067The directory to save in defaults to `gnus-article-save-directory'."
eec82323 4068 (setq filename (gnus-read-save-file-name
81df110a 4069 "Save %s body in file" filename
eec82323
LMI
4070 gnus-file-save-name gnus-newsgroup-name
4071 gnus-current-headers 'gnus-newsgroup-last-file))
a3f57c41 4072 (with-current-buffer gnus-save-article-buffer
eec82323
LMI
4073 (save-excursion
4074 (save-restriction
4075 (widen)
16409b0b 4076 (when (article-goto-body)
eec82323 4077 (narrow-to-region (point) (point-max)))
26c9afc3
MB
4078 (when (and overwrite
4079 (file-exists-p filename))
4080 (delete-file filename))
6748645f
LMI
4081 (gnus-output-to-file filename))))
4082 filename)
eec82323 4083
26c9afc3
MB
4084(put 'gnus-summary-write-body-to-file :decode t)
4085(put 'gnus-summary-write-body-to-file
4086 :function 'gnus-summary-save-body-in-file)
4087(defun gnus-summary-write-body-to-file (&optional filename)
4088 "Write this article body to a file, overwriting it if the file exists.
4089Optional argument FILENAME specifies file name.
4090The directory to save in defaults to `gnus-article-save-directory'."
4091 (setq filename (gnus-read-save-file-name
4092 "Save %s body in file" filename
4093 gnus-file-save-name gnus-newsgroup-name
4094 gnus-current-headers nil 'gnus-newsgroup-last-directory))
4095 (gnus-summary-save-body-in-file filename t))
4096
89167438
MB
4097(put 'gnus-summary-save-in-pipe :decode t)
4098(put 'gnus-summary-save-in-pipe :headers 'gnus-saved-headers)
d62672f3
MB
4099(defun gnus-summary-save-in-pipe (&optional command raw)
4100 "Pipe this article to subprocess COMMAND.
4101Valid values for COMMAND include:
4102 a string
4103 The executable command name and possibly arguments.
4104 nil
4105 You will be prompted for the command in the minibuffer.
4106 the symbol `default'
4107 It will be replaced with the command which the variable
4108 `gnus-summary-pipe-output-default-command' holds or the command
4109 last used for saving.
4110Non-nil value for RAW overrides `:decode' and `:headers' properties
4111and the raw article including all headers will be piped."
6ecfe5c2
MB
4112 (let ((article (gnus-summary-article-number))
4113 (decode (unless raw
4114 (get 'gnus-summary-save-in-pipe :decode)))
4115 save-buffer default)
4116 (if article
4117 (if (vectorp (gnus-summary-article-header article))
4118 (save-current-buffer
4119 (gnus-summary-select-article decode decode nil article)
4120 (insert-buffer-substring
4121 (prog1
4122 (if decode
4123 gnus-article-buffer
4124 gnus-original-article-buffer)
4125 (setq save-buffer
4126 (nnheader-set-temp-buffer " *Gnus Save*"))))
4127 ;; Remove unwanted headers.
4128 (when (and (not raw)
4129 (or (get 'gnus-summary-save-in-pipe :headers)
4130 (not gnus-save-all-headers)))
4131 (let ((gnus-visible-headers
4132 (or (symbol-value (get 'gnus-summary-save-in-pipe
4133 :headers))
4134 gnus-saved-headers gnus-visible-headers))
4135 (gnus-summary-buffer nil))
4136 (article-hide-headers 1 t))))
4137 (error "%d is not a real article" article))
4138 (error "No article to pipe"))
4139 (setq default (or gnus-summary-pipe-output-default-command
4140 gnus-last-shell-command))
89167438
MB
4141 (unless (stringp command)
4142 (setq command
4143 (if (and (eq command 'default) default)
4144 default
6ecfe5c2
MB
4145 (gnus-read-shell-command "Shell command on this article: "
4146 default))))
89167438
MB
4147 (when (string-equal command "")
4148 (if default
4149 (setq command default)
16c85f26 4150 (error "A command is required")))
a3f57c41 4151 (with-current-buffer save-buffer
16c85f26
MB
4152 (save-restriction
4153 (widen)
4154 (shell-command-on-region (point-min) (point-max) command nil)))
4155 (gnus-kill-buffer save-buffer))
89167438 4156 (setq gnus-summary-pipe-output-default-command command))
eec82323 4157
23f87bed
MB
4158(defun gnus-summary-pipe-to-muttprint (&optional command)
4159 "Pipe this article to muttprint."
16c85f26
MB
4160 (unless (stringp command)
4161 (setq command (read-string
4162 "Print using command: " gnus-summary-muttprint-program
4163 nil gnus-summary-muttprint-program)))
4164 (let ((gnus-summary-pipe-output-default-command
4165 gnus-summary-pipe-output-default-command))
4166 (gnus-summary-save-in-pipe command))
4167 (setq gnus-summary-muttprint-program command))
23f87bed 4168
eec82323
LMI
4169;;; Article file names when saving.
4170
4171(defun gnus-capitalize-newsgroup (newsgroup)
4172 "Capitalize NEWSGROUP name."
4173 (when (not (zerop (length newsgroup)))
4174 (concat (char-to-string (upcase (aref newsgroup 0)))
4175 (substring newsgroup 1))))
4176
4177(defun gnus-Numeric-save-name (newsgroup headers &optional last-file)
4178 "Generate file name from NEWSGROUP, HEADERS, and optional LAST-FILE.
4179If variable `gnus-use-long-file-name' is non-nil, it is ~/News/News.group/num.
4180Otherwise, it is like ~/News/news/group/num."
4181 (let ((default
4182 (expand-file-name
4183 (concat (if (gnus-use-long-file-name 'not-save)
4184 (gnus-capitalize-newsgroup newsgroup)
4185 (gnus-newsgroup-directory-form newsgroup))
4186 "/" (int-to-string (mail-header-number headers)))
4187 gnus-article-save-directory)))
4188 (if (and last-file
4189 (string-equal (file-name-directory default)
4190 (file-name-directory last-file))
4191 (string-match "^[0-9]+$" (file-name-nondirectory last-file)))
4192 default
4193 (or last-file default))))
4194
4195(defun gnus-numeric-save-name (newsgroup headers &optional last-file)
4196 "Generate file name from NEWSGROUP, HEADERS, and optional LAST-FILE.
4197If variable `gnus-use-long-file-name' is non-nil, it is
2ff9f5b4 4198~/News/news.group/num. Otherwise, it is like ~/News/news/group/num."
eec82323
LMI
4199 (let ((default
4200 (expand-file-name
4201 (concat (if (gnus-use-long-file-name 'not-save)
4202 newsgroup
4203 (gnus-newsgroup-directory-form newsgroup))
4204 "/" (int-to-string (mail-header-number headers)))
4205 gnus-article-save-directory)))
4206 (if (and last-file
4207 (string-equal (file-name-directory default)
4208 (file-name-directory last-file))
4209 (string-match "^[0-9]+$" (file-name-nondirectory last-file)))
4210 default
4211 (or last-file default))))
4212
eec82323
LMI
4213(defun gnus-plain-save-name (newsgroup headers &optional last-file)
4214 "Generate file name from NEWSGROUP, HEADERS, and optional LAST-FILE.
4215If variable `gnus-use-long-file-name' is non-nil, it is
4216~/News/news.group. Otherwise, it is like ~/News/news/group/news."
4217 (or last-file
4218 (expand-file-name
4219 (if (gnus-use-long-file-name 'not-save)
4220 newsgroup
23f87bed
MB
4221 (file-relative-name
4222 (expand-file-name "news" (gnus-newsgroup-directory-form newsgroup))
4223 default-directory))
eec82323
LMI
4224 gnus-article-save-directory)))
4225
23f87bed
MB
4226(defun gnus-sender-save-name (newsgroup headers &optional last-file)
4227 "Generate file name from sender."
4228 (let ((from (mail-header-from headers)))
4229 (expand-file-name
4230 (if (and from (string-match "\\([^ <]+\\)@" from))
4231 (match-string 1 from)
4232 "nobody")
4233 gnus-article-save-directory)))
4234
4235(defun article-verify-x-pgp-sig ()
4236 "Verify X-PGP-Sig."
bbbe940b 4237 ;; <ftp://ftp.isc.org/pub/pgpcontrol/FORMAT>
23f87bed
MB
4238 (interactive)
4239 (if (gnus-buffer-live-p gnus-original-article-buffer)
4240 (let ((sig (with-current-buffer gnus-original-article-buffer
4241 (gnus-fetch-field "X-PGP-Sig")))
4242 items info headers)
4243 (when (and sig
4244 mml2015-use
4245 (mml2015-clear-verify-function))
4246 (with-temp-buffer
4247 (insert-buffer-substring gnus-original-article-buffer)
4248 (setq items (split-string sig))
4249 (message-narrow-to-head)
4250 (let ((inhibit-point-motion-hooks t)
4251 (case-fold-search t))
4252 ;; Don't verify multiple headers.
4253 (setq headers (mapconcat (lambda (header)
4254 (concat header ": "
4255 (mail-fetch-field header)
4256 "\n"))
4257 (split-string (nth 1 items) ",") "")))
4258 (delete-region (point-min) (point-max))
4259 (insert "-----BEGIN PGP SIGNED MESSAGE-----\n\n")
4260 (insert "X-Signed-Headers: " (nth 1 items) "\n")
4261 (insert headers)
4262 (widen)
4263 (forward-line)
4264 (while (not (eobp))
4265 (if (looking-at "^-")
4266 (insert "- "))
4267 (forward-line))
4268 (insert "\n-----BEGIN PGP SIGNATURE-----\n")
4269 (insert "Version: " (car items) "\n\n")
4270 (insert (mapconcat 'identity (cddr items) "\n"))
4271 (insert "\n-----END PGP SIGNATURE-----\n")
4272 (let ((mm-security-handle (list (format "multipart/signed"))))
4273 (mml2015-clean-buffer)
4274 (let ((coding-system-for-write (or gnus-newsgroup-charset
4275 'iso-8859-1)))
4276 (funcall (mml2015-clear-verify-function)))
4277 (setq info
4278 (or (mm-handle-multipart-ctl-parameter
4279 mm-security-handle 'gnus-details)
4280 (mm-handle-multipart-ctl-parameter
4281 mm-security-handle 'gnus-info)))))
4282 (when info
4283 (let ((inhibit-read-only t) bface eface)
4284 (save-restriction
4285 (message-narrow-to-head)
4286 (goto-char (point-max))
4287 (forward-line -1)
01c52d31
MB
4288 (setq bface (get-text-property (point-at-bol) 'face)
4289 eface (get-text-property (1- (point-at-eol)) 'face))
23f87bed
MB
4290 (message-remove-header "X-Gnus-PGP-Verify")
4291 (if (re-search-forward "^X-PGP-Sig:" nil t)
4292 (forward-line)
4293 (goto-char (point-max)))
4294 (narrow-to-region (point) (point))
4295 (insert "X-Gnus-PGP-Verify: " info "\n")
4296 (goto-char (point-min))
4297 (forward-line)
4298 (while (not (eobp))
4299 (if (not (looking-at "^[ \t]"))
4300 (insert " "))
4301 (forward-line))
4302 ;; Do highlighting.
4303 (goto-char (point-min))
4304 (when (looking-at "\\([^:]+\\): *")
4305 (put-text-property (match-beginning 1) (1+ (match-end 1))
4306 'face bface)
4307 (put-text-property (match-end 0) (point-max)
4308 'face eface)))))))))
4309
5843126b 4310(autoload 'canlock-verify "canlock" nil t) ;; for XEmacs.
ec7995fa 4311
23f87bed
MB
4312(defun article-verify-cancel-lock ()
4313 "Verify Cancel-Lock header."
4314 (interactive)
4315 (if (gnus-buffer-live-p gnus-original-article-buffer)
4316 (canlock-verify gnus-original-article-buffer)))
4317
eec82323 4318(eval-and-compile
01c52d31 4319 (mapc
eec82323
LMI
4320 (lambda (func)
4321 (let (afunc gfunc)
4322 (if (consp func)
4323 (setq afunc (car func)
4324 gfunc (cdr func))
4325 (setq afunc func
4326 gfunc (intern (format "gnus-%s" func))))
16409b0b 4327 (defalias gfunc
23f87bed 4328 (when (fboundp afunc)
16409b0b
GM
4329 `(lambda (&optional interactive &rest args)
4330 ,(documentation afunc t)
4331 (interactive (list t))
80de1778 4332 (with-current-buffer gnus-article-buffer
16409b0b
GM
4333 (if interactive
4334 (call-interactively ',afunc)
4335 (apply ',afunc args))))))))
eec82323 4336 '(article-hide-headers
23f87bed
MB
4337 article-verify-x-pgp-sig
4338 article-verify-cancel-lock
eec82323
LMI
4339 article-hide-boring-headers
4340 article-treat-overstrike
01c52d31 4341 article-treat-ansi-sequences
16409b0b
GM
4342 article-fill-long-lines
4343 article-capitalize-sentences
eec82323 4344 article-remove-cr
23f87bed 4345 article-remove-leading-whitespace
eec82323 4346 article-display-x-face
23f87bed 4347 article-display-face
eec82323 4348 article-de-quoted-unreadable
16409b0b
GM
4349 article-de-base64-unreadable
4350 article-decode-HZ
4351 article-wash-html
23f87bed 4352 article-unsplit-urls
16409b0b 4353 article-hide-list-identifiers
16409b0b
GM
4354 article-strip-banner
4355 article-babel
eec82323
LMI
4356 article-hide-pem
4357 article-hide-signature
16409b0b 4358 article-strip-headers-in-body
eec82323
LMI
4359 article-remove-trailing-blank-lines
4360 article-strip-leading-blank-lines
4361 article-strip-multiple-blank-lines
4362 article-strip-leading-space
16409b0b 4363 article-strip-trailing-space
eec82323 4364 article-strip-blank-lines
6748645f 4365 article-strip-all-blank-lines
eec82323 4366 article-date-local
23f87bed 4367 article-date-english
6748645f 4368 article-date-iso8601
eec82323 4369 article-date-original
12e3ca0a 4370 article-treat-date
eec82323 4371 article-date-ut
16409b0b
GM
4372 article-decode-mime-words
4373 article-decode-charset
4374 article-decode-encoded-words
eec82323
LMI
4375 article-date-user
4376 article-date-lapsed
647559c2 4377 article-date-combined-lapsed
eec82323 4378 article-emphasize
6748645f 4379 article-treat-dumbquotes
be3c11b3 4380 article-treat-non-ascii
16409b0b 4381 article-normalize-headers
01c52d31 4382 ;;(article-show-all . gnus-article-show-all-headers)
23f87bed 4383 )))
eec82323
LMI
4384\f
4385;;;
4386;;; Gnus article mode
4387;;;
4388
4389(put 'gnus-article-mode 'mode-class 'special)
4390
16409b0b
GM
4391(set-keymap-parent gnus-article-mode-map widget-keymap)
4392
a8151ef7
LMI
4393(gnus-define-keys gnus-article-mode-map
4394 " " gnus-article-goto-next-page
9cec74cf 4395 [?\S-\ ] gnus-article-goto-prev-page
a8151ef7
LMI
4396 "\177" gnus-article-goto-prev-page
4397 [delete] gnus-article-goto-prev-page
4398 "\C-c^" gnus-article-refer-article
4399 "h" gnus-article-show-summary
4400 "s" gnus-article-show-summary
4401 "\C-c\C-m" gnus-article-mail
4402 "?" gnus-article-describe-briefly
a8151ef7
LMI
4403 "<" beginning-of-buffer
4404 ">" end-of-buffer
4405 "\C-c\C-i" gnus-info-find-node
4406 "\C-c\C-b" gnus-bug
23f87bed
MB
4407 "R" gnus-article-reply-with-original
4408 "F" gnus-article-followup-with-original
520aa572
SZ
4409 "\C-hk" gnus-article-describe-key
4410 "\C-hc" gnus-article-describe-key-briefly
0b6799c3 4411 "\C-hb" gnus-article-describe-bindings
a8151ef7 4412
6ab2c7a8 4413 "e" gnus-article-read-summary-keys
a8151ef7
LMI
4414 "\C-d" gnus-article-read-summary-keys
4415 "\M-*" gnus-article-read-summary-keys
4416 "\M-#" gnus-article-read-summary-keys
4417 "\M-^" gnus-article-read-summary-keys
4418 "\M-g" gnus-article-read-summary-keys)
4419
4420(substitute-key-definition
4421 'undefined 'gnus-article-read-summary-keys gnus-article-mode-map)
eec82323 4422
95838435
MB
4423(gnus-define-keys (gnus-article-send-map "S" gnus-article-mode-map)
4424 "W" gnus-article-wide-reply-with-original)
4425(if (featurep 'xemacs)
4426 (set-keymap-default-binding gnus-article-send-map
4427 'gnus-article-read-summary-send-keys)
4428 (define-key gnus-article-send-map [t] 'gnus-article-read-summary-send-keys))
4429
eec82323 4430(defun gnus-article-make-menu-bar ()
23f87bed
MB
4431 (unless (boundp 'gnus-article-commands-menu)
4432 (gnus-summary-make-menu-bar))
eec82323
LMI
4433 (unless (boundp 'gnus-article-article-menu)
4434 (easy-menu-define
4435 gnus-article-article-menu gnus-article-mode-map ""
4436 '("Article"
4437 ["Scroll forwards" gnus-article-goto-next-page t]
4438 ["Scroll backwards" gnus-article-goto-prev-page t]
4439 ["Show summary" gnus-article-show-summary t]
4440 ["Fetch Message-ID at point" gnus-article-refer-article t]
6748645f
LMI
4441 ["Mail to address at point" gnus-article-mail t]
4442 ["Send a bug report" gnus-bug t]))
eec82323
LMI
4443
4444 (easy-menu-define
4445 gnus-article-treatment-menu gnus-article-mode-map ""
bb367cba 4446 ;; Fixme: this should use :active (and maybe :visible).
eec82323
LMI
4447 '("Treatment"
4448 ["Hide headers" gnus-article-hide-headers t]
4449 ["Hide signature" gnus-article-hide-signature t]
4450 ["Hide citation" gnus-article-hide-citation t]
4451 ["Treat overstrike" gnus-article-treat-overstrike t]
01c52d31 4452 ["Treat ANSI sequences" gnus-article-treat-ansi-sequences t]
eec82323 4453 ["Remove carriage return" gnus-article-remove-cr t]
23f87bed 4454 ["Remove leading whitespace" gnus-article-remove-leading-whitespace t]
16409b0b
GM
4455 ["Remove quoted-unreadable" gnus-article-de-quoted-unreadable t]
4456 ["Remove base64" gnus-article-de-base64-unreadable t]
4457 ["Treat html" gnus-article-wash-html t]
23f87bed 4458 ["Remove newlines from within URLs" gnus-article-unsplit-urls t]
16409b0b 4459 ["Decode HZ" gnus-article-decode-HZ t]))
eec82323 4460
6748645f 4461 ;; Note "Commands" menu is defined in gnus-sum.el for consistency
eec82323 4462
23f87bed 4463 ;; Note "Post" menu is defined in gnus-sum.el for consistency
eec82323 4464
6748645f 4465 (gnus-run-hooks 'gnus-article-menu-hook)))
eec82323 4466
8e7d4ca1 4467(defvar bookmark-make-record-function)
ffb54e99 4468(defvar shr-put-image-function)
8e7d4ca1 4469
1b3b87df 4470(define-derived-mode gnus-article-mode fundamental-mode "Article"
eec82323
LMI
4471 "Major mode for displaying an article.
4472
4473All normal editing commands are switched off.
4474
4475The following commands are available in addition to all summary mode
4476commands:
4477\\<gnus-article-mode-map>
4478\\[gnus-article-next-page]\t Scroll the article one page forwards
4479\\[gnus-article-prev-page]\t Scroll the article one page backwards
4480\\[gnus-article-refer-article]\t Go to the article referred to by an article id near point
4481\\[gnus-article-show-summary]\t Display the summary buffer
4482\\[gnus-article-mail]\t Send a reply to the address near point
4483\\[gnus-article-describe-briefly]\t Describe the current mode briefly
4484\\[gnus-info-find-node]\t Go to the Gnus info node"
eec82323 4485 (gnus-simplify-mode-line)
eec82323 4486 (make-local-variable 'minor-mode-alist)
1653df0f 4487 (when (gnus-visual-p 'article-menu 'menu)
23f87bed
MB
4488 (gnus-article-make-menu-bar)
4489 (when gnus-summary-tool-bar-map
4490 (set (make-local-variable 'tool-bar-map) gnus-summary-tool-bar-map)))
eec82323
LMI
4491 (gnus-update-format-specifications nil 'article-mode)
4492 (set (make-local-variable 'page-delimiter) gnus-page-delimiter)
23f87bed 4493 (set (make-local-variable 'gnus-page-broken) nil)
6748645f 4494 (make-local-variable 'gnus-article-current-summary)
16409b0b
GM
4495 (make-local-variable 'gnus-article-mime-handles)
4496 (make-local-variable 'gnus-article-decoded-p)
4497 (make-local-variable 'gnus-article-mime-handle-alist)
4498 (make-local-variable 'gnus-article-wash-types)
23f87bed
MB
4499 (make-local-variable 'gnus-article-image-alist)
4500 (make-local-variable 'gnus-article-charset)
4501 (make-local-variable 'gnus-article-ignored-charsets)
33b48483
KF
4502 (set (make-local-variable 'bookmark-make-record-function)
4503 'gnus-summary-bookmark-make-record)
524705ae
MB
4504 ;; Prevent Emacs 22 from displaying non-break space with `nobreak-space'
4505 ;; face.
fc1c32c1 4506 (set (make-local-variable 'nobreak-char-display) nil)
ffb54e99
KY
4507 ;; Enable `gnus-article-remove-images' to delete images shr.el renders.
4508 (set (make-local-variable 'shr-put-image-function) 'gnus-shr-put-image)
e4a89ccf 4509 (setq cursor-in-non-selected-windows nil)
eec82323 4510 (gnus-set-default-directory)
16409b0b 4511 (buffer-disable-undo)
01c52d31
MB
4512 (setq buffer-read-only t
4513 show-trailing-whitespace nil)
1b3b87df 4514 (mm-enable-multibyte))
eec82323
LMI
4515
4516(defun gnus-article-setup-buffer ()
4517 "Initialize the article buffer."
4518 (let* ((name (if gnus-single-article-buffer "*Article*"
a3e0ee5a
KY
4519 (concat "*Article "
4520 (gnus-group-decoded-name gnus-newsgroup-name)
4521 "*")))
eec82323
LMI
4522 (original
4523 (progn (string-match "\\*Article" name)
4524 (concat " *Original Article"
4525 (substring name (match-end 0))))))
4526 (setq gnus-article-buffer name)
4527 (setq gnus-original-article-buffer original)
16409b0b 4528 (setq gnus-article-mime-handle-alist nil)
01c52d31
MB
4529 (with-current-buffer gnus-summary-buffer
4530 ;; This might be a variable local to the summary buffer.
4531 (unless gnus-single-article-buffer
eec82323
LMI
4532 (setq gnus-article-buffer name)
4533 (setq gnus-original-article-buffer original)
4534 (gnus-set-global-variables)))
16409b0b 4535 (gnus-article-setup-highlight-words)
eec82323 4536 ;; Init original article buffer.
80de1778 4537 (with-current-buffer (gnus-get-buffer-create gnus-original-article-buffer)
16409b0b 4538 (mm-enable-multibyte)
eec82323 4539 (setq major-mode 'gnus-original-article-mode)
eec82323 4540 (make-local-variable 'gnus-original-article))
aba1948a
MB
4541 (if (and (get-buffer name)
4542 (with-current-buffer name
4543 (if gnus-article-edit-mode
4544 (if (y-or-n-p "Article mode edit in progress; discard? ")
4545 (progn
4546 (set-buffer-modified-p nil)
4547 (gnus-kill-buffer name)
4548 (message "")
4549 nil)
4550 (error "Action aborted"))
4551 t)))
80de1778 4552 (with-current-buffer name
23f87bed 4553 (set (make-local-variable 'gnus-article-edit-mode) nil)
c146ad85 4554 (gnus-article-stop-animations)
16409b0b
GM
4555 (when gnus-article-mime-handles
4556 (mm-destroy-parts gnus-article-mime-handles)
4557 (setq gnus-article-mime-handles nil))
4558 ;; Set it to nil in article-buffer!
a1506d29 4559 (setq gnus-article-mime-handle-alist nil)
16409b0b 4560 (buffer-disable-undo)
eec82323 4561 (setq buffer-read-only t)
1b3b87df 4562 (unless (derived-mode-p 'gnus-article-mode)
eec82323 4563 (gnus-article-mode))
030158f3 4564 (setq truncate-lines gnus-article-truncate-lines)
eec82323 4565 (current-buffer))
cc21c235
G
4566 (let ((summary gnus-summary-buffer))
4567 (with-current-buffer (gnus-get-buffer-create name)
4568 (gnus-article-mode)
4569 (setq truncate-lines gnus-article-truncate-lines)
4570 (set (make-local-variable 'gnus-summary-buffer) summary)
4571 (gnus-summary-set-local-parameters gnus-newsgroup-name)
4572 (when article-lapsed-timer
4573 (gnus-stop-date-timer))
4574 (when gnus-article-update-date-headers
4575 (gnus-start-date-timer gnus-article-update-date-headers))
4576 (current-buffer))))))
eec82323 4577
c146ad85
LMI
4578(defun gnus-article-stop-animations ()
4579 (dolist (timer (and (boundp 'timer-list)
4580 timer-list))
5e2b4ce1 4581 (when (eq (gnus-timer--function timer) 'image-animate-timeout)
c146ad85
LMI
4582 (cancel-timer timer))))
4583
4eff9c1a
LI
4584(defun gnus-stop-downloads ()
4585 (when (boundp 'url-queue)
4586 (set (intern "url-queue" obarray) nil)))
4587
eec82323
LMI
4588;; Set article window start at LINE, where LINE is the number of lines
4589;; from the head of the article.
4590(defun gnus-article-set-window-start (&optional line)
01c52d31
MB
4591 (let ((article-window (gnus-get-buffer-window gnus-article-buffer t)))
4592 (when article-window
4593 (set-window-start
4594 article-window
80de1778 4595 (with-current-buffer gnus-article-buffer
01c52d31
MB
4596 (goto-char (point-min))
4597 (if (not line)
4598 (point-min)
4599 (gnus-message 6 "Moved to bookmark")
4600 (search-forward "\n\n" nil t)
4601 (forward-line line)
4602 (point)))))))
eec82323
LMI
4603
4604(defun gnus-article-prepare (article &optional all-headers header)
4605 "Prepare ARTICLE in article mode buffer.
4606ARTICLE should either be an article number or a Message-ID.
4607If ARTICLE is an id, HEADER should be the article headers.
4608If ALL-HEADERS is non-nil, no headers are hidden."
4609 (save-excursion
4610 ;; Make sure we start in a summary buffer.
1b3b87df 4611 (unless (derived-mode-p 'gnus-summary-mode)
eec82323
LMI
4612 (set-buffer gnus-summary-buffer))
4613 (setq gnus-summary-buffer (current-buffer))
eec82323
LMI
4614 (let* ((gnus-article (if header (mail-header-number header) article))
4615 (summary-buffer (current-buffer))
6748645f 4616 (gnus-tmp-internal-hook gnus-article-internal-prepare-hook)
eec82323
LMI
4617 (group gnus-newsgroup-name)
4618 result)
4619 (save-excursion
4620 (gnus-article-setup-buffer)
4621 (set-buffer gnus-article-buffer)
4622 ;; Deactivate active regions.
4623 (when (and (boundp 'transient-mark-mode)
4624 transient-mark-mode)
4625 (setq mark-active nil))
4e7d0221 4626 (if (not (setq result (let ((inhibit-read-only t))
eec82323
LMI
4627 (gnus-request-article-this-buffer
4628 article group))))
4629 ;; There is no such article.
4630 (save-excursion
4631 (when (and (numberp article)
4632 (not (memq article gnus-newsgroup-sparse)))
4633 (setq gnus-article-current
4634 (cons gnus-newsgroup-name article))
4635 (set-buffer gnus-summary-buffer)
4636 (setq gnus-current-article article)
23f87bed
MB
4637 (if (and (memq article gnus-newsgroup-undownloaded)
4638 (not (gnus-online (gnus-find-method-for-group
4639 gnus-newsgroup-name))))
6748645f
LMI
4640 (progn
4641 (gnus-summary-set-agent-mark article)
4642 (message "Message marked for downloading"))
4643 (gnus-summary-mark-article article gnus-canceled-mark)
4644 (unless (memq article gnus-newsgroup-sparse)
16409b0b 4645 (gnus-error 1 "No such article (may have expired or been canceled)")))))
6748645f
LMI
4646 (if (or (eq result 'pseudo)
4647 (eq result 'nneething))
eec82323 4648 (progn
80de1778 4649 (with-current-buffer summary-buffer
6748645f 4650 (push article gnus-newsgroup-history)
eec82323 4651 (setq gnus-last-article gnus-current-article
eec82323
LMI
4652 gnus-current-article 0
4653 gnus-current-headers nil
4654 gnus-article-current nil)
4655 (if (eq result 'nneething)
4656 (gnus-configure-windows 'summary)
4657 (gnus-configure-windows 'article))
4658 (gnus-set-global-variables))
16409b0b
GM
4659 (let ((gnus-article-mime-handle-alist-1
4660 gnus-article-mime-handle-alist))
4661 (gnus-set-mode-line 'article)))
eec82323
LMI
4662 ;; The result from the `request' was an actual article -
4663 ;; or at least some text that is now displayed in the
4664 ;; article buffer.
4665 (when (and (numberp article)
4666 (not (eq article gnus-current-article)))
4667 ;; Seems like a new article has been selected.
4668 ;; `gnus-current-article' must be an article number.
80de1778 4669 (with-current-buffer summary-buffer
6748645f 4670 (push article gnus-newsgroup-history)
eec82323 4671 (setq gnus-last-article gnus-current-article
eec82323
LMI
4672 gnus-current-article article
4673 gnus-current-headers
4674 (gnus-summary-article-header gnus-current-article)
4675 gnus-article-current
4676 (cons gnus-newsgroup-name gnus-current-article))
4677 (unless (vectorp gnus-current-headers)
4678 (setq gnus-current-headers nil))
6748645f
LMI
4679 (gnus-summary-goto-subject gnus-current-article)
4680 (when (gnus-summary-show-thread)
4681 ;; If the summary buffer really was folded, the
4682 ;; previous goto may not actually have gone to
4683 ;; the right article, but the thread root instead.
4684 ;; So we go again.
4685 (gnus-summary-goto-subject gnus-current-article))
4686 (gnus-run-hooks 'gnus-mark-article-hook)
eec82323
LMI
4687 (gnus-set-mode-line 'summary)
4688 (when (gnus-visual-p 'article-highlight 'highlight)
6748645f 4689 (gnus-run-hooks 'gnus-visual-mark-article-hook))
eec82323 4690 ;; Set the global newsgroup variables here.
eec82323
LMI
4691 (gnus-set-global-variables)
4692 (setq gnus-have-all-headers
6748645f 4693 (or all-headers gnus-show-all-headers))))
e0bad764
DL
4694 (save-excursion
4695 (gnus-configure-windows 'article))
eec82323
LMI
4696 (when (or (numberp article)
4697 (stringp article))
16409b0b 4698 (gnus-article-prepare-display)
eec82323
LMI
4699 ;; Do page break.
4700 (goto-char (point-min))
23f87bed
MB
4701 (when gnus-break-pages
4702 (gnus-narrow-to-page)))
16409b0b
GM
4703 (let ((gnus-article-mime-handle-alist-1
4704 gnus-article-mime-handle-alist))
4705 (gnus-set-mode-line 'article))
4706 (article-goto-body)
23f87bed
MB
4707 (unless (bobp)
4708 (forward-line -1))
6748645f 4709 (set-window-point (get-buffer-window (current-buffer)) (point))
16409b0b 4710 (gnus-configure-windows 'article)
56e96bed 4711 (gnus-run-hooks 'gnus-article-prepare-hook)
eec82323
LMI
4712 t))))))
4713
16409b0b
GM
4714;;;###autoload
4715(defun gnus-article-prepare-display ()
4716 "Make the current buffer look like a nice article."
4717 ;; Hooks for getting information from the article.
4718 ;; This hook must be called before being narrowed.
4719 (let ((gnus-article-buffer (current-buffer))
23f87bed
MB
4720 buffer-read-only
4721 (inhibit-read-only t))
1b3b87df 4722 (unless (derived-mode-p 'gnus-article-mode)
16409b0b
GM
4723 (gnus-article-mode))
4724 (setq buffer-read-only nil
23f87bed
MB
4725 gnus-article-wash-types nil
4726 gnus-article-image-alist nil)
16409b0b
GM
4727 (gnus-run-hooks 'gnus-tmp-internal-hook)
4728 (when gnus-display-mime-function
56e96bed 4729 (funcall gnus-display-mime-function))))
16409b0b 4730
01c52d31
MB
4731;;;
4732;;; Gnus Sticky Article Mode
4733;;;
4734
4735(define-derived-mode gnus-sticky-article-mode gnus-article-mode "StickyArticle"
4736 "Mode for sticky articles."
4737 ;; Release bindings that won't work.
4738 (substitute-key-definition 'gnus-article-read-summary-keys 'undefined
4739 gnus-sticky-article-mode-map)
4740 (substitute-key-definition 'gnus-article-refer-article 'undefined
4741 gnus-sticky-article-mode-map)
4742 (dolist (k '("e" "h" "s" "F" "R"))
4743 (define-key gnus-sticky-article-mode-map k nil))
4744 (define-key gnus-sticky-article-mode-map "k" 'gnus-kill-sticky-article-buffer)
4745 (define-key gnus-sticky-article-mode-map "q" 'bury-buffer)
4746 (define-key gnus-sticky-article-mode-map "\C-hc" 'describe-key-briefly)
4747 (define-key gnus-sticky-article-mode-map "\C-hk" 'describe-key))
4748
4749(defun gnus-sticky-article (arg)
4750 "Make the current article sticky.
4751If a prefix ARG is given, ask for a name for this sticky article buffer."
4752 (interactive "P")
4753 (gnus-summary-show-thread)
4754 (gnus-summary-select-article nil nil 'pseudo)
4755 (let (new-art-buf-name)
4756 (gnus-eval-in-buffer-window gnus-article-buffer
4757 (setq new-art-buf-name
4758 (concat
4759 "*Sticky Article: "
4760 (if arg
4761 (read-from-minibuffer "Sticky article buffer name: ")
4762 (gnus-with-article-headers
4763 (gnus-article-goto-header "subject")
4764 (setq new-art-buf-name
4765 (buffer-substring-no-properties
4766 (line-beginning-position) (line-end-position)))
4767 (goto-char (point-min))
4768 (gnus-article-goto-header "from")
4769 (setq new-art-buf-name
4770 (concat
4771 new-art-buf-name ", "
4772 (buffer-substring-no-properties
4773 (line-beginning-position) (line-end-position))))
4774 (goto-char (point-min))
4775 (gnus-article-goto-header "date")
4776 (setq new-art-buf-name
4777 (concat
4778 new-art-buf-name ", "
4779 (buffer-substring-no-properties
4780 (line-beginning-position) (line-end-position))))))
4781 "*"))
4782 (if (and (gnus-buffer-live-p new-art-buf-name)
4783 (with-current-buffer new-art-buf-name
1b3b87df 4784 (derived-mode-p 'gnus-sticky-article-mode)))
01c52d31
MB
4785 (switch-to-buffer new-art-buf-name)
4786 (setq new-art-buf-name (rename-buffer new-art-buf-name t)))
4787 (gnus-sticky-article-mode))
4788 (setq gnus-article-buffer new-art-buf-name))
4789 (gnus-summary-recenter)
4790 (gnus-summary-position-point))
4791
4792(defun gnus-kill-sticky-article-buffer (&optional buffer)
4793 "Kill the given sticky article BUFFER.
4794If none is given, assume the current buffer and kill it if it has
4795`gnus-sticky-article-mode'."
4796 (interactive)
4797 (unless buffer
4798 (setq buffer (current-buffer)))
4799 (with-current-buffer buffer
1b3b87df 4800 (when (derived-mode-p 'gnus-sticky-article-mode)
01c52d31
MB
4801 (gnus-kill-buffer buffer))))
4802
71f32295
JD
4803(defun gnus-kill-sticky-article-buffers (arg)
4804 "Kill all sticky article buffers.
4805If a prefix ARG is given, ask for confirmation."
4806 (interactive "P")
4807 (dolist (buf (gnus-buffers))
4808 (with-current-buffer buf
1b3b87df
SM
4809 (when (derived-mode-p 'gnus-sticky-article-mode)
4810 (if (not arg)
4811 (gnus-kill-buffer buf)
4812 (when (yes-or-no-p (concat "Kill buffer " (buffer-name buf) "? "))
4813 (gnus-kill-buffer buf)))))))
71f32295 4814
16409b0b
GM
4815;;;
4816;;; Gnus MIME viewing functions
4817;;;
4818
4819(defvar gnus-mime-button-line-format "%{%([%p. %d%T]%)%}%e\n"
23f87bed
MB
4820 "Format of the MIME buttons.
4821
4822Valid specifiers include:
16409b0b
GM
4823%t The MIME type
4824%T MIME type, along with additional info
4825%n The `name' parameter
4826%d The description, if any
4827%l The length of the encoded part
4828%p The part identifier number
23f87bed
MB
4829%e Dots if the part isn't displayed
4830
4831General format specifiers can also be used. See Info node
4832`(gnus)Formatting Variables'.")
16409b0b
GM
4833
4834(defvar gnus-mime-button-line-format-alist
4835 '((?t gnus-tmp-type ?s)
4836 (?T gnus-tmp-type-long ?s)
4837 (?n gnus-tmp-name ?s)
4838 (?d gnus-tmp-description ?s)
4839 (?p gnus-tmp-id ?s)
4840 (?l gnus-tmp-length ?d)
4841 (?e gnus-tmp-dots ?s)))
4842
4843(defvar gnus-mime-button-commands
4844 '((gnus-article-press-button "\r" "Toggle Display")
4845 (gnus-mime-view-part "v" "View Interactively...")
4846 (gnus-mime-view-part-as-type "t" "View As Type...")
23f87bed 4847 (gnus-mime-view-part-as-charset "C" "View As charset...")
16409b0b 4848 (gnus-mime-save-part "o" "Save...")
23f87bed 4849 (gnus-mime-save-part-and-strip "\C-o" "Save and Strip")
01c52d31 4850 (gnus-mime-replace-part "r" "Replace part")
23f87bed 4851 (gnus-mime-delete-part "d" "Delete part")
16409b0b
GM
4852 (gnus-mime-copy-part "c" "View As Text, In Other Buffer")
4853 (gnus-mime-inline-part "i" "View As Text, In This Buffer")
01c52d31 4854 (gnus-mime-view-part-internally "E" "View Internally") ;; Why `E'?
23f87bed
MB
4855 (gnus-mime-view-part-externally "e" "View Externally")
4856 (gnus-mime-print-part "p" "Print")
e0bad764 4857 (gnus-mime-pipe-part "|" "Pipe To Command...")
23f87bed 4858 (gnus-mime-action-on-part "." "Take action on the part...")))
16409b0b
GM
4859
4860(defun gnus-article-mime-part-status ()
4861 (if gnus-article-mime-handle-alist-1
23f87bed
MB
4862 (if (eq 1 (length gnus-article-mime-handle-alist-1))
4863 " (1 part)"
4864 (format " (%d parts)" (length gnus-article-mime-handle-alist-1)))
16409b0b
GM
4865 ""))
4866
4867(defvar gnus-mime-button-map
4868 (let ((map (make-sparse-keymap)))
16409b0b
GM
4869 (define-key map gnus-mouse-2 'gnus-article-push-button)
4870 (define-key map gnus-down-mouse-3 'gnus-mime-button-menu)
4871 (dolist (c gnus-mime-button-commands)
4872 (define-key map (cadr c) (car c)))
4873 map))
4874
23f87bed
MB
4875(easy-menu-define
4876 gnus-mime-button-menu gnus-mime-button-map "MIME button menu."
4877 `("MIME Part"
4878 ,@(mapcar (lambda (c)
01c52d31 4879 (vector (caddr c) (car c) :active t))
23f87bed
MB
4880 gnus-mime-button-commands)))
4881
7426b4f7
LMI
4882(defvar gnus-url-button-commands
4883 '((gnus-article-copy-string "u" "Copy URL to kill ring")))
4884
4885(defvar gnus-url-button-map
4886 (let ((map (make-sparse-keymap)))
4887 (dolist (c gnus-url-button-commands)
4888 (define-key map (cadr c) (car c)))
4889 map))
4890
4891(easy-menu-define
4892 gnus-url-button-menu gnus-url-button-map "URL button menu."
4893 `("Url Button"
4894 ,@(mapcar (lambda (c)
4895 (vector (caddr c) (car c) :active t))
4896 gnus-url-button-commands)))
4897
b0b63450
MB
4898(defmacro gnus-bind-safe-url-regexp (&rest body)
4899 "Bind `mm-w3m-safe-url-regexp' according to `gnus-safe-html-newsgroups'."
4900 `(let ((mm-w3m-safe-url-regexp
1b3b87df 4901 (let ((group (if (and (derived-mode-p 'gnus-article-mode)
b0b63450
MB
4902 (gnus-buffer-live-p
4903 gnus-article-current-summary))
4904 (with-current-buffer gnus-article-current-summary
4905 gnus-newsgroup-name)
4906 gnus-newsgroup-name)))
7cab80f9
KY
4907 (if (cond ((not group)
4908 ;; Maybe we're in a mml-preview buffer
4909 ;; and no group is selected.
4910 t)
4911 ((stringp gnus-safe-html-newsgroups)
b0b63450
MB
4912 (string-match gnus-safe-html-newsgroups group))
4913 ((consp gnus-safe-html-newsgroups)
4914 (member group gnus-safe-html-newsgroups)))
4915 nil
4916 mm-w3m-safe-url-regexp))))
4917 ,@body))
4918
23f87bed
MB
4919(defun gnus-mime-button-menu (event prefix)
4920 "Construct a context-sensitive menu of MIME commands."
4921 (interactive "e\nP")
4922 (save-window-excursion
4923 (let ((pos (event-start event)))
4924 (select-window (posn-window pos))
4925 (goto-char (posn-point pos))
4926 (gnus-article-check-buffer)
4927 (popup-menu gnus-mime-button-menu nil prefix))))
16409b0b
GM
4928
4929(defun gnus-mime-view-all-parts (&optional handles)
4930 "View all the MIME parts."
4931 (interactive)
01c52d31 4932 (with-current-buffer gnus-article-buffer
16409b0b
GM
4933 (let ((handles (or handles gnus-article-mime-handles))
4934 (mail-parse-charset gnus-newsgroup-charset)
a1506d29 4935 (mail-parse-ignored-charsets
23f87bed
MB
4936 (with-current-buffer gnus-summary-buffer
4937 gnus-newsgroup-ignored-charsets)))
4938 (when handles
4939 (mm-remove-parts handles)
4940 (goto-char (point-min))
4941 (or (search-forward "\n\n") (goto-char (point-max)))
4942 (let ((inhibit-read-only t))
4943 (delete-region (point) (point-max))
b0b63450 4944 (gnus-bind-safe-url-regexp (mm-display-parts handles)))))))
23f87bed 4945
01c52d31
MB
4946(defun gnus-article-jump-to-part (n)
4947 "Jump to MIME part N."
4948 (interactive "P")
a87ee50b
KY
4949 (let ((parts (with-current-buffer gnus-article-buffer
4950 (length gnus-article-mime-handle-alist))))
4951 (when (zerop parts)
4952 (error "No such part"))
4953 (pop-to-buffer gnus-article-buffer)
a87ee50b
KY
4954 (or n
4955 (setq n (if (= parts 1)
4956 1
4957 (read-number (format "Jump to part (1..%s): " parts)))))
01c52d31
MB
4958 (unless (and (integerp n) (<= n parts) (>= n 1))
4959 (setq n
4960 (progn
4961 (gnus-message 7 "Invalid part `%s', using %s instead."
4962 n parts)
4963 parts)))
4964 (gnus-message 9 "Jumping to part %s." n)
4965 (cond ((>= gnus-auto-select-part 1)
4966 (while (and (<= n parts)
4967 (not (gnus-article-goto-part n)))
4968 (setq n (1+ n))))
4969 ((< gnus-auto-select-part 0)
4970 (while (and (>= n 1)
4971 (not (gnus-article-goto-part n)))
4972 (setq n (1- n))))
4973 (t
4974 (gnus-article-goto-part n)))))
4975
3e3ab3ab
KY
4976(defvar gnus-mime-buttonized-part-id nil
4977 "ID of a mime part that should be buttonized.
4978`gnus-mime-save-part-and-strip' and `gnus-mime-delete-part' bind it.")
4979
01c52d31
MB
4980(eval-when-compile
4981 (defsubst gnus-article-edit-part (handles &optional current-id)
4982 "Edit an article in order to delete a mime part.
4983This function is exclusively used by `gnus-mime-save-part-and-strip'
4984and `gnus-mime-delete-part', and not provided at run-time normally."
4985 (gnus-article-edit-article
4986 `(lambda ()
4987 (buffer-disable-undo)
4988 (erase-buffer)
4989 (let ((mail-parse-charset (or gnus-article-charset
4990 ',gnus-newsgroup-charset))
4991 (mail-parse-ignored-charsets
4992 (or gnus-article-ignored-charsets
4993 ',gnus-newsgroup-ignored-charsets))
4994 (mbl mml-buffer-list))
4995 (setq mml-buffer-list nil)
4996 (insert-buffer-substring gnus-original-article-buffer)
4997 (mime-to-mml ',handles)
4998 (setq gnus-article-mime-handles nil)
4999 (let ((mbl1 mml-buffer-list))
5000 (setq mml-buffer-list mbl)
5001 (set (make-local-variable 'mml-buffer-list) mbl1))
5002 (gnus-make-local-hook 'kill-buffer-hook)
5003 (add-hook 'kill-buffer-hook 'mml-destroy-buffers t t)))
5004 `(lambda (no-highlight)
5005 (let ((mail-parse-charset (or gnus-article-charset
5006 ',gnus-newsgroup-charset))
5007 (message-options message-options)
5008 (message-options-set-recipient)
5009 (mail-parse-ignored-charsets
5010 (or gnus-article-ignored-charsets
5011 ',gnus-newsgroup-ignored-charsets)))
5012 (mml-to-mime)
5013 (mml-destroy-buffers)
5014 (remove-hook 'kill-buffer-hook
5015 'mml-destroy-buffers t)
5016 (kill-local-variable 'mml-buffer-list))
5017 (gnus-summary-edit-article-done
5018 ,(or (mail-header-references gnus-current-headers) "")
5019 ,(gnus-group-read-only-p)
5020 ,gnus-summary-buffer no-highlight))
5021 t)
3e3ab3ab
KY
5022 ;; Force buttonizing this part.
5023 (let ((gnus-mime-buttonized-part-id current-id))
5024 (gnus-article-edit-done))
54c72c31 5025 (gnus-configure-windows 'article)
01c52d31 5026 (when (and current-id (integerp gnus-auto-select-part))
3e3ab3ab
KY
5027 (gnus-article-jump-to-part
5028 (min (max (+ current-id gnus-auto-select-part) 1)
5029 (with-current-buffer gnus-article-buffer
5030 (length gnus-article-mime-handle-alist)))))))
01c52d31
MB
5031
5032(defun gnus-mime-replace-part (file)
5033 "Replace MIME part under point with an external body."
5034 ;; Useful if file has already been saved to disk
5035 (interactive
5036 (list
75eda25b
SM
5037 (read-file-name "Replace MIME part with file: "
5038 (or mm-default-directory default-directory)
5039 nil nil)))
01c52d31
MB
5040 (gnus-mime-save-part-and-strip file))
5041
5042(defun gnus-mime-save-part-and-strip (&optional file)
5043 "Save the MIME part under point then replace it with an external body.
5044If FILE is given, use it for the external part."
23f87bed
MB
5045 (interactive)
5046 (gnus-article-check-buffer)
5047 (when (gnus-group-read-only-p)
5048 (error "The current group does not support deleting of parts"))
5049 (when (mm-complicated-handles gnus-article-mime-handles)
5050 (error "\
5051The current article has a complicated MIME structure, giving up..."))
01c52d31
MB
5052 (let* ((data (get-text-property (point) 'gnus-data))
5053 (id (get-text-property (point) 'gnus-part))
5054 param
5055 (handles gnus-article-mime-handles))
5056 (unless file
5057 (setq file
5058 (and data (mm-save-part data "Delete MIME part and save to: "))))
5059 (when file
5060 (with-current-buffer (mm-handle-buffer data)
5061 (erase-buffer)
5062 (insert "Content-Type: " (mm-handle-media-type data))
5063 (mml-insert-parameter-string (cdr (mm-handle-type data))
5064 '(charset))
5065 ;; Add a filename for the sake of saving the part again.
5066 (mml-insert-parameter
5067 (mail-header-encode-parameter "name" (file-name-nondirectory file)))
5068 (insert "\n")
5069 (insert "Content-ID: " (message-make-message-id) "\n")
5070 (insert "Content-Transfer-Encoding: binary\n")
5071 (insert "\n"))
5072 (setcdr data
5073 (cdr (mm-make-handle nil
5074 `("message/external-body"
5075 (access-type . "LOCAL-FILE")
5076 (name . ,file)))))
5077 ;; (set-buffer gnus-summary-buffer)
5078 (gnus-article-edit-part handles id))))
5079
5080;; A function like `gnus-summary-save-parts' (`X m', `<MIME> <Extract all
5081;; parts...>') but with stripping would be nice.
23f87bed
MB
5082
5083(defun gnus-mime-delete-part ()
5084 "Delete the MIME part under point.
5085Replace it with some information about the removed part."
5086 (interactive)
5087 (gnus-article-check-buffer)
5088 (when (gnus-group-read-only-p)
5089 (error "The current group does not support deleting of parts"))
5090 (when (mm-complicated-handles gnus-article-mime-handles)
5091 (error "\
5092The current article has a complicated MIME structure, giving up..."))
01c52d31
MB
5093 (when (or gnus-expert-user
5094 (gnus-yes-or-no-p "\
5095Deleting parts may malfunction or destroy the article; continue? "))
23f87bed 5096 (let* ((data (get-text-property (point) 'gnus-data))
01c52d31 5097 (id (get-text-property (point) 'gnus-part))
23f87bed 5098 (handles gnus-article-mime-handles)
23f87bed 5099 (description
bbbe940b
MB
5100 (let ((desc (mm-handle-description data)))
5101 (when desc
5102 (mail-decode-encoded-word-string desc))))
88a7a941 5103 (filename (or (mm-handle-filename data) "(none)"))
23f87bed
MB
5104 (type (mm-handle-media-type data)))
5105 (unless data
5106 (error "No MIME part under point"))
5107 (with-current-buffer (mm-handle-buffer data)
e5fa3899 5108 (let ((bsize (buffer-size)))
23f87bed
MB
5109 (erase-buffer)
5110 (insert
5111 (concat
5112 ",----\n"
5113 "| The following attachment has been deleted:\n"
5114 "|\n"
5115 "| Type: " type "\n"
5116 "| Filename: " filename "\n"
e5fa3899
KY
5117 "| Size (encoded): " (format "%s byte%s\n"
5118 bsize (if (= bsize 1)
8ccbef23
G
5119 ""
5120 "s"))
bbbe940b
MB
5121 (when description
5122 (concat "| Description: " description "\n"))
23f87bed
MB
5123 "`----\n"))
5124 (setcdr data
5125 (cdr (mm-make-handle
0cf681b6 5126 nil `("text/plain" (charset . gnus-decoded)) nil nil
23f87bed
MB
5127 (list "attachment")
5128 (format "Deleted attachment (%s bytes)" bsize))))))
01c52d31
MB
5129 ;; (set-buffer gnus-summary-buffer)
5130 (gnus-article-edit-part handles id))))
16409b0b
GM
5131
5132(defun gnus-mime-save-part ()
5133 "Save the MIME part under point."
5134 (interactive)
5135 (gnus-article-check-buffer)
5136 (let ((data (get-text-property (point) 'gnus-data)))
23f87bed
MB
5137 (when data
5138 (mm-save-part data))))
16409b0b 5139
9581ba4d
KY
5140(defun gnus-mime-pipe-part (&optional cmd)
5141 "Pipe the MIME part under point to a process.
5142Use CMD as the process."
16409b0b
GM
5143 (interactive)
5144 (gnus-article-check-buffer)
5145 (let ((data (get-text-property (point) 'gnus-data)))
23f87bed 5146 (when data
9581ba4d 5147 (mm-pipe-part data cmd))))
16409b0b
GM
5148
5149(defun gnus-mime-view-part ()
5150 "Interactively choose a viewing method for the MIME part under point."
5151 (interactive)
5152 (gnus-article-check-buffer)
5153 (let ((data (get-text-property (point) 'gnus-data)))
23f87bed
MB
5154 (when data
5155 (setq gnus-article-mime-handles
5156 (mm-merge-handles
5157 gnus-article-mime-handles (setq data (copy-sequence data))))
5158 (mm-interactively-view-part data))))
16409b0b
GM
5159
5160(defun gnus-mime-view-part-as-type-internal ()
5161 (gnus-article-check-buffer)
54e573e6
MB
5162 (let* ((handle (get-text-property (point) 'gnus-data))
5163 (name (or
5164 ;; Content-Type: foo/bar; name=...
5165 (mail-content-type-get (mm-handle-type handle) 'name)
5166 ;; Content-Disposition: attachment; filename=...
5167 (cdr (assq 'filename (cdr (mm-handle-disposition handle))))))
16409b0b 5168 (def-type (and name (mm-default-file-encoding name))))
01c52d31
MB
5169 (or (and def-type (cons def-type 0))
5170 (and handle
5171 (equal (mm-handle-media-supertype handle) "text")
5172 '("text/plain" . 0))
5173 '("application/octet-stream" . 0))))
16409b0b 5174
54e573e6
MB
5175(defun gnus-mime-view-part-as-type (&optional mime-type pred)
5176 "Choose a MIME media type, and view the part as such.
5177If non-nil, PRED is a predicate to use during completion to limit the
5178available media-types."
23f87bed
MB
5179 (interactive)
5180 (unless mime-type
54e573e6
MB
5181 (setq mime-type
5182 (let ((default (gnus-mime-view-part-as-type-internal)))
229b59da
G
5183 (gnus-completing-read
5184 "View as MIME type"
568f71a8
KY
5185 (if pred
5186 (gnus-remove-if-not pred (mailcap-mime-types))
5187 (mailcap-mime-types))
229b59da 5188 nil nil nil
54e573e6 5189 (car default)))))
16409b0b
GM
5190 (gnus-article-check-buffer)
5191 (let ((handle (get-text-property (point) 'gnus-data)))
23f87bed 5192 (when handle
531bedc3
MB
5193 (when (equal (mm-handle-media-type handle) "message/external-body")
5194 (unless (mm-handle-cache handle)
5195 (mm-extern-cache-contents handle))
5196 (setq handle (mm-handle-cache handle)))
23f87bed
MB
5197 (setq handle
5198 (mm-make-handle (mm-handle-buffer handle)
5199 (cons mime-type (cdr (mm-handle-type handle)))
5200 (mm-handle-encoding handle)
5201 (mm-handle-undisplayer handle)
5202 (mm-handle-disposition handle)
5203 (mm-handle-description handle)
5204 nil
5205 (mm-handle-id handle)))
5206 (setq gnus-article-mime-handles
5207 (mm-merge-handles gnus-article-mime-handles handle))
01c52d31
MB
5208 (when (mm-handle-displayed-p handle)
5209 (mm-remove-part handle))
23f87bed
MB
5210 (gnus-mm-display-part handle))))
5211
01c52d31 5212(defun gnus-mime-copy-part (&optional handle arg)
23f87bed
MB
5213 "Put the MIME part under point into a new buffer.
5214If `auto-compression-mode' is enabled, compressed files like .gz and .bz2
5215are decompressed."
01c52d31 5216 (interactive (list nil current-prefix-arg))
16409b0b 5217 (gnus-article-check-buffer)
01c52d31
MB
5218 (unless handle
5219 (setq handle (get-text-property (point) 'gnus-data)))
5220 (when handle
247c22e1 5221 (let ((filename (mm-handle-filename handle))
01c52d31
MB
5222 contents dont-decode charset coding-system)
5223 (mm-with-unibyte-buffer
5224 (mm-insert-part handle)
5225 (setq contents (or (condition-case nil
5226 (mm-decompress-buffer filename nil 'sig)
5227 (error
5228 (setq dont-decode t)
5229 nil))
5230 (buffer-string))))
5231 (setq filename (cond (filename (file-name-nondirectory filename))
5232 (dont-decode "*raw data*")
5233 (t "*decoded*")))
5234 (cond
5235 (dont-decode)
5236 ((not arg)
5237 (unless (setq charset (mail-content-type-get
5238 (mm-handle-type handle) 'charset))
5239 (unless (setq coding-system (mm-with-unibyte-buffer
5240 (insert contents)
5241 (mm-find-buffer-file-coding-system)))
5242 (setq charset gnus-newsgroup-charset))))
5243 ((numberp arg)
5244 (setq charset (or (cdr (assq arg
5245 gnus-summary-show-article-charset-alist))
5246 (mm-read-coding-system "Charset: ")))))
5247 (switch-to-buffer (generate-new-buffer filename))
5248 (if (or coding-system
5249 (and charset
07178229
KY
5250 (setq coding-system (mm-charset-to-coding-system
5251 charset nil t))
a87ee50b 5252 (not (eq coding-system 'ascii))))
01c52d31
MB
5253 (progn
5254 (mm-enable-multibyte)
5255 (insert (mm-decode-coding-string contents coding-system))
5256 (setq buffer-file-coding-system
5257 (if (boundp 'last-coding-system-used)
5258 (symbol-value 'last-coding-system-used)
5259 coding-system)))
5260 (mm-disable-multibyte)
5261 (insert contents)
5262 (setq buffer-file-coding-system mm-binary-coding-system))
23f87bed
MB
5263 ;; We do it this way to make `normal-mode' set the appropriate mode.
5264 (unwind-protect
5265 (progn
01c52d31 5266 (setq buffer-file-name (expand-file-name filename))
23f87bed
MB
5267 (normal-mode))
5268 (setq buffer-file-name nil))
5269 (goto-char (point-min)))))
5270
5271(defun gnus-mime-print-part (&optional handle filename)
5272 "Print the MIME part under point."
5273 (interactive (list nil (ps-print-preprint current-prefix-arg)))
5274 (gnus-article-check-buffer)
5275 (let* ((handle (or handle (get-text-property (point) 'gnus-data)))
5276 (contents (and handle (mm-get-part handle)))
5277 (file (mm-make-temp-file (expand-file-name "mm." mm-tmp-directory)))
5278 (printer (mailcap-mime-info (mm-handle-media-type handle) "print")))
5279 (when contents
5280 (if printer
5281 (unwind-protect
5282 (progn
5283 (mm-save-part-to-file handle file)
5284 (call-process shell-file-name nil
5285 (generate-new-buffer " *mm*")
5286 nil
5287 shell-command-switch
5288 (mm-mailcap-command
5289 printer file (mm-handle-type handle))))
5290 (delete-file file))
5291 (with-temp-buffer
5292 (insert contents)
5293 (gnus-print-buffer))
5294 (ps-despool filename)))))
16409b0b 5295
e0bad764 5296(defun gnus-mime-inline-part (&optional handle arg)
01c52d31
MB
5297 "Insert the MIME part under point into the current buffer.
5298Compressed files like .gz and .bz2 are decompressed."
e0bad764 5299 (interactive (list nil current-prefix-arg))
16409b0b 5300 (gnus-article-check-buffer)
01c52d31
MB
5301 (unless handle
5302 (setq handle (get-text-property (point) 'gnus-data)))
5303 (when handle
5304 (let ((b (point))
5305 (inhibit-read-only t)
5306 contents charset coding-system)
23f87bed
MB
5307 (if (and (not arg) (mm-handle-undisplayer handle))
5308 (mm-remove-part handle)
01c52d31
MB
5309 (mm-with-unibyte-buffer
5310 (mm-insert-part handle)
5311 (setq contents
247c22e1 5312 (or (mm-decompress-buffer (mm-handle-filename handle) nil t)
01c52d31 5313 (buffer-string))))
23f87bed
MB
5314 (cond
5315 ((not arg)
01c52d31
MB
5316 (unless (setq charset (mail-content-type-get
5317 (mm-handle-type handle) 'charset))
5318 (unless (setq coding-system
5319 (mm-with-unibyte-buffer
5320 (insert contents)
5321 (mm-find-buffer-file-coding-system)))
5322 (setq charset gnus-newsgroup-charset))))
23f87bed
MB
5323 ((numberp arg)
5324 (if (mm-handle-undisplayer handle)
5325 (mm-remove-part handle))
5326 (setq charset
5327 (or (cdr (assq arg
5328 gnus-summary-show-article-charset-alist))
56c30d72 5329 (mm-read-coding-system "Charset: "))))
89b163db
G
5330 ((mm-handle-undisplayer handle)
5331 (mm-remove-part handle)))
23f87bed 5332 (forward-line 2)
6e3165fb 5333 (mm-display-inline handle)
23f87bed
MB
5334 (goto-char b)))))
5335
c0ccb0d6
KY
5336(defun gnus-mime-set-charset-parameters (handle charset)
5337 "Set CHARSET to parameters in HANDLE.
5338CHARSET may either be a string or a symbol."
5339 (unless (stringp charset)
5340 (setq charset (symbol-name charset)))
6b554e88 5341 (if (stringp (car handle))
c0ccb0d6
KY
5342 (dolist (h (cdr handle))
5343 (gnus-mime-set-charset-parameters h charset))
6b554e88
MB
5344 (let* ((type (mm-handle-type (if (equal (mm-handle-media-type handle)
5345 "message/external-body")
5346 (progn
5347 (unless (mm-handle-cache handle)
5348 (mm-extern-cache-contents handle))
5349 (mm-handle-cache handle))
5350 handle)))
c0ccb0d6
KY
5351 (param (assq 'charset (cdr type))))
5352 (if param
5353 (setcdr param charset)
5354 (setcdr type (cons (cons 'charset charset) (cdr type)))))))
6b554e88 5355
23f87bed
MB
5356(defun gnus-mime-view-part-as-charset (&optional handle arg)
5357 "Insert the MIME part under point into the current buffer using the
5358specified charset."
5359 (interactive (list nil current-prefix-arg))
5360 (gnus-article-check-buffer)
163cb72d
MB
5361 (let ((handle (or handle (get-text-property (point) 'gnus-data)))
5362 (fun (get-text-property (point) 'gnus-callback))
5363 (gnus-newsgroup-ignored-charsets 'gnus-all)
c0ccb0d6 5364 charset form preferred parts)
23f87bed 5365 (when handle
01c52d31
MB
5366 (when (prog1
5367 (and fun
c0ccb0d6 5368 (setq charset
01c52d31
MB
5369 (or (cdr (assq
5370 arg
5371 gnus-summary-show-article-charset-alist))
5372 (mm-read-coding-system "Charset: "))))
5373 (if (mm-handle-undisplayer handle)
5374 (mm-remove-part handle)))
c0ccb0d6 5375 (gnus-mime-set-charset-parameters handle charset)
6b554e88
MB
5376 (when (and (consp (setq form (cdr-safe fun)))
5377 (setq form (ignore-errors
5378 (assq 'gnus-mime-display-alternative form)))
5379 (setq preferred (caddr form))
5380 (progn
5381 (when (eq (car preferred) 'quote)
5382 (setq preferred (cadr preferred)))
5383 (not (equal preferred
5384 (get-text-property (point) 'gnus-data))))
5385 (setq parts (get-text-property (point) 'gnus-part))
5386 (setq parts (cdr (assq parts
5387 gnus-article-mime-handle-alist)))
5388 (equal (mm-handle-media-type parts) "multipart/alternative")
5389 (setq parts (reverse (cdr parts))))
5390 (setcar (cddr form)
5391 (list 'quote (or (cadr (member preferred parts))
5392 (car parts)))))
163cb72d 5393 (funcall fun handle)))))
23f87bed
MB
5394
5395(defun gnus-mime-view-part-externally (&optional handle)
16409b0b
GM
5396 "View the MIME part under point with an external viewer."
5397 (interactive)
5398 (gnus-article-check-buffer)
5399 (let* ((handle (or handle (get-text-property (point) 'gnus-data)))
5400 (mm-user-display-methods nil)
5401 (mm-inlined-types nil)
5402 (mail-parse-charset gnus-newsgroup-charset)
a1506d29 5403 (mail-parse-ignored-charsets
54e573e6
MB
5404 (with-current-buffer gnus-summary-buffer
5405 gnus-newsgroup-ignored-charsets))
5406 (type (mm-handle-media-type handle))
5407 (method (mailcap-mime-info type))
5408 (mm-enable-external t))
5409 (if (not (stringp method))
5410 (gnus-mime-view-part-as-type
f7aa0b8f 5411 nil (lambda (type) (stringp (mailcap-mime-info type))))
54e573e6 5412 (when handle
a87ee50b 5413 (mm-display-part handle nil t)))))
16409b0b 5414
23f87bed 5415(defun gnus-mime-view-part-internally (&optional handle)
16409b0b 5416 "View the MIME part under point with an internal viewer.
23f87bed 5417If no internal viewer is available, use an external viewer."
16409b0b
GM
5418 (interactive)
5419 (gnus-article-check-buffer)
5420 (let* ((handle (or handle (get-text-property (point) 'gnus-data)))
5421 (mm-inlined-types '(".*"))
5422 (mm-inline-large-images t)
5423 (mail-parse-charset gnus-newsgroup-charset)
a1506d29 5424 (mail-parse-ignored-charsets
54e573e6
MB
5425 (with-current-buffer gnus-summary-buffer
5426 gnus-newsgroup-ignored-charsets))
23f87bed 5427 (inhibit-read-only t))
54e573e6
MB
5428 (if (not (mm-inlinable-p handle))
5429 (gnus-mime-view-part-as-type
f7aa0b8f 5430 nil (lambda (type) (mm-inlinable-p handle type)))
54e573e6 5431 (when handle
a87ee50b 5432 (gnus-bind-safe-url-regexp (mm-display-part handle))))))
16409b0b 5433
e0bad764
DL
5434(defun gnus-mime-action-on-part (&optional action)
5435 "Do something with the MIME attachment at \(point\)."
5436 (interactive
229b59da 5437 (list (gnus-completing-read "Action" (mapcar 'car gnus-mime-action-alist) t)))
e0bad764
DL
5438 (gnus-article-check-buffer)
5439 (let ((action-pair (assoc action gnus-mime-action-alist)))
5440 (if action-pair
5441 (funcall (cdr action-pair)))))
5442
01c52d31
MB
5443(defun gnus-article-part-wrapper (n function &optional no-handle interactive)
5444 "Call FUNCTION on MIME part N.
c7015153
JB
5445Unless NO-HANDLE, call FUNCTION with N-th MIME handle as its only argument.
5446If INTERACTIVE, call FUNCTION interactively."
01c52d31
MB
5447 (let (window frame)
5448 ;; Check whether the article is displayed.
5449 (unless (and (gnus-buffer-live-p gnus-article-buffer)
5450 (setq window (get-buffer-window gnus-article-buffer t))
5451 (frame-visible-p (setq frame (window-frame window))))
5452 (error "No article is displayed"))
5453 (with-current-buffer gnus-article-buffer
5454 ;; Check whether the article displays the right contents.
5455 (unless (with-current-buffer gnus-summary-buffer
5456 (eq gnus-current-article (gnus-summary-article-number)))
5457 (error "You should select the right article first"))
5458 (if n
5459 (setq n (prefix-numeric-value n))
5460 (let ((pt (point)))
5461 (setq n (or (get-text-property pt 'gnus-part)
5462 (and (not (bobp))
5463 (get-text-property (1- pt) 'gnus-part))
5464 (get-text-property (prog2
5465 (forward-line 1)
5466 (point)
5467 (goto-char pt))
5468 'gnus-part)
5469 (get-text-property
5470 (or (and (setq pt (previous-single-property-change
5471 pt 'gnus-part))
5472 (1- pt))
5473 (next-single-property-change (point) 'gnus-part)
5474 (point))
5475 'gnus-part)
5476 1))))
5477 ;; Check whether the specified part exists.
5478 (when (> n (length gnus-article-mime-handle-alist))
5479 (error "No such part")))
5480 (unless
5481 (progn
5482 ;; To select the window is needed so that the cursor
5483 ;; might be visible on the MIME button.
5484 (select-window (prog1
5485 window
5486 (setq window (selected-window))
5487 ;; Article may be displayed in the other frame.
5488 (gnus-select-frame-set-input-focus
5489 (prog1
5490 frame
5491 (setq frame (selected-frame))))))
5492 (when (gnus-article-goto-part n)
5493 ;; We point the cursor and the arrow at the MIME button
5494 ;; when the `function' prompt the user for something.
a87ee50b
KY
5495 (unless (and (pos-visible-in-window-p)
5496 (> (count-lines (point) (window-end))
5497 (/ (1- (window-height)) 3)))
5498 (recenter (/ (1- (window-height)) 3)))
01c52d31
MB
5499 (let ((cursor-in-non-selected-windows t)
5500 (overlay-arrow-string "=>")
5501 (overlay-arrow-position (point-marker)))
5502 (unwind-protect
5503 (cond
5504 ((and no-handle interactive)
5505 (call-interactively function))
5506 (no-handle
5507 (funcall function))
5508 (interactive
5509 (call-interactively
a87ee50b 5510 function (get-text-property (point) 'gnus-data)))
01c52d31
MB
5511 (t
5512 (funcall function
a87ee50b 5513 (get-text-property (point) 'gnus-data))))
01c52d31
MB
5514 (set-marker overlay-arrow-position nil)
5515 (unless gnus-auto-select-part
5516 (gnus-select-frame-set-input-focus frame)
5517 (select-window window))))
5518 t))
5519 (if gnus-inhibit-mime-unbuttonizing
5520 ;; This is the default though the program shouldn't reach here.
5521 (error "No such part")
5522 ;; The part which doesn't have the MIME button is selected.
5523 ;; So, we display all the buttons and redo it.
5524 (let ((gnus-inhibit-mime-unbuttonizing t))
5525 (gnus-summary-show-article)
5526 (gnus-article-part-wrapper n function no-handle))))))
16409b0b
GM
5527
5528(defun gnus-article-pipe-part (n)
5529 "Pipe MIME part N, which is the numerical prefix."
01c52d31 5530 (interactive "P")
16409b0b
GM
5531 (gnus-article-part-wrapper n 'mm-pipe-part))
5532
5533(defun gnus-article-save-part (n)
5534 "Save MIME part N, which is the numerical prefix."
01c52d31 5535 (interactive "P")
16409b0b
GM
5536 (gnus-article-part-wrapper n 'mm-save-part))
5537
5538(defun gnus-article-interactively-view-part (n)
5539 "View MIME part N interactively, which is the numerical prefix."
01c52d31 5540 (interactive "P")
16409b0b
GM
5541 (gnus-article-part-wrapper n 'mm-interactively-view-part))
5542
5543(defun gnus-article-copy-part (n)
5544 "Copy MIME part N, which is the numerical prefix."
01c52d31 5545 (interactive "P")
16409b0b
GM
5546 (gnus-article-part-wrapper n 'gnus-mime-copy-part))
5547
23f87bed
MB
5548(defun gnus-article-view-part-as-charset (n)
5549 "View MIME part N using a specified charset.
5550N is the numerical prefix."
01c52d31 5551 (interactive "P")
23f87bed
MB
5552 (gnus-article-part-wrapper n 'gnus-mime-view-part-as-charset))
5553
5554(defun gnus-article-view-part-externally (n)
16409b0b 5555 "View MIME part N externally, which is the numerical prefix."
01c52d31 5556 (interactive "P")
23f87bed 5557 (gnus-article-part-wrapper n 'gnus-mime-view-part-externally))
16409b0b
GM
5558
5559(defun gnus-article-inline-part (n)
5560 "Inline MIME part N, which is the numerical prefix."
01c52d31 5561 (interactive "P")
16409b0b
GM
5562 (gnus-article-part-wrapper n 'gnus-mime-inline-part))
5563
01c52d31
MB
5564(defun gnus-article-save-part-and-strip (n)
5565 "Save MIME part N and replace it with an external body.
5566N is the numerical prefix."
5567 (interactive "P")
5568 (gnus-article-part-wrapper n 'gnus-mime-save-part-and-strip t))
5569
5570(defun gnus-article-replace-part (n)
5571 "Replace MIME part N with an external body.
5572N is the numerical prefix."
5573 (interactive "P")
5574 (gnus-article-part-wrapper n 'gnus-mime-replace-part t t))
5575
5576(defun gnus-article-delete-part (n)
5577 "Delete MIME part N and add some information about the removed part.
5578N is the numerical prefix."
5579 (interactive "P")
5580 (gnus-article-part-wrapper n 'gnus-mime-delete-part t))
5581
5582(defun gnus-article-view-part-as-type (n)
5583 "Choose a MIME media type, and view part N as such.
5584N is the numerical prefix."
5585 (interactive "P")
5586 (gnus-article-part-wrapper n 'gnus-mime-view-part-as-type t))
5587
16409b0b
GM
5588(defun gnus-article-mime-match-handle-first (condition)
5589 (if condition
01c52d31
MB
5590 (let (n)
5591 (dolist (ihandle gnus-article-mime-handle-alist)
a1506d29 5592 (if (and (cond
16409b0b
GM
5593 ((functionp condition)
5594 (funcall condition (cdr ihandle)))
a1506d29 5595 ((eq condition 'undisplayed)
16409b0b
GM
5596 (not (or (mm-handle-undisplayer (cdr ihandle))
5597 (equal (mm-handle-media-type (cdr ihandle))
5598 "multipart/alternative"))))
5599 ((eq condition 'undisplayed-alternative)
5600 (not (mm-handle-undisplayer (cdr ihandle))))
5601 (t t))
5602 (gnus-article-goto-part (car ihandle))
5603 (or (not n) (< (car ihandle) n)))
5604 (setq n (car ihandle))))
5605 (or n 1))
5606 1))
5607
5608(defun gnus-article-view-part (&optional n)
47fe149b
KY
5609 "View MIME part N, which is the numerical prefix.
5610If the part is already shown, hide the part. If N is nil, view
5611all parts."
16409b0b 5612 (interactive "P")
01c52d31 5613 (with-current-buffer gnus-article-buffer
a1506d29 5614 (or (numberp n) (setq n (gnus-article-mime-match-handle-first
16409b0b
GM
5615 gnus-article-mime-match-handle-function)))
5616 (when (> n (length gnus-article-mime-handle-alist))
5617 (error "No such part"))
5618 (let ((handle (cdr (assq n gnus-article-mime-handle-alist))))
5619 (when (gnus-article-goto-part n)
5620 (if (equal (car handle) "multipart/alternative")
71f56da2
KY
5621 (progn
5622 (beginning-of-line) ;; Make it toggle subparts
5623 (gnus-article-press-button))
16409b0b
GM
5624 (when (eq (gnus-mm-display-part handle) 'internal)
5625 (gnus-set-window-start)))))))
5626
e0bad764
DL
5627(defsubst gnus-article-mime-total-parts ()
5628 (if (bufferp (car gnus-article-mime-handles))
5629 1 ;; single part
5630 (1- (length gnus-article-mime-handles))))
5631
16409b0b
GM
5632(defun gnus-mm-display-part (handle)
5633 "Display HANDLE and fix MIME button."
5634 (let ((id (get-text-property (point) 'gnus-part))
5635 (point (point))
23f87bed 5636 (inhibit-read-only t))
16409b0b
GM
5637 (forward-line 1)
5638 (prog1
5639 (let ((window (selected-window))
5640 (mail-parse-charset gnus-newsgroup-charset)
a1506d29 5641 (mail-parse-ignored-charsets
23f87bed 5642 (if (gnus-buffer-live-p gnus-summary-buffer)
01c52d31 5643 (with-current-buffer gnus-summary-buffer
23f87bed
MB
5644 gnus-newsgroup-ignored-charsets)
5645 nil)))
16409b0b
GM
5646 (save-excursion
5647 (unwind-protect
23f87bed 5648 (let ((win (gnus-get-buffer-window (current-buffer) t))
16409b0b
GM
5649 (beg (point)))
5650 (when win
5651 (select-window win))
5652 (goto-char point)
5653 (forward-line)
5654 (if (mm-handle-displayed-p handle)
5655 ;; This will remove the part.
5656 (mm-display-part handle)
5657 (save-restriction
23f87bed
MB
5658 (narrow-to-region (point)
5659 (if (eobp) (point) (1+ (point))))
b0b63450 5660 (gnus-bind-safe-url-regexp (mm-display-part handle))
16409b0b
GM
5661 ;; We narrow to the part itself and
5662 ;; then call the treatment functions.
5663 (goto-char (point-min))
5664 (forward-line 1)
5665 (narrow-to-region (point) (point-max))
5666 (gnus-treat-article
5667 nil id
e0bad764 5668 (gnus-article-mime-total-parts)
16409b0b 5669 (mm-handle-media-type handle)))))
23f87bed
MB
5670 (if (window-live-p window)
5671 (select-window window)))))
16409b0b 5672 (goto-char point)
23f87bed 5673 (gnus-delete-line)
16409b0b
GM
5674 (gnus-insert-mime-button
5675 handle id (list (mm-handle-displayed-p handle)))
5676 (goto-char point))))
5677
5678(defun gnus-article-goto-part (n)
5679 "Go to MIME part N."
9efcd224
KY
5680 (when gnus-break-pages
5681 (widen))
95de0327
KY
5682 (prog1
5683 (let ((start (text-property-any (point-min) (point-max) 'gnus-part n))
5684 part handle end next handles)
5685 (when start
5686 (goto-char start)
5687 (if (setq handle (get-text-property start 'gnus-data))
5688 start
5689 ;; Go to the displayed subpart, assuming this is
5690 ;; multipart/alternative.
5691 (setq part start
5692 end (point-at-eol))
5693 (while (and (not handle)
5694 part
5695 (< part end)
5696 (setq next (text-property-not-all part end
5697 'gnus-data nil)))
5698 (setq part next
5699 handle (get-text-property part 'gnus-data))
5700 (push (cons handle part) handles)
5701 (unless (mm-handle-displayed-p handle)
5702 (setq handle nil
5703 part (text-property-any part end 'gnus-data nil))))
5704 (unless handle
5705 ;; No subpart is displayed, so we find preferred one.
5706 (setq part
5707 (cdr (assq (mm-preferred-alternative
5708 (nreverse (mapcar 'car handles)))
5709 handles))))
5710 (if part
5711 (goto-char (1+ part))
5712 start))))
5713 (when gnus-break-pages
5714 (gnus-narrow-to-page))))
16409b0b
GM
5715
5716(defun gnus-insert-mime-button (handle gnus-tmp-id &optional displayed)
5717 (let ((gnus-tmp-name
247c22e1 5718 (or (mm-handle-filename handle)
23f87bed 5719 (mail-content-type-get (mm-handle-type handle) 'url)
16409b0b
GM
5720 ""))
5721 (gnus-tmp-type (mm-handle-media-type handle))
4599d0ec 5722 (gnus-tmp-description (or (mm-handle-description handle) ""))
16409b0b
GM
5723 (gnus-tmp-dots
5724 (if (if displayed (car displayed)
5725 (mm-handle-displayed-p handle))
5726 "" "..."))
5727 (gnus-tmp-length (with-current-buffer (mm-handle-buffer handle)
5728 (buffer-size)))
5729 gnus-tmp-type-long b e)
5730 (when (string-match ".*/" gnus-tmp-name)
5731 (setq gnus-tmp-name (replace-match "" t t gnus-tmp-name)))
5732 (setq gnus-tmp-type-long (concat gnus-tmp-type
5733 (and (not (equal gnus-tmp-name ""))
5734 (concat "; " gnus-tmp-name))))
23f87bed
MB
5735 (unless (equal gnus-tmp-description "")
5736 (setq gnus-tmp-type-long (concat " --- " gnus-tmp-type-long)))
16409b0b
GM
5737 (unless (bolp)
5738 (insert "\n"))
5739 (setq b (point))
5740 (gnus-eval-format
5741 gnus-mime-button-line-format gnus-mime-button-line-format-alist
01c52d31
MB
5742 `(keymap ,gnus-mime-button-map
5743 gnus-callback gnus-mm-display-part
5744 gnus-part ,gnus-tmp-id
5745 article-type annotation
f0867027
KY
5746 gnus-data ,handle
5747 rear-nonsticky t))
23f87bed
MB
5748 (setq e (if (bolp)
5749 ;; Exclude a newline.
5750 (1- (point))
5751 (point)))
01c52d31
MB
5752 (when gnus-article-button-face
5753 (gnus-overlay-put (gnus-make-overlay b e nil t)
5754 'face gnus-article-button-face))
16409b0b
GM
5755 (widget-convert-button
5756 'link b e
5757 :mime-handle handle
5758 :action 'gnus-widget-press-button
5759 :button-keymap gnus-mime-button-map
5760 :help-echo
5843126b 5761 (lambda (widget)
16409b0b
GM
5762 ;; Needed to properly clear the message due to a bug in
5763 ;; wid-edit (XEmacs only).
5764 (if (boundp 'help-echo-owns-message)
5765 (setq help-echo-owns-message t))
5766 (format
5767 "%S: %s the MIME part; %S: more options"
5768 (aref gnus-mouse-2 0)
5843126b 5769 (if (mm-handle-displayed-p (widget-get widget :mime-handle))
16409b0b
GM
5770 "hide" "show")
5771 (aref gnus-down-mouse-3 0))))))
5772
5773(defun gnus-widget-press-button (elems el)
5774 (goto-char (widget-get elems :from))
5775 (gnus-article-press-button))
5776
5777(defvar gnus-displaying-mime nil)
5778
5779(defun gnus-display-mime (&optional ihandles)
5780 "Display the MIME parts."
5781 (save-excursion
5782 (save-selected-window
5783 (let ((window (get-buffer-window gnus-article-buffer))
5784 (point (point)))
5785 (when window
5786 (select-window window)
5787 ;; We have to do this since selecting the window
5788 ;; may change the point. So we set the window point.
5789 (set-window-point window point)))
73043f7d
MB
5790 (let ((handles ihandles)
5791 (inhibit-read-only t)
5792 handle)
5793 (cond (handles)
5794 ((setq handles (mm-dissect-buffer nil gnus-article-loose-mime))
5795 (when gnus-article-emulate-mime
5796 (mm-uu-dissect-text-parts handles)))
5797 (gnus-article-emulate-mime
5798 (setq handles (mm-uu-dissect))))
16409b0b
GM
5799 (when (and (not ihandles)
5800 (not gnus-displaying-mime))
5801 ;; Top-level call; we clean up.
5802 (when gnus-article-mime-handles
5803 (mm-destroy-parts gnus-article-mime-handles)
5804 (setq gnus-article-mime-handle-alist nil));; A trick.
5805 (setq gnus-article-mime-handles handles)
5806 ;; We allow users to glean info from the handles.
5807 (when gnus-article-mime-part-function
5808 (gnus-mime-part-function handles)))
5809 (if (and handles
5810 (or (not (stringp (car handles)))
5811 (cdr handles)))
5812 (progn
5813 (when (and (not ihandles)
5814 (not gnus-displaying-mime))
5815 ;; Clean up for mime parts.
5816 (article-goto-body)
5817 (delete-region (point) (point-max)))
5818 (let ((gnus-displaying-mime t))
5819 (gnus-mime-display-part handles)))
5820 (save-restriction
5821 (article-goto-body)
5822 (narrow-to-region (point) (point-max))
389b76fa 5823 (gnus-treat-article nil 1 1 "text/plain")
16409b0b
GM
5824 (widen)))
5825 (unless ihandles
5826 ;; Highlight the headers.
5827 (save-excursion
5828 (save-restriction
5829 (article-goto-body)
5830 (narrow-to-region (point-min) (point))
31640842 5831 (gnus-article-save-original-date
f362b760
MB
5832 (gnus-treat-article 'head)))))))
5833 ;; Cope with broken MIME messages.
5834 (goto-char (point-max))
5835 (unless (bolp)
5836 (insert "\n"))))
16409b0b 5837
23f87bed
MB
5838(defcustom gnus-mime-display-multipart-as-mixed nil
5839 "Display \"multipart\" parts as \"multipart/mixed\".
5840
5841If t, it overrides nil values of
5842`gnus-mime-display-multipart-alternative-as-mixed' and
5843`gnus-mime-display-multipart-related-as-mixed'."
5844 :group 'gnus-article-mime
5845 :type 'boolean)
5846
5847(defcustom gnus-mime-display-multipart-alternative-as-mixed nil
5848 "Display \"multipart/alternative\" parts as \"multipart/mixed\"."
bf247b6e 5849 :version "22.1"
23f87bed
MB
5850 :group 'gnus-article-mime
5851 :type 'boolean)
5852
5853(defcustom gnus-mime-display-multipart-related-as-mixed nil
5854 "Display \"multipart/related\" parts as \"multipart/mixed\".
5855
5856If displaying \"text/html\" is discouraged \(see
5857`mm-discouraged-alternatives'\) images or other material inside a
5858\"multipart/related\" part might be overlooked when this variable is nil."
bf247b6e 5859 :version "22.1"
23f87bed
MB
5860 :group 'gnus-article-mime
5861 :type 'boolean)
16409b0b
GM
5862
5863(defun gnus-mime-display-part (handle)
5864 (cond
430d3ed7
MB
5865 ;; Maybe a broken MIME message.
5866 ((null handle))
16409b0b
GM
5867 ;; Single part.
5868 ((not (stringp (car handle)))
5869 (gnus-mime-display-single handle))
5870 ;; User-defined multipart
5871 ((cdr (assoc (car handle) gnus-mime-multipart-functions))
5872 (funcall (cdr (assoc (car handle) gnus-mime-multipart-functions))
5873 handle))
5874 ;; multipart/alternative
5875 ((and (equal (car handle) "multipart/alternative")
23f87bed
MB
5876 (not (or gnus-mime-display-multipart-as-mixed
5877 gnus-mime-display-multipart-alternative-as-mixed)))
16409b0b
GM
5878 (let ((id (1+ (length gnus-article-mime-handle-alist))))
5879 (push (cons id handle) gnus-article-mime-handle-alist)
5880 (gnus-mime-display-alternative (cdr handle) nil nil id)))
5881 ;; multipart/related
5882 ((and (equal (car handle) "multipart/related")
23f87bed
MB
5883 (not (or gnus-mime-display-multipart-as-mixed
5884 gnus-mime-display-multipart-related-as-mixed)))
16409b0b
GM
5885 ;;;!!!We should find the start part, but we just default
5886 ;;;!!!to the first part.
23f87bed
MB
5887 ;;(gnus-mime-display-part (cadr handle))
5888 ;;;!!! Most multipart/related is an HTML message plus images.
5889 ;;;!!! Unfortunately we are unable to let W3 display those
5890 ;;;!!! included images, so we just display it as a mixed multipart.
5891 ;;(gnus-mime-display-mixed (cdr handle))
5892 ;;;!!! No, w3 can display everything just fine.
16409b0b 5893 (gnus-mime-display-part (cadr handle)))
23f87bed
MB
5894 ((equal (car handle) "multipart/signed")
5895 (gnus-add-wash-type 'signed)
5896 (gnus-mime-display-security handle))
5897 ((equal (car handle) "multipart/encrypted")
5898 (gnus-add-wash-type 'encrypted)
5899 (gnus-mime-display-security handle))
16409b0b
GM
5900 ;; Other multiparts are handled like multipart/mixed.
5901 (t
5902 (gnus-mime-display-mixed (cdr handle)))))
5903
5904(defun gnus-mime-part-function (handles)
5905 (if (stringp (car handles))
5906 (mapcar 'gnus-mime-part-function (cdr handles))
5907 (funcall gnus-article-mime-part-function handles)))
5908
5909(defun gnus-mime-display-mixed (handles)
5910 (mapcar 'gnus-mime-display-part handles))
5911
5912(defun gnus-mime-display-single (handle)
5913 (let ((type (mm-handle-media-type handle))
5914 (ignored gnus-ignored-mime-types)
5915 (not-attachment t)
5916 (move nil)
5917 display text)
5918 (catch 'ignored
5919 (progn
5920 (while ignored
5921 (when (string-match (pop ignored) type)
5922 (throw 'ignored nil)))
b59a9eef
KY
5923 (if (and (not (and (if (gnus-buffer-live-p gnus-summary-buffer)
5924 (with-current-buffer gnus-summary-buffer
5925 gnus-inhibit-images)
5926 gnus-inhibit-images)
40de2c6d
KY
5927 (string-match "\\`image/" type)))
5928 (setq not-attachment
16409b0b
GM
5929 (and (not (mm-inline-override-p handle))
5930 (or (not (mm-handle-disposition handle))
5931 (equal (car (mm-handle-disposition handle))
5932 "inline")
5933 (mm-attachment-override-p handle))))
5934 (mm-automatic-display-p handle)
23f87bed
MB
5935 (or (and
5936 (mm-inlinable-p handle)
5937 (mm-inlined-p handle))
16409b0b
GM
5938 (mm-automatic-external-display-p type)))
5939 (setq display t)
5940 (when (equal (mm-handle-media-supertype handle) "text")
5941 (setq text t)))
e0bad764
DL
5942 (let ((id (1+ (length gnus-article-mime-handle-alist)))
5943 beg)
16409b0b 5944 (push (cons id handle) gnus-article-mime-handle-alist)
531bedc3
MB
5945 (when (and display
5946 (equal (mm-handle-media-supertype handle) "message"))
5947 (insert-char
5948 ?\n
5949 (cond ((not (bolp)) 2)
5950 ((or (bobp) (eq (char-before (1- (point))) ?\n)) 0)
5951 (t 1))))
16409b0b 5952 (when (or (not display)
3e3ab3ab
KY
5953 (not (gnus-unbuttonized-mime-type-p type))
5954 (eq id gnus-mime-buttonized-part-id))
16409b0b
GM
5955 (gnus-insert-mime-button
5956 handle id (list (or display (and not-attachment text))))
5957 (gnus-article-insert-newline)
23f87bed 5958 ;; Remember modify the number of forward lines.
e0bad764
DL
5959 (setq move t))
5960 (setq beg (point))
16409b0b
GM
5961 (cond
5962 (display
5963 (when move
23f87bed 5964 (forward-line -1)
16409b0b
GM
5965 (setq beg (point)))
5966 (let ((mail-parse-charset gnus-newsgroup-charset)
a1506d29 5967 (mail-parse-ignored-charsets
16409b0b
GM
5968 (save-excursion (condition-case ()
5969 (set-buffer gnus-summary-buffer)
5970 (error))
5971 gnus-newsgroup-ignored-charsets)))
b0b63450 5972 (gnus-bind-safe-url-regexp (mm-display-part handle t)))
16409b0b
GM
5973 (goto-char (point-max)))
5974 ((and text not-attachment)
5975 (when move
23f87bed 5976 (forward-line -1)
16409b0b
GM
5977 (setq beg (point)))
5978 (gnus-article-insert-newline)
f205c6e7 5979 (mm-display-inline handle)
16409b0b
GM
5980 (goto-char (point-max))))
5981 ;; Do highlighting.
5982 (save-excursion
5983 (save-restriction
5984 (narrow-to-region beg (point))
01c52d31
MB
5985 (if (eq handle gnus-article-mime-handles)
5986 ;; The format=flowed case.
5987 (gnus-treat-article nil 1 1 (mm-handle-media-type handle))
5988 ;; Don't count signature parts that are never displayed.
5989 ;; The part number should be re-calculated supposing this
5990 ;; might be a message/rfc822 part.
5991 (let (handles)
5992 (dolist (part gnus-article-mime-handles)
5993 (unless (or (stringp part)
5994 (equal (car (mm-handle-type part))
5995 "application/pgp-signature"))
5996 (push part handles)))
5997 (gnus-treat-article
5998 nil (length (memq handle handles)) (length handles)
5999 (mm-handle-media-type handle)))))))))))
16409b0b
GM
6000
6001(defun gnus-unbuttonized-mime-type-p (type)
6002 "Say whether TYPE is to be unbuttonized."
6003 (unless gnus-inhibit-mime-unbuttonizing
23f87bed
MB
6004 (when (catch 'found
6005 (let ((types gnus-unbuttonized-mime-types))
6006 (while types
6007 (when (string-match (pop types) type)
6008 (throw 'found t)))))
6009 (not (catch 'found
6010 (let ((types gnus-buttonized-mime-types))
6011 (while types
6012 (when (string-match (pop types) type)
6013 (throw 'found t)))))))))
16409b0b
GM
6014
6015(defun gnus-article-insert-newline ()
6016 "Insert a newline, but mark it as undeletable."
6017 (gnus-put-text-property
6018 (point) (progn (insert "\n") (point)) 'gnus-undeletable t))
6019
6020(defun gnus-mime-display-alternative (handles &optional preferred ibegend id)
6021 (let* ((preferred (or preferred (mm-preferred-alternative handles)))
6022 (ihandles handles)
6023 (point (point))
23f87bed 6024 handle (inhibit-read-only t) from props begend not-pref)
16409b0b
GM
6025 (save-window-excursion
6026 (save-restriction
6027 (when ibegend
6028 (narrow-to-region (car ibegend)
6029 (or (cdr ibegend)
6030 (progn
6031 (goto-char (car ibegend))
6032 (forward-line 2)
6033 (point))))
6034 (delete-region (point-min) (point-max))
6035 (mm-remove-parts handles))
6036 (setq begend (list (point-marker)))
6037 ;; Do the toggle.
6038 (unless (setq not-pref (cadr (member preferred ihandles)))
6039 (setq not-pref (car ihandles)))
6040 (when (or ibegend
23f87bed 6041 (not preferred)
16409b0b
GM
6042 (not (gnus-unbuttonized-mime-type-p
6043 "multipart/alternative")))
6044 (gnus-add-text-properties
6045 (setq from (point))
6046 (progn
6047 (insert (format "%d. " id))
6048 (point))
6049 `(gnus-callback
6050 (lambda (handles)
6051 (unless ,(not ibegend)
6052 (setq gnus-article-mime-handle-alist
6053 ',gnus-article-mime-handle-alist))
6054 (gnus-mime-display-alternative
6055 ',ihandles ',not-pref ',begend ,id))
01c52d31 6056 keymap ,gnus-mime-button-map
16409b0b
GM
6057 ,gnus-mouse-face-prop ,gnus-article-mouse-face
6058 face ,gnus-article-button-face
16409b0b 6059 gnus-part ,id
f0867027
KY
6060 article-type multipart
6061 rear-nonsticky t))
16409b0b
GM
6062 (widget-convert-button 'link from (point)
6063 :action 'gnus-widget-press-button
6064 :button-keymap gnus-widget-button-keymap)
6065 ;; Do the handles
6066 (while (setq handle (pop handles))
6067 (gnus-add-text-properties
6068 (setq from (point))
6069 (progn
6070 (insert (format "(%c) %-18s"
6071 (if (equal handle preferred) ?* ? )
6072 (mm-handle-media-type handle)))
6073 (point))
6074 `(gnus-callback
6075 (lambda (handles)
6076 (unless ,(not ibegend)
6077 (setq gnus-article-mime-handle-alist
6078 ',gnus-article-mime-handle-alist))
6079 (gnus-mime-display-alternative
6080 ',ihandles ',handle ',begend ,id))
01c52d31 6081 keymap ,gnus-mime-button-map
16409b0b
GM
6082 ,gnus-mouse-face-prop ,gnus-article-mouse-face
6083 face ,gnus-article-button-face
16409b0b 6084 gnus-part ,id
f0867027
KY
6085 gnus-data ,handle
6086 rear-nonsticky t))
16409b0b
GM
6087 (widget-convert-button 'link from (point)
6088 :action 'gnus-widget-press-button
6089 :button-keymap gnus-widget-button-keymap)
6090 (insert " "))
6091 (insert "\n\n"))
6092 (when preferred
6093 (if (stringp (car preferred))
6094 (gnus-display-mime preferred)
6095 (let ((mail-parse-charset gnus-newsgroup-charset)
a1506d29 6096 (mail-parse-ignored-charsets
01c52d31
MB
6097 (with-current-buffer gnus-summary-buffer
6098 gnus-newsgroup-ignored-charsets)))
b0b63450 6099 (gnus-bind-safe-url-regexp (mm-display-part preferred))
16409b0b
GM
6100 ;; Do highlighting.
6101 (save-excursion
6102 (save-restriction
6103 (narrow-to-region (car begend) (point-max))
6104 (gnus-treat-article
6105 nil (length gnus-article-mime-handle-alist)
e0bad764 6106 (gnus-article-mime-total-parts)
389b76fa 6107 (mm-handle-media-type preferred))))))
16409b0b
GM
6108 (goto-char (point-max))
6109 (setcdr begend (point-marker)))))
6110 (when ibegend
6111 (goto-char point))))
6112
23f87bed
MB
6113(defconst gnus-article-wash-status-strings
6114 (let ((alist '((cite "c" "Possible hidden citation text"
6115 " " "All citation text visible")
6116 (headers "h" "Hidden headers"
6117 " " "All headers visible.")
6118 (pgp "p" "Encrypted or signed message status hidden"
6119 " " "No hidden encryption nor digital signature status")
6120 (signature "s" "Signature has been hidden"
6121 " " "Signature is visible")
6122 (overstrike "o" "Overstrike (^H) characters applied"
6123 " " "No overstrike characters applied")
6124 (emphasis "e" "/*_Emphasis_*/ characters applied"
6125 " " "No /*_emphasis_*/ characters applied")))
6126 result)
6127 (dolist (entry alist result)
6128 (let ((key (nth 0 entry))
6129 (on (copy-sequence (nth 1 entry)))
6130 (on-help (nth 2 entry))
6131 (off (copy-sequence (nth 3 entry)))
6132 (off-help (nth 4 entry)))
6133 (put-text-property 0 1 'help-echo on-help on)
6134 (put-text-property 0 1 'help-echo off-help off)
6135 (push (list key on off) result))))
6136 "Alist of strings describing wash status in the mode line.
6137Each entry has the form (KEY ON OF), where the KEY is a symbol
6138representing the particular washing function, ON is the string to use
6139in the article mode line when the washing function is active, and OFF
6140is the string to use when it is inactive.")
6141
6142(defun gnus-article-wash-status-entry (key value)
6143 (let ((entry (assoc key gnus-article-wash-status-strings)))
6144 (if value (nth 1 entry) (nth 2 entry))))
6145
eec82323
LMI
6146(defun gnus-article-wash-status ()
6147 "Return a string which display status of article washing."
01c52d31 6148 (with-current-buffer gnus-article-buffer
16409b0b
GM
6149 (let ((cite (memq 'cite gnus-article-wash-types))
6150 (headers (memq 'headers gnus-article-wash-types))
6151 (boring (memq 'boring-headers gnus-article-wash-types))
6152 (pgp (memq 'pgp gnus-article-wash-types))
6153 (pem (memq 'pem gnus-article-wash-types))
23f87bed
MB
6154 (signed (memq 'signed gnus-article-wash-types))
6155 (encrypted (memq 'encrypted gnus-article-wash-types))
16409b0b
GM
6156 (signature (memq 'signature gnus-article-wash-types))
6157 (overstrike (memq 'overstrike gnus-article-wash-types))
6158 (emphasis (memq 'emphasis gnus-article-wash-types)))
23f87bed
MB
6159 (concat
6160 (gnus-article-wash-status-entry 'cite cite)
6161 (gnus-article-wash-status-entry 'headers (or headers boring))
6162 (gnus-article-wash-status-entry 'pgp (or pgp pem signed encrypted))
6163 (gnus-article-wash-status-entry 'signature signature)
6164 (gnus-article-wash-status-entry 'overstrike overstrike)
6165 (gnus-article-wash-status-entry 'emphasis emphasis)))))
6166
6167(defun gnus-add-wash-type (type)
6168 "Add a washing of TYPE to the current status."
6169 (add-to-list 'gnus-article-wash-types type))
6170
6171(defun gnus-delete-wash-type (type)
6172 "Add a washing of TYPE to the current status."
6173 (setq gnus-article-wash-types (delq type gnus-article-wash-types)))
6174
6175(defun gnus-add-image (category image)
6176 "Add IMAGE of CATEGORY to the list of displayed images."
6177 (let ((entry (assq category gnus-article-image-alist)))
6178 (unless entry
6179 (setq entry (list category))
6180 (push entry gnus-article-image-alist))
6181 (nconc entry (list image))))
6182
6183(defun gnus-delete-images (category)
6184 "Delete all images in CATEGORY."
6185 (let ((entry (assq category gnus-article-image-alist)))
6186 (dolist (image (cdr entry))
6187 (gnus-remove-image image category))
6188 (setq gnus-article-image-alist (delq entry gnus-article-image-alist))
6189 (gnus-delete-wash-type category)))
eec82323 6190
16409b0b 6191(defalias 'gnus-article-hide-headers-if-wanted 'gnus-article-maybe-hide-headers)
6748645f
LMI
6192
6193(defun gnus-article-maybe-hide-headers ()
eec82323
LMI
6194 "Hide unwanted headers if `gnus-have-all-headers' is nil.
6195Provided for backwards compatibility."
16409b0b 6196 (when (and (or (not (gnus-buffer-live-p gnus-summary-buffer))
01c52d31
MB
6197 (not (with-current-buffer gnus-summary-buffer
6198 gnus-have-all-headers)))
16409b0b
GM
6199 (not gnus-inhibit-hiding))
6200 (gnus-article-hide-headers)))
eec82323 6201
89b163db 6202(declare-function shr-put-image "shr" (data alt &optional flags))
b9bdaf74 6203
89b163db 6204(defun gnus-shr-put-image (data alt &optional flags)
b9bdaf74 6205 "Put image DATA with a string ALT. Enable image to be deleted."
abd2f2a4
KY
6206 (let ((image (if flags
6207 (shr-put-image data (propertize (or alt "*")
6208 'gnus-image-category 'shr)
6209 flags)
6210 ;; Old `shr-put-image' doesn't take the optional `flags'
6211 ;; argument.
6212 (shr-put-image data (propertize (or alt "*")
6213 'gnus-image-category 'shr)))))
b9bdaf74
KY
6214 (when image
6215 (gnus-add-image 'shr image))))
6216
eec82323
LMI
6217;;; Article savers.
6218
6219(defun gnus-output-to-file (file-name)
26c9afc3
MB
6220 "Append the current article to a file named FILE-NAME.
6221If `gnus-article-save-coding-system' is non-nil, it is used to encode
6222text and used as the value of the coding cookie which is added to the
6223top of a file. Otherwise, this function saves a raw article without
6224the coding cookie."
6225 (let* ((artbuf (current-buffer))
6226 (file-name-coding-system nnmail-pathname-coding-system)
6227 (coding gnus-article-save-coding-system)
6228 (coding-system-for-read (if coding
6229 nil ;; Rely on the coding cookie.
6230 mm-text-coding-system))
6231 (coding-system-for-write (or coding
6232 mm-text-coding-system-for-write
6233 mm-text-coding-system))
6234 (exists (file-exists-p file-name)))
16409b0b 6235 (with-temp-buffer
26c9afc3
MB
6236 (when exists
6237 (insert-file-contents file-name)
6238 (goto-char (point-min))
6239 ;; Remove the existing coding cookie.
6240 (when (looking-at "X-Gnus-Coding-System: .+\n\n")
6241 (delete-region (match-beginning 0) (match-end 0))))
6242 (goto-char (point-max))
eec82323
LMI
6243 (insert-buffer-substring artbuf)
6244 ;; Append newline at end of the buffer as separator, and then
6245 ;; save it to file.
6246 (goto-char (point-max))
6247 (insert "\n")
26c9afc3
MB
6248 (when coding
6249 ;; If the coding system is not suitable to encode the text,
6250 ;; ask a user for a proper one.
6251 (when (fboundp 'select-safe-coding-system)
6252 (setq coding (coding-system-base
6253 (save-window-excursion
6254 (select-safe-coding-system (point-min) (point-max)
6255 coding))))
6256 (setq coding-system-for-write
6257 (or (cdr (assq coding '((mule-utf-8 . utf-8))))
6258 coding)))
6259 (goto-char (point-min))
6260 ;; Add the coding cookie.
6261 (insert (format "X-Gnus-Coding-System: -*- coding: %s; -*-\n\n"
6262 coding-system-for-write)))
6263 (if exists
6264 (progn
6265 (write-region (point-min) (point-max) file-name nil 'no-message)
6266 (message "Appended to %s" file-name))
6267 (write-region (point-min) (point-max) file-name))))
6268 t)
eec82323
LMI
6269
6270(defun gnus-narrow-to-page (&optional arg)
6271 "Narrow the article buffer to a page.
6272If given a numerical ARG, move forward ARG pages."
6273 (interactive "P")
6274 (setq arg (if arg (prefix-numeric-value arg) 0))
80de1778 6275 (with-current-buffer gnus-article-buffer
eec82323
LMI
6276 (widen)
6277 ;; Remove any old next/prev buttons.
6278 (when (gnus-visual-p 'page-marker)
4e7d0221 6279 (let ((inhibit-read-only t))
eec82323
LMI
6280 (gnus-remove-text-with-property 'gnus-prev)
6281 (gnus-remove-text-with-property 'gnus-next)))
8f7abae3
MB
6282 (let (st nd pt)
6283 (when (save-excursion
6284 (cond ((< arg 0)
6285 (if (re-search-backward page-delimiter nil 'move (abs arg))
6286 (prog1
6287 (setq nd (match-beginning 0)
6288 pt nd)
6289 (when (re-search-backward page-delimiter nil t)
6290 (setq st (match-end 0))))
6291 (when (re-search-forward page-delimiter nil t)
6292 (setq nd (match-beginning 0)
6293 pt (point-min)))))
6294 ((> arg 0)
6295 (if (re-search-forward page-delimiter nil 'move arg)
6296 (prog1
6297 (setq st (match-end 0)
6298 pt st)
6299 (when (re-search-forward page-delimiter nil t)
6300 (setq nd (match-beginning 0))))
6301 (when (re-search-backward page-delimiter nil t)
6302 (setq st (match-end 0)
6303 pt (point-max)))))
6304 (t
6305 (when (re-search-backward page-delimiter nil t)
6306 (goto-char (setq st (match-end 0))))
6307 (when (re-search-forward page-delimiter nil t)
6308 (setq nd (match-beginning 0)))
6309 (or st nd))))
6310 (setq gnus-page-broken t)
6311 (when pt (goto-char pt))
6312 (narrow-to-region (or st (point-min)) (or nd (point-max)))
6313 (when (gnus-visual-p 'page-marker)
6314 (save-excursion
6315 (when nd
6316 (goto-char nd)
6317 (gnus-insert-next-page-button))
6318 (when st
6319 (goto-char st)
6320 (gnus-insert-prev-page-button))))))))
eec82323
LMI
6321
6322;; Article mode commands
6323
6324(defun gnus-article-goto-next-page ()
6325 "Show the next page of the article."
6326 (interactive)
6327 (when (gnus-article-next-page)
6328 (goto-char (point-min))
6329 (gnus-article-read-summary-keys nil (gnus-character-to-event ?n))))
6330
23f87bed 6331
eec82323 6332(defun gnus-article-goto-prev-page ()
23f87bed 6333 "Show the previous page of the article."
eec82323 6334 (interactive)
8f7abae3 6335 (if (save-restriction (widen) (bobp)) ;; Real beginning-of-buffer?
23f87bed 6336 (gnus-article-read-summary-keys nil (gnus-character-to-event ?p))
eec82323
LMI
6337 (gnus-article-prev-page nil)))
6338
23f87bed
MB
6339;; This is cleaner but currently breaks `gnus-pick-mode':
6340;;
6341;; (defun gnus-article-goto-next-page ()
6342;; "Show the next page of the article."
6343;; (interactive)
6344;; (gnus-eval-in-buffer-window gnus-summary-buffer
6345;; (gnus-summary-next-page)))
6346;;
6347;; (defun gnus-article-goto-prev-page ()
6348;; "Show the next page of the article."
6349;; (interactive)
6350;; (gnus-eval-in-buffer-window gnus-summary-buffer
6351;; (gnus-summary-prev-page)))
6352
eec82323
LMI
6353(defun gnus-article-next-page (&optional lines)
6354 "Show the next page of the current article.
6355If end of article, return non-nil. Otherwise return nil.
6356Argument LINES specifies lines to be scrolled up."
6357 (interactive "p")
9153f10d 6358 (move-to-window-line (if (featurep 'xemacs) -1 (- -1 scroll-margin)))
60ece9b0
MB
6359 (if (and (not (and gnus-article-over-scroll
6360 (> (count-lines (window-start) (point-max))
9153f10d
MB
6361 (if (featurep 'xemacs)
6362 (or lines (1- (window-height)))
6363 (+ (or lines (1- (window-height))) scroll-margin)))))
60ece9b0
MB
6364 (save-excursion
6365 (end-of-line)
6366 (and (pos-visible-in-window-p) ;Not continuation line.
647559c2 6367 (>= (point) (point-max)))))
eec82323
LMI
6368 ;; Nothing in this page.
6369 (if (or (not gnus-page-broken)
6370 (save-excursion
6371 (save-restriction
23f87bed
MB
6372 (widen)
6373 (forward-line)
6374 (eobp)))) ;Real end-of-buffer?
6375 (progn
6376 (when gnus-article-over-scroll
6377 (gnus-article-next-page-1 lines))
6378 t) ;Nothing more.
eec82323
LMI
6379 (gnus-narrow-to-page 1) ;Go to next page.
6380 nil)
6381 ;; More in this page.
23f87bed 6382 (gnus-article-next-page-1 lines)
eec82323
LMI
6383 nil))
6384
b1992461 6385(defun gnus-article-beginning-of-window ()
d8a88581
MB
6386 "Move point to the beginning of the window.
6387In Emacs, the point is placed at the line number which `scroll-margin'
6388specifies."
6389 (if (featurep 'xemacs)
b1992461
KY
6390 (move-to-window-line 0)
6391 ;; There is an obscure bug in Emacs that makes it impossible to
6392 ;; scroll past big pictures in the article buffer. Try to fix
6393 ;; this by adding a sanity check by counting the lines visible.
6394 (when (> (count-lines (window-start) (window-end)) 30)
6395 (move-to-window-line
6396 (min (max 0 scroll-margin)
6397 (max 1 (- (window-height)
6398 (if mode-line-format 1 0)
6399 (if header-line-format 1 0)
6400 2)))))))
d8a88581 6401
23f87bed 6402(defun gnus-article-next-page-1 (lines)
4b91459a 6403 (condition-case ()
01baa1e6
G
6404 (let ((scroll-in-place nil)
6405 (auto-window-vscroll nil))
4b91459a
MB
6406 (scroll-up lines))
6407 (end-of-buffer
6408 ;; Long lines may cause an end-of-buffer error.
6409 (goto-char (point-max))))
6410 (gnus-article-beginning-of-window))
23f87bed 6411
eec82323
LMI
6412(defun gnus-article-prev-page (&optional lines)
6413 "Show previous page of current article.
6414Argument LINES specifies lines to be scrolled down."
6415 (interactive "p")
d8a88581 6416 (move-to-window-line 0)
eec82323
LMI
6417 (if (and gnus-page-broken
6418 (bobp)
6419 (not (save-restriction (widen) (bobp)))) ;Real beginning-of-buffer?
6420 (progn
6421 (gnus-narrow-to-page -1) ;Go to previous page.
6422 (goto-char (point-max))
60ece9b0
MB
6423 (recenter (if gnus-article-over-scroll
6424 (if lines
9153f10d
MB
6425 (max (if (featurep 'xemacs)
6426 lines
6427 (+ lines scroll-margin))
60ece9b0
MB
6428 3)
6429 (- (window-height) 2))
6430 -1)))
c03ac728
MB
6431 (prog1
6432 (condition-case ()
6433 (let ((scroll-in-place nil))
6434 (scroll-down lines))
6435 (beginning-of-buffer
6436 (goto-char (point-min))))
6437 (gnus-article-beginning-of-window))))
eec82323 6438
23f87bed
MB
6439(defun gnus-article-only-boring-p ()
6440 "Decide whether there is only boring text remaining in the article.
6441Something \"interesting\" is a word of at least two letters that does
6442not have a face in `gnus-article-boring-faces'."
6443 (when (and gnus-article-skip-boring
6444 (boundp 'gnus-article-boring-faces)
6445 (symbol-value 'gnus-article-boring-faces))
6446 (save-excursion
531bedc3
MB
6447 (let ((inhibit-point-motion-hooks t))
6448 (catch 'only-boring
6449 (while (re-search-forward "\\b\\w\\w" nil t)
6450 (forward-char -1)
6451 (when (not (gnus-intersection
6452 (gnus-faces-at (point))
6453 (symbol-value 'gnus-article-boring-faces)))
6454 (throw 'only-boring nil)))
6455 (throw 'only-boring t))))))
23f87bed 6456
eec82323
LMI
6457(defun gnus-article-refer-article ()
6458 "Read article specified by message-id around point."
6459 (interactive)
23f87bed 6460 (save-excursion
01c52d31
MB
6461 (re-search-backward "[ \t]\\|^" (point-at-bol) t)
6462 (re-search-forward "<?news:<?\\|<" (point-at-eol) t)
6463 (if (re-search-forward "[^@ ]+@[^ \t>]+" (point-at-eol) t)
23f87bed 6464 (let ((msg-id (concat "<" (match-string 0) ">")))
eec82323 6465 (set-buffer gnus-summary-buffer)
23f87bed 6466 (gnus-summary-refer-article msg-id))
eec82323
LMI
6467 (error "No references around point"))))
6468
6469(defun gnus-article-show-summary ()
6470 "Reconfigure windows to show summary buffer."
6471 (interactive)
6472 (if (not (gnus-buffer-live-p gnus-summary-buffer))
6473 (error "There is no summary buffer for this article buffer")
a8151ef7 6474 (gnus-article-set-globals)
eec82323 6475 (gnus-configure-windows 'article)
6748645f
LMI
6476 (gnus-summary-goto-subject gnus-current-article)
6477 (gnus-summary-position-point)))
eec82323
LMI
6478
6479(defun gnus-article-describe-briefly ()
6480 "Describe article mode commands briefly."
6481 (interactive)
bdaa75c7 6482 (gnus-message 6 "%s" (substitute-command-keys "\\<gnus-article-mode-map>\\[gnus-article-goto-next-page]:Next page \\[gnus-article-goto-prev-page]:Prev page \\[gnus-article-show-summary]:Show summary \\[gnus-info-find-node]:Run Info \\[gnus-article-describe-briefly]:This help")))
eec82323 6483
16409b0b
GM
6484(defun gnus-article-check-buffer ()
6485 "Beep if not in an article buffer."
1b3b87df 6486 (unless (derived-mode-p 'gnus-article-mode)
16409b0b
GM
6487 (error "Command invoked outside of a Gnus article buffer")))
6488
eec82323
LMI
6489(defun gnus-article-read-summary-keys (&optional arg key not-restore-window)
6490 "Read a summary buffer key sequence and execute it from the article buffer."
6491 (interactive "P")
16409b0b 6492 (gnus-article-check-buffer)
eec82323 6493 (let ((nosaves
23f87bed
MB
6494 '("q" "Q" "c" "r" "\C-c\C-f" "m" "a" "f"
6495 "Zc" "ZC" "ZE" "ZQ" "ZZ" "Zn" "ZR" "ZG" "ZN" "ZP"
6496 "=" "^" "\M-^" "|"))
6497 (nosave-but-article
0b6799c3
MB
6498 '("A " "A<" "A>" "AM" "AP" "AR" "AT" "A\C-?" "A\M-\r" "A\r" "Ab" "Ae"
6499 "An" "Ap" [?A (meta return)] [?A delete]))
23f87bed 6500 (nosave-in-article
0b6799c3 6501 '("AS" "\C-d"))
23f87bed
MB
6502 (up-to-top
6503 '("n" "Gn" "p" "Gp"))
6504 keys new-sum-point)
80de1778 6505 (with-current-buffer gnus-article-current-summary
eec82323 6506 (let (gnus-pick-mode)
95838435
MB
6507 (setq unread-command-events (nconc unread-command-events
6508 (list (or key last-command-event)))
6509 keys (if (featurep 'xemacs)
6510 (events-to-keys (read-key-sequence nil t))
6511 (read-key-sequence nil t)))))
a1506d29 6512
eec82323
LMI
6513 (message "")
6514
01c52d31
MB
6515 (cond
6516 ((eq (aref keys (1- (length keys))) ?\C-h)
0b6799c3 6517 (gnus-article-describe-bindings (substring keys 0 -1)))
01c52d31
MB
6518 ((or (member keys nosaves)
6519 (member keys nosave-but-article)
6520 (member keys nosave-in-article))
6521 (let (func)
6522 (save-window-excursion
6523 (pop-to-buffer gnus-article-current-summary)
6524 ;; We disable the pick minor mode commands.
6525 (let (gnus-pick-mode)
6ab2c7a8 6526 (setq func (key-binding keys t))))
01c52d31
MB
6527 (if (or (not func)
6528 (numberp func))
6529 (ding)
6530 (unless (member keys nosave-in-article)
6531 (set-buffer gnus-article-current-summary))
89b163db
G
6532 (when (and (symbolp func)
6533 (get func 'disabled))
cb51ba08 6534 (error "Function %s disabled" func))
01c52d31
MB
6535 (call-interactively func)
6536 (setq new-sum-point (point)))
6537 (when (member keys nosave-but-article)
6538 (pop-to-buffer gnus-article-buffer))))
6539 (t
eec82323
LMI
6540 ;; These commands should restore window configuration.
6541 (let ((obuf (current-buffer))
23f87bed 6542 (owin (current-window-configuration))
01c52d31 6543 win func in-buffer selected new-sum-start new-sum-hscroll err)
23f87bed 6544 (cond (not-restore-window
01c52d31
MB
6545 (pop-to-buffer gnus-article-current-summary)
6546 (setq win (selected-window)))
23f87bed
MB
6547 ((setq win (get-buffer-window gnus-article-current-summary))
6548 (select-window win))
6549 (t
01c52d31
MB
6550 (let ((summary-buffer gnus-article-current-summary))
6551 (gnus-configure-windows 'article)
6552 (unless (setq win (get-buffer-window summary-buffer 'visible))
6553 (let ((gnus-buffer-configuration
de0bdfe7
KY
6554 '((article ((vertical 1.0
6555 (summary 0.25 point)
6556 (article 1.0)))))))
01c52d31
MB
6557 (gnus-configure-windows 'article))
6558 (setq win (get-buffer-window summary-buffer 'visible)))
6559 (gnus-select-frame-set-input-focus (window-frame win))
6560 (select-window win))))
23f87bed
MB
6561 (setq in-buffer (current-buffer))
6562 ;; We disable the pick minor mode commands.
cb51ba08
LI
6563 (setq func (let (gnus-pick-mode)
6564 (key-binding keys t)))
6565 (when (get func 'disabled)
6566 (error "Function %s disabled" func))
6567 (if (and func
01c52d31
MB
6568 (functionp func)
6569 (condition-case code
6570 (progn
6571 (call-interactively func)
6572 t)
6573 (error
6574 (setq err code)
6575 nil)))
23f87bed 6576 (progn
23f87bed
MB
6577 (when (eq win (selected-window))
6578 (setq new-sum-point (point)
6579 new-sum-start (window-start win)
9a89f5b0 6580 new-sum-hscroll (window-hscroll win)))
01c52d31
MB
6581 (when (or (eq in-buffer (current-buffer))
6582 (when (eq obuf (current-buffer))
6583 (set-buffer in-buffer)
6584 t))
520aa572
SZ
6585 (setq selected (gnus-summary-select-article))
6586 (set-buffer obuf)
6587 (unless not-restore-window
6588 (set-window-configuration owin))
01c52d31
MB
6589 (when (and (eq selected 'old)
6590 new-sum-point)
520aa572
SZ
6591 (set-window-start (get-buffer-window (current-buffer))
6592 1)
6593 (set-window-point (get-buffer-window (current-buffer))
01c52d31
MB
6594 (if (article-goto-body)
6595 (1- (point))
6596 (point))))
23f87bed 6597 (when (and (not not-restore-window)
01c52d31 6598 new-sum-point
4520e527 6599 (window-live-p win)
01c52d31 6600 (with-current-buffer (window-buffer win)
1b3b87df 6601 (derived-mode-p 'gnus-summary-mode)))
23f87bed
MB
6602 (set-window-point win new-sum-point)
6603 (set-window-start win new-sum-start)
9a89f5b0 6604 (set-window-hscroll win new-sum-hscroll))))
23f87bed 6605 (set-window-configuration owin)
01c52d31
MB
6606 (if err
6607 (signal (car err) (cdr err))
6608 (ding))))))))
520aa572 6609
95838435
MB
6610(defun gnus-article-read-summary-send-keys ()
6611 (interactive)
0b6799c3 6612 (let ((unread-command-events (list (gnus-character-to-event ?S))))
95838435
MB
6613 (gnus-article-read-summary-keys)))
6614
520aa572 6615(defun gnus-article-describe-key (key)
95838435
MB
6616 "Display documentation of the function invoked by KEY.
6617KEY is a string or a vector."
6618 (interactive (list (let ((cursor-in-echo-area t)) ;; better for XEmacs.
6619 (read-key-sequence "Describe key: "))))
520aa572 6620 (gnus-article-check-buffer)
95838435
MB
6621 (if (memq (key-binding key t) '(gnus-article-read-summary-keys
6622 gnus-article-read-summary-send-keys))
80de1778 6623 (with-current-buffer gnus-article-current-summary
95838435
MB
6624 (setq unread-command-events
6625 (if (featurep 'xemacs)
6626 (append key nil)
6627 (mapcar (lambda (x) (if (and (integerp x) (>= x 128))
6628 (list 'meta (- x 128))
6629 x))
6630 key)))
6631 (let ((cursor-in-echo-area t)
6632 gnus-pick-mode)
6633 (describe-key (read-key-sequence nil t))))
520aa572
SZ
6634 (describe-key key)))
6635
6636(defun gnus-article-describe-key-briefly (key &optional insert)
95838435
MB
6637 "Display documentation of the function invoked by KEY.
6638KEY is a string or a vector."
6639 (interactive (list (let ((cursor-in-echo-area t)) ;; better for XEmacs.
6640 (read-key-sequence "Describe key: "))
6641 current-prefix-arg))
520aa572 6642 (gnus-article-check-buffer)
95838435
MB
6643 (if (memq (key-binding key t) '(gnus-article-read-summary-keys
6644 gnus-article-read-summary-send-keys))
80de1778 6645 (with-current-buffer gnus-article-current-summary
95838435
MB
6646 (setq unread-command-events
6647 (if (featurep 'xemacs)
6648 (append key nil)
6649 (mapcar (lambda (x) (if (and (integerp x) (>= x 128))
6650 (list 'meta (- x 128))
6651 x))
6652 key)))
6653 (let ((cursor-in-echo-area t)
6654 gnus-pick-mode)
6655 (describe-key-briefly (read-key-sequence nil t) insert)))
520aa572 6656 (describe-key-briefly key insert)))
eec82323 6657
0b6799c3
MB
6658;;`gnus-agent-mode' in gnus-agent.el will define it.
6659(defvar gnus-agent-summary-mode)
e9198520 6660(defvar gnus-draft-mode)
12ea3d65 6661(defvar help-xref-stack-item)
0b6799c3
MB
6662
6663(defun gnus-article-describe-bindings (&optional prefix)
6664 "Show a list of all defined keys, and their definitions.
6665The optional argument PREFIX, if non-nil, should be a key sequence;
6666then we display only bindings that start with that prefix."
6667 (interactive)
6668 (gnus-article-check-buffer)
6669 (let ((keymap (copy-keymap gnus-article-mode-map))
6670 (map (copy-keymap gnus-article-send-map))
6671 (sumkeys (where-is-internal 'gnus-article-read-summary-keys))
8a908224 6672 parent agent draft)
0b6799c3
MB
6673 (define-key keymap "S" map)
6674 (define-key map [t] nil)
6675 (with-current-buffer gnus-article-current-summary
8a908224
KY
6676 (set-keymap-parent
6677 keymap
6678 (if (setq parent (keymap-parent gnus-article-mode-map))
6679 (prog1
6680 (setq parent (copy-keymap parent))
6681 (set-keymap-parent parent (current-local-map)))
6682 (current-local-map)))
0b6799c3 6683 (set-keymap-parent map (key-binding "S"))
8f7abae3
MB
6684 (let (key def gnus-pick-mode)
6685 (while sumkeys
6686 (setq key (pop sumkeys))
6687 (cond ((and (vectorp key) (= (length key) 1)
6688 (consp (setq def (aref key 0)))
6689 (numberp (car def)) (numberp (cdr def)))
6690 (when (< (max (car def) (cdr def)) 128)
6691 (setq sumkeys
6692 (append (mapcar
6693 #'vector
6694 (nreverse (gnus-uncompress-range def)))
6695 sumkeys))))
6696 ((setq def (key-binding key))
6697 (unless (eq def 'undefined)
6698 (define-key keymap key def))))))
0b6799c3 6699 (when (boundp 'gnus-agent-summary-mode)
e9198520
MB
6700 (setq agent gnus-agent-summary-mode))
6701 (when (boundp 'gnus-draft-mode)
6702 (setq draft gnus-draft-mode)))
0b6799c3
MB
6703 (with-temp-buffer
6704 (use-local-map keymap)
6705 (set (make-local-variable 'gnus-agent-summary-mode) agent)
e9198520 6706 (set (make-local-variable 'gnus-draft-mode) draft)
0b6799c3
MB
6707 (describe-bindings prefix))
6708 (let ((item `((lambda (prefix)
80de1778 6709 (with-current-buffer ,(current-buffer)
0b6799c3
MB
6710 (gnus-article-describe-bindings prefix)))
6711 ,prefix)))
269db053
KY
6712 ;; Loading `help-mode' here is necessary if `describe-bindings'
6713 ;; is replaced with something, e.g. `helm-descbinds'.
af69a478 6714 (require 'help-mode)
5843126b 6715 (with-current-buffer (let (help-xref-following) (help-buffer))
0b6799c3
MB
6716 (setq help-xref-stack-item item)))))
6717
23f87bed
MB
6718(defun gnus-article-reply-with-original (&optional wide)
6719 "Start composing a reply mail to the current message.
6720The text in the region will be yanked. If the region isn't active,
6721the entire article will be yanked."
95838435 6722 (interactive)
23f87bed
MB
6723 (let ((article (cdr gnus-article-current))
6724 contents)
1d0df8af 6725 (if (not (gnus-region-active-p))
23f87bed
MB
6726 (with-current-buffer gnus-summary-buffer
6727 (gnus-summary-reply (list (list article)) wide))
6728 (setq contents (buffer-substring (point) (mark t)))
6729 ;; Deactivate active regions.
6730 (when (and (boundp 'transient-mark-mode)
6731 transient-mark-mode)
6732 (setq mark-active nil))
6733 (with-current-buffer gnus-summary-buffer
6734 (gnus-summary-reply
6735 (list (list article contents)) wide)))))
6736
95838435
MB
6737(defun gnus-article-wide-reply-with-original ()
6738 "Start composing a wide reply mail to the current message.
6739The text in the region will be yanked. If the region isn't active,
6740the entire article will be yanked."
6741 (interactive)
6742 (gnus-article-reply-with-original t))
6743
23f87bed
MB
6744(defun gnus-article-followup-with-original ()
6745 "Compose a followup to the current article.
6746The text in the region will be yanked. If the region isn't active,
6747the entire article will be yanked."
6748 (interactive)
6749 (let ((article (cdr gnus-article-current))
6750 contents)
1d0df8af 6751 (if (not (gnus-region-active-p))
23f87bed
MB
6752 (with-current-buffer gnus-summary-buffer
6753 (gnus-summary-followup (list (list article))))
6754 (setq contents (buffer-substring (point) (mark t)))
6755 ;; Deactivate active regions.
6756 (when (and (boundp 'transient-mark-mode)
6757 transient-mark-mode)
6758 (setq mark-active nil))
6759 (with-current-buffer gnus-summary-buffer
6760 (gnus-summary-followup
6761 (list (list article contents)))))))
6762
eec82323
LMI
6763(defun gnus-article-hide (&optional arg force)
6764 "Hide all the gruft in the current article.
23f87bed
MB
6765This means that signatures, cited text and (some) headers will be
6766hidden.
eec82323 6767If given a prefix, show the hidden text instead."
6748645f 6768 (interactive (append (gnus-article-hidden-arg) (list 'force)))
eec82323 6769 (gnus-article-hide-headers arg)
16409b0b 6770 (gnus-article-hide-list-identifiers arg)
eec82323
LMI
6771 (gnus-article-hide-citation-maybe arg force)
6772 (gnus-article-hide-signature arg))
6773
6748645f
LMI
6774(defun gnus-check-group-server ()
6775 ;; Make sure the connection to the server is alive.
6776 (unless (gnus-server-opened
6777 (gnus-find-method-for-group gnus-newsgroup-name))
6778 (gnus-check-server (gnus-find-method-for-group gnus-newsgroup-name))
6779 (gnus-request-group gnus-newsgroup-name t)))
6780
23f87bed
MB
6781(eval-when-compile
6782 (autoload 'nneething-get-file-name "nneething"))
6783
eec82323
LMI
6784(defun gnus-request-article-this-buffer (article group)
6785 "Get an article and insert it into this buffer."
6748645f 6786 (let (do-update-line sparse-header)
eec82323
LMI
6787 (prog1
6788 (save-excursion
6789 (erase-buffer)
6790 (gnus-kill-all-overlays)
6791 (setq group (or group gnus-newsgroup-name))
6792
eec82323
LMI
6793 ;; Using `gnus-request-article' directly will insert the article into
6794 ;; `nntp-server-buffer' - so we'll save some time by not having to
6795 ;; copy it from the server buffer into the article buffer.
6796
6797 ;; We only request an article by message-id when we do not have the
6798 ;; headers for it, so we'll have to get those.
6799 (when (stringp article)
16409b0b 6800 (gnus-read-header article))
eec82323
LMI
6801
6802 ;; If the article number is negative, that means that this article
6803 ;; doesn't belong in this newsgroup (possibly), so we find its
6804 ;; message-id and request it by id instead of number.
6805 (when (and (numberp article)
6806 gnus-summary-buffer
6807 (get-buffer gnus-summary-buffer)
6748645f 6808 (gnus-buffer-exists-p gnus-summary-buffer))
80de1778 6809 (with-current-buffer gnus-summary-buffer
eec82323
LMI
6810 (let ((header (gnus-summary-article-header article)))
6811 (when (< article 0)
6812 (cond
6813 ((memq article gnus-newsgroup-sparse)
6814 ;; This is a sparse gap article.
6815 (setq do-update-line article)
6816 (setq article (mail-header-id header))
16409b0b 6817 (setq sparse-header (gnus-read-header article))
eec82323
LMI
6818 (setq gnus-newsgroup-sparse
6819 (delq article gnus-newsgroup-sparse)))
6820 ((vectorp header)
6821 ;; It's a real article.
6822 (setq article (mail-header-id header)))
6823 (t
6824 ;; It is an extracted pseudo-article.
6825 (setq article 'pseudo)
6826 (gnus-request-pseudo-article header))))
6827
6828 (let ((method (gnus-find-method-for-group
6829 gnus-newsgroup-name)))
6748645f
LMI
6830 (when (and (eq (car method) 'nneething)
6831 (vectorp header))
23f87bed
MB
6832 (let ((dir (nneething-get-file-name
6833 (mail-header-id header))))
6834 (when (and (stringp dir)
6835 (file-directory-p dir))
eec82323
LMI
6836 (setq article 'nneething)
6837 (gnus-group-enter-directory dir))))))))
6838
6839 (cond
6840 ;; Refuse to select canceled articles.
6841 ((and (numberp article)
6842 gnus-summary-buffer
6843 (get-buffer gnus-summary-buffer)
6748645f 6844 (gnus-buffer-exists-p gnus-summary-buffer)
01c52d31 6845 (eq (cdr (with-current-buffer gnus-summary-buffer
eec82323
LMI
6846 (assq article gnus-newsgroup-reads)))
6847 gnus-canceled-mark))
6848 nil)
6849 ;; We first check `gnus-original-article-buffer'.
6850 ((and (get-buffer gnus-original-article-buffer)
6851 (numberp article)
01c52d31 6852 (with-current-buffer gnus-original-article-buffer
eec82323
LMI
6853 (and (equal (car gnus-original-article) group)
6854 (eq (cdr gnus-original-article) article))))
75eda25b
SM
6855 ;; `insert-buffer-substring' would incorrectly use the
6856 ;; equivalent of string-make-multibyte which amount to decoding
6857 ;; with locale-coding-system, causing failure of
6858 ;; subsequent decoding.
6859 (insert (mm-string-to-multibyte
6860 (with-current-buffer gnus-original-article-buffer
6861 (buffer-substring (point-min) (point-max)))))
eec82323
LMI
6862 'article)
6863 ;; Check the backlog.
6864 ((and gnus-keep-backlog
6865 (gnus-backlog-request-article group article (current-buffer)))
6866 'article)
6867 ;; Check asynchronous pre-fetch.
6868 ((gnus-async-request-fetched-article group article (current-buffer))
6869 (gnus-async-prefetch-next group article gnus-summary-buffer)
6748645f
LMI
6870 (when (and (numberp article) gnus-keep-backlog)
6871 (gnus-backlog-enter-article group article (current-buffer)))
eec82323
LMI
6872 'article)
6873 ;; Check the cache.
6874 ((and gnus-use-cache
6875 (numberp article)
6876 (gnus-cache-request-article article group))
6877 'article)
23f87bed
MB
6878 ;; Check the agent cache.
6879 ((gnus-agent-request-article article group)
6880 'article)
eec82323 6881 ;; Get the article and put into the article buffer.
16409b0b
GM
6882 ((or (stringp article)
6883 (numberp article))
6884 (let ((gnus-override-method gnus-override-method)
a1506d29 6885 (methods (and (stringp article)
936d08bb
G
6886 (with-current-buffer gnus-summary-buffer
6887 (gnus-refer-article-methods))))
23f87bed
MB
6888 (backend (car (gnus-find-method-for-group
6889 gnus-newsgroup-name)))
16409b0b 6890 result
4e7d0221 6891 (inhibit-read-only t))
16409b0b
GM
6892 (when (and (null gnus-override-method)
6893 methods)
6894 (setq gnus-override-method (pop methods)))
6895 (while (not result)
16409b0b
GM
6896 (erase-buffer)
6897 (gnus-kill-all-overlays)
6898 (let ((gnus-newsgroup-name group))
6899 (gnus-check-group-server))
23f87bed
MB
6900 (cond
6901 ((gnus-request-article article group (current-buffer))
16409b0b 6902 (when (numberp article)
a1506d29 6903 (gnus-async-prefetch-next group article
16409b0b
GM
6904 gnus-summary-buffer)
6905 (when gnus-keep-backlog
6906 (gnus-backlog-enter-article
f3b146e9
LMI
6907 group article (current-buffer)))
6908 (when (and gnus-agent
6909 (gnus-agent-group-covered-p group))
6910 (gnus-agent-store-article article group)))
16409b0b 6911 (setq result 'article))
23f87bed
MB
6912 (methods
6913 (setq gnus-override-method (pop methods)))
6914 ((not (string-match "^400 "
6915 (nnheader-get-report backend)))
6916 ;; If we get 400 server disconnect, reconnect and
6917 ;; retry; otherwise, assume the article has expired.
6918 (setq result 'done))))
16409b0b 6919 (and (eq result 'article) 'article)))
eec82323
LMI
6920 ;; It was a pseudo.
6921 (t article)))
6922
6748645f
LMI
6923 ;; Associate this article with the current summary buffer.
6924 (setq gnus-article-current-summary gnus-summary-buffer)
6925
eec82323
LMI
6926 ;; Take the article from the original article buffer
6927 ;; and place it in the buffer it's supposed to be in.
6928 (when (and (get-buffer gnus-article-buffer)
eec82323
LMI
6929 (equal (buffer-name (current-buffer))
6930 (buffer-name (get-buffer gnus-article-buffer))))
6931 (save-excursion
6932 (if (get-buffer gnus-original-article-buffer)
6748645f
LMI
6933 (set-buffer gnus-original-article-buffer)
6934 (set-buffer (gnus-get-buffer-create gnus-original-article-buffer))
16409b0b 6935 (buffer-disable-undo)
eec82323 6936 (setq major-mode 'gnus-original-article-mode)
6748645f 6937 (setq buffer-read-only t))
23f87bed 6938 (let ((inhibit-read-only t))
eec82323
LMI
6939 (erase-buffer)
6940 (insert-buffer-substring gnus-article-buffer))
16409b0b
GM
6941 (setq gnus-original-article (cons group article)))
6942
6943 ;; Decode charsets.
6944 (run-hooks 'gnus-article-decode-hook)
6945 ;; Mark article as decoded or not.
6946 (setq gnus-article-decoded-p gnus-article-decode-hook))
eec82323
LMI
6947
6948 ;; Update sparse articles.
6949 (when (and do-update-line
6950 (or (numberp article)
6951 (stringp article)))
6952 (let ((buf (current-buffer)))
6953 (set-buffer gnus-summary-buffer)
6748645f 6954 (gnus-summary-update-article do-update-line sparse-header)
eec82323 6955 (gnus-summary-goto-subject do-update-line nil t)
23f87bed 6956 (set-window-point (gnus-get-buffer-window (current-buffer) t)
eec82323
LMI
6957 (point))
6958 (set-buffer buf))))))
6959
2526f423 6960(defun gnus-block-private-groups (group)
6ed7a66a
G
6961 (if (or (gnus-news-group-p group)
6962 (gnus-member-of-valid 'global group))
2526f423
G
6963 ;; Block nothing in news groups.
6964 nil
6965 ;; Block everything anywhere else.
6966 "."))
6967
6968(defun gnus-blocked-images ()
6969 (if (functionp gnus-blocked-images)
6970 (funcall gnus-blocked-images gnus-newsgroup-name)
6971 gnus-blocked-images))
6972
eec82323
LMI
6973;;;
6974;;; Article editing
6975;;;
6976
6977(defcustom gnus-article-edit-mode-hook nil
6978 "Hook run in article edit mode buffers."
6979 :group 'gnus-article-various
6980 :type 'hook)
6981
6982(defvar gnus-article-edit-done-function nil)
6983
6984(defvar gnus-article-edit-mode-map nil)
6985
16409b0b 6986;; Should we be using derived.el for this?
eec82323 6987(unless gnus-article-edit-mode-map
23f87bed 6988 (setq gnus-article-edit-mode-map (make-keymap))
16409b0b 6989 (set-keymap-parent gnus-article-edit-mode-map text-mode-map)
eec82323
LMI
6990
6991 (gnus-define-keys gnus-article-edit-mode-map
23f87bed 6992 "\C-c?" describe-mode
eec82323 6993 "\C-c\C-c" gnus-article-edit-done
23f87bed
MB
6994 "\C-c\C-k" gnus-article-edit-exit
6995 "\C-c\C-f\C-t" message-goto-to
6996 "\C-c\C-f\C-o" message-goto-from
6997 "\C-c\C-f\C-b" message-goto-bcc
6998 ;;"\C-c\C-f\C-w" message-goto-fcc
6999 "\C-c\C-f\C-c" message-goto-cc
7000 "\C-c\C-f\C-s" message-goto-subject
7001 "\C-c\C-f\C-r" message-goto-reply-to
7002 "\C-c\C-f\C-n" message-goto-newsgroups
7003 "\C-c\C-f\C-d" message-goto-distribution
7004 "\C-c\C-f\C-f" message-goto-followup-to
7005 "\C-c\C-f\C-m" message-goto-mail-followup-to
7006 "\C-c\C-f\C-k" message-goto-keywords
7007 "\C-c\C-f\C-u" message-goto-summary
7008 "\C-c\C-f\C-i" message-insert-or-toggle-importance
7009 "\C-c\C-f\C-a" message-generate-unsubscribed-mail-followup-to
7010 "\C-c\C-b" message-goto-body
7011 "\C-c\C-i" message-goto-signature
7012
7013 "\C-c\C-t" message-insert-to
7014 "\C-c\C-n" message-insert-newsgroups
7015 "\C-c\C-o" message-sort-headers
7016 "\C-c\C-e" message-elide-region
7017 "\C-c\C-v" message-delete-not-region
7018 "\C-c\C-z" message-kill-to-signature
7019 "\M-\r" message-newline-and-reformat
7020 "\C-c\C-a" mml-attach-file
7021 "\C-a" message-beginning-of-line
7022 "\t" message-tab
7023 "\M-;" comment-region)
eec82323
LMI
7024
7025 (gnus-define-keys (gnus-article-edit-wash-map
7026 "\C-c\C-w" gnus-article-edit-mode-map)
7027 "f" gnus-article-edit-full-stops))
7028
23f87bed
MB
7029(easy-menu-define
7030 gnus-article-edit-mode-field-menu gnus-article-edit-mode-map ""
7031 '("Field"
7032 ["Fetch To" message-insert-to t]
7033 ["Fetch Newsgroups" message-insert-newsgroups t]
7034 "----"
7035 ["To" message-goto-to t]
7036 ["From" message-goto-from t]
7037 ["Subject" message-goto-subject t]
7038 ["Cc" message-goto-cc t]
7039 ["Reply-To" message-goto-reply-to t]
7040 ["Summary" message-goto-summary t]
7041 ["Keywords" message-goto-keywords t]
7042 ["Newsgroups" message-goto-newsgroups t]
7043 ["Followup-To" message-goto-followup-to t]
7044 ["Mail-Followup-To" message-goto-mail-followup-to t]
7045 ["Distribution" message-goto-distribution t]
7046 ["Body" message-goto-body t]
7047 ["Signature" message-goto-signature t]))
7048
4e7d0221 7049(define-derived-mode gnus-article-edit-mode message-mode "Article Edit"
eec82323
LMI
7050 "Major mode for editing articles.
7051This is an extended text-mode.
7052
7053\\{gnus-article-edit-mode-map}"
eec82323
LMI
7054 (make-local-variable 'gnus-article-edit-done-function)
7055 (make-local-variable 'gnus-prev-winconf)
80b47379
SZ
7056 (set (make-local-variable 'font-lock-defaults)
7057 '(message-font-lock-keywords t))
23f87bed
MB
7058 (set (make-local-variable 'mail-header-separator) "")
7059 (set (make-local-variable 'gnus-article-edit-mode) t)
7060 (easy-menu-add message-mode-field-menu message-mode-map)
7061 (mml-mode)
eec82323
LMI
7062 (setq buffer-read-only nil)
7063 (buffer-enable-undo)
80b47379 7064 (widen))
eec82323
LMI
7065
7066(defun gnus-article-edit (&optional force)
7067 "Edit the current article.
7068This will have permanent effect only in mail groups.
7069If FORCE is non-nil, allow editing of articles even in read-only
7070groups."
7071 (interactive "P")
7072 (when (and (not force)
7073 (gnus-group-read-only-p))
a8151ef7 7074 (error "The current newsgroup does not support article editing"))
6748645f 7075 (gnus-article-date-original)
eec82323 7076 (gnus-article-edit-article
16409b0b 7077 'ignore
6748645f 7078 `(lambda (no-highlight)
16409b0b 7079 'ignore
eec82323
LMI
7080 (gnus-summary-edit-article-done
7081 ,(or (mail-header-references gnus-current-headers) "")
6748645f 7082 ,(gnus-group-read-only-p) ,gnus-summary-buffer no-highlight))))
eec82323 7083
01c52d31 7084(defun gnus-article-edit-article (start-func exit-func &optional quiet)
eec82323
LMI
7085 "Start editing the contents of the current article buffer."
7086 (let ((winconf (current-window-configuration)))
7087 (set-buffer gnus-article-buffer)
0683d241
MB
7088 (let ((message-auto-save-directory
7089 ;; Don't associate the article buffer with a draft file.
7090 nil))
7091 (gnus-article-edit-mode))
16409b0b 7092 (funcall start-func)
23f87bed 7093 (set-buffer-modified-p nil)
eec82323
LMI
7094 (gnus-configure-windows 'edit-article)
7095 (setq gnus-article-edit-done-function exit-func)
7096 (setq gnus-prev-winconf winconf)
01c52d31
MB
7097 (unless quiet
7098 (gnus-message 6 "C-c C-c to end edits"))))
eec82323 7099
6748645f 7100(defun gnus-article-edit-done (&optional arg)
eec82323 7101 "Update the article edits and exit."
6748645f 7102 (interactive "P")
eec82323
LMI
7103 (let ((func gnus-article-edit-done-function)
7104 (buf (current-buffer))
23f87bed
MB
7105 (start (window-start))
7106 (p (point))
7107 (winconf gnus-prev-winconf))
7108 (widen) ;; Widen it in case that users narrowed the buffer.
7109 (funcall func arg)
7110 (set-buffer buf)
7111 ;; The cache and backlog have to be flushed somewhat.
7112 (when gnus-keep-backlog
7113 (gnus-backlog-remove-article
7114 (car gnus-article-current) (cdr gnus-article-current)))
7115 ;; Flush original article as well.
8ccbef23 7116 (gnus-flush-original-article-buffer)
23f87bed
MB
7117 (when gnus-use-cache
7118 (gnus-cache-update-article
7119 (car gnus-article-current) (cdr gnus-article-current)))
7120 ;; We remove all text props from the article buffer.
7121 (kill-all-local-variables)
01c52d31 7122 (set-text-properties (point-min) (point-max) nil)
23f87bed
MB
7123 (gnus-article-mode)
7124 (set-window-configuration winconf)
eec82323
LMI
7125 (set-buffer buf)
7126 (set-window-start (get-buffer-window buf) start)
23f87bed
MB
7127 (set-window-point (get-buffer-window buf) (point)))
7128 (gnus-summary-show-article))
eec82323 7129
8ccbef23
G
7130(defun gnus-flush-original-article-buffer ()
7131 (when (get-buffer gnus-original-article-buffer)
7132 (with-current-buffer gnus-original-article-buffer
7133 (setq gnus-original-article nil))))
7134
eec82323
LMI
7135(defun gnus-article-edit-exit ()
7136 "Exit the article editing without updating."
7137 (interactive)
23f87bed
MB
7138 (when (or (not (buffer-modified-p))
7139 (yes-or-no-p "Article modified; kill anyway? "))
7140 (let ((curbuf (current-buffer))
7141 (p (point))
7142 (window-start (window-start)))
7143 (erase-buffer)
7144 (if (gnus-buffer-live-p gnus-original-article-buffer)
d8a88581 7145 (insert-buffer-substring gnus-original-article-buffer))
23f87bed
MB
7146 (let ((winconf gnus-prev-winconf))
7147 (kill-all-local-variables)
7148 (gnus-article-mode)
7149 (set-window-configuration winconf)
7150 ;; Tippy-toe some to make sure that point remains where it was.
7151 (save-current-buffer
7152 (set-buffer curbuf)
7153 (set-window-start (get-buffer-window (current-buffer)) window-start)
7154 (goto-char p))))
7155 (gnus-summary-show-article)))
eec82323
LMI
7156
7157(defun gnus-article-edit-full-stops ()
7158 "Interactively repair spacing at end of sentences."
7159 (interactive)
7160 (save-excursion
7161 (goto-char (point-min))
7162 (search-forward-regexp "^$" nil t)
7163 (let ((case-fold-search nil))
7164 (query-replace-regexp "\\([.!?][])}]* \\)\\([[({A-Z]\\)" "\\1 \\2"))))
7165
7166;;;
7167;;; Article highlights
7168;;;
7169
7170;; Written by Per Abrahamsen <abraham@iesd.auc.dk>.
7171
7172;;; Internal Variables:
7173
a1506d29 7174(defcustom gnus-button-url-regexp
01c52d31
MB
7175 (concat
7176 "\\b\\(\\(www\\.\\|\\(s?https?\\|ftp\\|file\\|gopher\\|"
7177 "nntp\\|news\\|telnet\\|wais\\|mailto\\|info\\):\\)"
7178 "\\(//[-a-z0-9_.]+:[0-9]*\\)?"
7179 (if (string-match "[[:digit:]]" "1") ;; Support POSIX?
7180 (let ((chars "-a-z0-9_=#$@~%&*+\\/[:word:]")
7181 (punct "!?:;.,"))
7182 (concat
7183 "\\(?:"
7184 ;; Match paired parentheses, e.g. in Wikipedia URLs:
9b3ebcb6 7185 ;; http://thread.gmane.org/47B4E3B2.3050402@gmail.com
02e2beb9
AS
7186 "[" chars punct "]+" "(" "[" chars punct "]+" "[" chars "]*)"
7187 "\\(?:" "[" chars punct "]+" "[" chars "]" "\\)?"
01c52d31 7188 "\\|"
02e2beb9 7189 "[" chars punct "]+" "[" chars "]"
01c52d31
MB
7190 "\\)"))
7191 (concat ;; XEmacs 21.4 doesn't support POSIX.
7192 "\\([-a-z0-9_=!?#$@~%&*+\\/:;.,]\\|\\w\\)+"
7193 "\\([-a-z0-9_=#$@~%&*+\\/]\\|\\w\\)"))
7194 "\\)")
eec82323 7195 "Regular expression that matches URLs."
02e2beb9 7196 :version "24.4"
eec82323
LMI
7197 :group 'gnus-article-buttons
7198 :type 'regexp)
7199
23f87bed
MB
7200(defcustom gnus-button-valid-fqdn-regexp
7201 message-valid-fqdn-regexp
7202 "Regular expression that matches a valid FQDN."
bf247b6e 7203 :version "22.1"
23f87bed
MB
7204 :group 'gnus-article-buttons
7205 :type 'regexp)
7206
97f78c9b
MB
7207;; Regexp suggested by Felix Wiemann in <87oeuomcz9.fsf@news2.ososo.de>
7208(defcustom gnus-button-valid-localpart-regexp
14e6dc54 7209 "[a-z0-9$%(*-=?[_][^<>\")!;:,{}\n\t @]*"
97f78c9b
MB
7210 "Regular expression that matches a localpart of mail addresses or MIDs."
7211 :version "22.1"
7212 :group 'gnus-article-buttons
7213 :type 'regexp)
7214
23f87bed
MB
7215(defcustom gnus-button-man-handler 'manual-entry
7216 "Function to use for displaying man pages.
7217The function must take at least one argument with a string naming the
7218man page."
bf247b6e 7219 :version "22.1"
23f87bed
MB
7220 :type '(choice (function-item :tag "Man" manual-entry)
7221 (function-item :tag "Woman" woman)
7222 (function :tag "Other"))
7223 :group 'gnus-article-buttons)
7224
23f87bed 7225(defcustom gnus-button-mid-or-mail-regexp
97f78c9b 7226 (concat "\\b\\(<?" gnus-button-valid-localpart-regexp "@"
23f87bed
MB
7227 gnus-button-valid-fqdn-regexp
7228 ">?\\)\\b")
7229 "Regular expression that matches a message ID or a mail address."
bf247b6e 7230 :version "22.1"
23f87bed
MB
7231 :group 'gnus-article-buttons
7232 :type 'regexp)
7233
7234(defcustom gnus-button-prefer-mid-or-mail 'gnus-button-mid-or-mail-heuristic
7235 "What to do when the button on a string as \"foo123@bar.invalid\" is pushed.
7236Strings like this can be either a message ID or a mail address. If it is one
7237of the symbols `mid' or `mail', Gnus will always assume that the string is a
7238message ID or a mail address, respectively. If this variable is set to the
7239symbol `ask', always query the user what do do. If it is a function, this
aa819354 7240function will be called with the string as its only argument. The function
23f87bed 7241must return `mid', `mail', `invalid' or `ask'."
bf247b6e 7242 :version "22.1"
23f87bed
MB
7243 :group 'gnus-article-buttons
7244 :type '(choice (function-item :tag "Heuristic function"
7245 gnus-button-mid-or-mail-heuristic)
7246 (const ask)
7247 (const mid)
7248 (const mail)))
7249
7250(defcustom gnus-button-mid-or-mail-heuristic-alist
7251 '((-10.0 . ".+\\$.+@")
7252 (-10.0 . "#")
7253 (-10.0 . "\\*")
7254 (-5.0 . "\\+[^+]*\\+.*@") ;; # two plus signs
7255 (-5.0 . "@[Nn][Ee][Ww][Ss]") ;; /\@news/i
7256 (-5.0 . "@.*[Dd][Ii][Aa][Ll][Uu][Pp]") ;; /\@.*dialup/i;
7257 (-1.0 . "^[^a-z]+@")
7258 ;;
7259 (-5.0 . "\\.[0-9][0-9]+.*@") ;; "\.[0-9]{2,}.*\@"
7260 (-5.0 . "[a-z].*[A-Z].*[a-z].*[A-Z].*@") ;; "([a-z].*[A-Z].*){2,}\@"
7261 (-3.0 . "[A-Z][A-Z][a-z][a-z].*@")
7262 (-5.0 . "\\...?.?@") ;; (-5.0 . "\..{1,3}\@")
7263 ;;
7264 (-2.0 . "^[0-9]")
7265 (-1.0 . "^[0-9][0-9]")
7266 ;;
7267 ;; -3.0 /^[0-9][0-9a-fA-F]{2,2}/;
7268 (-3.0 . "^[0-9][0-9a-fA-F][0-9a-fA-F][^0-9a-fA-F]")
7269 ;; -5.0 /^[0-9][0-9a-fA-F]{3,3}/;
7270 (-5.0 . "^[0-9][0-9a-fA-F][0-9a-fA-F][0-9a-fA-F][^0-9a-fA-F]")
7271 ;;
7272 (-3.0 . "[0-9][0-9][0-9][0-9][0-9][^0-9].*@") ;; "[0-9]{5,}.*\@"
7273 (-3.0 . "[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][^0-9].*@")
7274 ;; "[0-9]{8,}.*\@"
7275 (-3.0
7276 . "[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9].*@")
7277 ;; "[0-9]{12,}.*\@"
7278 ;; compensation for TDMA dated mail addresses:
7279 (25.0 . "-dated-[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]+.*@")
7280 ;;
7281 (-20.0 . "\\.fsf@") ;; Gnus
7282 (-20.0 . "^slrn")
7283 (-20.0 . "^Pine")
437ce4be 7284 (-20.0 . "^alpine\\.")
23f87bed
MB
7285 (-20.0 . "_-_") ;; Subject change in thread
7286 ;;
7287 (-20.0 . "\\.ln@") ;; leafnode
7288 (-30.0 . "@ID-[0-9]+\\.[a-zA-Z]+\\.dfncis\\.de")
7289 (-30.0 . "@4[Aa][Xx]\\.com") ;; Forte Agent
7290 ;;
7291 ;; (5.0 . "") ;; $local_part_len <= 7
7292 (10.0 . "^[^0-9]+@")
7293 (3.0 . "^[^0-9]+[0-9][0-9]?[0-9]?@")
7294 ;; ^[^0-9]+[0-9]{1,3}\@ digits only at end of local part
7295 (3.0 . "\@stud")
7296 ;;
7297 (2.0 . "[a-z][a-z][._-][A-Z][a-z].*@")
7298 ;;
7299 (0.5 . "^[A-Z][a-z]")
7300 (0.5 . "^[A-Z][a-z][a-z]")
7301 (1.5 . "^[A-Z][a-z][A-Z][a-z][^a-z]") ;; ^[A-Z][a-z]{3,3}
7302 (2.0 . "^[A-Z][a-z][A-Z][a-z][a-z][^a-z]")) ;; ^[A-Z][a-z]{4,4}
7303 "An alist of \(RATE . REGEXP\) pairs for `gnus-button-mid-or-mail-heuristic'.
7304
7305A negative RATE indicates a message IDs, whereas a positive indicates a mail
7306address. The REGEXP is processed with `case-fold-search' set to nil."
bf247b6e 7307 :version "22.1"
23f87bed
MB
7308 :group 'gnus-article-buttons
7309 :type '(repeat (cons (number :tag "Rate")
7310 (regexp :tag "Regexp"))))
7311
7312(defun gnus-button-mid-or-mail-heuristic (mid-or-mail)
7313 "Guess whether MID-OR-MAIL is a message ID or a mail address.
7314Returns `mid' if MID-OR-MAIL is a message IDs, `mail' if it's a mail
7315address, `ask' if unsure and `invalid' if the string is invalid."
7316 (let ((case-fold-search nil)
7317 (list gnus-button-mid-or-mail-heuristic-alist)
7318 (result 0) rate regexp lpartlen elem)
7319 (setq lpartlen
7320 (length (gnus-replace-in-string mid-or-mail "^\\(.*\\)@.*$" "\\1")))
7321 (gnus-message 8 "`%s', length of local part=`%s'." mid-or-mail lpartlen)
7322 ;; Certain special cases...
7323 (when (string-match
7324 (concat
7325 "^0[0-9]+-[0-9][0-9][0-9][0-9]@t-online\\.de$\\|"
7326 "^[0-9]+\\.[0-9]+@compuserve\\|"
7327 "@public\\.gmane\\.org")
7328 mid-or-mail)
7329 (gnus-message 8 "`%s' is a known mail address." mid-or-mail)
7330 (setq result 'mail))
7331 (when (string-match "@.*@\\| " mid-or-mail)
7332 (gnus-message 8 "`%s' is invalid." mid-or-mail)
7333 (setq result 'invalid))
7334 ;; Nothing more to do, if result is not a number here...
7335 (when (numberp result)
7336 (while list
7337 (setq elem (car list)
7338 rate (car elem)
7339 regexp (cdr elem)
7340 list (cdr list))
7341 (when (string-match regexp mid-or-mail)
7342 (setq result (+ result rate))
7343 (gnus-message
7344 9 "`%s' matched `%s', rate `%s', result `%s'."
7345 mid-or-mail regexp rate result)))
7346 (when (<= lpartlen 7)
7347 (setq result (+ result 5.0))
7348 (gnus-message 9 "`%s' matched (<= lpartlen 7), result `%s'."
7349 mid-or-mail result))
7350 (when (>= lpartlen 12)
7351 (gnus-message 9 "`%s' matched (>= lpartlen 12)" mid-or-mail)
7352 (cond
7353 ((string-match "[0-9][^0-9]+[0-9].*@" mid-or-mail)
7354 ;; Long local part should contain realname if e-mail address,
7355 ;; too many digits: message-id.
7356 ;; $score -= 5.0 + 0.1 * $local_part_len;
7357 (setq rate (* -1.0 (+ 5.0 (* 0.1 lpartlen))))
7358 (setq result (+ result rate))
7359 (gnus-message
7360 9 "Many digits in `%s', rate `%s', result `%s'."
7361 mid-or-mail rate result))
7362 ((string-match "[^aeiouy][^aeiouy][^aeiouy][^aeiouy]+.*\@"
7363 mid-or-mail)
7364 ;; Too few vowels [^aeiouy]{4,}.*\@
7365 (setq result (+ result -5.0))
7366 (gnus-message
7367 9 "Few vowels in `%s', rate `%s', result `%s'."
7368 mid-or-mail -5.0 result))
7369 (t
7370 (setq result (+ result 5.0))
7371 (gnus-message
7372 9 "`%s', rate `%s', result `%s'." mid-or-mail 5.0 result)))))
7373 (gnus-message 8 "`%s': Final rate is `%s'." mid-or-mail result)
7374 ;; Maybe we should make this a customizable alist: (condition . 'result)
7375 (cond
7376 ((symbolp result) result)
7377 ;; Now convert number into proper results:
7378 ((< result -10.0) 'mid)
7379 ((> result 10.0) 'mail)
7380 (t 'ask))))
7381
7382(defun gnus-button-handle-mid-or-mail (mid-or-mail)
7383 (let* ((pref gnus-button-prefer-mid-or-mail) guessed
7384 (url-mid (concat "news" ":" mid-or-mail))
7385 (url-mailto (concat "mailto" ":" mid-or-mail)))
7386 (gnus-message 9 "mid-or-mail=%s" mid-or-mail)
7387 (when (fboundp pref)
7388 (setq guessed
7389 ;; get rid of surrounding angles...
7390 (funcall pref
7391 (gnus-replace-in-string mid-or-mail "^<\\|>$" "")))
7392 (if (or (eq 'mid guessed) (eq 'mail guessed))
7393 (setq pref guessed)
7394 (setq pref 'ask)))
7395 (if (eq pref 'ask)
7396 (save-window-excursion
7397 (if (y-or-n-p (concat "Is <" mid-or-mail "> a mail address? "))
7398 (setq pref 'mail)
7399 (setq pref 'mid))))
7400 (cond ((eq pref 'mid)
7401 (gnus-message 8 "calling `gnus-button-handle-news' %s" url-mid)
7402 (gnus-button-handle-news url-mid))
7403 ((eq pref 'mail)
7404 (gnus-message 8 "calling `gnus-url-mailto' %s" url-mailto)
7405 (gnus-url-mailto url-mailto))
7406 (t (gnus-message 3 "Invalid string.")))))
7407
01c52d31
MB
7408(defun gnus-button-handle-custom (fun arg)
7409 "Call function FUN on argument ARG.
7410Both FUN and ARG are supposed to be strings. ARG will be passed
7411as a symbol to FUN."
7412 (funcall (intern fun)
7413 (if (string-match "^customize-apropos" fun)
7414 arg
7415 (intern arg))))
23f87bed
MB
7416
7417(defvar gnus-button-handle-describe-prefix "^\\(C-h\\|<?[Ff]1>?\\)")
7418
23f87bed
MB
7419(defun gnus-button-handle-describe-function (url)
7420 "Call `describe-function' when pushing the corresponding URL button."
7421 (describe-function
7422 (intern
7423 (gnus-replace-in-string url gnus-button-handle-describe-prefix ""))))
7424
7425(defun gnus-button-handle-describe-variable (url)
7426 "Call `describe-variable' when pushing the corresponding URL button."
7427 (describe-variable
7428 (intern
7429 (gnus-replace-in-string url gnus-button-handle-describe-prefix ""))))
7430
7431(defun gnus-button-handle-symbol (url)
7432"Display help on variable or function.
7433Calls `describe-variable' or `describe-function'."
7434 (let ((sym (intern url)))
7435 (cond
7436 ((fboundp sym) (describe-function sym))
7437 ((boundp sym) (describe-variable sym))
7438 (t (gnus-message 3 "`%s' is not a known function of variable." url)))))
7439
7440(defun gnus-button-handle-describe-key (url)
7441 "Call `describe-key' when pushing the corresponding URL button."
7442 (let* ((key-string
7443 (gnus-replace-in-string url gnus-button-handle-describe-prefix ""))
7444 (keys (ignore-errors (eval `(kbd ,key-string)))))
7445 (if keys
7446 (describe-key keys)
7447 (gnus-message 3 "Invalid key sequence in button: %s" key-string))))
7448
7449(defun gnus-button-handle-apropos (url)
7450 "Call `apropos' when pushing the corresponding URL button."
7451 (apropos (gnus-replace-in-string url gnus-button-handle-describe-prefix "")))
7452
7453(defun gnus-button-handle-apropos-command (url)
7454 "Call `apropos' when pushing the corresponding URL button."
7455 (apropos-command
7456 (gnus-replace-in-string url gnus-button-handle-describe-prefix "")))
7457
7458(defun gnus-button-handle-apropos-variable (url)
7459 "Call `apropos' when pushing the corresponding URL button."
7460 (funcall
7461 (if (fboundp 'apropos-variable) 'apropos-variable 'apropos)
7462 (gnus-replace-in-string url gnus-button-handle-describe-prefix "")))
7463
7464(defun gnus-button-handle-apropos-documentation (url)
7465 "Call `apropos' when pushing the corresponding URL button."
7466 (funcall
7467 (if (fboundp 'apropos-documentation) 'apropos-documentation 'apropos)
7468 (gnus-replace-in-string url gnus-button-handle-describe-prefix "")))
7469
7470(defun gnus-button-handle-library (url)
7471 "Call `locate-library' when pushing the corresponding URL button."
7472 (gnus-message 9 "url=`%s'" url)
7473 (let* ((lib (locate-library url))
7474 (file (gnus-replace-in-string (or lib "") "\.elc" ".el")))
7475 (if (not lib)
7476 (gnus-message 1 "Cannot locale library `%s'." url)
7477 (find-file-read-only file))))
7478
23f87bed
MB
7479(defcustom gnus-button-man-level 5
7480 "*Integer that says how many man-related buttons Gnus will show.
7481The higher the number, the more buttons will appear and the more false
7482positives are possible. Note that you can set this variable local to
7483specific groups. Setting it higher in Unix groups is probably a good idea.
7484See Info node `(gnus)Group Parameters' and the variable `gnus-parameters' on
7485how to set variables in specific groups."
bf247b6e 7486 :version "22.1"
23f87bed
MB
7487 :group 'gnus-article-buttons
7488 :link '(custom-manual "(gnus)Group Parameters")
7489 :type 'integer)
7490
7491(defcustom gnus-button-emacs-level 5
7492 "*Integer that says how many emacs-related buttons Gnus will show.
7493The higher the number, the more buttons will appear and the more false
7494positives are possible. Note that you can set this variable local to
7495specific groups. Setting it higher in Emacs or Gnus related groups is
7496probably a good idea. See Info node `(gnus)Group Parameters' and the variable
7497`gnus-parameters' on how to set variables in specific groups."
bf247b6e 7498 :version "22.1"
23f87bed
MB
7499 :group 'gnus-article-buttons
7500 :link '(custom-manual "(gnus)Group Parameters")
7501 :type 'integer)
7502
7503(defcustom gnus-button-message-level 5
7504 "*Integer that says how many buttons for news or mail messages will appear.
7505The higher the number, the more buttons will appear and the more false
7506positives are possible."
7507 ;; mail addresses, MIDs, URLs for news, ...
bf247b6e 7508 :version "22.1"
23f87bed
MB
7509 :group 'gnus-article-buttons
7510 :type 'integer)
7511
7512(defcustom gnus-button-browse-level 5
7513 "*Integer that says how many buttons for browsing will appear.
7514The higher the number, the more buttons will appear and the more false
7515positives are possible."
7516 ;; stuff handled by `browse-url' or `gnus-button-embedded-url'
bf247b6e 7517 :version "22.1"
23f87bed
MB
7518 :group 'gnus-article-buttons
7519 :type 'integer)
7520
eec82323 7521(defcustom gnus-button-alist
23f87bed
MB
7522 '(("<\\(url:[>\n\t ]*?\\)?\\(nntp\\|news\\):[>\n\t ]*\\([^>\n\t ]*@[^>\n\t ]*\\)>"
7523 0 (>= gnus-button-message-level 0) gnus-button-handle-news 3)
97f78c9b
MB
7524 ((concat "\\b\\(nntp\\|news\\):\\("
7525 gnus-button-valid-localpart-regexp "@[a-z0-9.-]+[a-z]\\)")
7526 0 t gnus-button-handle-news 2)
23f87bed
MB
7527 ("\\(\\b<\\(url:[>\n\t ]*\\)?\\(nntp\\|news\\):[>\n\t ]*\\(//\\)?\\([^>\n\t ]*\\)>\\)"
7528 1 (>= gnus-button-message-level 0) gnus-button-fetch-group 5)
7529 ("\\b\\(nntp\\|news\\):\\(//\\)?\\([^'\">\n\t ]+\\)"
7530 0 (>= gnus-button-message-level 0) gnus-button-fetch-group 3)
7531 ;; RFC 2392 (Don't allow `/' in domain part --> CID)
7532 ("\\bmid:\\(//\\)?\\([^'\">\n\t ]+@[^'\">\n\t /]+\\)"
7533 0 (>= gnus-button-message-level 0) gnus-button-message-id 2)
7534 ("\\bin\\( +article\\| +message\\)? +\\(<\\([^\n @<>]+@[^\n @<>]+\\)>\\)"
7535 2 (>= gnus-button-message-level 0) gnus-button-message-id 3)
01c52d31
MB
7536 ("\\b\\(mid\\|message-id\\):? +\\(<\\([^\n @<>]+@[^\n @<>]+\\)>\\)"
7537 2 (>= gnus-button-message-level 0) gnus-button-message-id 3)
23f87bed
MB
7538 ("\\(<URL: *\\)mailto: *\\([^> \n\t]+\\)>"
7539 0 (>= gnus-button-message-level 0) gnus-url-mailto 2)
7540 ;; RFC 2368 (The mailto URL scheme)
531e5812 7541 ("\\bmailto:\\([-a-z.@_+0-9%=?&/]+\\)"
23f87bed
MB
7542 0 (>= gnus-button-message-level 0) gnus-url-mailto 1)
7543 ("\\bmailto:\\([^ \n\t]+\\)"
7544 0 (>= gnus-button-message-level 0) gnus-url-mailto 1)
9eb59592
MB
7545 ;; Info Konqueror style <info:/foo/bar baz>.
7546 ;; Must come before " Gnus home-grown style".
7547 ("\\binfo://?\\([^'\">\n\t]+\\)"
7548 0 (>= gnus-button-emacs-level 1) gnus-button-handle-info-url 1)
7549 ;; Info, Gnus home-grown style (deprecated) <info://foo/bar+baz>
23f87bed
MB
7550 ("\\binfo://\\([^'\">\n\t ]+\\)"
7551 0 (>= gnus-button-emacs-level 1) gnus-button-handle-info-url 1)
7552 ;; Info GNOME style <info:foo#bar_baz>
7553 ("\\binfo:\\([^('\n\t\r \"><][^'\n\t\r \"><]*\\)"
7554 0 (>= gnus-button-emacs-level 1) gnus-button-handle-info-url-gnome 1)
7555 ;; Info KDE style <info:(foo)bar baz>
7556 ("<\\(info:\\(([^)]+)[^>\n\r]*\\)\\)>"
7557 1 (>= gnus-button-emacs-level 1) gnus-button-handle-info-url-kde 2)
7558 ("\\((Info-goto-node\\|(info\\)[ \t\n]*\\(\"[^\"]*\"\\))" 0
7559 (>= gnus-button-emacs-level 1) gnus-button-handle-info-url 2)
9b3ebcb6
MB
7560 ("\\b\\(C-h\\|<?[Ff]1>?\\)[ \t\n]+i[ \t\n]+d?[ \t\n]?m[ \t\n]+[^ ]+ ?[^ ]+[ \t\n]+RET\\([ \t\n]+i[ \t\n]+[^ ]+ ?[^ ]+[ \t\n]+RET\\([ \t\n,]*\\)\\)?"
7561 ;; Info links like `C-h i d m Gnus RET' or `C-h i d m Gnus RET i partial RET'
7562 0 (>= gnus-button-emacs-level 1) gnus-button-handle-info-keystrokes 0)
23f87bed 7563 ;; This is custom
e425f18b 7564 ("M-x[ \t\n]\\(customize-[^ ]+\\)[ \t\n]RET[ \t\n]\\([^ ]+\\)[ \t\n]RET\\>" 0
01c52d31 7565 (>= gnus-button-emacs-level 1) gnus-button-handle-custom 1 2)
23f87bed 7566 ;; Emacs help commands
e425f18b 7567 ("M-x[ \t\n]+apropos[ \t\n]+RET[ \t\n]+\\([^ \t\n]+\\)[ \t\n]+RET\\>"
23f87bed
MB
7568 ;; regexp doesn't match arguments containing ` '.
7569 0 (>= gnus-button-emacs-level 1) gnus-button-handle-apropos 1)
e425f18b 7570 ("M-x[ \t\n]+apropos-command[ \t\n]+RET[ \t\n]+\\([^ \t\n]+\\)[ \t\n]+RET\\>"
23f87bed 7571 0 (>= gnus-button-emacs-level 1) gnus-button-handle-apropos-command 1)
e425f18b 7572 ("M-x[ \t\n]+apropos-variable[ \t\n]+RET[ \t\n]+\\([^ \t\n]+\\)[ \t\n]+RET\\>"
23f87bed 7573 0 (>= gnus-button-emacs-level 1) gnus-button-handle-apropos-variable 1)
e425f18b 7574 ("M-x[ \t\n]+apropos-documentation[ \t\n]+RET[ \t\n]+\\([^ \t\n]+\\)[ \t\n]+RET\\>"
23f87bed
MB
7575 0 (>= gnus-button-emacs-level 1) gnus-button-handle-apropos-documentation 1)
7576 ;; The following entries may lead to many false positives so don't enable
531e5812
MB
7577 ;; them by default (use a high button level).
7578 ("/\\([a-z][-a-z0-9]+\\.el\\)\\>[^.?]"
7579 ;; Exclude [.?] for URLs in gmane.emacs.cvs
23f87bed
MB
7580 1 (>= gnus-button-emacs-level 8) gnus-button-handle-library 1)
7581 ("`\\([a-z][-a-z0-9]+\\.el\\)'"
7582 1 (>= gnus-button-emacs-level 8) gnus-button-handle-library 1)
01c52d31 7583 ("`\\([a-z][a-z0-9]+-[a-z0-9]+-[-a-z0-9]*[a-z]\\|\\(gnus\\|message\\)-[-a-z]+\\)'"
23f87bed
MB
7584 0 (>= gnus-button-emacs-level 8) gnus-button-handle-symbol 1)
7585 ("`\\([a-z][a-z0-9]+-[a-z]+\\)'"
7586 0 (>= gnus-button-emacs-level 9) gnus-button-handle-symbol 1)
7587 ("(setq[ \t\n]+\\([a-z][a-z0-9]+-[-a-z0-9]+\\)[ \t\n]+.+)"
7588 1 (>= gnus-button-emacs-level 7) gnus-button-handle-describe-variable 1)
e425f18b 7589 ("\\bM-x[ \t\n]+\\([^ \t\n]+\\)[ \t\n]+RET\\>"
23f87bed 7590 1 (>= gnus-button-emacs-level 7) gnus-button-handle-describe-function 1)
e425f18b 7591 ("\\b\\(C-h\\|<?[Ff]1>?\\)[ \t\n]+f[ \t\n]+\\([^ \t\n]+\\)[ \t\n]+RET\\>"
23f87bed 7592 0 (>= gnus-button-emacs-level 1) gnus-button-handle-describe-function 2)
e425f18b 7593 ("\\b\\(C-h\\|<?[Ff]1>?\\)[ \t\n]+v[ \t\n]+\\([^ \t\n]+\\)[ \t\n]+RET\\>"
23f87bed 7594 0 (>= gnus-button-emacs-level 1) gnus-button-handle-describe-variable 2)
87ba2830 7595 ("`\\(\\(C-h\\|<?[Ff]1>?\\)[ \t\n]+k[ \t\n]+\\([^']+\\)\\)'"
23f87bed
MB
7596 ;; Unlike the other regexps we really have to require quoting
7597 ;; here to determine where it ends.
7598 1 (>= gnus-button-emacs-level 1) gnus-button-handle-describe-key 3)
7599 ;; This is how URLs _should_ be embedded in text (RFC 1738, RFC 2396)...
01c52d31 7600 ("<URL: *\\([^\n<>]*\\)>"
23f87bed
MB
7601 1 (>= gnus-button-browse-level 0) gnus-button-embedded-url 1)
7602 ;; RFC 2396 (2.4.3., delims) ...
01c52d31 7603 ("\"URL: *\\([^\n\"]*\\)\""
23f87bed 7604 1 (>= gnus-button-browse-level 0) gnus-button-embedded-url 1)
eec82323 7605 ;; Raw URLs.
23f87bed
MB
7606 (gnus-button-url-regexp
7607 0 (>= gnus-button-browse-level 0) browse-url 0)
7608 ;; man pages
531e5812 7609 ("\\b\\([a-z][a-z]+([1-9])\\)\\W"
23f87bed
MB
7610 0 (and (>= gnus-button-man-level 1) (< gnus-button-man-level 3))
7611 gnus-button-handle-man 1)
7612 ;; more man pages: resolv.conf(5), iso_8859-1(7), xterm(1x)
531e5812 7613 ("\\b\\([a-z][-_.a-z0-9]+([1-9])\\)\\W"
23f87bed
MB
7614 0 (and (>= gnus-button-man-level 3) (< gnus-button-man-level 5))
7615 gnus-button-handle-man 1)
7616 ;; even more: Apache::PerlRun(3pm), PDL::IO::FastRaw(3pm),
7617 ;; SoWWWAnchor(3iv), XSelectInput(3X11), X(1), X(7)
531e5812 7618 ("\\b\\(\\(?:[a-z][-+_.:a-z0-9]+([1-9][X1a-z]*)\\)\\|\\b\\(?:X([1-9])\\)\\)\\W"
23f87bed 7619 0 (>= gnus-button-man-level 5) gnus-button-handle-man 1)
01c52d31
MB
7620 ;; Recognizing patches to .el files. This is somewhat obscure,
7621 ;; but considering the percentage of Gnus users who hack Emacs
7622 ;; Lisp files...
7623 ("^--- \\([^ .]+\\.el\\).*\n.*\n@@ -?\\([0-9]+\\)" 1
7624 (>= gnus-button-message-level 4) gnus-button-patch 1 2)
7625 ("^\\*\\*\\* \\([^ .]+\\.el\\).*\n.*\n\\*+\n\\*\\*\\* \\([0-9]+\\)" 1
7626 (>= gnus-button-message-level 4) gnus-button-patch 1 2)
23f87bed
MB
7627 ;; MID or mail: To avoid too many false positives we don't try to catch
7628 ;; all kind of allowed MIDs or mail addresses. Domain part must contain
7629 ;; at least one dot. TLD must contain two or three chars or be a know TLD
7630 ;; (info|name|...). Put this entry near the _end_ of `gnus-button-alist'
7631 ;; so that non-ambiguous entries (see above) match first.
7632 (gnus-button-mid-or-mail-regexp
7633 0 (>= gnus-button-message-level 5) gnus-button-handle-mid-or-mail 1))
6748645f 7634 "*Alist of regexps matching buttons in article bodies.
eec82323
LMI
7635
7636Each entry has the form (REGEXP BUTTON FORM CALLBACK PAR...), where
23f87bed
MB
7637REGEXP: is the string (case insensitive) matching text around the button (can
7638also be Lisp expression evaluating to a string),
eec82323 7639BUTTON: is the number of the regexp grouping actually matching the button,
4e7d0221 7640FORM: is a Lisp expression which must eval to true for the button to
eec82323
LMI
7641be added,
7642CALLBACK: is the function to call when the user push this button, and each
7643PAR: is a number of a regexp grouping whose text will be passed to CALLBACK.
7644
7645CALLBACK can also be a variable, in that case the value of that
7646variable it the real callback function."
7647 :group 'gnus-article-buttons
23f87bed 7648 :type '(repeat (list (choice regexp variable sexp)
eec82323
LMI
7649 (integer :tag "Button")
7650 (sexp :tag "Form")
7651 (function :tag "Callback")
7652 (repeat :tag "Par"
7653 :inline t
7654 (integer :tag "Regexp group")))))
60ece9b0 7655(put 'gnus-button-alist 'risky-local-variable t)
eec82323
LMI
7656
7657(defcustom gnus-header-button-alist
23f87bed
MB
7658 '(("^\\(References\\|Message-I[Dd]\\|^In-Reply-To\\):" "<[^<>]+>"
7659 0 (>= gnus-button-message-level 0) gnus-button-message-id 0)
7660 ("^\\(From\\|Reply-To\\):" ": *\\(.+\\)$"
7661 1 (>= gnus-button-message-level 0) gnus-button-reply 1)
eec82323 7662 ("^\\(Cc\\|To\\):" "[^ \t\n<>,()\"]+@[^ \t\n<>,()\"]+"
fa9a04e1 7663 0 (>= gnus-button-message-level 0) gnus-msg-mail 0)
23f87bed
MB
7664 ("^X-[Uu][Rr][Ll]:" gnus-button-url-regexp
7665 0 (>= gnus-button-browse-level 0) browse-url 0)
7666 ("^Subject:" gnus-button-url-regexp
7667 0 (>= gnus-button-browse-level 0) browse-url 0)
7668 ("^[^:]+:" gnus-button-url-regexp
7669 0 (>= gnus-button-browse-level 0) browse-url 0)
01c52d31
MB
7670 ("^OpenPGP:.*url=" gnus-button-url-regexp
7671 0 (>= gnus-button-browse-level 0) gnus-button-openpgp 0)
531e5812 7672 ("^[^:]+:" "\\bmailto:\\([-a-z.@_+0-9%=?&/]+\\)"
23f87bed
MB
7673 0 (>= gnus-button-message-level 0) gnus-url-mailto 1)
7674 ("^[^:]+:" "\\(<\\(url: \\)?\\(nntp\\|news\\):\\([^>\n ]*\\)>\\)"
7675 1 (>= gnus-button-message-level 0) gnus-button-message-id 4))
6748645f 7676 "*Alist of headers and regexps to match buttons in article heads.
eec82323
LMI
7677
7678This alist is very similar to `gnus-button-alist', except that each
7679alist has an additional HEADER element first in each entry:
7680
7681\(HEADER REGEXP BUTTON FORM CALLBACK PAR)
7682
7683HEADER is a regexp to match a header. For a fuller explanation, see
7684`gnus-button-alist'."
7685 :group 'gnus-article-buttons
7686 :group 'gnus-article-headers
7687 :type '(repeat (list (regexp :tag "Header")
23f87bed 7688 (choice regexp variable)
eec82323
LMI
7689 (integer :tag "Button")
7690 (sexp :tag "Form")
7691 (function :tag "Callback")
7692 (repeat :tag "Par"
7693 :inline t
7694 (integer :tag "Regexp group")))))
60ece9b0 7695(put 'gnus-header-button-alist 'risky-local-variable t)
eec82323 7696
eec82323
LMI
7697;;; Commands:
7698
7699(defun gnus-article-push-button (event)
7700 "Check text under the mouse pointer for a callback function.
7701If the text under the mouse pointer has a `gnus-callback' property,
7702call it with the value of the `gnus-data' text property."
7703 (interactive "e")
7704 (set-buffer (window-buffer (posn-window (event-start event))))
7705 (let* ((pos (posn-point (event-start event)))
23f87bed 7706 (data (get-text-property pos 'gnus-data))
eec82323 7707 (fun (get-text-property pos 'gnus-callback)))
6748645f 7708 (goto-char pos)
eec82323
LMI
7709 (when fun
7710 (funcall fun data))))
7711
7712(defun gnus-article-press-button ()
7713 "Check text at point for a callback function.
7714If the text at point has a `gnus-callback' property,
7715call it with the value of the `gnus-data' text property."
7716 (interactive)
23f87bed
MB
7717 (let ((data (get-text-property (point) 'gnus-data))
7718 (fun (get-text-property (point) 'gnus-callback)))
eec82323
LMI
7719 (when fun
7720 (funcall fun data))))
7721
eec82323
LMI
7722(defun gnus-article-highlight (&optional force)
7723 "Highlight current article.
7724This function calls `gnus-article-highlight-headers',
7725`gnus-article-highlight-citation',
7726`gnus-article-highlight-signature', and `gnus-article-add-buttons' to
7727do the highlighting. See the documentation for those functions."
7728 (interactive (list 'force))
7729 (gnus-article-highlight-headers)
7730 (gnus-article-highlight-citation force)
7731 (gnus-article-highlight-signature)
a2e3ac99 7732 (gnus-article-add-buttons)
eec82323
LMI
7733 (gnus-article-add-buttons-to-head))
7734
7735(defun gnus-article-highlight-some (&optional force)
7736 "Highlight current article.
7737This function calls `gnus-article-highlight-headers',
7738`gnus-article-highlight-signature', and `gnus-article-add-buttons' to
7739do the highlighting. See the documentation for those functions."
7740 (interactive (list 'force))
7741 (gnus-article-highlight-headers)
7742 (gnus-article-highlight-signature)
7743 (gnus-article-add-buttons))
7744
7745(defun gnus-article-highlight-headers ()
7746 "Highlight article headers as specified by `gnus-header-face-alist'."
7747 (interactive)
01c52d31
MB
7748 (gnus-with-article-headers
7749 (let (regexp header-face field-face from hpoints fpoints)
7750 (dolist (entry gnus-header-face-alist)
7751 (goto-char (point-min))
7752 (setq regexp (concat "^\\("
7753 (if (string-equal "" (nth 0 entry))
7754 "[^\t ]"
7755 (nth 0 entry))
7756 "\\)")
7757 header-face (nth 1 entry)
7758 field-face (nth 2 entry))
7759 (while (and (re-search-forward regexp nil t)
7760 (not (eobp)))
7761 (beginning-of-line)
7762 (setq from (point))
7763 (unless (search-forward ":" nil t)
7764 (forward-char 1))
7765 (when (and header-face
7766 (not (memq (point) hpoints)))
7767 (push (point) hpoints)
7768 (gnus-put-text-property from (point) 'face header-face))
7769 (when (and field-face
7770 (not (memq (setq from (point)) fpoints)))
7771 (push from fpoints)
7772 (if (re-search-forward "^[^ \t]" nil t)
7773 (forward-char -2)
7774 (goto-char (point-max)))
7775 (gnus-put-text-property from (point) 'face field-face)))))))
eec82323
LMI
7776
7777(defun gnus-article-highlight-signature ()
7778 "Highlight the signature in an article.
7779It does this by highlighting everything after
0f49874b 7780`gnus-signature-separator' using the face `gnus-signature'."
eec82323 7781 (interactive)
01c52d31
MB
7782 (gnus-with-article-buffer
7783 (let ((inhibit-point-motion-hooks t))
eec82323
LMI
7784 (save-restriction
7785 (when (and gnus-signature-face
7786 (gnus-article-narrow-to-signature))
01c52d31 7787 (gnus-overlay-put (gnus-make-overlay (point-min) (point-max) nil t)
eec82323
LMI
7788 'face gnus-signature-face)
7789 (widen)
7790 (gnus-article-search-signature)
7791 (let ((start (match-beginning 0))
7792 (end (set-marker (make-marker) (1+ (match-end 0)))))
7793 (gnus-article-add-button start (1- end) 'gnus-signature-toggle
7794 end)))))))
7795
7796(defun gnus-button-in-region-p (b e prop)
7797 "Say whether PROP exists in the region."
7798 (text-property-not-all b e prop nil))
7799
672022e7 7800(defun gnus-article-add-buttons ()
eec82323
LMI
7801 "Find external references in the article and make buttons of them.
7802\"External references\" are things like Message-IDs and URLs, as
7803specified by `gnus-button-alist'."
672022e7 7804 (interactive)
01c52d31
MB
7805 (gnus-with-article-buffer
7806 (let ((inhibit-point-motion-hooks t)
eec82323
LMI
7807 (case-fold-search t)
7808 (alist gnus-button-alist)
7809 beg entry regexp)
eec82323 7810 ;; We skip the headers.
16409b0b 7811 (article-goto-body)
eec82323
LMI
7812 (setq beg (point))
7813 (while (setq entry (pop alist))
23f87bed 7814 (setq regexp (eval (car entry)))
eec82323
LMI
7815 (goto-char beg)
7816 (while (re-search-forward regexp nil t)
01c52d31
MB
7817 (let ((start (match-beginning (nth 1 entry)))
7818 (end (match-end (nth 1 entry)))
7819 (from (match-beginning 0)))
672022e7 7820 (when (and (eval (nth 2 entry))
eec82323
LMI
7821 (not (gnus-button-in-region-p
7822 start end 'gnus-callback)))
7823 ;; That optional form returned non-nil, so we add the
7824 ;; button.
01c52d31 7825 (setq from (set-marker (make-marker) from))
01c52d31
MB
7826 (unless (and (eq (car entry) 'gnus-button-url-regexp)
7827 (gnus-article-extend-url-button from start end))
7828 (gnus-article-add-button start end
672022e7 7829 'gnus-button-push (list from entry))
7426b4f7
LMI
7830 (gnus-put-text-property
7831 start end
10e91ca9
LMI
7832 'gnus-string (buffer-substring-no-properties
7833 start end))))))))))
01c52d31
MB
7834
7835(defun gnus-article-extend-url-button (beg start end)
7836 "Extend url button if url is folded into two or more lines.
7837Return non-nil if button is extended. BEG is a marker that points to
7838the beginning position of a text containing url. START and END are
7839the endpoints of a url button before it is extended. The concatenated
7840url is put as the `gnus-button-url' overlay property on the button."
7841 (let ((opoint (point))
7842 (points (list start end))
7843 url delim regexp)
7844 (prog1
7845 (when (and (progn
7846 (goto-char end)
7847 (not (looking-at "[\t ]*[\">]")))
7848 (progn
7849 (goto-char start)
7850 (string-match
7851 "\\(?:\"\\|\\(<\\)\\)[\t ]*\\(?:url[\t ]*:[\t ]*\\)?\\'"
7852 (buffer-substring (point-at-bol) start)))
7853 (progn
7854 (setq url (list (buffer-substring start end))
7855 delim (if (match-beginning 1) ">" "\""))
7856 (beginning-of-line)
7857 (setq regexp (concat
7858 (when (and (looking-at
7859 message-cite-prefix-regexp)
7860 (< (match-end 0) start))
7861 (regexp-quote (match-string 0)))
7862 "\
7863\[\t ]*\\(?:\\([^\t\n \">]+\\)[\t ]*$\\|\\([^\t\n \">]*\\)[\t ]*"
7864 delim "\\)"))
7865 (while (progn
7866 (forward-line 1)
7867 (and (looking-at regexp)
7868 (prog1
7869 (match-beginning 1)
7870 (push (or (match-string 2)
7871 (match-string 1))
7872 url)
7873 (push (setq end (or (match-end 2)
7874 (match-end 1)))
7875 points)
7876 (push (or (match-beginning 2)
7877 (match-beginning 1))
7878 points)))))
7879 (match-beginning 2)))
7880 (let (gnus-article-mouse-face widget-mouse-face)
7881 (while points
7882 (gnus-article-add-button (pop points) (pop points)
dbca79f8
KY
7883 'gnus-button-push
7884 (list beg (assq 'gnus-button-url-regexp
7885 gnus-button-alist)))))
01c52d31
MB
7886 (let ((overlay (gnus-make-overlay start end)))
7887 (gnus-overlay-put overlay 'evaporate t)
7888 (gnus-overlay-put overlay 'gnus-button-url
7889 (list (mapconcat 'identity (nreverse url) "")))
7890 (when gnus-article-mouse-face
7891 (gnus-overlay-put overlay 'mouse-face gnus-article-mouse-face)))
7892 t)
7893 (goto-char opoint))))
eec82323
LMI
7894
7895;; Add buttons to the head of an article.
7896(defun gnus-article-add-buttons-to-head ()
7897 "Add buttons to the head of the article."
7898 (interactive)
01c52d31
MB
7899 (gnus-with-article-headers
7900 (let (beg end)
7901 (dolist (entry gnus-header-button-alist)
7902 ;; Each alist entry.
7903 (goto-char (point-min))
7904 (while (re-search-forward (car entry) nil t)
7905 ;; Each header matching the entry.
7906 (setq beg (match-beginning 0))
7907 (setq end (or (and (re-search-forward "^[^ \t]" nil t)
7908 (match-beginning 0))
7909 (point-max)))
7910 (goto-char beg)
7911 (while (re-search-forward (eval (nth 1 entry)) end t)
7912 ;; Each match within a header.
7913 (let* ((entry (cdr entry))
7914 (start (match-beginning (nth 1 entry)))
7915 (end (match-end (nth 1 entry)))
7916 (form (nth 2 entry)))
7917 (goto-char (match-end 0))
7918 (when (eval form)
7919 (gnus-article-add-button
7920 start end (nth 3 entry)
7921 (buffer-substring (match-beginning (nth 4 entry))
7922 (match-end (nth 4 entry)))))))
7923 (goto-char end))))))
eec82323
LMI
7924
7925;;; External functions:
7926
b1992461 7927(defun gnus-article-add-button (from to fun &optional data text)
eec82323
LMI
7928 "Create a button between FROM and TO with callback FUN and data DATA."
7929 (when gnus-article-button-face
01c52d31 7930 (gnus-overlay-put (gnus-make-overlay from to nil t)
eec82323
LMI
7931 'face gnus-article-button-face))
7932 (gnus-add-text-properties
7933 from to
7934 (nconc (and gnus-article-mouse-face
7935 (list gnus-mouse-face-prop gnus-article-mouse-face))
7936 (list 'gnus-callback fun)
16409b0b
GM
7937 (and data (list 'gnus-data data))))
7938 (widget-convert-button 'link from to :action 'gnus-widget-press-button
b1992461 7939 :help-echo (or text "Follow the link")
7426b4f7 7940 :keymap gnus-url-button-map
16409b0b 7941 :button-keymap gnus-widget-button-keymap))
eec82323 7942
7426b4f7
LMI
7943(defun gnus-article-copy-string ()
7944 "Copy the string in the button to the kill ring."
7945 (interactive)
7946 (gnus-article-check-buffer)
10e91ca9 7947 (let ((data (get-text-property (point) 'gnus-string)))
7426b4f7
LMI
7948 (when data
7949 (with-temp-buffer
7950 (insert data)
c25d60ab
LMI
7951 (copy-region-as-kill (point-min) (point-max))
7952 (message "Copied %s" data)))))
7426b4f7 7953
eec82323
LMI
7954;;; Internal functions:
7955
a8151ef7 7956(defun gnus-article-set-globals ()
01c52d31 7957 (with-current-buffer gnus-summary-buffer
a8151ef7
LMI
7958 (gnus-set-global-variables)))
7959
eec82323 7960(defun gnus-signature-toggle (end)
01c52d31
MB
7961 (gnus-with-article-buffer
7962 (let ((inhibit-point-motion-hooks t))
520aa572 7963 (if (text-property-any end (point-max) 'article-type 'signature)
23f87bed
MB
7964 (progn
7965 (gnus-delete-wash-type 'signature)
7966 (gnus-remove-text-properties-when
7967 'article-type 'signature end (point-max)
7968 (cons 'article-type (cons 'signature
7969 gnus-hidden-properties))))
7970 (gnus-add-wash-type 'signature)
520aa572
SZ
7971 (gnus-add-text-properties-when
7972 'article-type nil end (point-max)
7973 (cons 'article-type (cons 'signature
23f87bed
MB
7974 gnus-hidden-properties)))))
7975 (let ((gnus-article-mime-handle-alist-1 gnus-article-mime-handle-alist))
7976 (gnus-set-mode-line 'article))))
eec82323 7977
672022e7 7978(defun gnus-button-push (marker-and-entry)
eec82323
LMI
7979 ;; Push button starting at MARKER.
7980 (save-excursion
672022e7
G
7981 (let* ((marker (car marker-and-entry))
7982 (entry (cadr marker-and-entry))
7983 (regexp (car entry))
7984 (inhibit-point-motion-hooks t))
7985 (goto-char marker)
7986 ;; This is obviously true, or something bad is happening :)
7987 ;; But we need it to have the match-data
7988 (when (looking-at (or (if (symbolp regexp)
7989 (symbol-value regexp)
7990 regexp)))
7991 (let ((fun (nth 3 entry))
7992 (args (or (and (eq (car entry) 'gnus-button-url-regexp)
7993 (get-char-property marker 'gnus-button-url))
7994 (mapcar (lambda (group)
7995 (let ((string (match-string group)))
7996 (set-text-properties
7997 0 (length string) nil string)
7998 string))
7999 (nthcdr 4 entry)))))
8000
8001 (cond
8002 ((fboundp fun)
8003 (apply fun args))
8004 ((and (boundp fun)
8005 (fboundp (symbol-value fun)))
8006 (apply (symbol-value fun) args))
8007 (t
8008 (gnus-message 1 "You must define `%S' to use this button"
8009 (cons fun args)))))))))
eec82323 8010
23f87bed 8011(defun gnus-parse-news-url (url)
82a8ad04 8012 (let (scheme server port group message-id articles)
23f87bed
MB
8013 (with-temp-buffer
8014 (insert url)
8015 (goto-char (point-min))
8016 (when (looking-at "\\([A-Za-z]+\\):")
8017 (setq scheme (match-string 1))
8018 (goto-char (match-end 0)))
82a8ad04 8019 (when (looking-at "//\\([^:/]+\\)\\(:?\\)\\([0-9]+\\)?/")
23f87bed 8020 (setq server (match-string 1))
82a8ad04
MB
8021 (setq port (if (stringp (match-string 3))
8022 (string-to-number (match-string 3))
8023 (match-string 3)))
23f87bed
MB
8024 (goto-char (match-end 0)))
8025
8026 (cond
8027 ((looking-at "\\(.*@.*\\)")
8028 (setq message-id (match-string 1)))
8029 ((looking-at "\\([^/]+\\)/\\([-0-9]+\\)")
8030 (setq group (match-string 1)
8031 articles (split-string (match-string 2) "-")))
8032 ((looking-at "\\([^/]+\\)/?")
8033 (setq group (match-string 1)))
8034 (t
8035 (error "Unknown news URL syntax"))))
82a8ad04 8036 (list scheme server port group message-id articles)))
23f87bed
MB
8037
8038(defun gnus-button-handle-news (url)
8039 "Fetch a news URL."
82a8ad04 8040 (destructuring-bind (scheme server port group message-id articles)
23f87bed
MB
8041 (gnus-parse-news-url url)
8042 (cond
8043 (message-id
80de1778 8044 (with-current-buffer gnus-summary-buffer
23f87bed 8045 (if server
ff4d3926
MB
8046 (let ((gnus-refer-article-method
8047 (nconc (list (list 'nntp server))
8048 gnus-refer-article-method))
82a8ad04 8049 (nntp-port-number (or port "nntp")))
ff4d3926
MB
8050 (gnus-message 7 "Fetching %s with %s"
8051 message-id gnus-refer-article-method)
23f87bed
MB
8052 (gnus-summary-refer-article message-id))
8053 (gnus-summary-refer-article message-id))))
8054 (group
8055 (gnus-button-fetch-group url)))))
8056
01c52d31
MB
8057(defun gnus-button-patch (library line)
8058 "Visit an Emacs Lisp library LIBRARY on line LINE."
8059 (interactive)
8060 (let ((file (locate-library (file-name-nondirectory library))))
8061 (unless file
8062 (error "Couldn't find library %s" library))
8063 (find-file file)
5dcc825f
GM
8064 (goto-char (point-min))
8065 (forward-line (1- (string-to-number line)))))
01c52d31 8066
23f87bed
MB
8067(defun gnus-button-handle-man (url)
8068 "Fetch a man page."
531e5812
MB
8069 (gnus-message 9 "`%s' `%s'" gnus-button-man-handler url)
8070 (when (eq gnus-button-man-handler 'woman)
8071 (setq url (gnus-replace-in-string url "([1-9][X1a-z]*).*\\'" "")))
8072 (gnus-message 9 "`%s' `%s'" gnus-button-man-handler url)
23f87bed
MB
8073 (funcall gnus-button-man-handler url))
8074
8075(defun gnus-button-handle-info-url (url)
8076 "Fetch an info URL."
8077 (setq url (mm-subst-char-in-string ?+ ?\ url))
8078 (cond
8079 ((string-match "^\\([^:/]+\\)?/\\(.*\\)" url)
8080 (gnus-info-find-node
8081 (concat "(" (or (gnus-url-unhex-string (match-string 1 url))
8082 "Gnus")
8083 ")" (gnus-url-unhex-string (match-string 2 url)))))
8084 ((string-match "([^)\"]+)[^\"]+" url)
8085 (setq url
8086 (gnus-replace-in-string
8087 (gnus-replace-in-string url "[\n\t ]+" " ") "\"" ""))
8088 (gnus-info-find-node url))
8089 (t (error "Can't parse %s" url))))
8090
8091(defun gnus-button-handle-info-url-gnome (url)
8092 "Fetch GNOME style info URL."
8093 (setq url (mm-subst-char-in-string ?_ ?\ url))
8094 (if (string-match "\\([^#]+\\)#?\\(.*\\)" url)
8095 (gnus-info-find-node
8096 (concat "("
bf247b6e 8097 (gnus-url-unhex-string
23f87bed
MB
8098 (match-string 1 url))
8099 ")"
bf247b6e 8100 (or (gnus-url-unhex-string
23f87bed
MB
8101 (match-string 2 url))
8102 "Top")))
8103 (error "Can't parse %s" url)))
8104
8105(defun gnus-button-handle-info-url-kde (url)
8106 "Fetch KDE style info URL."
8107 (gnus-info-find-node (gnus-url-unhex-string url)))
8108
9640c3bc
GM
8109;; (info) will autoload info.el
8110(declare-function Info-menu "info" (menu-item &optional fork))
9b3ebcb6 8111(declare-function Info-index-next "info" (num))
9640c3bc 8112
23f87bed
MB
8113(defun gnus-button-handle-info-keystrokes (url)
8114 "Call `info' when pushing the corresponding URL button."
9b3ebcb6
MB
8115 ;; For links like `C-h i d m gnus RET part RET , ,', `C-h i d m CC Mode RET'.
8116 (let (node indx comma)
8117 (if (string-match
8118 (concat "\\b\\(C-h\\|<?[Ff]1>?\\)[ \t\n]+i[ \t\n]+d?[ \t\n]?m[ \t\n]+"
8119 "\\([^ ]+ ?[^ ]+\\)[ \t\n]+RET"
e425f18b 8120 "\\([ \t\n]+i[ \t\n]+[^ ]+ ?[^ ]+[ \t\n]+RET\\>"
9b3ebcb6
MB
8121 "\\(?:[ \t\n,]*\\)\\)?")
8122 url)
8123 (setq node (match-string 2 url)
8124 indx (match-string 3 url))
8125 (error "Can't parse %s" url))
8126 (info)
8127 (Info-directory)
8128 (Info-menu node)
8129 (when (> (length indx) 0)
e425f18b 8130 (string-match (concat "[ \t\n]+i[ \t\n]+\\([^ ]+ ?[^ ]+\\)[ \t\n]+RET\\>"
9b3ebcb6
MB
8131 "\\([ \t\n,]*\\)")
8132 indx)
8133 (setq comma (match-string 2 indx))
8134 (setq indx (match-string 1 indx))
8135 (Info-index indx)
8136 (when comma
8137 (dotimes (i (with-temp-buffer
8138 (insert comma)
8139 ;; Note: the XEmacs version of `how-many' takes
8140 ;; no optional argument.
8141 (goto-char (point-min))
8142 (how-many ",")))
8143 (Info-index-next 1)))
8144 nil)))
1888e568 8145
9d9cfd53 8146(autoload 'pgg-snarf-keys-region "pgg")
1888e568
GM
8147;; Called after pgg-snarf-keys-region, which autoloads pgg.el.
8148(declare-function pgg-display-output-buffer "pgg" (start end status))
23f87bed 8149
01c52d31
MB
8150(defun gnus-button-openpgp (url)
8151 "Retrieve and add an OpenPGP key given URL from an OpenPGP header."
8152 (with-temp-buffer
8153 (mm-url-insert-file-contents-external url)
8154 (pgg-snarf-keys-region (point-min) (point-max))
8155 (pgg-display-output-buffer nil nil nil)))
8156
eec82323
LMI
8157(defun gnus-button-message-id (message-id)
8158 "Fetch MESSAGE-ID."
01c52d31 8159 (with-current-buffer gnus-summary-buffer
eec82323
LMI
8160 (gnus-summary-refer-article message-id)))
8161
01c52d31 8162(defun gnus-button-fetch-group (address &rest ignore)
eec82323 8163 "Fetch GROUP specified by ADDRESS."
01c52d31
MB
8164 (when (string-match "\\`\\(nntp\\|news\\):\\(//\\)?\\(.*\\)\\'"
8165 address)
8166 ;; Allow to use `gnus-button-fetch-group' in `browse-url-browser-function'
8167 ;; for nntp:// and news://
8168 (setq address (match-string 3 address)))
eec82323
LMI
8169 (if (not (string-match "[:/]" address))
8170 ;; This is just a simple group url.
8171 (gnus-group-read-ephemeral-group address gnus-select-method)
23f87bed
MB
8172 (if (not
8173 (string-match
8174 "^\\([^:/]+\\)\\(:\\([^/]+\\)\\)?/\\([^/]+\\)\\(/\\([0-9]+\\)\\)?"
8175 address))
eec82323
LMI
8176 (error "Can't parse %s" address)
8177 (gnus-group-read-ephemeral-group
8178 (match-string 4 address)
8179 `(nntp ,(match-string 1 address)
8180 (nntp-address ,(match-string 1 address))
8181 (nntp-port-number ,(if (match-end 3)
8182 (match-string 3 address)
23f87bed
MB
8183 "nntp")))
8184 nil nil nil
e9bd5782 8185 (and (match-end 6) (list (string-to-number (match-string 6 address))))))))
eec82323 8186
eec82323
LMI
8187(defun gnus-url-parse-query-string (query &optional downcase)
8188 (let (retval pairs cur key val)
16409b0b 8189 (setq pairs (split-string query "&"))
eec82323
LMI
8190 (while pairs
8191 (setq cur (car pairs)
23f87bed 8192 pairs (cdr pairs))
eec82323 8193 (if (not (string-match "=" cur))
23f87bed
MB
8194 nil ; Grace
8195 (setq key (gnus-url-unhex-string (substring cur 0 (match-beginning 0)))
8196 val (gnus-url-unhex-string (substring cur (match-end 0) nil) t))
8197 (if downcase
8198 (setq key (downcase key)))
8199 (setq cur (assoc key retval))
8200 (if cur
8201 (setcdr cur (cons val (cdr cur)))
8202 (setq retval (cons (list key val) retval)))))
eec82323
LMI
8203 retval))
8204
eec82323
LMI
8205(defun gnus-url-mailto (url)
8206 ;; Send mail to someone
1e91d0eb 8207 (setq url (replace-regexp-in-string "\n" " " url))
eec82323
LMI
8208 (when (string-match "mailto:/*\\(.*\\)" url)
8209 (setq url (substring url (match-beginning 1) nil)))
6748645f 8210 (let (to args subject func)
23f87bed
MB
8211 (setq args (gnus-url-parse-query-string
8212 (if (string-match "^\\?" url)
8213 (substring url 1)
8214 (if (string-match "^\\([^?]+\\)\\?\\(.*\\)" url)
8215 (concat "to=" (match-string 1 url) "&"
8216 (match-string 2 url))
440b1345 8217 (concat "to=" url))))
23f87bed
MB
8218 subject (cdr-safe (assoc "subject" args)))
8219 (gnus-msg-mail)
eec82323
LMI
8220 (while args
8221 (setq func (intern-soft (concat "message-goto-" (downcase (caar args)))))
8222 (if (fboundp func)
23f87bed
MB
8223 (funcall func)
8224 (message-position-on-field (caar args)))
8225 (insert (gnus-replace-in-string
8226 (mapconcat 'identity (reverse (cdar args)) ", ")
8227 "\r\n" "\n" t))
eec82323
LMI
8228 (setq args (cdr args)))
8229 (if subject
23f87bed 8230 (message-goto-body)
eec82323
LMI
8231 (message-goto-subject))))
8232
eec82323 8233(defun gnus-button-embedded-url (address)
e0bad764 8234 "Activate ADDRESS with `browse-url'."
1b978bfc 8235 (browse-url (gnus-strip-whitespace address)))
eec82323
LMI
8236
8237;;; Next/prev buttons in the article buffer.
8238
8239(defvar gnus-next-page-line-format "%{%(Next page...%)%}\n")
8240(defvar gnus-prev-page-line-format "%{%(Previous page...%)%}\n")
8241
23f87bed
MB
8242(defvar gnus-prev-page-map
8243 (let ((map (make-sparse-keymap)))
23f87bed
MB
8244 (define-key map gnus-mouse-2 'gnus-button-prev-page)
8245 (define-key map "\r" 'gnus-button-prev-page)
8246 map))
8247
8248(defvar gnus-next-page-map
8249 (let ((map (make-sparse-keymap)))
23f87bed
MB
8250 (define-key map gnus-mouse-2 'gnus-button-next-page)
8251 (define-key map "\r" 'gnus-button-next-page)
8252 map))
eec82323
LMI
8253
8254(defun gnus-insert-prev-page-button ()
01c52d31 8255 (let ((b (point)) e
23f87bed 8256 (inhibit-read-only t))
eec82323
LMI
8257 (gnus-eval-format
8258 gnus-prev-page-line-format nil
01c52d31
MB
8259 `(keymap ,gnus-prev-page-map
8260 gnus-prev t
8261 gnus-callback gnus-article-button-prev-page
8262 article-type annotation))
8263 (setq e (if (bolp)
8264 ;; Exclude a newline.
8265 (1- (point))
8266 (point)))
8267 (when gnus-article-button-face
8268 (gnus-overlay-put (gnus-make-overlay b e nil t)
8269 'face gnus-article-button-face))
23f87bed 8270 (widget-convert-button
01c52d31 8271 'link b e
23f87bed
MB
8272 :action 'gnus-button-prev-page
8273 :button-keymap gnus-prev-page-map)))
8274
8275(defun gnus-button-next-page (&optional args more-args)
eec82323
LMI
8276 "Go to the next page."
8277 (interactive)
8278 (let ((win (selected-window)))
23f87bed 8279 (select-window (gnus-get-buffer-window gnus-article-buffer t))
eec82323
LMI
8280 (gnus-article-next-page)
8281 (select-window win)))
8282
23f87bed 8283(defun gnus-button-prev-page (&optional args more-args)
eec82323
LMI
8284 "Go to the prev page."
8285 (interactive)
8286 (let ((win (selected-window)))
23f87bed 8287 (select-window (gnus-get-buffer-window gnus-article-buffer t))
eec82323
LMI
8288 (gnus-article-prev-page)
8289 (select-window win)))
8290
8291(defun gnus-insert-next-page-button ()
01c52d31 8292 (let ((b (point)) e
23f87bed 8293 (inhibit-read-only t))
eec82323 8294 (gnus-eval-format gnus-next-page-line-format nil
01c52d31
MB
8295 `(keymap ,gnus-next-page-map
8296 gnus-next t
8297 gnus-callback gnus-article-button-next-page
8298 article-type annotation))
8299 (setq e (if (bolp)
8300 ;; Exclude a newline.
8301 (1- (point))
8302 (point)))
8303 (when gnus-article-button-face
8304 (gnus-overlay-put (gnus-make-overlay b e nil t)
8305 'face gnus-article-button-face))
23f87bed 8306 (widget-convert-button
01c52d31 8307 'link b e
23f87bed
MB
8308 :action 'gnus-button-next-page
8309 :button-keymap gnus-next-page-map)))
eec82323
LMI
8310
8311(defun gnus-article-button-next-page (arg)
8312 "Go to the next page."
8313 (interactive "P")
8314 (let ((win (selected-window)))
23f87bed 8315 (select-window (gnus-get-buffer-window gnus-article-buffer t))
eec82323
LMI
8316 (gnus-article-next-page)
8317 (select-window win)))
8318
8319(defun gnus-article-button-prev-page (arg)
8320 "Go to the prev page."
8321 (interactive "P")
8322 (let ((win (selected-window)))
23f87bed 8323 (select-window (gnus-get-buffer-window gnus-article-buffer t))
eec82323
LMI
8324 (gnus-article-prev-page)
8325 (select-window win)))
8326
16409b0b
GM
8327(defvar gnus-decode-header-methods
8328 '(mail-decode-encoded-word-region)
8329 "List of methods used to decode headers.
8330
8331This variable is a list of FUNCTION or (REGEXP . FUNCTION). If item
4e7d0221 8332is FUNCTION, FUNCTION will be applied to all newsgroups. If item is a
23f87bed 8333\(REGEXP . FUNCTION), FUNCTION will be only apply to the newsgroups
16409b0b
GM
8334whose names match REGEXP.
8335
8336For example:
8f688cb0 8337\((\"chinese\" . gnus-decode-encoded-word-region-by-guess)
16409b0b
GM
8338 mail-decode-encoded-word-region
8339 (\"chinese\" . rfc1843-decode-region))
8340")
8341
8342(defvar gnus-decode-header-methods-cache nil)
8343
8344(defun gnus-multi-decode-header (start end)
8345 "Apply the functions from `gnus-encoded-word-methods' that match."
8346 (unless (and gnus-decode-header-methods-cache
8347 (eq gnus-newsgroup-name
8348 (car gnus-decode-header-methods-cache)))
8349 (setq gnus-decode-header-methods-cache (list gnus-newsgroup-name))
01c52d31
MB
8350 (dolist (x gnus-decode-header-methods)
8351 (if (symbolp x)
8352 (nconc gnus-decode-header-methods-cache (list x))
8353 (if (and gnus-newsgroup-name
8354 (string-match (car x) gnus-newsgroup-name))
8355 (nconc gnus-decode-header-methods-cache
8356 (list (cdr x)))))))
16409b0b
GM
8357 (let ((xlist gnus-decode-header-methods-cache))
8358 (pop xlist)
8359 (save-restriction
8360 (narrow-to-region start end)
8361 (while xlist
8362 (funcall (pop xlist) (point-min) (point-max))))))
8363
8364;;;
8365;;; Treatment top-level handling.
8366;;;
8367
389b76fa
G
8368(defvar gnus-inhibit-article-treatments nil)
8369
c497474b
GM
8370(defun gnus-treat-article (gnus-treat-condition
8371 &optional part-number total-parts gnus-treat-type)
8372 (let ((gnus-treat-length (- (point-max) (point-min)))
16409b0b
GM
8373 (alist gnus-treatment-function-alist)
8374 (article-goto-body-goes-to-point-min-p t)
8375 (treated-type
c497474b 8376 (or (not gnus-treat-type)
16409b0b
GM
8377 (catch 'found
8378 (let ((list gnus-article-treat-types))
8379 (while list
c497474b 8380 (when (string-match (pop list) gnus-treat-type)
16409b0b
GM
8381 (throw 'found t)))))))
8382 (highlightp (gnus-visual-p 'article-highlight 'highlight))
8383 val elem)
8384 (gnus-run-hooks 'gnus-part-display-hook)
23f87bed 8385 (dolist (elem alist)
16409b0b
GM
8386 (setq val
8387 (save-excursion
23f87bed
MB
8388 (when (gnus-buffer-live-p gnus-summary-buffer)
8389 (set-buffer gnus-summary-buffer))
16409b0b
GM
8390 (symbol-value (car elem))))
8391 (when (and (or (consp val)
8392 treated-type)
389b76fa 8393 (or (not gnus-inhibit-article-treatments)
c497474b 8394 (eq gnus-treat-condition 'head))
16409b0b
GM
8395 (gnus-treat-predicate val)
8396 (or (not (get (car elem) 'highlight))
8397 highlightp))
8398 (save-restriction
8399 (funcall (cadr elem)))))))
8400
8401;; Dynamic variables.
9efa445f
DN
8402(defvar part-number)
8403(defvar total-parts)
c497474b
GM
8404(defvar gnus-treat-type)
8405(defvar gnus-treat-condition)
8406(defvar gnus-treat-length)
e0bad764 8407
16409b0b
GM
8408(defun gnus-treat-predicate (val)
8409 (cond
8410 ((null val)
8411 nil)
c497474b
GM
8412 (gnus-treat-condition
8413 (eq gnus-treat-condition val))
16409b0b
GM
8414 ((and (listp val)
8415 (stringp (car val)))
8416 (apply 'gnus-or (mapcar `(lambda (s)
8417 (string-match s ,(or gnus-newsgroup-name "")))
8418 val)))
8419 ((listp val)
8420 (let ((pred (pop val)))
8421 (cond
8422 ((eq pred 'or)
8423 (apply 'gnus-or (mapcar 'gnus-treat-predicate val)))
8424 ((eq pred 'and)
8425 (apply 'gnus-and (mapcar 'gnus-treat-predicate val)))
8426 ((eq pred 'not)
8427 (not (gnus-treat-predicate (car val))))
8428 ((eq pred 'typep)
c497474b 8429 (equal (car val) gnus-treat-type))
47cc1156
G
8430 ((functionp pred)
8431 (funcall pred))
16409b0b
GM
8432 (t
8433 (error "%S is not a valid predicate" pred)))))
16409b0b
GM
8434 ((eq val t)
8435 t)
8436 ((eq val 'head)
8437 nil)
01c52d31
MB
8438 ((eq val 'first)
8439 (eq part-number 1))
16409b0b
GM
8440 ((eq val 'last)
8441 (eq part-number total-parts))
8442 ((numberp val)
c497474b 8443 (< gnus-treat-length val))
16409b0b
GM
8444 (t
8445 (error "%S is not a valid value" val))))
8446
23f87bed
MB
8447(defun gnus-article-encrypt-body (protocol &optional n)
8448 "Encrypt the article body."
8449 (interactive
8450 (list
8451 (or gnus-article-encrypt-protocol
229b59da
G
8452 (gnus-completing-read "Encrypt protocol"
8453 (mapcar 'car gnus-article-encrypt-protocol-alist)
8454 t))
23f87bed 8455 current-prefix-arg))
bbbe940b
MB
8456 ;; User might hit `K E' instead of `K e', so prompt once.
8457 (when (and gnus-article-encrypt-protocol
8458 gnus-novice-user)
8459 (unless (gnus-y-or-n-p "Really encrypt article(s)? ")
d93ec753 8460 (error "Encrypt aborted")))
23f87bed
MB
8461 (let ((func (cdr (assoc protocol gnus-article-encrypt-protocol-alist))))
8462 (unless func
998a5a95 8463 (error "Can't find the encrypt protocol %s" protocol))
23f87bed
MB
8464 (if (member gnus-newsgroup-name '("nndraft:delayed"
8465 "nndraft:drafts"
8466 "nndraft:queue"))
8467 (error "Can't encrypt the article in group %s"
8468 gnus-newsgroup-name))
8469 (gnus-summary-iterate n
80de1778 8470 (with-current-buffer gnus-summary-buffer
23f87bed
MB
8471 (let ((mail-parse-charset gnus-newsgroup-charset)
8472 (mail-parse-ignored-charsets gnus-newsgroup-ignored-charsets)
8473 (summary-buffer gnus-summary-buffer)
8474 references point)
8475 (gnus-set-global-variables)
8476 (when (gnus-group-read-only-p)
8477 (error "The current newsgroup does not support article encrypt"))
8478 (gnus-summary-show-article t)
8479 (setq references
8480 (or (mail-header-references gnus-current-headers) ""))
8481 (set-buffer gnus-article-buffer)
8482 (let* ((inhibit-read-only t)
8483 (headers
8484 (mapcar (lambda (field)
8485 (and (save-restriction
8486 (message-narrow-to-head)
8487 (goto-char (point-min))
8488 (search-forward field nil t))
8489 (prog2
8490 (message-narrow-to-field)
8491 (buffer-string)
8492 (delete-region (point-min) (point-max))
8493 (widen))))
8494 '("Content-Type:" "Content-Transfer-Encoding:"
8495 "Content-Disposition:"))))
8496 (message-narrow-to-head)
8497 (message-remove-header "MIME-Version")
8498 (goto-char (point-max))
8499 (setq point (point))
8500 (insert (apply 'concat headers))
8501 (widen)
8502 (narrow-to-region point (point-max))
8503 (let ((message-options message-options))
8504 (message-options-set 'message-sender user-mail-address)
8505 (message-options-set 'message-recipients user-mail-address)
8506 (message-options-set 'message-sign-encrypt 'not)
8507 (funcall func))
8508 (goto-char (point-min))
8509 (insert "MIME-Version: 1.0\n")
8510 (widen)
8511 (gnus-summary-edit-article-done
8512 references nil summary-buffer t))
8513 (when gnus-keep-backlog
8514 (gnus-backlog-remove-article
8515 (car gnus-article-current) (cdr gnus-article-current)))
8ccbef23 8516 (gnus-flush-original-article-buffer)
23f87bed
MB
8517 (when gnus-use-cache
8518 (gnus-cache-update-article
8519 (car gnus-article-current) (cdr gnus-article-current))))))))
8520
8521(defvar gnus-mime-security-button-line-format "%{%([[%t:%i]%D]%)%}\n"
8522 "The following specs can be used:
8523%t The security MIME type
8524%i Additional info
8525%d Details
8526%D Details if button is pressed")
8527
8528(defvar gnus-mime-security-button-end-line-format "%{%([[End of %t]%D]%)%}\n"
8529 "The following specs can be used:
8530%t The security MIME type
8531%i Additional info
8532%d Details
8533%D Details if button is pressed")
8534
8535(defvar gnus-mime-security-button-line-format-alist
8536 '((?t gnus-tmp-type ?s)
8537 (?i gnus-tmp-info ?s)
8538 (?d gnus-tmp-details ?s)
8539 (?D gnus-tmp-pressed-details ?s)))
8540
01c52d31
MB
8541(defvar gnus-mime-security-button-commands
8542 '((gnus-article-press-button "\r" "Show Detail")
8543 (undefined "v")
8544 (undefined "t")
8545 (undefined "C")
8546 (gnus-mime-security-save-part "o" "Save...")
8547 (undefined "\C-o")
8548 (undefined "r")
8549 (undefined "d")
8550 (undefined "c")
8551 (undefined "i")
8552 (undefined "E")
8553 (undefined "e")
8554 (undefined "p")
8555 (gnus-mime-security-pipe-part "|" "Pipe To Command...")
8556 (undefined ".")))
8557
23f87bed
MB
8558(defvar gnus-mime-security-button-map
8559 (let ((map (make-sparse-keymap)))
23f87bed 8560 (define-key map gnus-mouse-2 'gnus-article-push-button)
01c52d31
MB
8561 (define-key map gnus-down-mouse-3 'gnus-mime-security-button-menu)
8562 (dolist (c gnus-mime-security-button-commands)
8563 (define-key map (cadr c) (car c)))
23f87bed
MB
8564 map))
8565
01c52d31
MB
8566(easy-menu-define
8567 gnus-mime-security-button-menu gnus-mime-security-button-map
8568 "Security button menu."
8569 `("Security Part"
8570 ,@(delq nil
8571 (mapcar (lambda (c)
8572 (unless (eq (car c) 'undefined)
8573 (vector (caddr c) (car c) :active t)))
8574 gnus-mime-security-button-commands))))
8575
8576(defun gnus-mime-security-button-menu (event prefix)
8577 "Construct a context-sensitive menu of security commands."
8578 (interactive "e\nP")
8579 (save-window-excursion
8580 (let ((pos (event-start event)))
8581 (select-window (posn-window pos))
8582 (goto-char (posn-point pos))
8583 (gnus-article-check-buffer)
8584 (popup-menu gnus-mime-security-button-menu nil prefix))))
8585
23f87bed
MB
8586(defvar gnus-mime-security-details-buffer nil)
8587
8588(defvar gnus-mime-security-button-pressed nil)
8589
8590(defvar gnus-mime-security-show-details-inline t
8591 "If non-nil, show details in the article buffer.")
8592
8593(defun gnus-mime-security-verify-or-decrypt (handle)
8594 (mm-remove-parts (cdr handle))
8595 (let ((region (mm-handle-multipart-ctl-parameter handle 'gnus-region))
8596 point (inhibit-read-only t))
8597 (if region
8598 (goto-char (car region)))
01c52d31
MB
8599 (setq point (point))
8600 (with-current-buffer (mm-handle-multipart-original-buffer handle)
8601 (let* ((mm-verify-option 'known)
8602 (mm-decrypt-option 'known)
8603 (nparts (mm-possibly-verify-or-decrypt (cdr handle) handle)))
8604 (unless (eq nparts (cdr handle))
8605 (mm-destroy-parts (cdr handle))
8606 (setcdr handle nparts))))
8607 (gnus-mime-display-security handle)
23f87bed
MB
8608 (when region
8609 (delete-region (point) (cdr region))
8610 (set-marker (car region) nil)
8611 (set-marker (cdr region) nil))
8612 (goto-char point)))
8613
8614(defun gnus-mime-security-show-details (handle)
8615 (let ((details (mm-handle-multipart-ctl-parameter handle 'gnus-details)))
8616 (if (not details)
8617 (gnus-message 5 "No details.")
8618 (if gnus-mime-security-show-details-inline
8619 (let ((gnus-mime-security-button-pressed
8620 (not (get-text-property (point) 'gnus-mime-details)))
8621 (gnus-mime-security-button-line-format
8622 (get-text-property (point) 'gnus-line-format))
8623 (inhibit-read-only t))
8624 (forward-char -1)
8625 (while (eq (get-text-property (point) 'gnus-line-format)
8626 gnus-mime-security-button-line-format)
8627 (forward-char -1))
8628 (forward-char)
8629 (save-restriction
8630 (narrow-to-region (point) (point))
8631 (gnus-insert-mime-security-button handle))
8632 (delete-region (point)
8633 (or (text-property-not-all
8634 (point) (point-max)
8635 'gnus-line-format
8636 gnus-mime-security-button-line-format)
8637 (point-max))))
8638 ;; Not inlined.
8639 (if (gnus-buffer-live-p gnus-mime-security-details-buffer)
8640 (with-current-buffer gnus-mime-security-details-buffer
8641 (erase-buffer)
8642 t)
8643 (setq gnus-mime-security-details-buffer
8644 (gnus-get-buffer-create "*MIME Security Details*")))
8645 (with-current-buffer gnus-mime-security-details-buffer
8646 (insert details)
8647 (goto-char (point-min)))
8648 (pop-to-buffer gnus-mime-security-details-buffer)))))
8649
8650(defun gnus-mime-security-press-button (handle)
8651 (save-excursion
8652 (if (mm-handle-multipart-ctl-parameter handle 'gnus-info)
8653 (gnus-mime-security-show-details handle)
8654 (gnus-mime-security-verify-or-decrypt handle))))
8655
8656(defun gnus-insert-mime-security-button (handle &optional displayed)
8657 (let* ((protocol (mm-handle-multipart-ctl-parameter handle 'protocol))
8658 (gnus-tmp-type
8659 (concat
8660 (or (nth 2 (assoc protocol mm-verify-function-alist))
8661 (nth 2 (assoc protocol mm-decrypt-function-alist))
8662 "Unknown")
8663 (if (equal (car handle) "multipart/signed")
8664 " Signed" " Encrypted")
8665 " Part"))
8666 (gnus-tmp-info
8667 (or (mm-handle-multipart-ctl-parameter handle 'gnus-info)
8668 "Undecided"))
8669 (gnus-tmp-details
8670 (mm-handle-multipart-ctl-parameter handle 'gnus-details))
8671 gnus-tmp-pressed-details
8672 b e)
8673 (setq gnus-tmp-details
8674 (if gnus-tmp-details
8675 (concat "\n" gnus-tmp-details)
8676 ""))
8677 (setq gnus-tmp-pressed-details
8678 (if gnus-mime-security-button-pressed gnus-tmp-details ""))
8679 (unless (bolp)
8680 (insert "\n"))
8681 (setq b (point))
8682 (gnus-eval-format
8683 gnus-mime-security-button-line-format
8684 gnus-mime-security-button-line-format-alist
01c52d31 8685 `(keymap ,gnus-mime-security-button-map
23f87bed
MB
8686 gnus-callback gnus-mime-security-press-button
8687 gnus-line-format ,gnus-mime-security-button-line-format
8688 gnus-mime-details ,gnus-mime-security-button-pressed
8689 article-type annotation
8690 gnus-data ,handle))
8691 (setq e (if (bolp)
8692 ;; Exclude a newline.
8693 (1- (point))
8694 (point)))
01c52d31
MB
8695 (when gnus-article-button-face
8696 (gnus-overlay-put (gnus-make-overlay b e nil t)
8697 'face gnus-article-button-face))
23f87bed
MB
8698 (widget-convert-button
8699 'link b e
8700 :mime-handle handle
8701 :action 'gnus-widget-press-button
8702 :button-keymap gnus-mime-security-button-map
8703 :help-echo
5843126b 8704 (lambda (widget)
23f87bed
MB
8705 ;; Needed to properly clear the message due to a bug in
8706 ;; wid-edit (XEmacs only).
8707 (when (boundp 'help-echo-owns-message)
8708 (setq help-echo-owns-message t))
8709 (format
01c52d31
MB
8710 "%S: show detail; %S: more options"
8711 (aref gnus-mouse-2 0)
8712 (aref gnus-down-mouse-3 0))))))
23f87bed
MB
8713
8714(defun gnus-mime-display-security (handle)
8715 (save-restriction
8716 (narrow-to-region (point) (point))
8717 (unless (gnus-unbuttonized-mime-type-p (car handle))
8718 (gnus-insert-mime-security-button handle))
01c52d31 8719 (gnus-mime-display-part (cadr handle))
23f87bed
MB
8720 (unless (bolp)
8721 (insert "\n"))
8722 (unless (gnus-unbuttonized-mime-type-p (car handle))
8723 (let ((gnus-mime-security-button-line-format
8724 gnus-mime-security-button-end-line-format))
8725 (gnus-insert-mime-security-button handle)))
8726 (mm-set-handle-multipart-parameter
30818a23 8727 handle 'gnus-region (cons (point-min-marker) (point-max-marker)))
01c52d31
MB
8728 (goto-char (point-max))))
8729
8730(defun gnus-mime-security-run-function (function)
8731 "Run FUNCTION with the security part under point."
8732 (gnus-article-check-buffer)
8733 (let ((data (get-text-property (point) 'gnus-data))
8734 buffer handle)
8735 (when (and (stringp (car-safe data))
8736 (setq buffer (mm-handle-multipart-original-buffer data))
8737 (setq handle (cadr data)))
8738 (if (bufferp (mm-handle-buffer handle))
8739 (progn
8740 (setq handle (cons buffer (copy-sequence (cdr handle))))
8741 (mm-handle-set-undisplayer handle nil))
8742 (setq handle (mm-make-handle
8743 buffer
8744 (mm-handle-multipart-ctl-parameter handle 'protocol)
8745 nil nil nil nil nil nil)))
8746 (funcall function handle))))
8747
8748(defun gnus-mime-security-save-part ()
8749 "Save the security part under point."
8750 (interactive)
8751 (gnus-mime-security-run-function 'mm-save-part))
8752
8753(defun gnus-mime-security-pipe-part ()
8754 "Pipe the security part under point to a process."
8755 (interactive)
8756 (gnus-mime-security-run-function 'mm-pipe-part))
23f87bed 8757
eec82323
LMI
8758(gnus-ems-redefine)
8759
8760(provide 'gnus-art)
8761
8762(run-hooks 'gnus-art-load-hook)
8763
8764;;; gnus-art.el ends here