+;;; gnus-gl.el --- an interface to GroupLens for Gnus
+;; Copyright (C) 1995,96,97,98,99 Free Software Foundation, Inc.
+
+;; Author: Brad Miller <bmiller@cs.umn.edu>
+;; Keywords: news, score
+
+;; This file is part of GNU Emacs.
+
+;; GNU Emacs is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation; either version 2, or (at your option)
+;; any later version.
+
+;; GNU Emacs is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs; see the file COPYING. If not, write to the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
+
+;;; Commentary:
+
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; GroupLens software and documentation is copyright (c) 1995 by Paul
;; Resnick (Massachusetts Institute of Technology); Brad Miller, John
;; The copyright holders request that they be notified of
;; modifications of this code. Please send electronic mail to
;; grouplens@cs.umn.edu for more information or to announce derived
-;; works.
+;; works.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Author: Brad Miller
;;
-;; $Id: gnus-gl.el,v 1.2 1996/02/25 03:46:03 steve Exp $
-;;
-;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;
;; User Documentation:
;;
;; ---------------- For your .emacs or .gnus file ----------------
;;
-;; As of version 2.5, grouplens now works as a minor mode of
+;; As of version 2.5, grouplens now works as a minor mode of
;; gnus-summary-mode. To get make that work you just need a couple of
;; hooks.
-;; In addition, there are a few gnus-*-hooks that need to be set:
-;; (add-hook 'gnus-startup-hook 'bbb-login)
-;; (add-hook 'gnus-summary-mode-hook 'gnus-grouplens-mode)
-;;
-;; If you want to see grouplens scores using our format you might want to
-;; add a %uG to the gnus-summary-line-format. For example, I use:
-;; (setq gnus-summary-line-format "%U%R%uG%I%(%[%4L: %-20,20uB%]%) %s\n")
-;; The above format also assumes that you are using gnus-bbdb You can
-;; just as easily ad %uG to whatever format string you use. Or add
-;; a %i to just see a simple numeric version of the predictions that
-;; uses less space on the summary line. If you use %uG you have several
-;; choices for how things look. See the doc string for the
-;; grouplens-prediction-display variable.
-;; (setq grouplens-prediction-display 'prediction-bar)
-;;
-;; If you use %uI on your group-line-format you will get (GroupLens Enhanced)
-;; after the names of newsgroups supported by GroupLens.
-;; (setq gnus-group-line-format "%M%S%p%5y: %(%g%) %uI\n")
+;; (setq gnus-use-grouplens t)
+;; (setq grouplens-pseudonym "")
+;; (setq grouplens-bbb-host "grouplens.cs.umn.edu")
;;
;; (setq gnus-summary-default-score 0)
;;
-;; In addition there are some GroupLens user variables to set
-;; (setq grouplens-pseudonym "foobar")
-;; If you are using a bbb other than twain.cs.umn.edu you will need to
-;; set the grouplens-bbb-host variable, and possibly the
-;; grouplens-bbb-port variable.
-;;
-;;(setq grouplens-newsgroups '("comp.lang.c++" "rec.humor" "rec.food.recipes"))
-;; This sets up the groups for which you will get predictions and ratings.
-;;
;; USING GROUPLENS
;; How do I Rate an article??
;; Before you type n to go to the next article, hit a number from 1-5
-;; Type V r in the summary buffer and you will be prompted.
+;; Type r in the summary buffer and you will be prompted.
+;; Note that when you're in grouplens-minor-mode 'r' masks the
+;; usual reply binding for 'r'
;;
;; What if, Gasp, I find a bug???
;; Please type M-x gnus-gl-submit-bug-report. This will set up a
;; mail buffer with the state of variables and buffers that will help
;; me debug the problem. A short description up front would help too!
-;;
-;; How do I display the prediction for an aritcle:
+;;
+;; How do I display the prediction for an article:
;; If you set the gnus-summary-line-format as shown above, the score
;; (prediction) will be shown automatically.
;;
-;;
+;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; Programmer Notes
+;; Programmer Notes
;; 10/9/95
;; gnus-scores-articles contains the articles
;; When scoring is done, the call tree looks something like:
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; bugs
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;;
+;;
+
+;;; Code:
-(require 'gnus-score)
(eval-when-compile (require 'cl))
-(require 'cl)
+
+(require 'gnus-score)
+(require 'gnus)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;; User variables
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
(defvar gnus-summary-grouplens-line-format
- "%U%R%z%l%I%(%[%4L: %-20,20n%]%) %s\n"
+ "%U\%R\%z%l%I\%(%[%4L: %-20,20n%]%) %s\n"
"*The line format spec in summary GroupLens mode buffers.")
(defvar grouplens-pseudonym ""
- "User's pseudonym. This pseudonym is obtained during the registration process")
+ "User's pseudonym.
+This pseudonym is obtained during the registration process")
(defvar grouplens-bbb-host "grouplens.cs.umn.edu"
- "Host where the bbbd is running" )
-
-(defvar grouplens-bbb-port 9000
- "Port where the bbbd is listening" )
-
-(defvar grouplens-newsgroups
- '("comp.lang.c++" "rec.humor" "rec.food.recipes" "comp.groupware"
+ "Host where the bbbd is running.")
+
+(defvar grouplens-bbb-port 9000
+ "Port where the bbbd is listening.")
+
+(defvar grouplens-newsgroups
+ '("comp.groupware" "comp.human-factors" "comp.lang.c++"
+ "comp.lang.java" "comp.os.linux.admin" "comp.os.linux.advocacy"
+ "comp.os.linux.announce" "comp.os.linux.answers"
+ "comp.os.linux.development" "comp.os.linux.development.apps"
+ "comp.os.linux.development.system" "comp.os.linux.hardware"
+ "comp.os.linux.help" "comp.os.linux.m68k" "comp.os.linux.misc"
+ "comp.os.linux.networking" "comp.os.linux.setup" "comp.os.linux.x"
"mn.general" "rec.arts.movies" "rec.arts.movies.current-films"
- "comp.lang.java")
+ "rec.food.recipes" "rec.humor")
"*Groups that are part of the GroupLens experiment.")
(defvar grouplens-prediction-display 'prediction-spot
- "valid values are:
- prediction-spot -- an * corresponding to the prediction between 1 and 5,
+ "valid values are:
+ prediction-spot -- an * corresponding to the prediction between 1 and 5,
confidence-interval -- a numeric confidence interval
prediction-bar -- |##### | the longer the bar, the better the article,
confidence-bar -- | ----- } the prediction is in the middle of the bar,
confidence-plus-minus -- prediction +/i confidence")
(defvar grouplens-score-offset 0
- "Offset the prediction by this value.
- Setting this variable to -2 would have the following effect
- on grouplens scores:
+ "Offset the prediction by this value.
+Setting this variable to -2 would have the following effect on
+GroupLens scores:
+
1 --> -2
2 --> -1
3 --> 0
4 --> 1
5 --> 2
-
- the reason a user might want to do this is to combine grouplens
- predictions with scores calculated by other score methods"
-)
+
+The reason is that a user might want to do this is to combine
+GroupLens predictions with scores calculated by other score methods.")
(defvar grouplens-score-scale-factor 1
- "This variable allow sthe user to magify the effect of
- grouplens scores. The scale factor is applied after
- the offset.")
+ "This variable allows the user to magnify the effect of GroupLens scores.
+The scale factor is applied after the offset.")
+
+(defvar gnus-grouplens-override-scoring 'override
+ "Tell GroupLens to override the normal Gnus scoring mechanism.
+GroupLens scores can be combined with gnus scores in one of three ways.
+'override -- just use grouplens predictions for grouplens groups
+'combine -- combine grouplens scores with gnus scores
+'separate -- treat grouplens scores completely separate from gnus")
+
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;; Program global variables
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-
-(defvar grouplens-bbb-token "0"
- "Current session token number")
+(defvar grouplens-bbb-token nil
+ "Current session token number.")
(defvar grouplens-bbb-process nil
- "Process Id of current bbbd network stream process")
+ "Process Id of current bbbd network stream process.")
+
+(defvar grouplens-bbb-buffer nil
+ "Buffer associated with the BBBD process.")
(defvar grouplens-rating-alist nil
- "Current set of message-id rating pairs")
+ "Current set of message-id rating pairs.")
-(defvar grouplens-current-hashtable (make-hash-table :test 'equal :size 100))
-;; this seems like a pretty ugly way to get around the problem, but If
-;; I don't do this, then the compiler complains when I call gethash
-;;
-(eval-when-compile (setq grouplens-current-hashtable
- (make-hash-table :test 'equal :size 100)))
+(defvar grouplens-current-hashtable nil
+ "A hashtable to hold predictions from the BBB.")
(defvar grouplens-current-group nil)
-(defvar bbb-mid-list nil)
-
-(defvar bbb-alist nil)
+;;(defvar bbb-alist nil)
(defvar bbb-timeout-secs 10
- "Number of seconds to wait for some response from the BBB before
- we give up and assume that something has died..." )
-
-(defvar starting-time nil)
-
-(defvar elapsed-time 0)
+ "Number of seconds to wait for some response from the BBB.
+If this times out we give up and assume that something has died..." )
-(defvar previous-article nil)
+(defvar grouplens-previous-article nil
+ "Message-ID of the last article read.")
-(defvar process-buffer)
(defvar bbb-read-point)
(defvar bbb-response-point)
-(defvar login-response)
+
+(defun bbb-renew-hash-table ()
+ (setq grouplens-current-hashtable (make-vector 100 0)))
+
+(bbb-renew-hash-table)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;; Utility Functions
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-(defun connect-to-bbbd (host port)
- (setq process-buffer
- (get-buffer-create (format "trace of BBBD session to %s" host)))
+
+(defun bbb-connect-to-bbbd (host port)
+ (unless grouplens-bbb-buffer
+ (setq grouplens-bbb-buffer
+ (gnus-get-buffer-create (format " *BBBD trace: %s*" host)))
+ (save-excursion
+ (set-buffer grouplens-bbb-buffer)
+ (make-local-variable 'bbb-read-point)
+ (make-local-variable 'bbb-response-point)
+ (setq bbb-read-point (point-min))))
+
+ ;; if an old process is still running for some reason, kill it
+ (when grouplens-bbb-process
+ (ignore-errors
+ (when (eq 'open (process-status grouplens-bbb-process))
+ (set-process-buffer grouplens-bbb-process nil)
+ (delete-process grouplens-bbb-process))))
+
;; clear the trace buffer of old output
(save-excursion
- (set-buffer process-buffer)
+ (set-buffer grouplens-bbb-buffer)
(erase-buffer))
+
;; open the connection to the server
- (setq grouplens-bbb-process nil)
(catch 'done
(condition-case error
- (setq grouplens-bbb-process
- (open-network-stream "BBBD" process-buffer host port))
+ (setq grouplens-bbb-process
+ (open-network-stream "BBBD" grouplens-bbb-buffer host port))
(error (gnus-message 3 "Error: Failed to connect to BBB")
nil))
- (and (null grouplens-bbb-process) (throw 'done nil))
- (set-process-filter grouplens-bbb-process 'bbb-process-filter)
+ (and (null grouplens-bbb-process)
+ (throw 'done nil))
(save-excursion
- (set-buffer process-buffer)
- (make-local-variable 'bbb-read-point)
+ (set-buffer grouplens-bbb-buffer)
(setq bbb-read-point (point-min))
- (and (null (setq greeting (bbb-read-response grouplens-bbb-process t)))
- (throw 'done nil))
- ))
- grouplens-bbb-process )
+ (or (bbb-read-response grouplens-bbb-process)
+ (throw 'done nil))))
-(defun bbb-process-filter (process output)
- (save-excursion
- (set-buffer (process-buffer process))
- (goto-char (point-max))
- (insert output)))
+ ;; return the process
+ grouplens-bbb-process)
(defun bbb-send-command (process command)
(goto-char (point-max))
- (insert command "\r\n")
+ (insert command)
+ (insert "\r\n")
(setq bbb-read-point (point))
(setq bbb-response-point (point))
+ (set-marker (process-mark process) (point)) ; process output also comes here
(process-send-string process command)
- (process-send-string process "\r\n"))
+ (process-send-string process "\r\n")
+ (process-send-eof process))
-;; This function eats the initial response of OK or ERROR from
-;; the BBB.
-(defun bbb-read-response (process &optional return-response-string)
+(defun bbb-read-response (process)
+ "This function eats the initial response of OK or ERROR from the BBB."
(let ((case-fold-search nil)
- match-end)
+ match-end)
(goto-char bbb-read-point)
(while (and (not (search-forward "\r\n" nil t))
(accept-process-output process bbb-timeout-secs))
(goto-char bbb-read-point))
(setq match-end (point))
(goto-char bbb-read-point)
- (if (not (looking-at "OK"))
- (progn (setq bbb-read-point match-end) nil)
- (setq bbb-read-point match-end)
- (if return-response-string
- (buffer-substring (point) match-end)
- t ))))
+ (setq bbb-read-point match-end)
+ (looking-at "OK")))
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;;;; Login Functionons
+;;;; Login Functions
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
(defun bbb-login ()
- "return the token number if login is successful, otherwise return nil"
+ "return the token number if login is successful, otherwise return nil."
(interactive)
+ (setq grouplens-bbb-token nil)
(if (not (equal grouplens-pseudonym ""))
- (let ((bbb-process (connect-to-bbbd grouplens-bbb-host grouplens-bbb-port)))
+ (let ((bbb-process
+ (bbb-connect-to-bbbd grouplens-bbb-host grouplens-bbb-port)))
(if bbb-process
- (save-excursion (set-buffer (process-buffer bbb-process))
- (bbb-send-command bbb-process
- (concat "login " grouplens-pseudonym))
- (if (setq login-response
- (bbb-read-response bbb-process t))
- (setq grouplens-bbb-token (extract-token-number))
- (gnus-message 3 "Error: Grouplens login failed")
- (setq grouplens-bbb-token "0")
- nil))) )
+ (save-excursion
+ (set-buffer (process-buffer bbb-process))
+ (bbb-send-command bbb-process
+ (concat "login " grouplens-pseudonym))
+ (if (bbb-read-response bbb-process)
+ (setq grouplens-bbb-token (bbb-extract-token-number))
+ (gnus-message 3 "Error: GroupLens login failed")))))
(gnus-message 3 "Error: you must set a pseudonym"))
- nil)
+ grouplens-bbb-token)
-(defun extract-token-number ()
- (let ((token-pos (search-forward "token=" nil t) ))
- (if (looking-at "[0-9]+")
- (buffer-substring token-pos (match-end 0)))))
+(defun bbb-extract-token-number ()
+ (let ((token-pos (search-forward "token=" nil t)))
+ (when (looking-at "[0-9]+")
+ (buffer-substring token-pos (match-end 0)))))
+
+(gnus-add-shutdown 'bbb-logout 'gnus)
(defun bbb-logout ()
- "logout of bbb session"
- (let ((bbb-process (connect-to-bbbd grouplens-bbb-host grouplens-bbb-port)))
- (if bbb-process
- (save-excursion (set-buffer (process-buffer bbb-process))
- (bbb-send-command bbb-process
- (concat "logout " grouplens-bbb-token))
- (if (bbb-read-response bbb-process t)
- t
- nil) ))))
+ "logout of bbb session."
+ (when grouplens-bbb-token
+ (let ((bbb-process
+ (bbb-connect-to-bbbd grouplens-bbb-host grouplens-bbb-port)))
+ (when bbb-process
+ (save-excursion
+ (set-buffer (process-buffer bbb-process))
+ (bbb-send-command bbb-process (concat "logout " grouplens-bbb-token))
+ (bbb-read-response bbb-process))))))
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;; Get Predictions
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; this function can be called as part of the function
-;; to return the list of score files to use.
-;; See the gnus variable gnus-score-find-score-files-function
-;; *Note:* If you want to use grouplens scores along with
-;; calculated scores, you should see the offset and scale variables.
-;; At this point, I don't recommend using both scores and grouplens
-;; predictions together.
(defun bbb-build-mid-scores-alist (groupname)
- (if (member groupname grouplens-newsgroups)
- (let* ((mid-list (get-all-mids))
- (predict-list (bbb-get-predictions mid-list groupname)))
- ; alist should be a list of lists
- ; ((("message-id" ("<message-id>"
- ; score nil s)))
- (setq grouplens-current-group groupname)
- (setq previous-article nil)
- (list (list (list (append (list "message-id") predict-list)))))
- (progn (setq grouplens-current-group groupname)
- nil))
- )
-
-;; Ask the bbb for predictions, and build up the score alist.
+ "this function can be called as part of the function to return the list of score files to use.
+See the gnus variable gnus-score-find-score-files-function.
+
+*Note:* If you want to use grouplens scores along with calculated scores,
+you should see the offset and scale variables. At this point, I don't
+recommend using both scores and grouplens predictions together."
+ (setq grouplens-current-group groupname)
+ (when (member groupname grouplens-newsgroups)
+ (setq grouplens-previous-article nil)
+ ;; scores-alist should be a list of lists:
+ ;; ((("message-id" ("<mid1>" score1 nil s) ("<mid2> score2 nil s))))
+ ;;`((("message-id" . ,predict-list))) ; Yes, this is the return value
+ (list
+ (list
+ (list (append (list "message-id")
+ (bbb-get-predictions (bbb-get-all-mids) groupname)))))))
+
(defun bbb-get-predictions (midlist groupname)
- (if (equal grouplens-bbb-token "0")
- (gnus-message 3 "Error: You are not logged in to a BBB")
- (gnus-message 5 "Fetching Predictions...")
- (let* ((predict-command (build-predict-command
- midlist groupname grouplens-bbb-token ))
- (predict-list nil)
- (bbb-process (connect-to-bbbd grouplens-bbb-host grouplens-bbb-port)))
- (if bbb-process
- (save-excursion (set-buffer (process-buffer bbb-process))
- (bbb-send-command bbb-process predict-command)
- (if (bbb-read-response bbb-process nil)
- (setq predict-list
- (bbb-get-prediction-response bbb-process))
- (gnus-message 1 "Invalid Token, login and try again")
- (ding)
- )))
- (setq bbb-alist predict-list))
- ))
-
-
-
-(defun get-all-mids ()
- (let ((index (nth 1 (assoc "message-id" gnus-header-index)))
- (articles gnus-newsgroup-headers)
- art this)
- (setq bbb-mid-list nil)
- (while articles
- (progn (setq art (car articles)
- this (aref art index)
- articles (cdr articles))
- (setq bbb-mid-list (cons this bbb-mid-list))))
- bbb-mid-list)
- )
-
-(defun build-predict-command (mlist grpname token)
- (let ((cmd (concat "getpredictions " token " " grpname "\r\n"))
- art)
- (while mlist
- (setq art (car mlist)
- cmd (concat cmd art "\r\n")
- mlist (cdr mlist)))
- (setq cmd (concat cmd ".\r\n"))
- cmd)
- )
+ "Ask the bbb for predictions, and build up the score alist."
+ (gnus-message 5 "Fetching Predictions...")
+ (if grouplens-bbb-token
+ (let ((bbb-process (bbb-connect-to-bbbd grouplens-bbb-host
+ grouplens-bbb-port)))
+ (when bbb-process
+ (save-excursion
+ (set-buffer (process-buffer bbb-process))
+ (bbb-send-command bbb-process
+ (bbb-build-predict-command midlist groupname
+ grouplens-bbb-token))
+ (if (bbb-read-response bbb-process)
+ (bbb-get-prediction-response bbb-process)
+ (gnus-message 1 "Invalid Token, login and try again")
+ (ding)))))
+ (gnus-message 3 "Error: You are not logged in to a BBB")
+ (ding)))
+
+(defun bbb-get-all-mids ()
+ (mapcar (function (lambda (x) (mail-header-id x))) gnus-newsgroup-headers))
+
+(defun bbb-build-predict-command (mlist grpname token)
+ (concat "getpredictions " token " " grpname "\r\n"
+ (mapconcat 'identity mlist "\r\n") "\r\n.\r\n"))
(defun bbb-get-prediction-response (process)
- (let ((case-fold-search nil)
- match-end)
+ (let ((case-fold-search nil))
(goto-char bbb-read-point)
(while (and (not (search-forward ".\r\n" nil t))
(accept-process-output process bbb-timeout-secs))
(goto-char bbb-read-point))
- (setq match-end (point))
- (goto-char (+ bbb-response-point 4)) ;; we ought to be right before OK
- (build-response-alist)))
+ (goto-char (+ bbb-response-point 4));; we ought to be right before OK
+ (bbb-build-response-alist)))
;; build-response-alist assumes that the cursor has been positioned at
-;; the first line of the list of mid/rating pairs. For now we will
-;; use a prediction of 99 to signify no prediction. Ultimately, we
-;; should just ignore messages with no predictions.
-(defun build-response-alist ()
- (let ((resp nil)
- (match-end (point)))
- (setq grouplens-current-hashtable (make-hash-table :test 'equal :size 100))
+;; the first line of the list of mid/rating pairs.
+(defun bbb-build-response-alist ()
+ (let (resp mid pred)
(while
- (cond ((looking-at "\\(<.*>\\) :nopred=")
- (setq resp (cons (list (get-mid)
- gnus-summary-default-score
- nil 's) resp))
- (forward-line 1)
- t)
- ((looking-at "\\(<.*>\\) :pred=\\([0-9]\.[0-9][0-9]\\) :conflow=\\([0-9]\.[0-9][0-9]\\) :confhigh=\\([0-9]\.[0-9][0-9]\\)")
- (setq resp (cons (list (get-mid) (get-pred) nil 's) resp))
- (cl-puthash (get-mid)
- (list (get-pred) (get-confl) (get-confh))
- grouplens-current-hashtable)
- (forward-line 1)
- t)
- ((looking-at "\\(<.*>\\) :pred=\\([0-9]\.[0-9][0-9]\\)")
- (setq resp (cons (list (get-mid) (get-pred) nil 's) resp))
- (cl-puthash (get-mid)
- (list (get-pred) 0 0)
- grouplens-current-hashtable)
- (forward-line 1)
- t)
- (t nil) ))
- resp)
-)
-
-;; these two functions assume that there is an active match lying
+ (cond
+ ((looking-at "\\(<.*>\\) :nopred=")
+ ;;(push `(,(bbb-get-mid) ,gnus-summary-default-score nil s) resp)
+ (forward-line 1)
+ t)
+ ((looking-at "\\(<.*>\\) :pred=\\([0-9]\.[0-9][0-9]\\) :conflow=\\([0-9]\.[0-9][0-9]\\) :confhigh=\\([0-9]\.[0-9][0-9]\\)")
+ (setq mid (bbb-get-mid)
+ pred (bbb-get-pred))
+ (push `(,mid ,pred nil s) resp)
+ (gnus-sethash mid (list pred (bbb-get-confl) (bbb-get-confh))
+ grouplens-current-hashtable)
+ (forward-line 1)
+ t)
+ ((looking-at "\\(<.*>\\) :pred=\\([0-9]\.[0-9][0-9]\\)")
+ (setq mid (bbb-get-mid)
+ pred (bbb-get-pred))
+ (push `(,mid ,pred nil s) resp)
+ (gnus-sethash mid (list pred 0 0) grouplens-current-hashtable)
+ (forward-line 1)
+ t)
+ (t nil)))
+ resp))
+
+;; these "get" functions assume that there is an active match lying
;; around. Where the first parenthesized expression is the
-;; message-id, and the second is the prediction. Since gnus assumes
-;; that scores are integer values?? we round the prediction.
-(defun get-mid ()
+;; message-id, and the second is the prediction, the third and fourth
+;; are the confidence interval
+;;
+;; Since gnus assumes that scores are integer values?? we round the
+;; prediction.
+(defun bbb-get-mid ()
(buffer-substring (match-beginning 1) (match-end 1)))
-(defun get-pred ()
- (let ((tpred (round (string-to-int (buffer-substring
- (match-beginning 2)
- (match-end 2))))))
+(defun bbb-get-pred ()
+ (let ((tpred (string-to-number (buffer-substring (match-beginning 2)
+ (match-end 2)))))
(if (> tpred 0)
- (* grouplens-score-scale-factor (+ grouplens-score-offset tpred))
- 1))
-)
+ (round (* grouplens-score-scale-factor
+ (+ grouplens-score-offset tpred)))
+ 1)))
-(defun get-confl ()
- (string-to-number (buffer-substring (match-beginning 3) (match-end 3))))
+(defun bbb-get-confl ()
+ (string-to-number (buffer-substring (match-beginning 4) (match-end 4))))
-(defun get-confh ()
+(defun bbb-get-confh ()
(string-to-number (buffer-substring (match-beginning 4) (match-end 4))))
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;; Prediction Display
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-(defconst rating-range 4.0)
+(defconst grplens-rating-range 4.0)
(defconst grplens-maxrating 5)
(defconst grplens-minrating 1)
(defconst grplens-predstringsize 12)
-(defalias 'bbb-grouplens-score 'gnus-user-format-function-G)
-
(defvar gnus-tmp-score)
-(defun gnus-user-format-function-G (header)
- (let* ((rate-string (make-string 12 ? ))
- (mid
- (aref header
- (nth 1 (assoc "message-id" gnus-header-index))))
- (hashent (gethash mid grouplens-current-hashtable))
- (iscore (if (string-match "September" gnus-version)
- gnus-tmp-score
- score))
- (low (car (cdr hashent)))
- (high (car (cdr (cdr hashent)))))
- (aset rate-string 0 ?|) (aset rate-string 11 ?|)
- (if (not (member grouplens-current-group grouplens-newsgroups))
- (progn
- (if (not (equal grouplens-prediction-display 'prediction-num))
- (cond ((< iscore 0)
- (setq iscore 1))
- ((> iscore 5)
- (setq iscore 5))))
- (setq low 0) (setq high 0)))
- (if (and (grouplens-valid-score iscore)
- (not (null mid)))
- (cond
- ;; prediction-spot
- ((equal grouplens-prediction-display 'prediction-spot)
- (setq rate-string (fmt-prediction-spot rate-string iscore)))
- ;; confidence-interval
- ((equal grouplens-prediction-display 'confidence-interval)
- (setq rate-string (fmt-confidence-interval iscore low high)))
- ;; prediction-bar
- ((equal grouplens-prediction-display 'prediction-bar)
- (setq rate-string (fmt-prediction-bar rate-string iscore)))
- ;; confidence-bar
- ((equal grouplens-prediction-display 'confidence-bar)
- (setq rate-string (format "| %4.2f |" iscore)))
- ;; confidence-spot
- ((equal grouplens-prediction-display 'confidence-spot)
- (setq rate-string (format "| %4.2f |" iscore)))
- ;; prediction-num
- ((equal grouplens-prediction-display 'prediction-num)
- (setq rate-string (fmt-prediction-num iscore)))
- ;; confidence-plus-minus
- ((equal grouplens-prediction-display 'confidence-plus-minus)
- (setq rate-string (fmt-confidence-plus-minus iscore low high))
- )
- (t (gnus-message 3 "Invalid prediction display type"))
- )
- (aset rate-string 5 ?N) (aset rate-string 6 ?A))
- rate-string))
+(defun bbb-grouplens-score (header)
+ (if (eq gnus-grouplens-override-scoring 'separate)
+ (bbb-grouplens-other-score header)
+ (let* ((rate-string (make-string 12 ?\ ))
+ (mid (mail-header-id header))
+ (hashent (gnus-gethash mid grouplens-current-hashtable))
+ (iscore gnus-tmp-score)
+ (low (car (cdr hashent)))
+ (high (car (cdr (cdr hashent)))))
+ (aset rate-string 0 ?|)
+ (aset rate-string 11 ?|)
+ (unless (member grouplens-current-group grouplens-newsgroups)
+ (unless (equal grouplens-prediction-display 'prediction-num)
+ (cond ((< iscore 0)
+ (setq iscore 1))
+ ((> iscore 5)
+ (setq iscore 5))))
+ (setq low 0)
+ (setq high 0))
+ (if (and (bbb-valid-score iscore)
+ (not (null mid)))
+ (cond
+ ;; prediction-spot
+ ((equal grouplens-prediction-display 'prediction-spot)
+ (setq rate-string (bbb-fmt-prediction-spot rate-string iscore)))
+ ;; confidence-interval
+ ((equal grouplens-prediction-display 'confidence-interval)
+ (setq rate-string (bbb-fmt-confidence-interval iscore low high)))
+ ;; prediction-bar
+ ((equal grouplens-prediction-display 'prediction-bar)
+ (setq rate-string (bbb-fmt-prediction-bar rate-string iscore)))
+ ;; confidence-bar
+ ((equal grouplens-prediction-display 'confidence-bar)
+ (setq rate-string (format "| %4.2f |" iscore)))
+ ;; confidence-spot
+ ((equal grouplens-prediction-display 'confidence-spot)
+ (setq rate-string (format "| %4.2f |" iscore)))
+ ;; prediction-num
+ ((equal grouplens-prediction-display 'prediction-num)
+ (setq rate-string (bbb-fmt-prediction-num iscore)))
+ ;; confidence-plus-minus
+ ((equal grouplens-prediction-display 'confidence-plus-minus)
+ (setq rate-string (bbb-fmt-confidence-plus-minus iscore low high))
+ )
+ (t (gnus-message 3 "Invalid prediction display type")))
+ (aset rate-string 5 ?N) (aset rate-string 6 ?A))
+ rate-string)))
-;;
;; Gnus user format function that doesn't depend on
;; bbb-build-mid-scores-alist being used as the score function, but is
;; instead called from gnus-select-group-hook. -- LAB
-(defun gnus-user-format-function-L (header)
+(defun bbb-grouplens-other-score (header)
(if (not (member grouplens-current-group grouplens-newsgroups))
;; Return an empty string
""
- (let* ((rate-string (make-string 12 ? ))
- (mid
- (aref header
- (nth 1 (assoc "message-id" gnus-header-index))))
- (hashent (gethash mid grouplens-current-hashtable))
- (pred (nth 0 hashent))
+ (let* ((rate-string (make-string 12 ?\ ))
+ (mid (mail-header-id header))
+ (hashent (gnus-gethash mid grouplens-current-hashtable))
+ (pred (or (nth 0 hashent) 0))
(low (nth 1 hashent))
(high (nth 2 hashent)))
- (gnus-message 3 (concat "mid = " mid))
;; Init rate-string
- (aset rate-string 0 ?|)
+ (aset rate-string 0 ?|)
(aset rate-string 11 ?|)
-
+ (unless (equal grouplens-prediction-display 'prediction-num)
+ (cond ((< pred 0)
+ (setq pred 1))
+ ((> pred 5)
+ (setq pred 5))))
;; If no entry in BBB hash mark rate string as NA and return
- (if (null hashent)
- (progn
- (aset rate-string 5 ?N)
- (aset rate-string 6 ?A)
- rate-string)
- ;; Otherwise
- (cond
- ;; prediction-spot
- ((equal grouplens-prediction-display 'prediction-spot)
- (fmt-prediction-spot rate-string pred))
-
- ;; confidence-interval
- ((equal grouplens-prediction-display 'confidence-interval)
- (fmt-confidence-interval pred low high))
-
- ;; prediction-bar
- ((equal grouplens-prediction-display 'prediction-bar)
- (fmt-prediction-bar rate-string pred))
-
- ;; confidence-bar
- ((equal grouplens-prediction-display 'confidence-bar)
- (format "| %4.2f |" pred))
-
- ;; confidence-spot
- ((equal grouplens-prediction-display 'confidence-spot)
- (format "| %4.2f |" pred))
-
- ;; prediction-num
- ((equal grouplens-prediction-display 'prediction-num)
- (fmt-prediction-num pred))
-
- ;; confidence-plus-minus
- ((equal grouplens-prediction-display 'confidence-plus-minus)
- (fmt-confidence-plus-minus pred low high))
-
- (t
- (gnus-message 3 "Invalid prediction display type")
- (aset rate-string 0 ?|)
- (aset rate-string 11 ?|)
- rate-string)
- )
- )
- )
- )
- )
+ (cond
+ ((null hashent)
+ (aset rate-string 5 ?N)
+ (aset rate-string 6 ?A)
+ rate-string)
-(defun grouplens-valid-score (score)
- (if (equal grouplens-prediction-display 'prediction-num)
- t
- (and (>= score grplens-minrating)
- (<= score grplens-maxrating))))
+ ((equal grouplens-prediction-display 'prediction-spot)
+ (bbb-fmt-prediction-spot rate-string pred))
-(defun requires-confidence (format-type)
+ ((equal grouplens-prediction-display 'confidence-interval)
+ (bbb-fmt-confidence-interval pred low high))
+
+ ((equal grouplens-prediction-display 'prediction-bar)
+ (bbb-fmt-prediction-bar rate-string pred))
+
+ ((equal grouplens-prediction-display 'confidence-bar)
+ (format "| %4.2f |" pred))
+
+ ((equal grouplens-prediction-display 'confidence-spot)
+ (format "| %4.2f |" pred))
+
+ ((equal grouplens-prediction-display 'prediction-num)
+ (bbb-fmt-prediction-num pred))
+
+ ((equal grouplens-prediction-display 'confidence-plus-minus)
+ (bbb-fmt-confidence-plus-minus pred low high))
+
+ (t
+ (gnus-message 3 "Invalid prediction display type")
+ (aset rate-string 0 ?|)
+ (aset rate-string 11 ?|)
+ rate-string)))))
+
+(defun bbb-valid-score (score)
+ (or (equal grouplens-prediction-display 'prediction-num)
+ (and (>= score grplens-minrating)
+ (<= score grplens-maxrating))))
+
+(defun bbb-requires-confidence (format-type)
(or (equal format-type 'confidence-plus-minus)
(equal format-type 'confidence-spot)
(equal format-type 'confidence-interval)))
-(defun have-confidence (clow chigh)
+(defun bbb-have-confidence (clow chigh)
(not (or (null clow)
(null chigh))))
-
-(defun fmt-prediction-spot (rate-string score)
+(defun bbb-fmt-prediction-spot (rate-string score)
(aset rate-string
- (round (* (/ (- score grplens-minrating) rating-range)
+ (round (* (/ (- score grplens-minrating) grplens-rating-range)
(+ (- grplens-predstringsize 4) 1.49)))
?*)
rate-string)
-(defun fmt-confidence-interval (score low high)
- (if (have-confidence low high)
+(defun bbb-fmt-confidence-interval (score low high)
+ (if (bbb-have-confidence low high)
(format "|%4.2f-%4.2f |" low high)
- (fmt-prediction-num score)))
+ (bbb-fmt-prediction-num score)))
-(defun fmt-confidence-plus-minus (score low high)
- (if (have-confidence low high)
+(defun bbb-fmt-confidence-plus-minus (score low high)
+ (if (bbb-have-confidence low high)
(format "|%3.1f+/-%4.2f|" score (/ (- high low) 2.0))
- (fmt-prediction-num score)))
+ (bbb-fmt-prediction-num score)))
-(defun fmt-prediction-bar (rate-string score)
- (let* ((i 1)
- (step (/ rating-range (- grplens-predstringsize 4)))
+(defun bbb-fmt-prediction-bar (rate-string score)
+ (let* ((i 1)
+ (step (/ grplens-rating-range (- grplens-predstringsize 4)))
(half-step (/ step 2))
(loc (- grplens-minrating half-step)))
(while (< i (- grplens-predstringsize 2))
(if (> score loc)
(aset rate-string i ?#)
- (aset rate-string i ? ))
+ (aset rate-string i ?\ ))
(setq i (+ i 1))
(setq loc (+ loc step)))
)
rate-string)
-(defun fmt-prediction-num (score)
- (format "| %4.2f |" score)
-)
+(defun bbb-fmt-prediction-num (score)
+ (format "| %4.2f |" score))
+
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;; Put Ratings
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;; The message-id for the current article can be found in
-;; (aref gnus-current-headers (nth 1 (assoc "message-id" gnus-header-index)))
-;;
-
-;;
-
(defun bbb-put-ratings ()
- (if (and grouplens-rating-alist
+ (if (and grouplens-bbb-token
+ grouplens-rating-alist
(member gnus-newsgroup-name grouplens-newsgroups))
- (let ((bbb-process (connect-to-bbbd grouplens-bbb-host
- grouplens-bbb-port))
- (rate-command (build-rate-command grouplens-rating-alist)))
+ (let ((bbb-process (bbb-connect-to-bbbd grouplens-bbb-host
+ grouplens-bbb-port))
+ (rate-command (bbb-build-rate-command grouplens-rating-alist)))
(if bbb-process
- (save-excursion (set-buffer (process-buffer bbb-process))
- (gnus-message 5 "Sending Ratings...")
- (bbb-send-command bbb-process rate-command)
- (if (bbb-read-response bbb-process t)
- (setq grouplens-rating-alist nil)
- (gnus-message 1
- "Token timed out: call bbb-login and quit again")
- (ding))
- (gnus-message 5 "Sending Ratings...Done"))
+ (save-excursion
+ (set-buffer (process-buffer bbb-process))
+ (gnus-message 5 "Sending Ratings...")
+ (bbb-send-command bbb-process rate-command)
+ (if (bbb-read-response bbb-process)
+ (setq grouplens-rating-alist nil)
+ (gnus-message 1
+ "Token timed out: call bbb-login and quit again")
+ (ding))
+ (gnus-message 5 "Sending Ratings...Done"))
(gnus-message 3 "No BBB connection")))
- (setq grouplens-rating-alist nil))
-)
-
-(defun build-rate-command (rate-alist)
- (let ((cmd (concat "putratings " grouplens-bbb-token
- " " grouplens-current-group " \r\n"))
- this)
- (while rate-alist
- (setq this (car rate-alist)
- cmd (concat cmd (car this) " :rating=" (cadr this) ".00"
- " :time=" (cddr this) "\r\n")
- rate-alist (cdr rate-alist)))
- (concat cmd ".\r\n"))
-)
+ (setq grouplens-rating-alist nil)))
+
+(defun bbb-build-rate-command (rate-alist)
+ (concat "putratings " grouplens-bbb-token " " grouplens-current-group " \r\n"
+ (mapconcat '(lambda (this) ; form (mid . (score . time))
+ (concat (car this)
+ " :rating=" (cadr this) ".00"
+ " :time=" (cddr this)))
+ rate-alist "\r\n")
+ "\r\n.\r\n"))
;; Interactive rating functions.
-(defun bbb-summary-rate-article (rating &optional midin)
+(defun bbb-summary-rate-article (rating &optional midin)
(interactive "nRating: ")
- (let ((mid (or midin (get-current-id)))
- oldrating)
- (if (and rating (or (> rating 0)
- (< rating 6))
- mid
- (member gnus-newsgroup-name grouplens-newsgroups))
- (progn
- (if (not (setq oldrating (assoc mid grouplens-rating-alist)))
- (setq grouplens-rating-alist (cons (cons mid (cons rating 0))
- grouplens-rating-alist))
- (setcdr oldrating (cons rating 0)))
- (gnus-summary-mark-article nil (int-to-string rating)))
- (gnus-message 3 "Invalid rating"))))
+ (when (member gnus-newsgroup-name grouplens-newsgroups)
+ (let ((mid (or midin (bbb-get-current-id))))
+ (if (and rating
+ (>= rating grplens-minrating)
+ (<= rating grplens-maxrating)
+ mid)
+ (let ((oldrating (assoc mid grouplens-rating-alist)))
+ (if oldrating
+ (setcdr oldrating (cons rating 0))
+ (push `(,mid . (,rating . 0)) grouplens-rating-alist))
+ (gnus-summary-mark-article nil (int-to-string rating)))
+ (gnus-message 3 "Invalid rating")))))
(defun grouplens-next-unread-article (rating)
"Select unread article after current one."
(interactive "P")
- (if rating
- (bbb-summary-rate-article rating))
- (gnus-summary-next-article t (and gnus-auto-select-same
- (gnus-summary-subject-string))))
+ (when rating
+ (bbb-summary-rate-article rating))
+ (gnus-summary-next-unread-article))
(defun grouplens-best-unread-article (rating)
"Select unread article after current one."
(interactive "P")
- (if rating
- (bbb-summary-rate-article rating))
+ (when rating
+ (bbb-summary-rate-article rating))
(gnus-summary-best-unread-article))
-(defun grouplens-score-thread-sept (score)
+(defun grouplens-summary-catchup-and-exit (rating)
+ "Mark all articles not marked as unread in this newsgroup as read, then exit.
+If prefix argument ALL is non-nil, all articles are marked as read."
+ (interactive "P")
+ (when rating
+ (bbb-summary-rate-article rating))
+ (if (numberp rating)
+ (gnus-summary-catchup-and-exit)
+ (gnus-summary-catchup-and-exit rating)))
+
+(defun grouplens-score-thread (score)
"Raise the score of the articles in the current thread with SCORE."
- (interactive "nRating:")
+ (interactive "nRating: ")
(let (e)
(save-excursion
- (let ((articles (gnus-summary-articles-in-thread)))
- (while articles
- (gnus-summary-goto-subject (car articles))
- (gnus-set-global-variables)
+ (let ((articles (gnus-summary-articles-in-thread))
+ article)
+ (while (setq article (pop articles))
+ (gnus-summary-goto-subject article)
(bbb-summary-rate-article score
- (mail-header-id
- (gnus-summary-article-header (car articles))))
- (setq articles (cdr articles))))
+ (mail-header-id
+ (gnus-summary-article-header article)))))
(setq e (point)))
(let ((gnus-summary-check-current t))
(or (zerop (gnus-summary-next-subject 1 t))
(gnus-summary-position-point)
(gnus-set-mode-line 'summary))
-(defun grouplens-score-thread-v5 (score)
- "Raise the score of the articles in the current thread with SCORE."
- (interactive "nRating: ")
- (gnus-set-global-variables)
- (let ((scoring t)
- (level (gnus-summary-thread-level)))
- (save-excursion
- (while scoring
- (bbb-summary-rate-article score
- (mail-header-id
- (gnus-get-header-by-number
- (gnus-summary-article-number))))
- ;; ...and go forward until either the buffer ends or the subtree
- ;; ends.
- (if (not (and (zerop (forward-line 1))
- (> (gnus-summary-thread-level) level)))
- (setq scoring nil))))
- ;; Go to next unread subject.
- (gnus-summary-next-subject 1 t))
- (gnus-set-mode-line 'summary))
+(defun bbb-exit-group ()
+ (bbb-put-ratings)
+ (bbb-renew-hash-table))
-(if (string-match "September" gnus-version)
- (defalias 'grouplens-score-thread 'grouplens-score-thread-sept)
- (defalias 'grouplens-score-thread 'grouplens-score-thread-v5))
-
-(defun get-current-id ()
+(defun bbb-get-current-id ()
(if gnus-current-headers
- (aref gnus-current-headers (nth 1 (assoc "message-id" gnus-header-index)))
+ (mail-header-id gnus-current-headers)
(gnus-message 3 "You must select an article before you rate it")))
-
-(defvar gnus-tmp-group)
-(defun gnus-user-format-function-I (header)
- (let ((gname (if (string-match "September" gnus-version)
- gnus-tmp-group
- group)))
- (if (member gname grouplens-newsgroups)
- " (GroupLens Enhanced)"
- ""))
-)
-
(defun bbb-grouplens-group-p (group)
"Say whether GROUP is a GroupLens group."
- (if (member group grouplens-newsgroups)
- " (GroupLens Enhanced)"
- ""))
+ (if (member group grouplens-newsgroups) " (GroupLens Enhanced)" ""))
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; TIME SPENT READING
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+(defvar grouplens-current-starting-time nil)
(defun grouplens-start-timer ()
- (setq starting-time (current-time))
-)
+ (setq grouplens-current-starting-time (current-time)))
(defun grouplens-elapsed-time ()
- (let ((et (time-float (current-time))))
- (- et (time-float starting-time)))
-)
+ (let ((et (bbb-time-float (current-time))))
+ (- et (bbb-time-float grouplens-current-starting-time))))
-(defun time-float (timeval)
- (+ (* (car timeval) 65536)
- (cadr timeval)))
+(defun bbb-time-float (timeval)
+ (+ (* (car timeval) 65536)
+ (cadr timeval)))
(defun grouplens-do-time ()
- (let (oldrating)
- (if (member gnus-newsgroup-name grouplens-newsgroups)
- (progn
- (cond ((not (null previous-article))
- (setq elapsed-time (grouplens-elapsed-time))
- (if (not (setq oldrating (assoc previous-article
- grouplens-rating-alist)))
- (setq grouplens-rating-alist (cons (cons previous-article
- (cons 0
- elapsed-time))
- grouplens-rating-alist))
- (setcdr oldrating (cons (cadr oldrating) elapsed-time)))
- ))
- (grouplens-start-timer)
- (setq previous-article (get-current-id)))
- ) ; end if
- ))
-
+ (when (member gnus-newsgroup-name grouplens-newsgroups)
+ (when grouplens-previous-article
+ (let ((elapsed-time (grouplens-elapsed-time))
+ (oldrating (assoc grouplens-previous-article
+ grouplens-rating-alist)))
+ (if (not oldrating)
+ (push `(,grouplens-previous-article . (0 . ,elapsed-time))
+ grouplens-rating-alist)
+ (setcdr oldrating (cons (cadr oldrating) elapsed-time)))))
+ (grouplens-start-timer)
+ (setq grouplens-previous-article (bbb-get-current-id))))
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; BUG REPORTING
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-(defconst gnus-gl-version "$Id: gnus-gl.el,v 1.2 1996/02/25 03:46:03 steve Exp $")
+(defconst gnus-gl-version "gnus-gl.el 2.50")
(defconst gnus-gl-maintainer-address "grouplens-bug@cs.umn.edu")
(defun gnus-gl-submit-bug-report ()
- "Submit via mail a bug report on gnus-gl"
+ "Submit via mail a bug report on gnus-gl."
(interactive)
(require 'reporter)
- (reporter-submit-bug-report
- gnus-gl-maintainer-address
- (concat "gnus-gl.el " gnus-gl-version)
- (list 'grouplens-pseudonym
- 'grouplens-bbb-host
- 'grouplens-bbb-port
- 'grouplens-newsgroups
- 'grouplens-bbb-token
- 'grouplens-bbb-process
- 'grouplens-current-group
- 'grouplens-previous-article
- 'grouplens-mid-list
- 'bbb-alist)
- nil
- 'gnus-gl-get-trace))
+ (reporter-submit-bug-report gnus-gl-maintainer-address
+ (concat "gnus-gl.el " gnus-gl-version)
+ (list 'grouplens-pseudonym
+ 'grouplens-bbb-host
+ 'grouplens-bbb-port
+ 'grouplens-newsgroups
+ 'grouplens-bbb-token
+ 'grouplens-bbb-process
+ 'grouplens-current-group
+ 'grouplens-previous-article)
+ nil
+ 'gnus-gl-get-trace))
(defun gnus-gl-get-trace ()
-(insert-buffer (concat "trace of BBBD session to " grouplens-bbb-host)))
+ "Insert the contents of the BBBD trace buffer."
+ (when grouplens-bbb-buffer
+ (insert-buffer-substring grouplens-bbb-buffer)))
-;;;
-;;; Additions to make gnus-grouplens-mode Warning Warning!!
-;;; This version of the gnus-grouplens-mode does
-;;; not work with gnus-5.x. The "old" way of
-;;; setting up GroupLens still works however.
-;;;
+;;
+;; GroupLens minor mode
+;;
(defvar gnus-grouplens-mode nil
"Minor mode for providing a GroupLens interface in Gnus summary buffers.")
(unless gnus-grouplens-mode-map
(setq gnus-grouplens-mode-map (make-keymap))
(gnus-define-keys
- gnus-grouplens-mode-map
- "n" grouplens-next-unread-article
- "r" bbb-summary-rate-article
- "k" grouplens-score-thread
- "," grouplens-best-unread-article))
+ gnus-grouplens-mode-map
+ "n" grouplens-next-unread-article
+ "r" bbb-summary-rate-article
+ "k" grouplens-score-thread
+ "c" grouplens-summary-catchup-and-exit
+ "," grouplens-best-unread-article))
(defun gnus-grouplens-make-menu-bar ()
(unless (boundp 'gnus-grouplens-menu)
["Rate" bbb-summary-rate-article t]
["Next article" grouplens-next-unread-article t]
["Best article" grouplens-best-unread-article t]
- ["Raise thread" grouplens-score-thread-sept t]
+ ["Raise thread" grouplens-score-thread t]
["Report bugs" gnus-gl-submit-bug-report t]))))
(defun gnus-grouplens-mode (&optional arg)
(when (and (eq major-mode 'gnus-summary-mode)
(member gnus-newsgroup-name grouplens-newsgroups))
(make-local-variable 'gnus-grouplens-mode)
- (setq gnus-grouplens-mode
+ (setq gnus-grouplens-mode
(if (null arg) (not gnus-grouplens-mode)
(> (prefix-numeric-value arg) 0)))
(when gnus-grouplens-mode
(make-local-hook 'gnus-select-article-hook)
- (add-hook 'gnus-select-article-hook 'grouplens-do-time)
- (make-local-hook 'bbb-put-ratings)
- (add-hook 'gnus-exit-group-hook 'bbb-put-ratings)
- (setq gnus-score-find-score-files-function 'bbb-build-mid-scores-alist)
+ (add-hook 'gnus-select-article-hook 'grouplens-do-time nil 'local)
+ (make-local-hook 'gnus-exit-group-hook)
+ (add-hook 'gnus-exit-group-hook 'bbb-exit-group nil 'local)
+ (make-local-variable 'gnus-score-find-score-files-function)
+
+ (cond
+ ((eq gnus-grouplens-override-scoring 'combine)
+ ;; either add bbb-buld-mid-scores-alist to a list
+ ;; or make a list
+ (if (listp gnus-score-find-score-files-function)
+ (setq gnus-score-find-score-files-function
+ (append 'bbb-build-mid-scores-alist
+ gnus-score-find-score-files-function))
+ (setq gnus-score-find-score-files-function
+ (list gnus-score-find-score-files-function
+ 'bbb-build-mid-scores-alist))))
+ ;; leave the gnus-score-find-score-files variable alone
+ ((eq gnus-grouplens-override-scoring 'separate)
+ (add-hook 'gnus-select-group-hook
+ (lambda ()
+ (bbb-get-predictions (bbb-get-all-mids)
+ gnus-newsgroup-name))))
+ ;; default is to override
+ (t
+ (setq gnus-score-find-score-files-function
+ 'bbb-build-mid-scores-alist)))
+
+ ;; Change how summary lines look
(make-local-variable 'gnus-summary-line-format)
- (setq gnus-summary-line-format gnus-summary-grouplens-line-format)
(make-local-variable 'gnus-summary-line-format-spec)
+ (setq gnus-summary-line-format gnus-summary-grouplens-line-format)
+ (setq gnus-summary-line-format-spec nil)
+ (gnus-update-format-specifications nil 'summary)
+ (gnus-update-summary-mark-positions)
;; Set up the menu.
(when (and menu-bar-mode
(gnus-visual-p 'grouplens-menu 'menu))
- (gnus-grouplens-make-menu-bar)
- (easy-menu-add 'gnus-grouplens-menu))
- (unless (assq 'gnus-grouplens-mode minor-mode-alist)
- (push '(gnus-grouplens-mode " GroupLens") minor-mode-alist))
- (unless (assq 'gnus-grouplens-mode minor-mode-map-alist)
- (push (cons 'gnus-grouplens-mode gnus-grouplens-mode-map)
- minor-mode-map-alist))
- (run-hooks 'gnus-grouplens-mode-hook))))
+ (gnus-grouplens-make-menu-bar))
+ (gnus-add-minor-mode
+ 'gnus-grouplens-mode " GroupLens" gnus-grouplens-mode-map)
+ (gnus-run-hooks 'gnus-grouplens-mode-hook))))
(provide 'gnus-gl)
-
-
+;;; gnus-gl.el ends here