vars.el.in 90.4 KB
Newer Older
David Byers's avatar
David Byers committed
1
;;;;; -*-coding: raw-text;mode: emacs-lisp;-*-
Linus Tolke's avatar
Linus Tolke committed
2
;;;;; $Id$
3
;;;;; Copyright (C) 1991, 1996  Lysator Academic Computer Association.
Linus Tolke's avatar
Linus Tolke committed
4
5
6
7
8
;;;;;
;;;;; This file is part of the LysKOM server.
;;;;; 
;;;;; LysKOM is free software; you can redistribute it and/or modify it
;;;;; under the terms of the GNU General Public License as published by 
9
;;;;; the Free Software Foundation; either version 2, or (at your option) 
Linus Tolke's avatar
Linus Tolke committed
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
;;;;; 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
25
26
27
28
29
30
31
32
33
;;;; ================================================================
;;;; ================================================================
;;;;
;;;; File: vars.el
;;;;
;;;; This file contains almost all the variables used in lyskom.
;;;;


David Byers's avatar
X    
David Byers committed
34
35
36
(setq lyskom-clientversion-long 
      (concat lyskom-clientversion-long
	      "$Id$\n"))
37

David Byers's avatar
David Byers committed
38
(defvar lyskom-mule-compiled
39
40
  (eval-when-compile (and (fboundp 'multibyte-string-p)
                          (multibyte-string-p "ÅÄÖ")))
David Byers's avatar
David Byers committed
41
42
  "Non-nil if the client was compiled with multibyte characters enabled")

David Byers's avatar
X    
David Byers committed
43
(provide 'lyskom)
44

David Byers's avatar
X    
David Byers committed
45
(require 'lyskom-defvar "defvar")
Per Cederqvist's avatar
.    
Per Cederqvist committed
46

David Byers's avatar
David Byers committed
47
48
49
50
51
52
53
54
55
56
57
(defconst lyskom-global-boolean-variables '(
  kom-created-texts-are-read
  kom-dashed-lines
  kom-presence-messages
  kom-print-number-of-unread-on-entrance
  kom-read-depth-first
  kom-reading-puts-comments-in-pointers-last
  kom-confirm-multiple-recipients
)
  "List of flags that are to be saved as booleans in the common block.

58
Don't change these. They are defined by the protocol.")
David Byers's avatar
David Byers committed
59
60
61
62
63
64
65
				  
(defconst lyskom-global-non-boolean-variables '(
  kom-default-mark
)
  "List of flags that are to be saved in the common block.
These are the non-boolean ones. See: lyskom-global-boolean-variables.

66
Don't change these. They are defined by the protocol.")
David Byers's avatar
David Byers committed
67
68


David Byers's avatar
X    
David Byers committed
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

(defun lyskom-protect-variable (sym) 
  (put sym 'permanent-local t)
  (lyskom-local-variable sym)
  (add-to-list 'lyskom-protected-variables sym))

(defun lyskom-local-variable (sym)
  (add-to-list 'lyskom-local-variables sym))

(defun lyskom-inherited-variable (sym)
  (add-to-list 'lyskom-inherited-variable sym)
  (lyskom-protect-variable sym))

(defun lyskom-setup-local-variables ()
  (mapcar 'make-local-variable lyskom-local-variables)
  (mapcar 'make-local-hook lyskom-local-hooks))
Per Cederqvist's avatar
.    
Per Cederqvist committed
85

David Byers's avatar
David Byers committed
86
87
88
89
(defvar lyskom-is-loaded nil
  "Non-nil when lyskom has been loaded.")


David Byers's avatar
David Byers committed
90
91
(def-kom-var kom-dont-read-saved-variables '(kom-dont-read-saved-variables
                                             lyskom-login-hook)
92
  "*Non-nil means don't read some variables from the server.
David Byers's avatar
David Byers committed
93
94
95
t means don't read any variables. A list means don't read variables that
are in the list.")

Per Cederqvist's avatar
.    
Per Cederqvist committed
96
97
98
99
100
101
102
103


;;;; ================================================================
;;;;                     Variables and constants.


;;; User flags

David Byers's avatar
X    
David Byers committed
104
(def-kom-var kom-allow-incompleteness nil
105
106
  "*If nil, commands like kom-list-news will wait for the prefetch.
If this flag is set to t, some commands may give incomplete answers,
107
but it might make them faster, especially during the login phase."
David Byers's avatar
X    
David Byers committed
108
109
  server
)
110

David Byers's avatar
X    
David Byers committed
111
(def-kom-var kom-bury-buffers t
112
113
114
  "*Controls the behaviour of kom-next-kom and its cousins.
If this variable is non-nil the current buffer is sent to the back
of the buffer list when one of the commands `kom-next-kom',
David Byers's avatar
X    
David Byers committed
115
116
`kom-previous-kom' or `kom-next-unread-kom' is invoked."
  server)
117

David Byers's avatar
X    
David Byers committed
118
(def-kom-var kom-write-texts-in-window nil
119
  "*Where to edit texts. One of nil, 'other, 'new-frame, 'other-frame, a string
David Byers's avatar
David Byers committed
120
121
122
or a buffer.

nil means edit texts in the same window as the LysKOM buffer.
123
124
125
'other means edit in another window, creating it if necessary.
'other-frame means edit in another frame, if there is one.
'new-frame means create a new frame for editing. The frame will be removed 
David Byers's avatar
David Byers committed
126
          when editing is finished.
127
A string or buffer means edit in the indicated buffer."
David Byers's avatar
X    
David Byers committed
128
  server)
129

David Byers's avatar
X    
David Byers committed
130
(def-kom-var kom-view-commented-in-window 'other
131
  "*Where to view commented texts. See kom-write-texts-in-window for details."
David Byers's avatar
X    
David Byers committed
132
  server)
David Byers's avatar
David Byers committed
133

David Byers's avatar
X    
David Byers committed
134
135
136
137
(def-kom-var kom-edit-filters-in-window nil
  "*Where to edit filters. See kom-write-texts-in-window for
more information."
  server)
David Byers's avatar
David Byers committed
138

David Byers's avatar
X    
David Byers committed
139
140
141
142
(def-kom-var kom-list-membership-in-window 'other
  "*Where to list membership. See kom-write-texts-in-window for
more information."
  server)
143

144
145
146
147
148
(def-kom-var kom-personal-messages-in-window 'other
  "*Where to display personal messages. See kom-write-texts-in-window 
for more information."
  server)

David Byers's avatar
X    
David Byers committed
149
150
151
(def-kom-var kom-customize-format 'long
  "*Format of the customize buffer. Must be long or short."
  server)
152

David Byers's avatar
X    
David Byers committed
153
154
155
(def-kom-var kom-user-prompt-format "%[%c% %m%] - "
  "*Format of LysKOM prompt when waiting for input."
  server)
David Byers's avatar
David Byers committed
156

Per Cederqvist's avatar
.    
Per Cederqvist committed
157

David Byers's avatar
X    
David Byers committed
158
159
160
(def-kom-var kom-user-prompt-format-executing "%[%c% %m%]."
  "*Format of LysKOM prompt when executing a default command"
  server)
David Byers's avatar
David Byers committed
161
162


David Byers's avatar
X    
David Byers committed
163
164
165
(def-kom-var kom-enabled-prompt-format "%[%c% %m%] # "
  "*Format of LysKOM prompt when in enabled mode."
  server)
David Byers's avatar
David Byers committed
166

167

David Byers's avatar
X    
David Byers committed
168
169
170
171
(def-kom-var kom-enabled-prompt-format-executing "%[%c% %m%]."
  "*Format of LysKOM prompt when executing a default command in 
enabled mode."
  server)
David Byers's avatar
David Byers committed
172

David Byers's avatar
David Byers committed
173
174
175
176
177
178
179
180
(def-kom-var kom-anonymous-prompt-format "%[%c% %m%] (%a) - "
  "*Format of the LysKOM prompt when running anonymously."
  server)

(def-kom-var kom-anonymous-prompt-format-executing "%[%c% %m%] (%a)."
  "*Format of the LysKOM prompt when executing a command anonymously."
  server)

181
182
183
184
(def-kom-var kom-show-week-number t
  "*If non-nil show the ISO week number when displaying the time."
  server)

David Byers's avatar
David Byers committed
185

David Byers's avatar
X    
David Byers committed
186
187
188
(def-kom-var kom-cite-string ">"
  "*String to insert before each line of a commented text."
  server)
189

190
191
192
193
194
195
(def-kom-var kom-created-texts-are-saved nil
  "*If non-nil, save all created texts to a file. 
The value of this variable is the file name on which to save new texts."
  server
  inherited)

David Byers's avatar
X    
David Byers committed
196
197
198
(def-kom-var kom-created-texts-are-read t
  "*Non-nil means automatically mark texts that you create as read."
  server)
David Byers's avatar
David Byers committed
199

David Byers's avatar
X    
David Byers committed
200
(def-kom-var kom-customize-in-window nil
201
  "*Where to customize LysKOM. See kom-write-texts-in-window."
David Byers's avatar
X    
David Byers committed
202
  server)
Per Cederqvist's avatar
.    
Per Cederqvist committed
203

David Byers's avatar
X    
David Byers committed
204
(def-kom-var kom-prioritize-in-window nil
205
  "*Where to prioritize conferences. See kom-write-texts-in-window."
David Byers's avatar
X    
David Byers committed
206
  server)
David Byers's avatar
David Byers committed
207

208
(def-kom-var kom-default-mark nil
209
  "*If non-nil (must be an integer), the user is not asked for type of mark."
David Byers's avatar
X    
David Byers committed
210
  server)
Per Cederqvist's avatar
.    
Per Cederqvist committed
211

212
213
214
215
(def-kom-var kom-symbolic-marks-alist '(("Standard" . 100))
  "*Assoc list which maps symbolic mark strings to mark numbers."
  server)

David Byers's avatar
X    
David Byers committed
216
(def-kom-var kom-reading-puts-comments-in-pointers-last t
217
  "*If non-nil, the texts are shown with comment references at the end."
David Byers's avatar
David Byers committed
218
219
  server
  inherited)
David Byers's avatar
David Byers committed
220

221
222
223
224
225
(def-kom-var kom-review-uses-cache t
  "*If non-nil, review commands don't use the cache."
  server
  inherited)

David Byers's avatar
David Byers committed
226
227
228
229
230
(def-kom-var kom-postpone-default 17
  "*The number of articles to postpone by default."
  server)


David Byers's avatar
X    
David Byers committed
231
(def-kom-var kom-dashed-lines t
232
  "*If non-nil, all texts will be surrounded by lines of dashes."
David Byers's avatar
David Byers committed
233
234
  server
  inherited)
Per Cederqvist's avatar
.    
Per Cederqvist committed
235

236
(def-kom-var kom-long-lines nil
237
  "*If non-nil, some lines and borders will be made longer."
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
  server
  inherited)

(def-kom-var kom-text-footer-dash-length 52
  "*If non-nil, the total length of the text footer, when dashes are in use.
Note that the footer may end up longer than this if one or more elements
together are longer than this length.

This length is currently ignored when kom-text-footer-format is used."
  server
  inherited)

(def-kom-var kom-text-header-dash-length 60
  "*If non-nil, the total length of the dashes before a text body.
If kom-dashed-lines is non-nil, this is ignored."
  server
  inherited)



258
259
260
261
262
263
264
265
266
267
268
269
270
271
(def-kom-var kom-text-footer-format nil
  "*If non-nil, this specifies the format of a text footer.

The following format directives are legal:

    %n      The text number.
    %p      The number of the author.
    %P      The name of the author
    %-      A bunch of dashes
    %f      Information about the text in parentheses.

Format letters can be prefixed with a number specifying the minimum
field width. The field width can be prefixed with an equals sign which
means that the field is exactly as wide as specified (contents may be
272
truncated). A negative field width means left justify the contents.
273
274

The field width of %- is special. It specifies the maximum number of
275
dashes printed. The actual number will be the maximum minus the
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
length of the author's name, if it is included anywhere in the format
string.

When set, this variable overrides kom-dashed-lines and
kom-show-author-at-end.

The default format is equivalent to the following strings, depending on 
the settings of kom-dashed-lines and kom-show-author-at-end.

kom-dashed-lines    kom-show-author-at-end      Format
t                   t                           \"(%n) /%P/%42-%f\"
t                   nil                         \"(%n) %42-%f\"
nil                 t                           \"(%n) /%P/ %f\"
nil                 nil                         \"(%n) %f\"
"
  server
  inherited)



296
(def-kom-var kom-show-creating-software nil
297
  "*If non-nil, show the creating software of each text, if specified."
298
299
300
  server
  inherited)

David Byers's avatar
David Byers committed
301
(def-kom-var kom-show-author-at-end t
302
  "*If non-nil, the author will be shown at the end of each text."
David Byers's avatar
David Byers committed
303
304
  server
  inherited)
David Byers's avatar
David Byers committed
305

306
(def-kom-var kom-truncate-threshold nil
307
308
  "*If non-nil, truncate long texts when reviewing.
If the text is longer (in lines), the threshold it will be
309
310
311
truncated to `kom-truncate-show-lines' length."
  server)

312
(def-kom-var kom-truncate-show-lines 10
313
314
315
316
317
318
319
  "*How many lines to show after truncating.
If the text is truncated by `kom-truncate-threshold', show this many
lines.  If this is greater than the threshold, the threshold will be
used."
  server)


David Byers's avatar
X    
David Byers committed
320
(def-kom-var kom-print-number-of-unread-on-entrance t
321
  "*If non-nil, print automatically the number of unread articles when
David Byers's avatar
X    
David Byers committed
322
323
entering a conference."
  server)
Per Cederqvist's avatar
.    
Per Cederqvist committed
324

325
(def-kom-var kom-show-unread-in-frame-title t
326
  "*If non-nil, show an unread indicator in the frame title of each
327
328
329
LysKOM session."
  server)

David Byers's avatar
X    
David Byers committed
330
(def-kom-var kom-presence-messages t
331
  "*If non-nil, LysKOM prints continuous info about what other people are doing.
Per Cederqvist's avatar
.    
Per Cederqvist committed
332
Info is printed on the message line and never in the buffer. If minibuffer is
333
used, no message is printed.
Linus Tolke's avatar
Linus Tolke committed
334

David Byers's avatar
David Byers committed
335
336
337
338
A list of integers means show messages for those users.

The value 'friends means show messages for the users in kom-friends.

339
340
341
342
343
The value 'morons means show messages for the users in kom-morons.

The value 'friends-and-morons means show messages for the users in 
kom-friends and kom-morons.

344
If you want the messages in the buffer, you could set the variable 
David Byers's avatar
X    
David Byers committed
345
346
kom-presence-messages-in-buffer."
  server)
David Byers's avatar
David Byers committed
347

David Byers's avatar
X    
David Byers committed
348
(def-kom-var kom-presence-messages-in-buffer nil
349
  "*If t, LysKOM prints information about what other people are doing in the buffer.
Per Cederqvist's avatar
.    
Per Cederqvist committed
350
351
All printing is done just before the prompt.
If nil no messages are printed.
352
353
If 'presence, messages about people logging in, out and people 
changing name are printed."
David Byers's avatar
X    
David Byers committed
354
  server)
Per Cederqvist's avatar
.    
Per Cederqvist committed
355

David Byers's avatar
X    
David Byers committed
356
(def-kom-var kom-show-where-and-what t
Per Cederqvist's avatar
.    
Per Cederqvist committed
357
  "*Non-nil means kom-who-is-on shows from which machine the user is running
David Byers's avatar
X    
David Byers committed
358
359
and what he is doing."
  server)
David Byers's avatar
David Byers committed
360

361
362
(def-kom-var kom-show-since-and-when nil
  "*Non-nil means kom-who-is-on shows when the user connected and when
363
he last was active."
364
  server)
Per Cederqvist's avatar
.    
Per Cederqvist committed
365

David Byers's avatar
X    
David Byers committed
366
(def-kom-var kom-idle-hide 30
367
  "*The number of minutes of idle-time before a user is excluded from the list
David Byers's avatar
X    
David Byers committed
368
369
of users. This can be overridden by a prefix argument to `kom-who-is-on'."
  server)
370

David Byers's avatar
X    
David Byers committed
371
372
373
(def-kom-var kom-show-footnotes-immediately t
  "*Non-nil means show footnotes immediately following the text."
  server)
374

David Byers's avatar
X    
David Byers committed
375
(def-kom-var kom-follow-comments-outside-membership nil
376
377
378
  "*Show comments in conferences you are not a member of.

If this variable is nil, texts with no recipient you are a member of
David Byers's avatar
X    
David Byers committed
379
380
will not be shown."
  server)
381

David Byers's avatar
David Byers committed
382
383
384
385
(def-kom-var kom-follow-attachments t
  "*Follow attachments as if they are regular comments."
  server)

386
387
388
389
;;(def-kom-var kom-who-buffer-size-when-displaying 10
;;  "Size of window to display the who-buffer.
;;This is used when executing the kom-display-who-buffer command."
;;  server)
Per Cederqvist's avatar
.    
Per Cederqvist committed
390

David Byers's avatar
X    
David Byers committed
391
392
393
(def-kom-var kom-read-depth-first t
  "*Non-nil means read comments and footnotes to a text before other texts."
  server)
David Byers's avatar
David Byers committed
394

David Byers's avatar
X    
David Byers committed
395
(def-kom-var kom-continuous-scrolling t
396
  "*Non-nil means scroll LysKOM window as text is inserted. The last viewed
David Byers's avatar
X    
David Byers committed
397
398
position (generally the most recent prompt) will always be visible."
  server)
399
400


401
;; Should this be set to nil if baud-rate is low?
David Byers's avatar
X    
David Byers committed
402
(def-kom-var kom-deferred-printing t
403
  "*Non-nil means delay printing of some information not in the cache.
404
405
You might want to turn this off to have the old, linear behaviour."
  server)
406

David Byers's avatar
X    
David Byers committed
407
408
(def-kom-var lyskom-defer-indicator "[...]"
  "String to display while LysKOM is waiting for the real string.")
409

410
411
412
413
414
415
(def-kom-var kom-review-priority nil
  "*If non-nil, the priority to use when reviewing texts. Set this to
255 or higher to avoid texts and conferences with higher priority to
break in while reviewing."
  server)

David Byers's avatar
X    
David Byers committed
416
(def-kom-var kom-higher-priority-breaks nil
417
418
419
  "*Non-nil means allow texts from conferences with higher priority to break in.
If the value is 'express, texts are allowed to break in the middle of a
comment chain. Otherwise we don't let them in until the end of the comment
David Byers's avatar
X    
David Byers committed
420
421
tree."
  server)
Per Cederqvist's avatar
.    
Per Cederqvist committed
422

423
424
(def-kom-var kom-server-priority-breaks nil
  "*Non-nil means allow servers with a higher priority to break in.
425
426
Valid values are 'express, 'express-letters, 'letters, 'after-conf, 
'after-conf-letters, t and 'when-done.
427

428
'express means break immediately when a text arrives in a prioritized
429
430
session.

431
'express-letters means break immediately when a letter arrives in a 
432
433
434
435
436
prioritized session.

t means break after the current comment chain when a text arrives in 
a prioritized session.

437
'letters means break after the current comment chain when a letter
438
439
arrives in a prioritized session.

440
'after-conf means break after the current conference when a text
441
442
arrives in a prioritized session.

443
'after-conf-letters means break after the current conference when a
444
445
letter arrives in a prioritized session.

446
'when-done means prompt user to go to the next session with unreads
447
448
449
450
451
after everything has been read. This overrides kom-do-when-done as
long as there are sessions with unread texts.
"
  server)

David Byers's avatar
X    
David Byers committed
452
(def-kom-var lyskom-view-text-hook nil
453
  "*Hook that is called before a text is shown. When the hooks are
454
455
called, lyskom-view-text-text is bound to the text mass of the 
text and lyskom-view-text-text-stat to the text-stat of the text
456
457
to be shown."
  local-hook)
458
459


David Byers's avatar
X    
David Byers committed
460
(def-kom-var lyskom-send-message-hook '(lyskom-send-message-trim-newlines)
David Byers's avatar
David Byers committed
461
462
463
464
465
466
467
  "*Hook that is called before a personal, group or common message is sent. 

When called, lyskom-message-string is bound to the message that will be sent
and lyskom-message-recipient to the conf-stat of the recipient or nil if
the recipient does not exist or if the message is a common message.

If lyskom-message-string is set to nil by a hook, the message will not
468
469
be sent."
  local-hook)
David Byers's avatar
David Byers committed
470

David Byers's avatar
X    
David Byers committed
471
(def-kom-var lyskom-send-message-setup-hook nil
472
473
  "*Hook that is called when the minibuffer is entered to read a message."
  local-hook)
474

David Byers's avatar
X    
David Byers committed
475
(def-kom-var lyskom-send-message-exit-hook nil
476
477
  "*Hook that is called when the minibuffer is exited after reading a message."
  local-hook)
478

David Byers's avatar
David Byers committed
479
480
(def-kom-var lyskom-send-text-hook nil
  "*Hook that is called before sending a text. Hook functions return t to
481
signal success and nil to prevent the text from being sent."
482
  local-hook)
David Byers's avatar
David Byers committed
483

David Byers's avatar
X    
David Byers committed
484
(def-kom-var lyskom-after-load-hook nil
485
  "*Hook to run once after LysKOM is loaded.")
David Byers's avatar
David Byers committed
486

David Byers's avatar
David Byers committed
487
488
489
(def-kom-var lyskom-change-conf-hook nil
  "*Hook to run when changing conferences.
The functions in this list are run with two arguments. The first is the 
490
491
492
493
494
495
496
497
498
499
500
501
502
current conf-no and the second is the conf-no being changed to.

This hook is run before lyskom-current-conf is changed, and before any
standard messages have been printed."
  local-hook)

(def-kom-var lyskom-after-change-conf-hook nil
  "*Hook to run when changing conferences.
The functions in this list are run with two arguments. The first is the 
current conf-no and the second is the conf-no being changed to.

This hook is run after lyskom-current-conf is changed, and after any
standard messages have been printed."
503
  local-hook)
David Byers's avatar
David Byers committed
504

David Byers's avatar
X    
David Byers committed
505
(def-kom-var lyskom-login-hook nil
506
  "*What to do when logged in.
507
This hook is called after we have logged in but before any command is
508
accepted from the keyboard. It is called immediately before
509
510
kom-login-hook."
  local-hook)
511

David Byers's avatar
X    
David Byers committed
512
(def-kom-var kom-login-hook nil
Per Cederqvist's avatar
.    
Per Cederqvist committed
513
514
  "*What to do when logged in.
This is a list of commands that are executed after we have logged in but before
David Byers's avatar
X    
David Byers committed
515
516
any command is accepted from the keyboard. See also lyskom-login-hook."
  server)
David Byers's avatar
David Byers committed
517

518
519
520
(def-kom-var kom-confirm-add-recipients t
  "*When non-nil, offer to add cc-recipient instead of full recipient."
  server)
521

Per Cederqvist's avatar
.    
Per Cederqvist committed
522

David Byers's avatar
X    
David Byers committed
523
(def-kom-var kom-do-when-done '(kom-review-all-marked-texts kom-display-time)
Per Cederqvist's avatar
.    
Per Cederqvist committed
524
525
526
527
528
  "*What to do when all texts are read.
This is a list of commands and lists of commands that are prompted for
and executed when there are no more new texts.  The last element in
the list is the one that will never be removed from the list.
A command can be one of:
529

Per Cederqvist's avatar
.    
Per Cederqvist committed
530
type			prompt
531
532
533
534
535
------------------------------
lyskom-function		from the lyskom-command-name function
command			\"Command:\" (name of function or definition of
			lambda expression)
keyboard macro		\"Command:\" (keyboard macro definition)"
David Byers's avatar
X    
David Byers committed
536
  server)
David Byers's avatar
David Byers committed
537

David Byers's avatar
X    
David Byers committed
538
(def-kom-var kom-page-before-command nil
539
  "*This is a list of all commands before which the screen is cleared.
David Byers's avatar
X    
David Byers committed
540
541
If it isn't a list and isn't nil the screen is cleared before all commands."
  server)
Per Cederqvist's avatar
.    
Per Cederqvist committed
542

David Byers's avatar
X    
David Byers committed
543
(def-kom-var kom-permissive-completion t
544
545
  "*If t, completion on logged-in persons will usually also include
persons who are not logged in. Values other than t or nil are reserved
David Byers's avatar
X    
David Byers committed
546
547
for future use."
  server)
548

549
550
551
552
553
(def-kom-var kom-unsubscribe-makes-passive t
  "*If non-nil subtracting oneself from a conference makes the membership
passive. A second leave will actually remove the membership."
  server)

David Byers's avatar
David Byers committed
554
(def-kom-var kom-membership-default-priority 'ask
Per Cederqvist's avatar
.    
Per Cederqvist committed
555
556
557
558
  "*Default priority when joining a new conference.
If a valid priority then new conferences are read with this priority. 
Otherwise ask the user for a priority.

David Byers's avatar
X    
David Byers committed
559
560
Valid priorities are only the range 0-255."
  server)
David Byers's avatar
David Byers committed
561

David Byers's avatar
X    
David Byers committed
562
(def-kom-var kom-membership-default-placement 'last
Per Cederqvist's avatar
.    
Per Cederqvist committed
563
564
565
566
567
  "*Tells the system where to put new conferences.
The value can be one of the following:
'first => before all other conferences.
'last => after all other conferences.
a number => at that position
568
otherwise => the new conference is entered after all conferences."
David Byers's avatar
X    
David Byers committed
569
  server)
David Byers's avatar
David Byers committed
570

David Byers's avatar
X    
David Byers committed
571
(def-kom-var lyskom-current-prompt nil
572
573
  "The current prompt or nil.
This is either nil, indicating that there is currently no prompt, or
574
a symbol indicating which command is prompted in the LysKOM buffer."
David Byers's avatar
X    
David Byers committed
575
  local)
David Byers's avatar
David Byers committed
576

David Byers's avatar
X    
David Byers committed
577
578
579
580
581
582
(def-kom-var lyskom-current-prompt-text nil
  "The current prompt text or nil.
This is either nil, indicating that there is currently no prompt, or
a string indicating the prompt shown in the LysKOM buffer."
  local)

583
584
585
586
587
588
589
590
591
(def-kom-var lyskom-current-prompt-args nil
  "The current prompt arguments
These are arguments used to format the current prompt."
  local)

(def-kom-var lyskom-need-prompt-update nil
  "Non-nil if all prompts need to be updated."
  local)

David Byers's avatar
X    
David Byers committed
592
(def-kom-var kom-show-personal-messages-in-buffer t
593
594
595
596
  "*Buffer to show personal messages in.
If nil, discard them.
If t, insert them in the *kom* buffert.
If non-nil and non-t this should be a buffer or a name of a (possibly
David Byers's avatar
X    
David Byers committed
597
598
nonexistent) buffer in which the message is inserted."
  server)
David Byers's avatar
David Byers committed
599

David Byers's avatar
X    
David Byers committed
600
(def-kom-var kom-pop-personal-messages nil
601
  "*Non-nil means pop up a buffer with personal messages as they arrive.
David Byers's avatar
X    
David Byers committed
602
603
kom-show-personal-messages-in-buffer decides which buffer to pop."
  server)
604

605
606
607
(def-kom-var kom-ding-pause-amount 0.1
  "*Amount of time to wait between successive beeps.")

David Byers's avatar
X    
David Byers committed
608
(def-kom-var kom-ding-on-new-letter nil
609
  "*Non-nil means ding if a message arrives in the letter box. See 
David Byers's avatar
X    
David Byers committed
610
611
kom-ding-on-priority-break for valid values."
  server)
612
613


David Byers's avatar
X    
David Byers committed
614
(def-kom-var kom-ding-on-priority-break 1
615
616
  "*Non-nil means ding if a higher priority text or conference breaks in.
A number means the number of times to ding. A string is an argument for the
David Byers's avatar
X    
David Byers committed
617
618
program named by kom-audio-player."
  server)
David Byers's avatar
David Byers committed
619

David Byers's avatar
X    
David Byers committed
620
(def-kom-var kom-ding-on-wait-done 1
621
622
623
  "*Non-nil means ding when busy-waiting finishes.
A number means the number of times to ding. A string is an argument
for the program named by kom-audio-player. A symbol is interpreted as a 
David Byers's avatar
X    
David Byers committed
624
625
function to call."
  server)
626

David Byers's avatar
X    
David Byers committed
627
(def-kom-var kom-ding-on-common-messages 0
628
629
630
631
632
633
634
  "*Non-nil means ding as alarm messages arrive. 
A number means the number of times to ding. A string is an argument
for the program named by kom-audio-player. A symbol is interpreted as
a function to call. A list consisting of pairs (KEY . VALUE) is used
for fine-grained control. The list is searched for a pair where KEY
matches the sender identity. The corresponding VALUE is used as the
specification on how to beep."
David Byers's avatar
X    
David Byers committed
635
  server)
David Byers's avatar
David Byers committed
636

David Byers's avatar
X    
David Byers committed
637
(def-kom-var kom-ding-on-group-messages 1
638
  "*Non-nil means ding as group messages arrive.
639
640
641
642
643
644
A number means the number of times to ding. A string is an argument
for the program named by kom-audio-player. A symbol is interpreted as
a function to call. A list consisting of pairs (KEY . VALUE) is used
for fine-grained control. The list is searched for a pair where KEY
matches the recipient identity. The corresponding VALUE is used as the
specification on how to beep."
David Byers's avatar
X    
David Byers committed
645
  server)
646

David Byers's avatar
X    
David Byers committed
647
(def-kom-var kom-ding-on-personal-messages 2
648
  "*Non-nil means ding as personal messages arrive.
649
650
651
652
653
654
A number means the number of times to ding. A string is an argument
for the program named by kom-audio-player. A symbol is interpreted as
a function to call. A list consisting of pairs (KEY . VALUE) is used
for fine-grained control. The list is searched for a pair where KEY
matches the sender identity. The corresponding VALUE is used as the
specification on how to beep."
David Byers's avatar
X    
David Byers committed
655
  server)
David Byers's avatar
David Byers committed
656
657


David Byers's avatar
David Byers committed
658
(def-kom-var kom-ding-on-no-subject 2
659
  "*How to ding if the user has not entered a subject line.
660
661
A number means the number of times to ding. A string is an argument for the
program named by kom-audio-player. A symbol is interpreted as a function 
David Byers's avatar
David Byers committed
662
663
to call."
  server)
David Byers's avatar
David Byers committed
664

665

David Byers's avatar
X    
David Byers committed
666
(def-kom-var kom-audio-player "audioplay"
David Byers's avatar
David Byers committed
667
668
  "*Program to play audio files."
  server)
David Byers's avatar
David Byers committed
669

Per Cederqvist's avatar
.    
Per Cederqvist committed
670

671
672
673
674
675
676
677
678
(def-kom-var kom-ignore-message-senders nil
  "*List of senders whose personal, group and alarm messages are ignored."
  server)

(def-kom-var kom-ignore-message-recipients nil
  "*List of recipients you do not want group messages to."
  server)

679
680
681
682
(def-kom-var kom-show-personal-message-date t
  "*Show date on personal messages is non-nil."
  server)

David Byers's avatar
X    
David Byers committed
683
(def-kom-var kom-default-message-recipient 'group
David Byers's avatar
David Byers committed
684
685
  "*Determines default recipient of personal messages.

686
687
688
689
690
691
'everybody means the default recipient is everybody.
'group     means the default recipient is the group to which the last
           message was sent, if it was a group message. If the last message
           was a personal message or a common message, it means the same as 
           'sender. 
'sender    means the sender of the last message received."
David Byers's avatar
X    
David Byers committed
692
  server)
David Byers's avatar
David Byers committed
693
694


David Byers's avatar
X    
David Byers committed
695
(def-kom-var lyskom-filter-outgoing-messages t
696
  "*t if outgoing remote-control messages and automatic replies are not
697
698
to be displayed in the buffer."
  server)
David Byers's avatar
David Byers committed
699
700


David Byers's avatar
X    
David Byers committed
701
702
703
(def-kom-var kom-friends nil
  "*List of people whose names should be formatted using kom-friends-face."
  server)
704

705
706
707
708
(def-kom-var kom-morons nil
  "*List of people whose names should be formatted using kom-morons-face."
  server)

709
710
711
(def-kom-var kom-dont-check-commented-authors nil
  "*List of recipients who do not need to be added to comments that they
might not see. Typically this list consists of import agents."
712
713
  server
  inherited)
714

David Byers's avatar
X    
David Byers committed
715
716
(def-kom-var kom-default-face-scheme nil  
  "*Face scheme to use per default for new logins.")
David Byers's avatar
David Byers committed
717

David Byers's avatar
David Byers committed
718
719
720
721
(def-kom-var kom-smileys t
  "*Non-nil means to reformat smileys in text."
  server)

David Byers's avatar
X    
David Byers committed
722
(def-kom-var kom-text-properties t
723
  "*Non-nil means to insert text properties in the Emacs buffer for
David Byers's avatar
X    
David Byers committed
724
various LysKOM elements.")
725

David Byers's avatar
X    
David Byers committed
726
727
(def-kom-var kom-use-button-hints t
  "*Non-nil means use button hints for overriding default actions.")
David Byers's avatar
David Byers committed
728

David Byers's avatar
David Byers committed
729
(def-kom-var kom-autowrap t
David Byers's avatar
David Byers committed
730
731
  "*Non-nil means auto wrap articles with discretion.
A number means wrap articles shorter than the number (in bytes)."
David Byers's avatar
David Byers committed
732
733
  server)

734
735
736
(def-kom-var kom-keep-alive-interval 180
  "*The number of seconds between periodic requests used to keep the session alive"
  server)
737

738
739
740
741
(defvar lyskom-transforming-external-text nil
  "Dynamically bound to non-nil when transforming text in which text,
conference and person buttons are not expected.")

David Byers's avatar
David Byers committed
742
(def-kom-var lyskom-url-protocol-regexp
743
744
  "\\(file\\|ftp\\|gopher\\|http\\|https\\|news\\|wais\\|mailto\\|telnet\\):"
  "Regexp to match the protocol part of a URL.")
David Byers's avatar
David Byers committed
745

David Byers's avatar
X    
David Byers committed
746
(def-kom-var lyskom-text-buttons
747
748
  '(
    ;; Text numbers
749
750
751
752
753
754
    ("\\(\\<[0-9][0-9][0-9][0-9]\\([0-9]\\)?\\([0-9]\\)?\\([0-9]\\)?\\>\\)" 
                                        ; Match
     text                               ; Button type
     0                                  ; Portion that's a button
     1                                  ; Portion that's the arg
     nil                                ; Face or nil (=default)
755
756
     )

David Byers's avatar
David Byers committed
757
758
    ;; Email

David Byers's avatar
David Byers committed
759
    ("\\(\\b\\|^\\)[^()<>@,;:\"\\\\\000- ]+@[^\000- <>;,.'\"!:?) \t\012\014]+\\(\\.[^\000- <>;,.'\"!:?)]+\\)+"
David Byers's avatar
David Byers committed
760
761
     email 0 0 kom-url-face)

762
763
    ;; URLs

764
    ("\\b\\(www\\|ftp\\|home\\)\\.[^\t \012\014\"<>|\\]*[^\t \012\014\"<>|.,!(){}?'`:]" 
David Byers's avatar
David Byers committed
765
766
     pseudo-url 0 nil kom-url-face)

767
    ("\\(file://\\|ftp://\\|gopher://\\|http://\\|https://\\|news:\\|wais://\\|mailto:\\|telnet:\\)[^\t \012\014\"<>|\\]*[^\t \012\014\"<>|.,!(){}?'`:]" 
768
     url 0 nil kom-url-face)
David Byers's avatar
X    
David Byers committed
769
770
771
    ("<URL:\\s-*\\([^>]*\\)\\s-*>"
     url 1 1 kom-url-face)

772
773
    ;; JySKom enhancements

774
775
776
    ("<(?m[|ö]te[ \t\n]*\\([0-9]+\\)[^0-9>]*)?>" conf 0 1 nil)
    ("<(?text[ \t\n]*\\([0-9]+\\)[^0-9>]*)?>" text 0 1 nil)
    ("<(?person[ \t\n]*\\([0-9]+\\)[^0-9>]*)?>" pers 0 1 nil)
David Byers's avatar
David Byers committed
777

778
779
    ;; Info node reference

David Byers's avatar
David Byers committed
780
    ("\\*Note[ \n\t]+\\([^:\n]*\\(\n[^:\n]*\\)?\\):\\s-*\\(\\(([^\)]+)\\)?[^.,\t\n]*\\(\n[^.,\t\n]*\\)?\\)[.,\t]" 
781
     info-node 1 3 kom-url-face)
782

David Kågedal's avatar
David Kågedal committed
783
    )
784
785
786
  "List of buttons to install in the text mass of LysKOM objects. Each element is
a list consisting of REGEXP TYPE BUTTON-MATCH BUTTON-ARG-MATCH FACE.
REGEXP is the regexp to look for in the text.
787
TYPE is the button type. Valid button types are defined in lyskom-button-actions.
788
BUTTON-MATCH is the number of the parenthesized expression that is the actual button.
789
BUTTON-ARG-MATCH is the number of the expression to be used as the button argument.
David Byers's avatar
X    
David Byers committed
790
FACE is the text face to apply to the button, or nil to use the default face.")
791

David Byers's avatar
X    
David Byers committed
792
(def-kom-var kom-url-viewer-preferences '("emacs"
793
794
                                          "windows"
                                          "w3")
David Byers's avatar
David Byers committed
795

796
  "*LysKOM will attempt to use URL viewers in the order specified here.
David Byers's avatar
David Byers committed
797
798
799
kom-url-managers is a list of all available viewers. Note that the elements
are all strings.

800
When you select a URL, this list is used to determine which URL
David Byers's avatar
David Byers committed
801
802
803
804
805
806
viewer to use in the following manner: Each element is in turn matched
against the manager regexp for each manager in kom-url-managers, and the
first manager found that matches is used to display the URL.

See kom-url-managers for a list of all available URL viewers. See
kom-netscape-command and kom-mosaic-command for information specific 
David Byers's avatar
David Byers committed
807
808
to some URL viewers."
  server)
809
810


David Byers's avatar
X    
David Byers committed
811
812
(def-kom-var kom-url-managers '(("default"
                            ".*"
813
                            "Browse-URL"
David Byers's avatar
X    
David Byers committed
814
815
                            lyskom-view-url-browse-url)
                           ("w3" 
816
817
818
			    "\\(http\\|gopher\\|ftp\\)"
			    "Emacs W3" 
			    lyskom-view-url-w3)
819
820
                           ("windows"
                            ".*"
821
                            "web browser"
822
                            lyskom-view-url-windows)
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
			   ("netscape"
			    ".*"
			    "Netscape Navigator"
			    lyskom-view-url-netscape)
			   ("\\(emacs\\|dired\\)"
			    "\\(ftp\\|file\\)"
			    "dired"
			    lyskom-view-url-dired)
			   ("\\(emacs\\|telnet-mode\\)"
			    "telnet"
			    "emacs telnet"
			    lyskom-view-url-telnet)
			   ("\\(emacs\\|mail-mode\\)"
			    "mailto"
			    "mail-mode"
			    lyskom-view-url-mailmode)
			   ("mosaic"
Peter Liljenberg's avatar
Peter Liljenberg committed
840
841
842
843
844
845
			    "\\(http\\|gopher\\|ftp\\|mailto\\|news\\|wais\\|file\\|telnet\\)"
			    "NCSA Mosaic"
			    lyskom-view-url-mosaic)
			   ("lynx"
			    "\\(http\\|gopher\\|ftp\\|mailto\\|news\\|wais\\|file\\|telnet\\)"
			    "Lynx"
Ulrik Haugen's avatar
Ulrik Haugen committed
846
847
848
849
850
			    lyskom-view-url-lynx)
			   ("galeon"
			    "\\(http\\|gopher\\|ftp\\|mailto\\|news\\|wais\\|file\\|telnet\\)"
			    "Galeon"
			    lyskom-view-url-galeon))
851
852

  "List of URL managers. Each element is a list consisting of
David Byers's avatar
David Byers committed
853
(MANAGER-REGEXP PROTOCOLS NAME VIEW-FUNCTION). When LysKOM attempts to
854
view a URL, kom-url-viewer-preferences is scanned, and the URL
David Byers's avatar
David Byers committed
855
856
857
manager whose MANAGER-REGEXP first matches an element in
kom-url-viewer-preferences and whose PROTOCOLS matches the protocol of
the selected URL is used to view the URL by calling its VIEW-FUNCTION
David Byers's avatar
X    
David Byers committed
858
with the URL and the manager entry as arguments.")
David Byers's avatar
David Byers committed
859

David Byers's avatar
X    
David Byers committed
860
(def-kom-var kom-mosaic-command "/usr/local/bin/mosaic"
861
  "*Command to run to start Mosaic."
David Byers's avatar
David Byers committed
862
  server)
David Byers's avatar
David Byers committed
863

David Byers's avatar
X    
David Byers committed
864
(def-kom-var kom-netscape-command "netscape"
David Byers's avatar
David Byers committed
865
866
867
868
869
870
871
  "*Command to run to start Netscape.

If a string, it should be a command that starts Netscape with no
arguments. If a list, the first element must be a command that starts
Netscape. The remaining elements are used as arguments to Netscape.

For instance, a value of \"netscape\" is valid, but \"netscape -d host:0\"
David Byers's avatar
David Byers committed
872
873
is not. Instead, the latter should be \(\"netscape\" \"-d\" \"host:0\"\)"
  server)
David Byers's avatar
David Byers committed
874

Ulrik Haugen's avatar
Ulrik Haugen committed
875
876
877
878
879
880
881
882
883
884
885
(def-kom-var kom-galeon-command "galeon"
  "*Command to run to start Galeon.

If a string, it should be a command that starts Galeon with no
arguments. If a list, the first element must be a command that starts
Galeon. The remaining elements are used as arguments to Galeon.

For instance, a value of \"galeon\" is valid, but \"galeon --display host:0\"
is not. Instead, the latter should be \(\"galeon\" \"--display\" \"host:0\"\)"
  server)

Peter Liljenberg's avatar
Peter Liljenberg committed
886
887
888
(def-kom-var kom-lynx-terminal 'xterm
  "*Where to start Lynx.
Valid values are 'xterm (start Lynx in an xterm) and 'terminal (start
889
Lynx in Emacs terminal mode).")
Peter Liljenberg's avatar
Peter Liljenberg committed
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904

(def-kom-var kom-lynx-xterm-command
  '("xterm" "-geometry" "90x50+100+100" "-e" "lynx")
  "*Command to run to start Lynx in an xterm.
Must be a list of strings, where the first element is the name of the
xterm program, and the remaining elements are arguments to the
xterm. The last elements should be \"-e\" \"lynx\", or something similar,
to start Lynx.")

(def-kom-var kom-lynx-terminal-command "lynx"
  "*Command to run Lynx in Emacs terminal mode.

This can be either a string, to start Lynx with no arguments, or a
list of strings, where the first element is the command, and the rest
are arguments to Lynx.")
905

David Byers's avatar
X    
David Byers committed
906
(def-kom-var kom-confirm-multiple-recipients 'after
907
908
  "*Non-nil means ask the user for confirmation about recipients.
When the user writes a comment to a text with more than one recipient
909
910
he gets a y-or-n-p question for all recipients. 'before means check
before opening the edit buffer. Anything else means check before
David Byers's avatar
X    
David Byers committed
911
912
sending the article."
  server)
913

David Byers's avatar
David Byers committed
914
915
916
917
918
919
920
921
(def-kom-var kom-check-for-new-comments t
  "*Non-nil means check that no new comments have been written to a commented
texts since the last check. A list means check in all conferences except
those listed. A function means call the function and check if non-nil is
returned. The function is called with the commented text's text-stat as
an argument."
  server)

David Byers's avatar
X    
David Byers committed
922
(def-kom-var kom-check-commented-author-membership t
923
924
  "*Non-nil means check that the authors of the commented texts are
members of at least one of the recipient conferences. If not, offer to
David Byers's avatar
X    
David Byers committed
925
926
add them as recipients."
  server)
927

David Byers's avatar
X    
David Byers committed
928
(def-kom-var kom-inhibit-typeahead nil
929
  "*If non-nil, discard keyboard input that arrives while a LysKOM command is
David Byers's avatar
X    
David Byers committed
930
931
executing. "
  server)
932

David Byers's avatar
X    
David Byers committed
933
(def-kom-var kom-max-buffer-size nil
934
  "*If non-nil, ensure that buffers won't grow any larger than this."
935
  server)
David Byers's avatar
David Byers committed
936

937
938
939
940
941
942
943
944
945
946
(def-kom-var kom-print-relative-dates t
  "*If non-nil, print today's and yesterday's date as \"today\" and
\"yesterday\" (respectively) in some places instead of the default,
numeric format."
  server)

(def-kom-var kom-print-seconds-in-time-strings nil
  "*If non-nil, include seconds, minutes and hours when printing
time in some places. If nil, only include minutes and hours."
  server)
947

David Byers's avatar
David Byers committed
948
(def-kom-var kom-show-namedays nil
949
  "*Non-nil means display namedays when running in Swedish.
David Byers's avatar
David Byers committed
950
951
952
This variable will eventually be replaced with something else."
  server)

David Byers's avatar
David Byers committed
953
954
955
956
957
958
959
(def-kom-var kom-www-proxy nil
  "*Non-nil indicates a WWW proxy to use for the connection.
This is useful behind a firewall if the proxy supports the CONNECT
method. 

If this variable is a string, it is assumed to be a proxy
specification for all LysKOM servers. If it is a list, it is assumed
960
961
to be a list of pairs, (SERVER . PROXY), where SERVER is the server for
which PROXY specification is to be used. The special value t
David Byers's avatar
David Byers committed
962
963
964
965
966
967
can be used for SERVER to indicate a default proxy.

A proxy specification has the form \"HOST:PORT\" where HOST is the
host name of the proxy and PORT is the port to connect to. The :PORT
part is optional. If it is not specified, port 80 is assumed.")

968
969
970
971
972
973
974
975
976
977
978
979
980
(def-kom-var kom-www-proxy-headers
  "User-Agent: Mozilla/4.7C-CCK-MCD  [en] (X11; I; SunOS 5.6 sun4u)"
  "*Headers to send to the proxy when connecting to LysKOM through a WWW
proxy. The value of this variable should either be a single string, which
is sent verbatim to the proxy, or a list of strings which will be sent to
the proxy separated by CRLF, or a list of elements like (NAME H1 H2 ... Hn)
where NAME is the name of a proxy and the remaining elements are headers
to send when connecting through that proxy.

Do not use this variable for proxy authentication.")



David Byers's avatar
X    
David Byers committed
981
(def-kom-var kom-server-aliases
David Kågedal's avatar
David Kågedal committed
982
983
  '(("kom.lysator.liu.se" . "LysKOM")
    ("kom.ludd.luth.se" . "LuddKOM")
984
    ("kom.hem.liu.se" . "RydKOM")
David Kågedal's avatar
David Kågedal committed
985
986
    ("kom.csd.uu.se" . "CSD-KOM")
    ("striterax.medio.mh.se" . "MedioKOM")
987
    ("kom.mds.mdh.se" . "MdS-KOM")
988
    ("kom.stacken.kth.se" . "TokKOM")
David Byers's avatar
David Byers committed
989
    ("com.helsinki.fi" . "HelKOM")
990
991
    ("kom.cd.chalmers.se" . "CD-KOM")
    ("community.roxen.com" . "Roxen Community KOM"))
David Byers's avatar
X    
David Byers committed
992
  "*An alist mapping server names to shorter identification strings")
David Byers's avatar
David Byers committed
993

David Byers's avatar
X    
David Byers committed
994
995
996
(def-kom-var kom-ansaphone-on nil
  "t if automatic replies to personal messages are in effect."
  local)
997

998
999
1000
1001
(def-kom-var kom-silent-ansaphone nil
  "*Non-nil if messages should not cause beeps when the ansaphone is on."
  server)

David Byers's avatar
X    
David Byers committed
1002
1003
1004
(def-kom-var kom-ansaphone-record-messages t
  "*t if messages are recorded while the ansaphone is on."
  server)
1005

David Byers's avatar
X    
David Byers committed
1006
1007
1008
(def-kom-var kom-ansaphone-show-messages t
  "*t if messages are to be shown when they are recorded."
  server)
1009
1010


David Byers's avatar
X    
David Byers committed
1011
(def-kom-var lyskom-ansaphone-messages nil
1012
  "Messages collected by the automatic reply facility.
David Byers's avatar
X    
David Byers committed
1013
1014
The most recent message is the first message in the list."
  local)
1015

David Byers's avatar
X    
David Byers committed
1016
1017
1018
(def-kom-var lyskom-ansaphone-when-set (current-time-string)
  "Time when the auto-reply facility was enabled."
  local)
1019

David Byers's avatar
X    
David Byers committed
1020
1021
1022
(def-kom-var kom-remote-control t
  "*t if LysKOM may be remotely controlled."
  server)
1023

David Byers's avatar
X    
David Byers committed
1024
(def-kom-var kom-remote-controllers nil 
1025
  "*Persons who may control LysKOM using messages. By default you can
David Byers's avatar
David Byers committed
1026
always control your own sessions. See kom-self-control for more
David Byers's avatar
X    
David Byers committed
1027
1028
information."
  server)
David Byers's avatar
David Byers committed
1029

David Byers's avatar
X    
David Byers committed
1030
(def-kom-var kom-self-control t
David Byers's avatar
David Byers committed
1031
  "*If non-nil, remote control commands are accepted from sessions logged
David Byers's avatar
X    
David Byers committed
1032
1033
in as the same user as the current session."
  server)
David Byers's avatar
David Byers committed
1034

David Byers's avatar
X    
David Byers committed
1035
(def-kom-var kom-ansaphone-replies
David Byers's avatar
David Byers committed
1036
1037
1038
1039
1040
  '((group nil nil nil nil)
    (common nil nil nil nil))
  "*List of automatic replies to various messages.

A list of (MESSAGE-TYPE SENDER RECIPIENT TEXT REPLY)
1041
    MESSAGE-TYPE is one of 'personal, 'group or 'common or nil
David Byers's avatar
David Byers committed
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
    SENDER is a list of integers or a single integer or nil
    RECIPIENT is a list of integers or a single integer or nil
    TEXT is a regular expression or nil
    REPLY is a string or nil

When an incoming message arrives and the auto-reply facility is on,
this list is checked for automatic replies. The message type, sender,
recipient and text of the incoming messages is matched against the 
elements of this list. If a match is found, the corresponding reply is
send. A nil in one of the message-type, sender, recipient or text
components in the list is taken to mean a wildcard. A null reply means
don't send a reply.

1055
If none of the elements match, kom-ansaphone-default-reply is sent."
David Byers's avatar
X    
David Byers committed
1056
  server)
David Byers's avatar
David Byers committed
1057

1058
(def-kom-var kom-agree-text nil