1 ;;; gnus-picon.el --- displaying pretty icons in Gnus
2 ;; Copyright (C) 1996,97 Free Software Foundation, Inc.
4 ;; Author: Wes Hardaker <hardaker@ece.ucdavis.edu>
5 ;; Keywords: news xpm annotation glyph faces
7 ;; This file is part of GNU Emacs.
9 ;; GNU Emacs is free software; you can redistribute it and/or modify
10 ;; it under the terms of the GNU General Public License as published by
11 ;; the Free Software Foundation; either version 2, or (at your option)
14 ;; GNU Emacs is distributed in the hope that it will be useful,
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 ;; GNU General Public License for more details.
19 ;; You should have received a copy of the GNU General Public License
20 ;; along with GNU Emacs; see the file COPYING. If not, write to the
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 ;; Boston, MA 02111-1307, USA.
30 (require 'annotations)
38 "Show pictures of people, domains, and newsgroups (XEmacs).
39 For this to work, you must add gnus-group-display-picons to the
40 gnus-summary-display-hook or to the gnus-article-display-hook
41 depending on what gnus-picons-display-where is set to. You must
42 also add gnus-article-display-picons to gnus-article-display-hook."
45 (defcustom gnus-picons-display-where 'picons
46 "Where to display the group and article icons.
47 Legal values are `article' and `picons'."
48 :type '(choice symbol string)
51 (defcustom gnus-picons-has-modeline-p t
52 "Wether the picons window should have a modeline.
53 This is only useful if `gnus-picons-display-where' is `picons'."
57 (defcustom gnus-picons-database "/usr/local/faces"
58 "Defines the location of the faces database.
59 For information on obtaining this database of pretty pictures, please
60 see http://www.cs.indiana.edu/picons/ftp/index.html"
64 (defcustom gnus-picons-news-directories '("news")
65 "Sub-directory of the faces database containing the icons for newsgroups."
66 :type '(repeat string)
68 (define-obsolete-variable-alias 'gnus-picons-news-directory
69 'gnus-picons-news-directories)
71 (defcustom gnus-picons-user-directories '("local" "users" "usenix" "misc")
72 "List of directories to search for user faces."
73 :type '(repeat string)
76 (defcustom gnus-picons-domain-directories '("domains")
77 "List of directories to search for domain faces.
78 Some people may want to add \"unknown\" to this list."
79 :type '(repeat string)
82 (defcustom gnus-picons-refresh-before-display nil
83 "If non-nil, display the article buffer before computing the picons."
87 (defcustom gnus-picons-x-face-file-name
88 (format "/tmp/picon-xface.%s.xbm" (user-login-name))
89 "The name of the file in which to store the converted X-face header."
93 (defcustom gnus-picons-convert-x-face (format "{ echo '/* Width=48, Height=48 */'; uncompface; } | icontopbm | pbmtoxbm > %s" gnus-picons-x-face-file-name)
94 "Command to convert the x-face header into a xbm file."
98 (defcustom gnus-picons-display-as-address t
99 "*If t display textual email addresses along with pictures."
103 (defcustom gnus-picons-file-suffixes
105 (let ((types (list "xbm")))
106 (when (featurep 'gif)
108 (when (featurep 'xpm)
111 "List of suffixes on picon file names to try."
112 :type '(repeat string)
115 (defcustom gnus-picons-display-article-move-p t
116 "*Whether to move point to first empty line when displaying picons.
117 This has only an effect if `gnus-picons-display-where' has value `article'."
121 (defcustom gnus-picons-clear-cache-on-shutdown t
122 "*Whether to clear the picons cache when exiting gnus.
123 Gnus caches every picons it finds while it is running. This saves
124 some time in the search process but eats some memory. If this
125 variable is set to nil, Gnus will never clear the cache itself; you
126 will have to manually call `gnus-picons-clear-cache' to clear it.
127 Otherwise the cache will be cleared every time you exit Gnus."
131 (defcustom gnus-picons-piconsearch-url nil
132 "*The url to query for picons. Setting this to nil will disable it.
133 The only plublicly available address currently known is
134 http://www.cs.indiana.edu:800/piconsearch. If you know of any other,
135 please tell me so that we can list it."
136 :type '(choice (const :tag "Disable" :value nil)
137 (const :tag "www.cs.indiana.edu"
138 :value "http://www.cs.indiana.edu:800/piconsearch")
142 ;;; Internal variables:
144 (defvar gnus-picons-processes-alist nil
145 "Picons processes currently running and their environment.")
146 (defvar gnus-picons-glyph-alist nil
147 "Picons glyphs cache.
148 List of pairs (KEY . GLYPH) where KEY is either a filename or an URL.")
149 (defvar gnus-picons-url-alist nil
150 "Picons file names cache.
151 List of pairs (KEY . NAME) where KEY is (USER HOST DBS) and NAME is an URL.")
153 (defvar gnus-group-annotations nil
154 "List of annotations added/removed when selecting/exiting a group")
155 (defvar gnus-article-annotations nil
156 "List of annotations added/removed when selecting an article")
157 (defvar gnus-x-face-annotations nil
158 "List of annotations added/removed when selecting an article with an
161 (defvar gnus-picons-jobs-alist nil
162 "List of jobs that still need be done.
163 This is a list of (SYM-ANN TAG ARGS...) where SYM-ANN three annotations list,
164 TAG is one of `picon' or `search' indicating that the job should query a
165 picon or do a search for picons file names, and ARGS is some additionnal
166 arguments necessary for the job.")
168 (defvar gnus-picons-job-already-running nil
169 "Lock to ensure only one stream of http requests is running.")
173 (defun gnus-picons-remove (symbol)
174 "Remove all annotations in variable named SYMBOL.
175 This function is careful to set it to nil before removing anything so that
176 asynchronous process don't get crazy."
177 (setq gnus-picons-jobs-alist (remassq symbol gnus-picons-jobs-alist))
178 ;; notify running job that it may have been preempted
179 (if (eq (car gnus-picons-job-already-running) symbol)
180 (setq gnus-picons-job-already-running t))
181 ;; clear all annotations
182 (mapc (function (lambda (item)
183 (if (annotationp item)
184 (delete-annotation item))))
185 (prog1 (symbol-value symbol)
188 (defun gnus-picons-remove-all ()
189 "Removes all picons from the Gnus display(s)."
191 (gnus-picons-remove 'gnus-article-annotations)
192 (gnus-picons-remove 'gnus-group-annotations)
193 (gnus-picons-remove 'gnus-x-face-annotations))
195 (defun gnus-get-buffer-name (variable)
196 "Returns the buffer name associated with the contents of a variable."
197 (cond ((symbolp variable) (let ((newvar (cdr (assq variable
198 gnus-window-to-buffer))))
199 (cond ((symbolp newvar)
200 (symbol-value newvar))
201 ((stringp newvar) newvar))))
202 ((stringp variable) variable)))
204 (defun gnus-picons-set-buffer ()
206 (get-buffer-create (gnus-get-buffer-name gnus-picons-display-where)))
207 (gnus-add-current-to-buffer-list)
208 (goto-char (point-min))
209 (if (and (eq gnus-picons-display-where 'article)
210 gnus-picons-display-article-move-p)
211 (if (search-forward "\n\n" nil t)
213 (goto-char (point-max)))
214 (setq buffer-read-only t)
215 (unless gnus-picons-has-modeline-p
216 (set-specifier has-modeline-p
217 (list (list (current-buffer)
218 (cons nil gnus-picons-has-modeline-p)))))))
220 (defun gnus-picons-prepare-for-annotations (annotations)
221 "Prepare picons buffer for puting annotations memorized in ANNOTATIONS.
222 ANNOTATIONS should be a symbol naming a variable wich contains a list of
223 annotations. Sets buffer to `gnus-picons-display-where'."
224 ;; let drawing catch up
225 (when gnus-picons-refresh-before-display
227 (gnus-picons-set-buffer)
228 (gnus-picons-remove annotations))
230 (defsubst gnus-picons-make-annotation (&rest args)
231 (let ((annot (apply 'make-annotation args)))
232 (set-extent-property annot 'duplicable nil)
235 (defun gnus-picons-article-display-x-face ()
236 "Display the x-face header bitmap in the 'gnus-picons-display-where buffer."
237 ;; delete any old ones.
238 ;; This is needed here because gnus-picons-display-x-face will not
239 ;; be called if there is no X-Face header
240 (gnus-picons-remove 'gnus-x-face-annotations)
241 ;; display the new one.
242 (let ((gnus-article-x-face-command 'gnus-picons-display-x-face))
243 (gnus-article-display-x-face)))
245 (defun gnus-picons-x-face-sentinel (process event)
246 (let* ((env (assq process gnus-picons-processes-alist))
248 (setq gnus-picons-processes-alist (remassq process
249 gnus-picons-processes-alist))
251 (set-annotation-glyph annot
252 (make-glyph gnus-picons-x-face-file-name))
253 (if (memq annot gnus-x-face-annotations)
254 (delete-file gnus-picons-x-face-file-name)))))
256 (defun gnus-picons-display-x-face (beg end)
257 "Function to display the x-face header in the picons window.
258 To use: (setq gnus-article-x-face-command 'gnus-picons-display-x-face)"
260 (if (featurep 'xface)
261 ;; Use builtin support
262 (let ((buf (current-buffer)))
264 (gnus-picons-prepare-for-annotations 'gnus-x-face-annotations)
265 (setq gnus-x-face-annotations
266 (cons (gnus-picons-make-annotation
268 :data (concat "X-Face: "
269 (buffer-substring beg end buf)))
271 gnus-x-face-annotations))))
272 ;; convert the x-face header to a .xbm file
273 (let* ((process-connection-type nil)
274 (annot (save-excursion
275 (gnus-picons-prepare-for-annotations
276 'gnus-x-face-annotations)
277 (gnus-picons-make-annotation nil nil 'text)))
278 (process (start-process-shell-command "gnus-x-face" nil
279 gnus-picons-convert-x-face)))
280 (push annot gnus-x-face-annotations)
281 (push (cons process annot) gnus-picons-processes-alist)
282 (process-kill-without-query process)
283 (set-process-sentinel process 'gnus-picons-x-face-sentinel)
284 (process-send-region process beg end)
285 (process-send-eof process))))
287 (defun gnus-article-display-picons ()
288 "Display faces for an author and his/her domain in gnus-picons-display-where."
291 (when (and (featurep 'xpm)
292 (or (not (fboundp 'device-type)) (equal (device-type) 'x))
293 (setq from (mail-fetch-field "from"))
294 (setq from (downcase (or (cadr (mail-extract-address-components
297 (or (setq at-idx (string-match "@" from))
298 (setq at-idx (length from))))
300 (let ((username (downcase (substring from 0 at-idx)))
301 (addrs (if (eq at-idx (length from))
302 (if gnus-local-domain
303 (message-tokenize-header gnus-local-domain "."))
304 (message-tokenize-header (substring from (1+ at-idx))
306 (gnus-picons-prepare-for-annotations 'gnus-article-annotations)
307 ;; if display in article buffer, the group annotations
308 ;; wrongly placed. Move them here
309 (if (eq gnus-picons-display-where 'article)
310 (dolist (ext gnus-group-annotations)
311 (set-extent-endpoints ext (point) (point))))
312 (if (null gnus-picons-piconsearch-url)
313 (setq gnus-article-annotations
314 (nconc gnus-article-annotations
315 (gnus-picons-display-pairs
316 (gnus-picons-lookup-pairs
317 addrs gnus-picons-domain-directories)
318 gnus-picons-display-as-address
320 (if (and gnus-picons-display-as-address addrs)
321 (list (gnus-picons-make-annotation
322 [string :data "@"] nil
323 'text nil nil nil t)))
324 (gnus-picons-display-picon-or-name
325 (gnus-picons-lookup-user username addrs)
327 (push (list 'gnus-article-annotations 'search username addrs
328 gnus-picons-domain-directories t)
329 gnus-picons-jobs-alist)
330 (gnus-picons-next-job))
332 (add-hook 'gnus-summary-exit-hook 'gnus-picons-remove-all))))))
334 (defun gnus-group-display-picons ()
335 "Display icons for the group in the gnus-picons-display-where buffer."
337 (when (and (featurep 'xpm)
338 (or (not (fboundp 'device-type)) (equal (device-type) 'x)))
340 (gnus-picons-prepare-for-annotations 'gnus-group-annotations)
341 (if (null gnus-picons-piconsearch-url)
342 (setq gnus-group-annotations
343 (gnus-picons-display-pairs
344 (gnus-picons-lookup-pairs (reverse (message-tokenize-header
345 gnus-newsgroup-name "."))
346 gnus-picons-news-directories)
348 (push (list 'gnus-group-annotations 'search nil
349 (message-tokenize-header gnus-newsgroup-name ".")
350 (if (listp gnus-picons-news-directories)
351 gnus-picons-news-directories
352 (list gnus-picons-news-directories))
354 gnus-picons-jobs-alist)
355 (gnus-picons-next-job))
357 (add-hook 'gnus-summary-exit-hook 'gnus-picons-remove-all))))
359 (defsubst gnus-picons-lookup-internal (addrs dir)
360 (setq dir (expand-file-name dir gnus-picons-database))
361 (gnus-picons-try-face (dolist (part (reverse addrs) dir)
362 (setq dir (expand-file-name part dir)))))
364 (defun gnus-picons-lookup (addrs dirs)
365 "Lookup the picon for ADDRS in databases DIRS.
366 Returns the picon filename or NIL if none found."
368 (while (and dirs (null result))
369 (setq result (gnus-picons-lookup-internal addrs (pop dirs))))
372 (defun gnus-picons-lookup-user-internal (user domains)
373 (let ((dirs gnus-picons-user-directories)
374 domains-tmp dir picon)
375 (while (and dirs (null picon))
376 (setq domains-tmp domains
378 (while (and domains-tmp
379 (null (setq picon (gnus-picons-lookup-internal
380 (cons user domains-tmp) dir))))
382 ;; Also make a try in MISC subdir
384 (setq picon (gnus-picons-lookup-internal (list user "MISC") dir))))
387 (defun gnus-picons-lookup-user (user domains)
388 "Lookup the picon for USER at DOMAINS.
389 USER is a string containing a name.
390 DOMAINS is a list of strings from the fully qualified domain name."
391 (or (gnus-picons-lookup-user-internal user domains)
392 (gnus-picons-lookup-user-internal "unknown" domains)))
394 (defun gnus-picons-lookup-pairs (domains directories)
395 "Lookup picons for DOMAINS and all its parents in DIRECTORIES.
396 Returns a list of PAIRS whose CAR is the picon filename or NIL if
397 none, and whose CDR is the corresponding element of DOMAINS."
399 (setq directories (if (listp directories)
403 (push (list (gnus-picons-lookup (cons "unknown" domains) directories)
408 (defun gnus-picons-display-picon-or-name (picon name &optional right-p)
409 (cond (picon (gnus-picons-display-glyph picon name right-p))
410 (gnus-picons-display-as-address (list (gnus-picons-make-annotation
411 (vector 'string :data name)
413 nil nil nil right-p)))))
415 (defun gnus-picons-display-pairs (pairs &optional bar-p dot-p right-p)
416 "Display picons in list PAIRS."
417 (let ((domain-p (and gnus-picons-display-as-address dot-p))
419 (if (and bar-p domain-p right-p)
420 (setq picons (gnus-picons-display-glyph
421 (gnus-picons-try-face gnus-xmas-glyph-directory
425 (setq pair (pop pairs)
427 (gnus-picons-display-picon-or-name (car pair)
430 (if (and domain-p pairs)
431 (list (gnus-picons-make-annotation
432 (vector 'string :data dot-p)
433 nil 'text nil nil nil right-p))))))
434 (if (and bar-p domain-p (not right-p))
435 (setq picons (nconc picons
436 (gnus-picons-display-glyph
437 (gnus-picons-try-face gnus-xmas-glyph-directory
442 (defun gnus-picons-try-face (dir &optional filebase)
443 (let* ((dir (file-name-as-directory dir))
444 (filebase (or filebase "face."))
445 (key (concat dir filebase))
446 (glyph (cdr (assoc key gnus-picons-glyph-alist)))
447 (suffixes gnus-picons-file-suffixes)
449 (while (and suffixes (null glyph))
450 (when (file-exists-p (setq f (expand-file-name (concat filebase
453 (setq glyph (make-glyph f))
454 (push (cons key glyph) gnus-picons-glyph-alist)))
457 (defun gnus-picons-display-glyph (glyph &optional part rightp)
458 (let ((new (gnus-picons-make-annotation glyph (point)
459 'text nil nil nil rightp)))
460 (when (and part gnus-picons-display-as-address)
461 (set-annotation-data new (cons new
462 (make-glyph (vector 'string :data part))))
463 (set-annotation-action new 'gnus-picons-action-toggle))
466 (if (and (eq major-mode 'gnus-article-mode)
467 (not gnus-picons-display-as-address)
469 (list (gnus-picons-make-annotation [string :data " "] (point)
470 'text nil nil nil rightp))))))
472 (defun gnus-picons-action-toggle (data)
475 (let* ((annot (car data))
476 (glyph (annotation-glyph annot)))
477 (set-annotation-glyph annot (cdr data))
478 (set-annotation-data annot (cons annot glyph))))
480 (defun gnus-picons-clear-cache ()
481 "Clear the picons cache"
483 (setq gnus-picons-glyph-alist nil
484 gnus-picons-url-alist nil))
486 (gnus-add-shutdown 'gnus-picons-close 'gnus)
488 (defun gnus-picons-close ()
489 "Shut down the picons."
490 (if gnus-picons-clear-cache-on-shutdown
491 (gnus-picons-clear-cache)))
493 ;;; Query a remote DB. This requires some stuff from w3 !
498 (defun gnus-picons-url-retrieve (url fn arg)
499 (let ((old-asynch (default-value 'url-be-asynchronous))
500 (url-working-buffer (generate-new-buffer " *picons*"))
501 (url-package-name "Gnus")
502 (url-package-version gnus-version-number)
504 (setq-default url-be-asynchronous t)
506 (set-buffer url-working-buffer)
507 (setq url-be-asynchronous t
508 url-current-callback-data arg
509 url-current-callback-func fn)
510 (url-retrieve url t))
511 (setq-default url-be-asynchronous old-asynch)))
513 (defun gnus-picons-make-glyph (type)
514 "Make a TYPE glyph using current buffer as data. Handles xbm nicely."
515 (cond ((null type) nil)
516 ((eq type 'xbm) (let ((fname (make-temp-name "/tmp/picon")))
517 (write-region (point-min) (point-max) fname
519 (prog1 (make-glyph (vector 'xbm :file fname))
520 (delete-file fname))))
521 (t (make-glyph (vector type :data (buffer-string))))))
523 ;;; Parsing of piconsearch result page.
526 ;; 1 - each value field has the form: "<strong>key</strong> = <kbd>value</kbd>"
527 ;; 2 - a "<p>" separates the keywords from the results
528 ;; 3 - every results begins by the path within the database at the beginning
529 ;; of the line in raw text.
530 ;; 3b - and the href following it is the preferred image type.
532 ;; if 1 or 2 is not met, it will probably cause an error. The other
533 ;; will go undetected
535 (defun gnus-picons-parse-value (name)
536 (goto-char (point-min))
537 (re-search-forward (concat "<strong>"
539 "</strong> *= *<kbd> *\\([^ <][^<]*\\) *</kbd>"))
540 (buffer-substring (match-beginning 1) (match-end 1)))
542 (defun gnus-picons-parse-filenames ()
543 ;; returns an alist of ((USER ADDRS DB) . URL)
544 (let* ((case-fold-search t)
545 (user (gnus-picons-parse-value "user"))
546 (host (gnus-picons-parse-value "host"))
547 (dbs (message-tokenize-header (gnus-picons-parse-value "db") " "))
551 "^\\(" (mapconcat 'identity dbs "\\|") "\\)/"
553 "\\(\\(" (replace-in-string host "\\." "/\\|" t) "/\\|MISC/\\)*\\)"
555 "\\(" (regexp-quote user) "\\|unknown\\)/"
557 cur-db cur-host cur-user types res)
558 ;; now point will be somewhere in the header. Find beginning of
560 (re-search-forward "<p>[ \t\n]*")
561 (while (re-search-forward start-re nil t)
562 (setq cur-db (buffer-substring (match-beginning 1) (match-end 1))
563 cur-host (buffer-substring (match-beginning 2) (match-end 2))
564 cur-user (buffer-substring (match-beginning 4) (match-end 4))
565 cur-host (nreverse (message-tokenize-header cur-host "/")))
566 ;; XXX - KLUDGE: there is a blank picon in news/MISC/unknown
567 (unless (and (string-equal cur-db "news")
568 (string-equal cur-user "unknown")
569 (equal cur-host '("MISC")))
570 ;; ok now we have found an entry (USER HOST DB), find the
571 ;; corresponding picon URL
573 ;; restrict region to this entry
574 (narrow-to-region (point) (search-forward "<br>"))
575 (goto-char (point-min))
576 (setq types gnus-picons-file-suffixes)
578 (not (re-search-forward
579 (concat "<a[ \t\n]+href=\"\\([^\"]*\\."
580 (regexp-quote (car types)) "\\)\"")
583 (push (cons (list cur-user cur-host cur-db)
584 (buffer-substring (match-beginning 1) (match-end 1)))
588 ;;; picon network display functions :
590 (defun gnus-picons-network-display-internal (sym-ann glyph part right-p)
591 (gnus-picons-set-buffer)
592 (set sym-ann (nconc (symbol-value sym-ann)
593 (gnus-picons-display-picon-or-name glyph part right-p)))
594 (gnus-picons-next-job-internal))
596 (defun gnus-picons-network-display-callback (url part sym-ann right-p)
597 (let ((glyph (gnus-picons-make-glyph (cdr (assoc url-current-mime-type
598 w3-image-mappings)))))
599 (kill-buffer (current-buffer))
600 (push (cons url glyph) gnus-picons-glyph-alist)
601 ;; only do the job if it has not been preempted.
602 (if (equal gnus-picons-job-already-running
603 (list sym-ann 'picon url part right-p))
604 (gnus-picons-network-display-internal sym-ann glyph part right-p)
605 (gnus-picons-next-job-internal))))
607 (defun gnus-picons-network-display (url part sym-ann right-p)
608 (let ((cache (assoc url gnus-picons-glyph-alist)))
609 (if (or cache (null url))
610 (gnus-picons-network-display-internal sym-ann (cdr cache) part right-p)
611 (gnus-picons-url-retrieve url 'gnus-picons-network-display-callback
612 (list url part sym-ann right-p)))))
614 ;;; search job functions
616 (defun gnus-picons-network-search-internal (user addrs dbs sym-ann right-p
618 (let (curkey dom pfx url dbs-tmp cache new-jobs)
619 ;; First do the domain search
620 (dolist (part (if right-p
623 (setq pfx (nconc (list part) pfx)
624 dom (cond ((and dom right-p) (concat part "." dom))
625 (dom (concat dom "." part))
627 curkey (list "unknown" dom dbs))
628 (when (null (setq cache (assoc curkey gnus-picons-url-alist)))
629 ;; This one is not yet in the cache, create a new entry
630 ;; Search for an entry
633 (while (and dbs-tmp (null url))
634 (setq url (or (cdr (assoc (list "unknown" pfx (car dbs-tmp)) fnames))
636 ;; This is the first component. Try the
637 ;; catch-all MISC component
638 (cdr (assoc (list "unknown"
643 (push (setq cache (cons curkey url)) gnus-picons-url-alist))
644 ;; Put this glyph in the job list
645 (if (and (not (eq dom part)) gnus-picons-display-as-address)
646 (push (list sym-ann "." right-p) new-jobs))
647 (push (list sym-ann 'picon (cdr cache) part right-p) new-jobs))
648 ;; next, the user search
650 (setq curkey (list user dom gnus-picons-user-directories))
651 (if (null (setq cache (assoc curkey gnus-picons-url-alist)))
652 (let ((users (list user "unknown"))
653 dirs usr domains-tmp dir picon)
654 (while (and users (null picon))
655 (setq dirs gnus-picons-user-directories
657 (while (and dirs (null picon))
658 (setq domains-tmp addrs
660 (while (and domains-tmp
661 (null (setq picon (assoc (list usr domains-tmp dir)
665 (setq picon (assoc (list usr '("MISC") dir) fnames)))))
666 (push (setq cache (cons curkey (cdr picon)))
667 gnus-picons-url-alist)))
668 (if (and gnus-picons-display-as-address new-jobs)
669 (push (list sym-ann "@" right-p) new-jobs))
670 (push (list sym-ann 'picon (cdr cache) user right-p) new-jobs))
671 (if (and gnus-picons-display-as-address (not right-p))
672 (push (list sym-ann 'bar right-p) new-jobs))
673 ;; only put the jobs in the queue if this job has not been preempted.
674 (if (equal gnus-picons-job-already-running
675 (list sym-ann 'search user addrs dbs right-p))
676 (setq gnus-picons-jobs-alist
677 (nconc (if (and gnus-picons-display-as-address right-p)
678 (list (list sym-ann 'bar right-p)))
680 gnus-picons-jobs-alist)))
681 (gnus-picons-next-job-internal)))
683 (defun gnus-picons-network-search-callback (user addrs dbs sym-ann right-p)
684 (gnus-picons-network-search-internal user addrs dbs sym-ann right-p
685 (prog1 (gnus-picons-parse-filenames)
686 (kill-buffer (current-buffer)))))
688 (defun gnus-picons-network-search (user addrs dbs sym-ann right-p)
689 (let* ((host (mapconcat 'identity addrs "."))
690 (key (list (or user "unknown") host (if user
691 gnus-picons-user-directories
693 (cache (assoc key gnus-picons-url-alist)))
695 (gnus-picons-url-retrieve
696 (concat gnus-picons-piconsearch-url
697 "?user=" (w3-form-encode-xwfu (or user "unknown"))
698 "&host=" (w3-form-encode-xwfu host)
699 "&db=" (mapconcat 'w3-form-encode-xwfu
702 gnus-picons-user-directories)
705 'gnus-picons-network-search-callback
706 (list user addrs dbs sym-ann right-p))
707 (gnus-picons-network-search-internal user addrs dbs sym-ann right-p))))
709 ;;; Main jobs dispatcher function
711 (defun gnus-picons-next-job-internal ()
712 (if (setq gnus-picons-job-already-running (pop gnus-picons-jobs-alist))
713 (let* ((job gnus-picons-job-already-running)
717 (cond ((stringp tag);; (SYM-ANN "..." RIGHT-P)
718 (gnus-picons-network-display-internal sym-ann nil tag
721 (gnus-picons-network-display-internal
722 sym-ann (gnus-picons-try-face gnus-xmas-glyph-directory
725 ((eq 'search tag);; (SYM-ANN 'search USER ADDRS DBS RIGHT-P)
726 (gnus-picons-network-search
727 (pop job) (pop job) (pop job) sym-ann (pop job)))
728 ((eq 'picon tag);; (SYM-ANN 'picon URL PART RIGHT-P)
729 (gnus-picons-network-display
730 (pop job) (pop job) sym-ann (pop job)))
731 (t (setq gnus-picons-job-already-running nil)
732 (error "Unknown picon job tag %s" tag)))))))
734 (defun gnus-picons-next-job ()
735 "Start processing the job queue if it is not in progress"
736 (unless gnus-picons-job-already-running
737 (gnus-picons-next-job-internal)))
739 (provide 'gnus-picon)
741 ;;; gnus-picon.el ends here