commands1.el 169 KB
Newer Older
David Byers's avatar
David Byers committed
1
;;;;; -*-coding: iso-8859-1;-*-
Linus Tolke's avatar
Linus Tolke committed
2
3
;;;;;
;;;;; $Id$
4
;;;;; Copyright (C) 1991-2002  Lysator Academic Computer Association.
Linus Tolke's avatar
Linus Tolke committed
5
;;;;;
6
;;;;; This file is part of the LysKOM Emacs LISP client.
Linus Tolke's avatar
Linus Tolke committed
7
8
9
;;;;; 
;;;;; LysKOM is free software; you can redistribute it and/or modify it
;;;;; under the terms of the GNU General Public License as published by 
10
;;;;; the Free Software Foundation; either version 2, or (at your option) 
Linus Tolke's avatar
Linus Tolke committed
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
;;;;; any later version.
;;;;; 
;;;;; LysKOM 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 LysKOM; see the file COPYING.  If not, write to
;;;;; Lysator, c/o ISY, Linkoping University, S-581 83 Linkoping, SWEDEN,
;;;;; or the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, 
;;;;; MA 02139, USA.
;;;;;
;;;;; Please mail bug reports to bug-lyskom@lysator.liu.se. 
;;;;;
Per Cederqvist's avatar
.  
Per Cederqvist committed
26
27
28
29
30
31
32
33
;;;; ================================================================
;;;; ================================================================
;;;;
;;;; File: commands1.el
;;;;
;;;; This file contains the code for some of the high level commands.
;;;;

34
35
36
37
(setq lyskom-clientversion-long 
      (concat lyskom-clientversion-long
	      "$Id$\n"))

38
39
40
(eval-when-compile
  (require 'lyskom-command "command"))

41

Per Cederqvist's avatar
.  
Per Cederqvist committed
42
43
44
45
46
47
;;; ================================================================
;;;                  F} uppmuntran - Get appreciation 

;;; Author: Inge Wallin


David Kågedal's avatar
David Kågedal committed
48
(def-kom-command kom-get-appreciation ()
49
  "Provides a little light in the dark."
Per Cederqvist's avatar
.  
Per Cederqvist committed
50
  (interactive)
David Kågedal's avatar
David Kågedal committed
51
52
  (lyskom-insert-string 'appreciation))
  
Per Cederqvist's avatar
.  
Per Cederqvist committed
53
54
55
56
57
58
59

;;; ================================================================
;;;                      F} Sk{ll - Get abuse

;;; Author: Inge Wallin


David Kågedal's avatar
David Kågedal committed
60
(def-kom-command kom-get-abuse ()
61
  "Provides a bit of verbal abuse."
Per Cederqvist's avatar
.  
Per Cederqvist committed
62
  (interactive)
David Kågedal's avatar
David Kågedal committed
63
  (lyskom-insert-string 'abuse))
Per Cederqvist's avatar
.  
Per Cederqvist committed
64
65
66
67
68
69
70
71


;;; ================================================================
;;;            Utpl}na - Delete a person or a conference

;;; Author: Inge Wallin


David Kågedal's avatar
David Kågedal committed
72
(def-kom-command kom-delete-conf ()
73
74
75
76
77
  "Deletes a person or a conference. In order to delete a conference
you must be the supervisor of the conference. Once a conference is
deleted, it can never be restored, and texts with no recipients other
than the deleted conference will become inaccessible, and will
eventually be permanently deleted."
Per Cederqvist's avatar
.  
Per Cederqvist committed
78
  (interactive)
David Kågedal's avatar
David Kågedal committed
79
80
  (let ((conf-stat 
	 (lyskom-read-conf-stat (lyskom-get-string 'what-conf-to-delete)
81
				'(all) nil nil t)))
David Kågedal's avatar
David Kågedal committed
82
83
84
85
86
87
88
89
90
91
    (if conf-stat
	(if (lyskom-ja-or-nej-p
	     (lyskom-format 'confirm-delete-pers-or-conf
			    (if (conf-type->letterbox (conf-stat->conf-type 
						       conf-stat))
				(lyskom-get-string 'the-pers)
			      (lyskom-get-string 'the-conf))
			    (conf-stat->name conf-stat)))
	    (if (blocking-do 'delete-conf
			     (conf-stat->conf-no conf-stat))
92
93
94
95
96
97
98
99
100
101
102
103
104
105
		(progn
		  (lyskom-format-insert 'conf-is-deleted
					(conf-stat->name conf-stat))
		  (when (= (conf-stat->conf-no conf-stat)
			   lyskom-pers-no)
		    (lyskom-insert (lyskom-get-string
				    'you-have-deleted-yourself))
		    (setq lyskom-pers-no nil
			  lyskom-membership nil
			  lyskom-to-do-list (lyskom-create-read-list)
			  lyskom-reading-list (lyskom-create-read-list)
			  lyskom-pending-commands (cons
						   'kom-start-anew
						   lyskom-pending-commands))))
David Kågedal's avatar
David Kågedal committed
106
107
108
109
	      (lyskom-format-insert 'you-could-not-delete
				    conf-stat))
	  (lyskom-insert-string 'deletion-not-confirmed))
      (lyskom-insert-string 'somebody-else-deleted-that-conf))))
Per Cederqvist's avatar
.  
Per Cederqvist committed
110
111
112
113
114
115
116
117


;;; ================================================================
;;;                Radera (text) - Delete a text

;;; Author: Inge Wallin


118
(def-kom-command kom-delete-text (text-no)
119
120
121
122
123
124
125
126
127
128
129
130
131
132
  "Permanently deletes a text. In order to delete a text you must
be the author of the text, or the supervisor of the author.

It is a very bad idea to delete texts that have comments. By deleting
a text with comments, the comments lost their context. This can lead
to fragmented discussion trees, where it is impossible to understand
what a comment means, or indeed what the whole discussion is about.

Instead of deleting a text, consider moving it to a conference created
specifically for storing texts that are no longer interesting. Several
LysKOM systems have such conferences, so ask around.

This command accepts text number prefix arguments (see
`lyskom-read-text-no-prefix-arg')."
133
134
  (interactive (list (lyskom-read-text-no-prefix-arg 'what-text-to-delete)))
  (if text-no
David Byers's avatar
David Byers committed
135
136
137
      (let* ((text-stat (blocking-do 'get-text-stat text-no))
             (num-marks (and text-stat (text-stat->no-of-marks text-stat)))
             (num-comments (and text-stat (length (lyskom-text-comments text-stat))))
138
             (is-marked-by-me (cache-text-is-marked text-no)))
David Byers's avatar
David Byers committed
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

        (if (null text-stat)
            (lyskom-report-command-answer nil)
          (when (and (or (eq 0 num-marks)
                         (lyskom-j-or-n-p 
                          (lyskom-format 'delete-marked-text
                                         (if (> num-marks 0)
                                             (if is-marked-by-me
                                                 (if (= num-marks 1)
                                                     (lyskom-get-string 'delete-marked-by-you)
                                                   (lyskom-format 'delete-marked-by-you-and-others
                                                                  (1- num-marks)))
                                               (lyskom-format 'delete-marked-by-several
                                                              num-marks))))))
                     (or (eq 0 num-comments)
                         (progn (lyskom-format-insert "%#1@%#2t\n" 
155
                                                      `(face ,kom-warning-face)
David Byers's avatar
David Byers committed
156
157
158
159
160
161
162
163
164
165
166
                                                      (lyskom-get-string 'delete-commented-text-help))
                                (lyskom-beep t)
                                (and (lyskom-j-or-n-p
                                      (lyskom-get-string 'delete-commented-text))
                                     (lyskom-j-or-n-p
                                      (lyskom-get-string 'really-delete-commented-text))))))
            (lyskom-format-insert 'deleting-text text-no)
            (when (lyskom-report-command-answer 
                   (blocking-do 'delete-text text-no))
              (when is-marked-by-me
                (lyskom-unmark-text text-no))))))
167
    (lyskom-insert 'confusion-what-to-delete)))
David Byers's avatar
David Byers committed
168

Per Cederqvist's avatar
.  
Per Cederqvist committed
169
170
171
172
173
174
175
176
177


;;; ================================================================
;;;        ]terse presentation - Review the presentation
;;;               for a person or a conference

;;; Author: Inge Wallin


David Byers's avatar
David Byers committed
178
(def-kom-command kom-review-presentation (&optional text-or-conf-no)
179
180
181
182
183
184
185
  "Reviews the presentation for a person or a conference. If you give
a prefix argument it is treated as a text number prefix argument (see
`lyskom-read-text-no-prefix-arg'), and this command shows the
presentation of the author of that text.

This command accepts text number prefix arguments (see
`lyskom-read-text-no-prefix-arg')."
186
187
188
189
  (interactive (and current-prefix-arg ; only peek at textno:s when prefixed!
		    (list (lyskom-read-text-no-prefix-arg
			   'text-to-see-author-of))))
  (let ((conf-stat
David Byers's avatar
David Byers committed
190
         (if text-or-conf-no
191
             (blocking-do 'get-conf-stat
David Byers's avatar
David Byers committed
192
193
194
195
                          (if (interactive-p)
                              (text-stat->author
                               (blocking-do 'get-text-stat text-or-conf-no))
                            text-or-conf-no))
196
           (lyskom-read-conf-stat
197
198
199
            (lyskom-get-string 'presentation-for-whom)
            '(all)
            nil "" t))))
David Byers's avatar
David Byers committed
200
201
    (lyskom-review-presentation conf-stat)))

202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
(def-kom-command kom-unread-presentation (&optional text-or-conf-no)
  "Marks the presentation for a person or a conference as unread. If
you give a prefix argument it is treated as a text number prefix
argument (see `lyskom-read-text-no-prefix-arg'), and this command
unreads the presentation of the author of that text.

This command accepts text number prefix arguments (see
`lyskom-read-text-no-prefix-arg')."
  (interactive (and current-prefix-arg ; only peek at textno:s when prefixed!
		    (list (lyskom-read-text-no-prefix-arg
			   'text-to-unread-author-of))))
  (let ((conf-stat
         (if text-or-conf-no
             (blocking-do 'get-conf-stat
                          (if (interactive-p)
                              (text-stat->author
                               (blocking-do 'get-text-stat text-or-conf-no))
                            text-or-conf-no))
           (lyskom-read-conf-stat
            (lyskom-get-string 'unread-presentation-for-whom)
            '(all)
            nil "" t))))
    (if (zerop (conf-stat->presentation conf-stat))
        (lyskom-format-insert 'has-no-presentation conf-stat)
      (lyskom-format-insert 'marking-text-unread
                            (conf-stat->presentation conf-stat))
      (lyskom-report-command-answer
       (lyskom-mark-unread (conf-stat->presentation conf-stat))))))

David Byers's avatar
David Byers committed
231
232
233
234
235
236
237
238
239
240
241
242
243
244
(defun lyskom-review-presentation (conf-stat)
  "Review the presentation of conference CONF-STAT."
  (if (null conf-stat)
      (lyskom-insert-string 'somebody-deleted-that-conf)
    (lyskom-format-insert 'review-presentation-of
                          conf-stat)
    (if (/= (conf-stat->presentation conf-stat) 0)
        (lyskom-view-text (conf-stat->presentation conf-stat))
      (lyskom-format-insert 'has-no-presentation
                            conf-stat))
    (lyskom-traverse faq (lyskom-get-aux-item 
                          (conf-stat->aux-items conf-stat)
                          14)
      (lyskom-print-comment-like-aux faq conf-stat))))  
245
246
247

(defun lyskom-print-comment-like-aux (item object)
  (let* ((text-no (string-to-int (aux-item->data item)))
David Byers's avatar
David Byers committed
248
249
250
251
252
253
254
         (text-stat nil)
         (text nil))
    (unless kom-deferred-printing
      (blocking-do-multiple ((x-text (get-text text-no))
                             (x-text-stat (get-text-stat text-no)))
        (setq text-stat x-text-stat text x-text)))

255
    (cond ((or text-stat (not kom-deferred-printing))
David Byers's avatar
David Byers committed
256
           (lyskom-insert-comment-like-aux item text-no text-stat text object))
257
258
259
260
261
262
263
264
265
266
267
          (t (let ((defer-info (lyskom-create-defer-info
                                'get-text-stat
                                text-no
                                'lyskom-insert-deferred-comment-like-aux
                                (point-max-marker)
                                (length lyskom-defer-indicator)
                                nil     ; Filled in later
                                (list item object text-no))))
               (lyskom-format-insert "%#1s\n" lyskom-defer-indicator)
               (lyskom-defer-insertion defer-info))))))

David Byers's avatar
David Byers committed
268
(defun lyskom-insert-comment-like-aux (item text-no text-stat text object)
269
270
271
272
273
274
  (let* ((author (if text-stat (text-stat->author text-stat) nil))
         (mx-from (car (lyskom-get-aux-item (text-stat->aux-items text-stat)
                                            17)))
         (mx-author (car (lyskom-get-aux-item (text-stat->aux-items text-stat)
                                              16)))
         (formats (lyskom-aux-item-definition-field item 'text-header-line))
David Byers's avatar
David Byers committed
275
         (subject (lyskom-print-faq-format-subject text text-stat text-no))
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
         content-type
         )
    (if (and mx-from
             (setq content-type
                   (car (lyskom-get-aux-item (text-stat->aux-items 
                                              text-stat) 1))))
        (progn (string-match "^\\(\\S-+\\)" (aux-item->data content-type))
               (setq content-type (format "(%s) "
                                          (aux-item->data content-type))))
      (setq content-type ""))
    (setq author (or (lyskom-format-mx-author mx-from mx-author) author))

    (lyskom-format-insert (cond ((not (listp formats)) formats)
                                ((<= (length formats) 1) (car formats))
                                (author (elt formats 1))
                                (t (elt formats 0)))
                          text-no
                          author
                          content-type
                          (lyskom-aux-item-terminating-button item
David Byers's avatar
David Byers committed
296
297
                                                              object)
                          subject)
298
299
300
301
302
303
    (lyskom-insert "\n")))

;;; FIXME: This contains code that duplicates the code in 
;;; lyskom-insert-deferred-header-comm. That's a BAD THING.

(defun lyskom-insert-deferred-comment-like-aux (text-stat defer-info)
David Byers's avatar
David Byers committed
304
305
306
307
308
309
310
  (initiate-get-text 'deferred
                     'lyskom-insert-deferred-comment-like-aux-2
                     (elt (defer-info->data defer-info) 2)
                     text-stat
                     defer-info))

(defun lyskom-insert-deferred-comment-like-aux-2 (text text-stat defer-info)
311
312
313
314
315
316
317
318
319
  (let* ((author (if text-stat (text-stat->author text-stat) nil))
         (item (elt (defer-info->data defer-info) 0))
         (object (elt (defer-info->data defer-info) 1))
         (text-no (elt (defer-info->data defer-info) 2))
         (mx-from (car (lyskom-get-aux-item (text-stat->aux-items text-stat)
                                            17)))
         (mx-author (car (lyskom-get-aux-item (text-stat->aux-items text-stat)
                                              16)))
         (formats (lyskom-aux-item-definition-field item 'text-header-line))
David Byers's avatar
David Byers committed
320
         (subject (lyskom-print-faq-format-subject text text-stat text-no))
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
         content-type
         )
    (if (and mx-from
             (setq content-type
                   (car (lyskom-get-aux-item (text-stat->aux-items 
                                              text-stat) 1))))
        (progn (string-match "^\\(\\S-+\\)" (aux-item->data content-type))
               (setq content-type (format "(%s) "
                                          (aux-item->data content-type))))
      (setq content-type ""))
    (setq author (or (lyskom-format-mx-author mx-from mx-author) author))

    (set-defer-info->format defer-info 
                            (cond ((not (listp formats)) formats)
                                  ((<= (length formats) 1) (car formats))
                                  (author (elt formats 1))
                                  (t (elt formats 0))))
    (lyskom-replace-deferred defer-info
                             text-no
                             author
                             content-type
                             (lyskom-aux-item-terminating-button item
David Byers's avatar
David Byers committed
343
344
                                                                 object)
                             subject)))
345
346
347



348

Per Cederqvist's avatar
.  
Per Cederqvist committed
349
350
351


;;; ================================================================
352
;;;          Återse det kommenterade - View commented text
Per Cederqvist's avatar
.  
Per Cederqvist committed
353
354

;;; Author: Inge Wallin
355
;;; Modified by: David Kågedal, Johan Sundström
Per Cederqvist's avatar
.  
Per Cederqvist committed
356

357
(def-kom-command kom-view-commented-text (text-no)
358
359
360
361
362
363
364
365
  "Views the text that the selected text is a comment to. If the
current text is comment or footnote to several texts then the first
text is shown and the remaining texts are reviewed.

This command accepts text number prefix arguments (see
`lyskom-read-text-no-prefix-arg').

See `kom-review-uses-cache'."
366
  (interactive (list (lyskom-read-text-no-prefix-arg 'review-commented-q)))
367
368
369
  (if text-no
      (progn
	(lyskom-tell-internat 'kom-tell-read)
370
371
        (unless kom-review-uses-cache
          (cache-del-text-stat text-no))
372
373
	(lyskom-view-commented-text
	 (blocking-do 'get-text-stat text-no)))
374
    (lyskom-insert-string 'confusion-what-to-view)))
Per Cederqvist's avatar
.  
Per Cederqvist committed
375

David Byers's avatar
David Byers committed
376
377
378
379
380
381
382
383
384
385
386
(def-kom-command kom-unread-commented-text (text-no)
  "MArkes the texts that the selected text is a comment to as unread.

This command accepts text number prefix arguments (see
`lyskom-read-text-no-prefix-arg')."
  (interactive (list (lyskom-read-text-no-prefix-arg 'unread-commented-q)))
  (if text-no
      (lyskom-unread-commented-text 
       (blocking-do 'get-text-stat text-no))
    (lyskom-insert-string 'confusion-what-to-mark-unread)))

Per Cederqvist's avatar
.  
Per Cederqvist committed
387

388
(def-kom-command kom-view-previous-commented-text (text-no)
389
390
391
392
393
394
395
396
397
398
399
400
  "Views the text that the selected text is a comment to. If the
current text is comment or footnote to several texts then the first
text is shown and the remaining texts are reviewed.

Without a prefix argument this will display the text that the
next-to-last text in the buffer is a comment to. With a prefix
argument this command is identical to `kom-view-commented-text'.

This command accepts text number prefix arguments (see
`lyskom-read-text-no-prefix-arg')

See `kom-review-uses-cache'."
401
402
403
404
  (interactive (list (lyskom-read-text-no-prefix-arg 'review-commented-q nil
                                                     lyskom-previous-text)))
  (cond (text-no
         (lyskom-tell-internat 'kom-tell-read)
405
406
        (unless kom-review-uses-cache
          (cache-del-text-stat text-no))
407
         (lyskom-view-commented-text
David Byers's avatar
David Byers committed
408
          (blocking-do 'get-text-stat text-no)))
409
        (t (lyskom-insert-string 'confusion-what-to-view))))
410

411

David Byers's avatar
David Byers committed
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
(def-kom-command kom-unread-previous-commented-text (text-no)
  "Marks the texts that the selected text is a comment to as unread.

Without a prefix argument this will display the text that the
next-to-last text in the buffer is a comment to. With a prefix
argument this command is identical to `kom-unread-commented-text'.

This command accepts text number prefix arguments (see
`lyskom-read-text-no-prefix-arg')"
  (interactive (list (lyskom-read-text-no-prefix-arg 'review-commented-q nil
                                                     lyskom-previous-text)))
  (if text-no
      (lyskom-unread-commented-text
       (blocking-do 'get-text-stat text-no))
    (lyskom-insert-string 'confusion-what-to-mark-unread)))


429
430
(defun lyskom-text-stat-commented-texts (text-stat)
  "Return a list of the text-nos that TEXT-STAT is a comment or footnote to."
431
  (let* ((misc-info-list (and text-stat
432
433
434
435
436
                              (text-stat->misc-info-list text-stat)))
         (misc-infos (and misc-info-list
                          (append (lyskom-misc-infos-from-list
                                   'COMM-TO misc-info-list)
                                  (lyskom-misc-infos-from-list
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
                                   'FOOTN-TO misc-info-list)))))
    (and misc-infos
	 (mapcar
	  (function
	   (lambda (misc-info)
	     (if (equal (misc-info->type misc-info)
			'COMM-TO)
		 (misc-info->comm-to misc-info)
	       (misc-info->footn-to misc-info))))
	  misc-infos))))


(defun lyskom-view-commented-text (text-stat)
  "Handles the return from the initiate-get-text-stat, displays and builds list."
  (let ((text-nos (lyskom-text-stat-commented-texts text-stat)))
452
    (if text-nos
453
454
455
456
457
458
        (progn
          (lyskom-format-insert 'review-text-no 
                                (car text-nos))
          (if (cdr text-nos)
              (read-list-enter-read-info
               (lyskom-create-read-info
David Byers's avatar
David Byers committed
459
                'REVIEW nil (lyskom-review-get-priority)
460
461
462
                (lyskom-create-text-list (cdr text-nos))
                lyskom-current-text)
               lyskom-reading-list t))
463
464
          (unless kom-review-uses-cache
            (cache-del-text-stat (car text-nos)))
465
466
467
468
          (lyskom-view-text (car text-nos)
			    nil nil nil 
			    nil nil nil
			    t))
469
      (lyskom-insert-string 'no-comment-to))))
Per Cederqvist's avatar
.  
Per Cederqvist committed
470

David Byers's avatar
David Byers committed
471
472
473
474
475
476
477
478
479
(defun lyskom-unread-commented-text (text-stat)
  "Marks the texts that TEXT-STAT is a comment to as unread."
  (let ((text-nos (lyskom-text-stat-commented-texts text-stat)))
    (if text-nos
        (lyskom-traverse text-no text-nos
          (lyskom-format-insert 'marking-text-unread text-no)
          (lyskom-report-command-answer (lyskom-mark-unread text-no)))
      (lyskom-insert-string 'no-comment-to-to-unread))))

Per Cederqvist's avatar
.  
Per Cederqvist committed
480
481
482
483

(defun lyskom-misc-infos-from-list (type list)
  "Get all the misc-infos from the misc-info-list LIST with the same type
as TYPE. If no such misc-info, return NIL"
David Byers's avatar
David Byers committed
484
485
486
487
488
  (let ((result nil))
    (while list
      (when (equal type (misc-info->type (car list)))
        (setq result (cons (car list) result)))
      (setq list (cdr list)))
David Kågedal's avatar
David Kågedal committed
489
    (nreverse result)))
Per Cederqvist's avatar
.  
Per Cederqvist committed
490
491
492
493
494
495


;;; ================================================================
;;;                         Brev - Send letter
;;; Author: Inge Wallin

496
(def-kom-command kom-send-letter (&optional pers-no)
497
498
  "Send a personal letter to a person. This command is similar to
`kom-write-text', but intended specifically for sending personal
499
500
501
502
503
504
messages.

Several settings affect writing texts in general.
`kom-write-texts-in-window' controls which window is used to write the
comment; `kom-confirm-multiple-recipients' affects how multiple
recipients are handled."
Per Cederqvist's avatar
.  
Per Cederqvist committed
505
  (interactive)
506
507
  (lyskom-tell-internat 'kom-tell-write-letter)
  (lyskom-write-text pers-no 'who-letter-to nil))
Per Cederqvist's avatar
.  
Per Cederqvist committed
508
509
510
511
512
513
514


;;; ================================================================
;;;           Bli medlem i m|te - Become a member of a conference
;;;             Addera medlem - Add somebody else as a member

;;; Author: ???
515
;;; Rewritten by: David K}gedal
Per Cederqvist's avatar
.  
Per Cederqvist committed
516
517
518
519


;; Add another person

David Kågedal's avatar
David Kågedal committed
520
(def-kom-command kom-add-member ()
521
522
523
524
  "Invite a person as a member of a conference. Depending on the
server configuration this command may either create an invitation or
simply make the person a member of the conference without asking them
for confirmation."
Per Cederqvist's avatar
.  
Per Cederqvist committed
525
  (interactive)
David Kågedal's avatar
David Kågedal committed
526
  (let* ((who (lyskom-read-conf-stat (lyskom-get-string 'who-to-add)
527
				     '(pers) nil nil t))
David Kågedal's avatar
David Kågedal committed
528
	 (whereto (lyskom-read-conf-stat (lyskom-get-string 'where-to-add)
529
					 '(all) nil nil t))
David Kågedal's avatar
David Kågedal committed
530
	 (pers-stat (blocking-do 'get-pers-stat (conf-stat->conf-no who))))
David Byers's avatar
David Byers committed
531
    (lyskom-add-member-answer (lyskom-try-add-member whereto who 
532
533
534
535
                                                     pers-stat 
                                                     nil
                                                     nil
                                                     t)
David Kågedal's avatar
David Kågedal committed
536
			      whereto who)))
Per Cederqvist's avatar
.  
Per Cederqvist committed
537
538
539
540
541



;; Add self

542
(def-kom-command kom-add-self (&optional conf)
543
544
545
546
547
548
549
550
  "Become a member of a conference. The default priority of the
membership is determined by `kom-membership-default-priority' and its
placement by `kom-membership-default-placement' You can also use this
command to change the priority of an existing membership and to
re-join a conference of which you are a passive member.

See `kom-membership-default-priority' and 
`kom-membership-default-placement'"
Per Cederqvist's avatar
.  
Per Cederqvist committed
551
  (interactive)
David Byers's avatar
David Byers committed
552
553
554
  (let* ((whereto (if conf (blocking-do 'get-conf-stat conf)
                    (lyskom-read-conf-stat 
                     (lyskom-get-string 'where-to-add-self)
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
                     '(all) nil "" t)))
         (mship (lyskom-is-member (conf-stat->conf-no whereto)
                                  lyskom-pers-no)))

    (cond ((and mship (membership-type->passive
                       (membership->type mship)))
              (set-membership-type->passive (membership->type mship) nil)
              (blocking-do 'set-membership-type
                           lyskom-pers-no
                           (conf-stat->conf-no whereto)
                           (membership->type mship))
              (lyskom-format-insert 'activate-mship-done whereto)
              (lyskom-fetch-start-of-map whereto mship))

          ((and mship (not (membership-type->invitation
                            (membership->type mship))))
           (lyskom-format-insert 'you-already-member whereto))

          (t 
           (let* ((who (blocking-do 'get-conf-stat lyskom-pers-no))
                  (pers-stat (blocking-do 'get-pers-stat lyskom-pers-no))
                  (mship (lyskom-get-membership (conf-stat->conf-no whereto) t))
                  (no-of-unread
                   (unless (and mship (not (membership-type->passive
                                            (membership->type mship))))
                     (lyskom-read-num-range-or-date 
                      0 
                      (conf-stat->no-of-texts whereto)
                      (lyskom-format 'initial-unread)
                      nil
                      t
                      nil)))
                  (kom-membership-default-priority
                   (if (and mship (membership-type->passive (membership->type mship)))
                       (membership->priority mship)
                     kom-membership-default-priority)))

             (lyskom-add-member-answer (lyskom-try-add-member whereto
                                                              who
                                                              pers-stat
                                                              nil
                                                              nil
                                                              t
                                                              nil
                                                              no-of-unread)
                                       whereto who
                                       no-of-unread))))))
David Byers's avatar
David Byers committed
602
603
604


(def-kom-command kom-change-priority (&optional conf)
605
606
  "Changes the priority of a single membership. If you want to change
the priority of several memberships, use `kom-prioritize' instead."
David Byers's avatar
David Byers committed
607
608
609
610
611
  (interactive)
  (let* ((conf-stat (if conf (blocking-do 'get-conf-stat conf)
                      (lyskom-read-conf-stat 
                       (lyskom-get-string 'change-priority-for-q)
                       '(all) nil "" t)))
612
613
         (mship (lyskom-get-membership (conf-stat->conf-no conf-stat) t))
	 (kom-membership-default-priority nil))
David Byers's avatar
David Byers committed
614
615
    (blocking-do-multiple ((who (get-conf-stat lyskom-pers-no))
                           (pers-stat (get-pers-stat lyskom-pers-no)))
616
617
618
619
      (cond ((and (null mship) conf-stat)
             (lyskom-format-insert 'not-member-of-conf conf-stat))
	    ((null conf-stat)
	     (lyskom-format-insert 'no-such-conf))
David Byers's avatar
David Byers committed
620
621
            (t (lyskom-add-member-answer
                (lyskom-try-add-member conf-stat who pers-stat nil
David Byers's avatar
David Byers committed
622
                                       'change-priority-for t)
David Byers's avatar
David Byers committed
623
                conf-stat who))))))
Per Cederqvist's avatar
.  
Per Cederqvist committed
624
625
626
627
628


;;; NOTE: This function is also called from lyskom-go-to-conf-handler
;;;       and from lyskom-create-conf-handler.

629
(defun lyskom-add-member-by-no (conf-no pers-no &optional no-of-unread thendo &rest data)
Per Cederqvist's avatar
.  
Per Cederqvist committed
630
631
  "Fetch info to be able to add a person to a conf.
Get the conf-stat CONF-NO for the conference and the conf-stat and pers-stat 
632
for person PERS-NO and send them into lyskom-try-add-member."
David Byers's avatar
David Byers committed
633
634
635
  (blocking-do-multiple ((whereto (get-conf-stat conf-no))
                         (who (get-conf-stat pers-no))
                         (pers-stat (get-pers-stat pers-no)))
636
637
638
    (let ((result (lyskom-try-add-member whereto who pers-stat 
                                         nil nil t nil no-of-unread)))
      (lyskom-add-member-answer result whereto who no-of-unread)
David Byers's avatar
David Byers committed
639
640
      (if thendo
          (apply thendo data))
David Byers's avatar
David Byers committed
641
      (car result))))
Per Cederqvist's avatar
.  
Per Cederqvist committed
642
643


David Byers's avatar
David Byers committed
644
645
646
647
(defun lyskom-try-add-member (conf-conf-stat 
                              pers-conf-stat 
                              pers-stat
                              membership-type
David Byers's avatar
David Byers committed
648
                              &optional message-string
649
                              need-extra-information
650
651
                              default-priority
                              no-of-unread)
Per Cederqvist's avatar
.  
Per Cederqvist committed
652
  "Add a member to a conference.
653
Args: CONF-CONF-STAT PERS-CONF-STAT PERS-STAT
Per Cederqvist's avatar
.  
Per Cederqvist committed
654
655
656
CONF-CONF-STAT: the conf-stat of the conference the person is being added to
PERS-CONF-STAT: the conf-stat of the person being added.
PERS-STAT: the pers-stat of the person being added.
657

David Byers's avatar
David Byers committed
658
Optional MESSAGE-STRING is the message to print before making server call.
David Byers's avatar
David Byers committed
659
660
661
662
Returns t if it was possible, otherwise nil.

If optional NEED-EXTRA-INFORMATION is non-nil, the return value will be
a list where the first element is the result of add-member and the second
663
664
665
666
is the position where the membership was placed.

If optional USE-PRIORITY is non-nil then use that as the priority.
"
667
668
669
670
671
672
673
674
675
676
677
678
679
  (cond ((null no-of-unread))

        ((numberp no-of-unread)
         (setq no-of-unread (lyskom-format 'member-in-conf-with-unread
                                           no-of-unread)))
        ((listp no-of-unread)
                 (setq no-of-unread
                       (lyskom-format 'member-in-conf-with-unread-date
                                      (elt no-of-unread 0)
                                      (car (rassq (elt no-of-unread 1)
                                                  lyskom-month-names))
                                      (elt no-of-unread 2)))))

Per Cederqvist's avatar
.  
Per Cederqvist committed
680
681
  (if (or (null conf-conf-stat)
	  (null pers-conf-stat))
682
      nil				; We have some problem here.
Per Cederqvist's avatar
.  
Per Cederqvist committed
683
    (let ((priority
684
685
           (if (/= lyskom-pers-no (conf-stat->conf-no pers-conf-stat))
               (lyskom-read-num-range 0 255
686
                                      (lyskom-get-string 'other-priority-q)
David Byers's avatar
David Byers committed
687
                                      nil 100)
688
689
690
691
692
             (if (and (numberp kom-membership-default-priority)
                      (< kom-membership-default-priority 256)
                      (>= kom-membership-default-priority 0))
                 kom-membership-default-priority
               (lyskom-read-num-range 0 255 (lyskom-get-string 'priority-q) nil default-priority))))
Per Cederqvist's avatar
.  
Per Cederqvist committed
693
694
695
696
	  (where
	   (if (/= lyskom-pers-no (conf-stat->conf-no pers-conf-stat))
	       1			; When adding someone else
	     (cond
697
698
699
700
	      ((and (numberp kom-membership-default-placement)
		    (>= kom-membership-default-placement 0))
	       kom-membership-default-placement)
	      ((eq kom-membership-default-placement 'first)
Per Cederqvist's avatar
.  
Per Cederqvist committed
701
	       0)
702
	      ((eq kom-membership-default-placement 'last)
Per Cederqvist's avatar
.  
Per Cederqvist committed
703
704
705
706
707
708
709
	       (length lyskom-membership))
	      (t
	       (lyskom-read-num-range
		0 (pers-stat->no-of-confs pers-stat)
		(lyskom-format 'where-on-list-q
			       (length lyskom-membership))))))))

David Byers's avatar
David Byers committed
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
      ;;
      ;; Adding ourselves. Adjust where so the membership
      ;; list remains sorted. Find the closest position to
      ;; where at which we can put the membership and keep
      ;; the membership lsit sorted.
      ;;

      (when (eq lyskom-pers-no (conf-stat->conf-no pers-conf-stat))
        (let ((mship-list lyskom-membership)
              (mship nil)
              (index 0)
              (found nil))
          (while mship-list
            (setq mship (car mship-list)
                  mship-list (cdr mship-list))
            (cond ((> (membership->priority mship) priority))
                  ((< (membership->priority mship) priority) 
                   (setq where index mship-list nil found t))
                  ((and (= (membership->priority mship) priority)
                        (= index where))
                   (setq mship-list nil found t))
                  ((and (= (membership->priority mship) priority)
                        (> index where))
                   (setq where index mship-list nil found t)))
            (setq index (1+ index))
            (unless found (setq where (1+ index))))))

737
738
739
740
741
      (when (null membership-type)
        (setq membership-type 
              (lyskom-create-membership-type nil nil nil nil
                                             nil nil nil nil)))

David Byers's avatar
David Byers committed
742
743
744
745
746
747
748
      (if message-string
          (lyskom-format-insert message-string
                                pers-conf-stat
                                conf-conf-stat)
        (if (= (conf-stat->conf-no pers-conf-stat)
               lyskom-pers-no)
            (lyskom-format-insert 'member-in-conf
749
750
                                  conf-conf-stat
                                  no-of-unread)
David Byers's avatar
David Byers committed
751
752
753
          (lyskom-format-insert 'add-member-in
                                pers-conf-stat
                                conf-conf-stat)))
David Byers's avatar
David Byers committed
754
755
      (lyskom-ignoring-async (18 lyskom-pers-no
                                 (conf-stat->conf-no conf-conf-stat))
David Byers's avatar
David Byers committed
756
757
758
759
760
761
762
763
764
765
        (let ((res (blocking-do 'add-member 
                                (conf-stat->conf-no conf-conf-stat)
                                (conf-stat->conf-no pers-conf-stat)
                                priority where
                                membership-type)))
          (if need-extra-information
              (list res where)
            res))))))


766
767
768
769
(defun lyskom-add-member-answer (answer 
                                 conf-conf-stat
                                 pers-conf-stat
                                 &optional no-of-unread)
Per Cederqvist's avatar
.  
Per Cederqvist committed
770
  "Handle the result from an attempt to add a member to a conference."
David Byers's avatar
David Byers committed
771
772
773
774
775
776
  (let ((pos (if (consp answer) (elt answer 1) nil))
        (answer (if (consp answer) (elt answer 0) answer)))
    (if (null answer)
        (progn
          (lyskom-insert-string 'nope)
          (let* ((errno lyskom-errno)
Per Cederqvist's avatar
Per Cederqvist committed
777
                 (err-stat lyskom-err-stat)
David Byers's avatar
David Byers committed
778
779
780
781
782
783
784
785
786
787
788
789
                 (is-supervisor (lyskom-is-supervisor (conf-stat->conf-no conf-conf-stat)
                                                      lyskom-pers-no))
                 (is-member (lyskom-is-member (conf-stat->conf-no conf-conf-stat)
                                              (conf-stat->conf-no pers-conf-stat)))
                 (rd-prot (conf-type->rd_prot (conf-stat->conf-type conf-conf-stat))))


            (cond (is-member
                   (lyskom-format-insert 'add-already-member 
                                         pers-conf-stat
                                         conf-conf-stat))
                  ((and rd-prot is-supervisor)
Per Cederqvist's avatar
Per Cederqvist committed
790
                   (lyskom-insert-error errno err-stat))
David Byers's avatar
David Byers committed
791
792
793
794
795
796
797
798
799
800
801

                  (rd-prot (let ((supervisorconf (blocking-do
                                                  'get-conf-stat
                                                  (conf-stat->supervisor conf-conf-stat))))
                             (if supervisorconf
                                 (lyskom-format-insert 'is-read-protected-contact-supervisor
                                                       conf-conf-stat
                                                       supervisorconf)
                               (lyskom-format-insert 'cant-find-supervisor
                                                     conf-conf-stat))))

Per Cederqvist's avatar
Per Cederqvist committed
802
                  (t (lyskom-insert-error errno err-stat)))))
David Byers's avatar
David Byers committed
803
804
805
806
807

      ;;+++Borde {ndra i cachen i st{llet.
      (cache-del-pers-stat (conf-stat->conf-no pers-conf-stat))
      ;;+++Borde {ndra i cachen i st{llet.
      (cache-del-conf-stat (conf-stat->conf-no conf-conf-stat))
808
      (when (= (conf-stat->conf-no pers-conf-stat)
David Byers's avatar
David Byers committed
809
             lyskom-pers-no)
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
        (when no-of-unread
          (cond ((listp no-of-unread)
                 (let* ((target-date (lyskom-create-time 0 0 0 (elt no-of-unread 2) (elt no-of-unread 1) (elt no-of-unread 0) 0 0 nil))
                        (text (lyskom-find-text-by-date conf-conf-stat target-date)))
                   (when text
                     (blocking-do 'set-last-read 
                                  (conf-stat->conf-no conf-conf-stat)
                                  (car text)))))
                ((numberp no-of-unread) 
                 (blocking-do 'set-unread (conf-stat->conf-no conf-conf-stat)
                              no-of-unread))))
        (let ((mship (blocking-do 'query-read-texts
                                  lyskom-pers-no 
                                  (conf-stat->conf-no conf-conf-stat)
                                  t 0)))
825
826
827
828
829
830
831
832
833
834
835
836
          (if (< (membership->priority mship) lyskom-session-priority)
              (lyskom-format-insert-before-prompt
               'member-in-conf-with-low-priority
               conf-conf-stat)
            (unless (membership->position mship)
              (set-membership->position mship pos))
            (if (lyskom-try-get-membership (conf-stat->conf-no conf-conf-stat) t)
                (progn (lyskom-replace-membership mship)
                       (lyskom-fetch-start-of-map conf-conf-stat mship))
              (lyskom-add-membership mship
                                     conf-conf-stat
                                     t)))))
837
      (lyskom-insert-string 'done))))
Per Cederqvist's avatar
.  
Per Cederqvist committed
838
839


Linus Tolke's avatar
Linus Tolke committed
840

841
(defun lyskom-add-membership (membership conf-no-or-stat &optional blocking)
Per Cederqvist's avatar
.  
Per Cederqvist committed
842
  "Adds MEMBERSHIP to the sorted list of memberships.
843
844
845
If BLOCKING is non-nil, block while reading the conference map until at 
least one text has been seen. CONF-NO-OR-STAT is the conf-no to add 
unless BLOCKING is t, in which cast it is the conf-stat."
Per Cederqvist's avatar
.  
Per Cederqvist committed
846
847
  (if membership
      (progn
David Byers's avatar
David Byers committed
848
	(lyskom-insert-membership membership)
849
850
851
        (if blocking
            (lyskom-fetch-start-of-map conf-no-or-stat membership)
          (lyskom-prefetch-map conf-no-or-stat membership))
David Byers's avatar
X    
David Byers committed
852
853
        (lyskom-run-hook-with-args 'lyskom-add-membership-hook
                                   membership))
854
    (lyskom-insert-string 'conf-does-not-exist)))
Per Cederqvist's avatar
.  
Per Cederqvist committed
855
856
857
858
859
860
861



;;; ================================================================
;;;     Uttr{d - Subtract yourself as a member from a conference
;;;     Uteslut medlem - Subtract somebody else as a member

862
863
;;; Author: David Byers
;;; Based on code by Inge Wallin
Per Cederqvist's avatar
.  
Per Cederqvist committed
864
865
866
867


;; Subtract another person

David Kågedal's avatar
David Kågedal committed
868
(def-kom-command kom-sub-member ()
869
870
  "Remove a member from a conference. To do this you need to be the
supervisor of the conference or of the member being removed."
Per Cederqvist's avatar
.  
Per Cederqvist committed
871
  (interactive)
David Kågedal's avatar
David Kågedal committed
872
  (lyskom-sub-member
873
   (lyskom-read-conf-stat (lyskom-get-string 'who-to-exclude)
874
                          '(pers) nil "" t)
David Kågedal's avatar
David Kågedal committed
875
   (lyskom-read-conf-stat (lyskom-get-string 'where-from-exclude) 
876
			  '(all) nil "" t)))
Per Cederqvist's avatar
.  
Per Cederqvist committed
877
878


879
(def-kom-command kom-sub-self (&optional conf)
880
  "Resign your membership of a conference. If
881
`kom-unsubscribe-makes-passive' is set, them resigning once converts
882
883
884
885
your membership to a passive membership and resigning twice removes
the membership completely (if the server supports passive
memberships).

886
See `kom-unsubscribe-makes-passive'."
Per Cederqvist's avatar
.  
Per Cederqvist committed
887
  (interactive)
David Kågedal's avatar
David Kågedal committed
888
889
  (lyskom-sub-member 
   (blocking-do 'get-conf-stat lyskom-pers-no)
890
891
   (if conf (blocking-do 'get-conf-stat conf)
     (lyskom-read-conf-stat (lyskom-get-string 'leave-what-conf)
David Byers's avatar
David Byers committed
892
                            '(membership) nil 
893
                            (let ((ccn 
David Byers's avatar
David Byers committed
894
895
                                   (if (or (null lyskom-current-conf)
                                           (zerop lyskom-current-conf))
896
897
898
899
900
901
                                       ""
                                     (conf-stat->name
                                      (blocking-do 'get-conf-stat
                                                   lyskom-current-conf)))))
                              (if ccn
                                  (cons ccn 0)
902
                                "")) t))))
903

904
(defun lyskom-sub-member (pers conf &optional have-message)
905
  "Remove the person indicated by PERS as a member of CONF."
906
907
908
909
910
911
  (let* ((reply nil)
         (self (= (conf-stat->conf-no pers) lyskom-pers-no))
         (mship (and self 
                     kom-unsubscribe-makes-passive
                     (lyskom-get-membership (conf-stat->conf-no conf))))
         (passivate (and mship
David Byers's avatar
David Byers committed
912
                         (lyskom-have-call 102) ; set-membership-type
913
914
915
                         (not (membership-type->passive
                               (membership->type mship))))))

916
917
    (cond ((null pers) (lyskom-insert-string 'error-fetching-person))
	  ((null conf) (lyskom-insert-string 'error-fetching-conf))
918
          (passivate 
919
           (lyskom-prefetch-cancel-prefetch-map (conf-stat->conf-no conf))
920
921
           (unless have-message
             (lyskom-format-insert 'unsubscribe-to conf))
922
923
924
925
926
927
928
929
930
931
932
           (set-membership-type->passive (membership->type mship) t)
           (setq reply (blocking-do 'set-membership-type
                                    (conf-stat->conf-no pers)
                                    (conf-stat->conf-no conf)
                                    (membership->type mship)))
           (if (not reply)
               (lyskom-format-insert 'unsubscribe-failed
                                     (lyskom-get-string 'You)
                                     conf)
             (lyskom-insert-string 'done)
             (lyskom-format-insert 'passivate-done conf)
David Byers's avatar
David Byers committed
933
934
             (when (= (conf-stat->conf-no conf) lyskom-current-conf)
               (lyskom-leave-current-conf))
935
936
	     (read-list-delete-read-info (conf-stat->conf-no conf)
					 lyskom-to-do-list)))
937
	  (t
938
939
940
           (when self
             (lyskom-prefetch-cancel-prefetch-map (conf-stat->conf-no conf)))

941
942
943
944
	   (if self
	       (lyskom-format-insert 'unsubscribe-to conf)
	     (lyskom-format-insert 'exclude-from pers conf))

David Byers's avatar
David Byers committed
945
946
947
948
           (lyskom-ignoring-async (8 (conf-stat->conf-no conf))
             (setq reply (blocking-do 'sub-member
                                      (conf-stat->conf-no conf)
                                      (conf-stat->conf-no pers))))
949
	   (if self
David Byers's avatar
David Byers committed
950
	       (lyskom-remove-membership (conf-stat->conf-no conf)))
951
952
953
954
	   (if (not reply)
	       (lyskom-format-insert 'unsubscribe-failed
				     (if self
					 (lyskom-get-string 'You)
955
				       (conf-stat->name pers))
956
				     conf)
957
	     (lyskom-insert-string 'done)
David Byers's avatar
David Byers committed
958
959
960
	     (when (and self (= (conf-stat->conf-no conf)
                              lyskom-current-conf))
               (lyskom-leave-current-conf))
961
	     (read-list-delete-read-info (conf-stat->conf-no conf)
962
					 lyskom-to-do-list))))))
963
	   
Per Cederqvist's avatar
.  
Per Cederqvist committed
964

965
	 
966

Per Cederqvist's avatar
.  
Per Cederqvist committed
967
968
969
970
971
972
;;; ================================================================
;;;                 Skapa m|te - Create a conference

;;; Author: ???


David Kågedal's avatar
David Kågedal committed
973
(def-kom-command kom-create-conf (&optional name)
974
975
976
977
978
979
980
  "Create a new conference. Use this command when you want to create a
new conference. It will ask for all required information.

Before creating a conference, check that there isn't already one
covering the intended topics. There may be a conference for discussing
converence creation where you can ask. If there isn't, there is
probably a general Q&A conference where you can ask."
David Kågedal's avatar
David Kågedal committed
981
  (interactive)
David Kågedal's avatar
David Kågedal committed
982
983
984
  (let* ((conf-name (or name
			(lyskom-read-string
			 (lyskom-get-string 'name-of-conf))))
985
	 (open (j-or-n-p (lyskom-get-string 'anyone-member)))
Per Cederqvist's avatar
.  
Per Cederqvist committed
986
	 (secret (if (not open)
987
988
989
		     (j-or-n-p (lyskom-get-string 'secret-conf))))
	 (orig (j-or-n-p (lyskom-get-string 'comments-allowed)))
         (anarchy (j-or-n-p (lyskom-get-string 'anonymous-allowed)))
David Byers's avatar
David Byers committed
990
         (secmem (and (lyskom-have-feature long-conf-types)
991
                      (not (lyskom-j-or-n-p (lyskom-get-string 'secret-members-allowed)))))
992
993
	 (life-expectancy (lyskom-read-number 'new-garb-nice-q))
	 (conf-no (blocking-do 'create-conf
David Kågedal's avatar
David Kågedal committed
994
			       conf-name
995
			       (lyskom-create-conf-type (not open)
David Kågedal's avatar
David Kågedal committed
996
997
							(not orig)
							secret
998
999
							nil
                                                        anarchy
David Byers's avatar
David Byers committed
1000
                                                        secmem
For faster browsing, not all history is shown. View entire blame