vars.el.in 71.6 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
X    
David Byers committed
38
(provide 'lyskom)
39

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

David Byers's avatar
David Byers committed
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
(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.

Dont change this. These are defined by the protocol.")
				  
(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.

Dont change these. These are defined by the protocol.")


David Byers's avatar
X    
David Byers committed
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

(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
80

David Byers's avatar
David Byers committed
81
82
83
84
(defvar lyskom-is-loaded nil
  "Non-nil when lyskom has been loaded.")


David Byers's avatar
David Byers committed
85
86
(def-kom-var kom-dont-read-saved-variables '(kom-dont-read-saved-variables
                                             lyskom-login-hook)
David Byers's avatar
David Byers committed
87
88
89
90
  "*Non nil means don't read some variables from the server.
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
91
92
93
94
95
96
97
98


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


;;; User flags

David Byers's avatar
X    
David Byers committed
99
(def-kom-var kom-allow-incompleteness nil
100
101
  "*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,
David Byers's avatar
X    
David Byers committed
102
103
104
but it might give them faster, especially during the login phase."
  server
)
105

David Byers's avatar
X    
David Byers committed
106
(def-kom-var kom-bury-buffers t
107
108
109
  "*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
110
111
`kom-previous-kom' or `kom-next-unread-kom' is invoked."
  server)
112

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

nil means edit texts in the same window as the LysKOM buffer.
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 
          when editing is finished.
David Byers's avatar
X    
David Byers committed
122
123
a string or buffer means edit in the indicated buffer."
  server)
124

David Byers's avatar
X    
David Byers committed
125
126
127
(def-kom-var kom-view-commented-in-window 'other
  "*Where to view commented texts. See kom-write-texts-in-window for details"
  server)
David Byers's avatar
David Byers committed
128

David Byers's avatar
X    
David Byers committed
129
130
131
132
(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
133

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

139
140
141
142
143
(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
144
145
146
(def-kom-var kom-customize-format 'long
  "*Format of the customize buffer. Must be long or short."
  server)
147

David Byers's avatar
X    
David Byers committed
148
149
150
(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
151

Per Cederqvist's avatar
.  
Per Cederqvist committed
152

David Byers's avatar
X    
David Byers committed
153
154
155
(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
156
157


David Byers's avatar
X    
David Byers committed
158
159
160
(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
161

162

David Byers's avatar
X    
David Byers committed
163
164
165
166
(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
167

David Byers's avatar
David Byers committed
168
169
170
171
172
173
174
175
(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)

176
177
178
179
(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
180

David Byers's avatar
X    
David Byers committed
181
182
183
(def-kom-var kom-cite-string ">"
  "*String to insert before each line of a commented text."
  server)
184

David Byers's avatar
X    
David Byers committed
185
186
187
(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
188

David Byers's avatar
X    
David Byers committed
189
190
191
(def-kom-var kom-customize-in-window nil
  "*Where to customize LysKOM. See kom-write-texts-in-window"
  server)
Per Cederqvist's avatar
.  
Per Cederqvist committed
192

David Byers's avatar
X    
David Byers committed
193
194
195
(def-kom-var kom-prioritize-in-window nil
  "*Where to prioritize conferences. See kom-write-texts-in-window"
  server)
David Byers's avatar
David Byers committed
196

David Byers's avatar
X    
David Byers committed
197
198
199
(def-kom-var kom-default-mark 100
  "*If non-nil (must be an integer) then the user is not asked for type of mark."
  server)
Per Cederqvist's avatar
.  
Per Cederqvist committed
200

David Byers's avatar
X    
David Byers committed
201
202
(def-kom-var kom-reading-puts-comments-in-pointers-last t
  "*If Non-nil the texts are shown with comments references at the end."
David Byers's avatar
David Byers committed
203
204
  server
  inherited)
David Byers's avatar
David Byers committed
205

David Byers's avatar
David Byers committed
206
207
208
209
210
(def-kom-var kom-postpone-default 17
  "*The number of articles to postpone by default."
  server)


David Byers's avatar
X    
David Byers committed
211
212
(def-kom-var kom-dashed-lines t
  "*If Non-nil then all texts will be surrounded by lines of dashes."
David Byers's avatar
David Byers committed
213
214
  server
  inherited)
Per Cederqvist's avatar
.  
Per Cederqvist committed
215

216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
(def-kom-var kom-long-lines nil
  "*If non-nil, then some lines and borders will be made longer."
  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)



238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
(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
truncated.) A negative field width means left justify the contents.

The field width of %- is special. It specifies the maximum number of
dashes the print. The actual number will be the maximum minus the
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)



276
277
278
279
280
(def-kom-var kom-show-creating-software nil
  "*If non-nil then show the creating software of each text, if specitfied."
  server
  inherited)

David Byers's avatar
David Byers committed
281
282
(def-kom-var kom-show-author-at-end t
  "*If non-nil then the author will be shown at the end of each text."
David Byers's avatar
David Byers committed
283
284
  server
  inherited)
David Byers's avatar
David Byers committed
285

286
287
288
289
290
291
(def-kom-var kom-truncate-threshold nil
  "*If non-nil, truncate long texts when revieiwing.
If the text is longer (in lines) then the threshold it will be
truncated to `kom-truncate-show-lines' length."
  server)

292
(def-kom-var kom-truncate-show-lines 10
293
294
295
296
297
298
299
  "*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
300
(def-kom-var kom-print-number-of-unread-on-entrance t
Per Cederqvist's avatar
.  
Per Cederqvist committed
301
  "*If Non-nil then print automatically the number of unread articles when
David Byers's avatar
X    
David Byers committed
302
303
entering a conference."
  server)
Per Cederqvist's avatar
.  
Per Cederqvist committed
304

305
306
307
308
309
(def-kom-var kom-show-unread-in-frame-title t
  "*If non-nil, then show an unread indicator in the frame title of each
LysKOM session."
  server)

David Byers's avatar
X    
David Byers committed
310
(def-kom-var kom-presence-messages t
Per Cederqvist's avatar
.  
Per Cederqvist committed
311
312
  "*If non-nil, lyskom prints continuous info about what other people are doing.
Info is printed on the message line and never in the buffer. If minibuffer is
Linus Tolke's avatar
Linus Tolke committed
313
314
used then no message is printed.

David Byers's avatar
David Byers committed
315
316
317
318
A list of integers means show messages for those users.

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

319
320
321
322
323
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.

Linus Tolke's avatar
Linus Tolke committed
324
If you want the messages in the buffer you could set the variable 
David Byers's avatar
X    
David Byers committed
325
326
kom-presence-messages-in-buffer."
  server)
David Byers's avatar
David Byers committed
327

David Byers's avatar
X    
David Byers committed
328
(def-kom-var kom-presence-messages-in-buffer nil
Per Cederqvist's avatar
.  
Per Cederqvist committed
329
330
331
  "*If t, lyskom prints information about what other people are doing in buffer.
All printing is done just before the prompt.
If nil no messages are printed.
332
If 'presence then messages about people logging in, out and people 
David Byers's avatar
X    
David Byers committed
333
334
changing name is printed."
  server)
Per Cederqvist's avatar
.  
Per Cederqvist committed
335

David Byers's avatar
X    
David Byers committed
336
(def-kom-var kom-show-where-and-what t
Per Cederqvist's avatar
.  
Per Cederqvist committed
337
  "*Non-nil means kom-who-is-on shows from which machine the user is running
David Byers's avatar
X    
David Byers committed
338
339
and what he is doing."
  server)
David Byers's avatar
David Byers committed
340

341
342
343
344
(def-kom-var kom-show-since-and-when nil
  "*Non-nil means kom-who-is-on shows when the user connected and when
he was active last."
  server)
Per Cederqvist's avatar
.  
Per Cederqvist committed
345

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

David Byers's avatar
X    
David Byers committed
351
352
353
(def-kom-var kom-show-footnotes-immediately t
  "*Non-nil means show footnotes immediately following the text."
  server)
354

David Byers's avatar
X    
David Byers committed
355
(def-kom-var kom-follow-comments-outside-membership nil
356
357
358
  "*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
359
360
will not be shown."
  server)
361

David Byers's avatar
David Byers committed
362
363
364
365
(def-kom-var kom-follow-attachments t
  "*Follow attachments as if they are regular comments."
  server)

366
367
368
369
;;(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
370

David Byers's avatar
X    
David Byers committed
371
372
373
(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
374

David Byers's avatar
X    
David Byers committed
375
(def-kom-var kom-continuous-scrolling t
376
  "*Non-nil means scroll LysKOM window as text is inserted. The last viewed
David Byers's avatar
X    
David Byers committed
377
378
position (generally the most recent prompt) will always be visible."
  server)
379
380


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

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

390
391
392
393
394
395
(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
396
(def-kom-var kom-higher-priority-breaks nil
Per Cederqvist's avatar
.  
Per Cederqvist committed
397
398
  "*Non-nil means allow texts from conferences with highter priority to break in.
If the value is 'express then texts are allowed to break in the middle of a
399
comment chain.  Otherwise we don't let them in until the end of the comment
David Byers's avatar
X    
David Byers committed
400
401
tree."
  server)
Per Cederqvist's avatar
.  
Per Cederqvist committed
402

403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
(def-kom-var kom-server-priority-breaks nil
  "*Non-nil means allow servers with a higher priority to break in.
Valid values are express, express-letters, letters, after-conf, 
after-conf-letters, t and when-done.

express means break immediately when a text arrives in a prioritized
session.

express-letters means break immediately when a letter arrives in a 
prioritized session.

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

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

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

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

when-done means prompt user to go to the next session with unreads
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
432
(def-kom-var lyskom-view-text-hook nil
433
  "*Hook that is called before a text is shown. When the hooks are
434
435
436
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
to be shown.")
437
438


David Byers's avatar
X    
David Byers committed
439
(def-kom-var lyskom-send-message-hook '(lyskom-send-message-trim-newlines)
David Byers's avatar
David Byers committed
440
441
442
443
444
445
446
447
448
  "*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
be sent.")

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

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

David Byers's avatar
David Byers committed
455
456
457
458
(def-kom-var lyskom-send-text-hook nil
  "*Hook that is called before sending a text. Hook functions return t to
signal suggess and nil to prevent the text from being sent.")

David Byers's avatar
X    
David Byers committed
459
460
(def-kom-var lyskom-after-load-hook nil
  "*Hook to run once after lyskom is loaded.")
David Byers's avatar
David Byers committed
461

David Byers's avatar
David Byers committed
462
463
464
465
466
(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 
current conf-no and the second is the conf-no being changed to.")

David Byers's avatar
X    
David Byers committed
467
(def-kom-var lyskom-login-hook nil
468
  "*What to do when logged in.
469
470
This hook is called after we have logged in but before and command is
accepted from the keyboard. It is called immediately before
David Byers's avatar
X    
David Byers committed
471
kom-login-hook.")
472

David Byers's avatar
X    
David Byers committed
473
(def-kom-var kom-login-hook nil
Per Cederqvist's avatar
.  
Per Cederqvist committed
474
475
  "*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
476
477
any command is accepted from the keyboard. See also lyskom-login-hook."
  server)
David Byers's avatar
David Byers committed
478

479
480
481
482
483
484
(def-kom-var lyskom-add-sub-recipients-hook '(lyskom-annoying-verify-add-rcpt)
  "*Hook that is called when adding and removing recipients. When the
hooks are called, lyskom-add-sub-recipient-action is bound to the
action in progress, lyskom-add-sub-recipient-source-conf to the
conference being moved from (when lyskom-add-sub-recipient-action is
'move) and lyskom-add-sub-recipient-target-conf to the conference
David Byers's avatar
David Byers committed
485
being moved to/added to/subtracted from. See also
486
487
`lyskom-add-sub-recipient'.")

Per Cederqvist's avatar
.  
Per Cederqvist committed
488

David Byers's avatar
X    
David Byers committed
489
(def-kom-var kom-do-when-done '(kom-review-all-marked-texts kom-display-time)
Per Cederqvist's avatar
.  
Per Cederqvist committed
490
491
492
493
494
495
496
497
498
  "*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:
type			prompt
lyskom-function		from the lyskom-command-name function.
command			\"Kommandot:\" name of function or definition of
			lambda expression
David Byers's avatar
X    
David Byers committed
499
500
keyboard macro		\"Kommandot:\" keyboard macro definition."
  server)
David Byers's avatar
David Byers committed
501

David Byers's avatar
X    
David Byers committed
502
(def-kom-var kom-page-before-command nil
503
  "*This is a list of all commands before which the screen is cleared.
David Byers's avatar
X    
David Byers committed
504
505
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
506

David Byers's avatar
X    
David Byers committed
507
(def-kom-var kom-permissive-completion t
508
509
  "*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
510
511
for future use."
  server)
512
513


514
515
516
517
518
(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
519
(def-kom-var kom-membership-default-priority 'ask
Per Cederqvist's avatar
.  
Per Cederqvist committed
520
521
522
523
  "*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
524
525
Valid priorities are only the range 0-255."
  server)
David Byers's avatar
David Byers committed
526

David Byers's avatar
X    
David Byers committed
527
(def-kom-var kom-membership-default-placement 'last
Per Cederqvist's avatar
.  
Per Cederqvist committed
528
529
530
531
532
  "*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
David Byers's avatar
X    
David Byers committed
533
534
otherwise => the new conf is entered after all conferences."
  server)
David Byers's avatar
David Byers committed
535

David Byers's avatar
X    
David Byers committed
536
(def-kom-var lyskom-current-prompt nil
537
538
  "The current prompt or nil.
This is either nil, indicating that there is currently no prompt, or
David Byers's avatar
X    
David Byers committed
539
540
one a symbol indcating which command is prompted in the LysKOM buffer."
  local)
David Byers's avatar
David Byers committed
541

David Byers's avatar
X    
David Byers committed
542
543
544
545
546
547
(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)

548
549
550
551
552
553
554
555
556
(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
557
(def-kom-var kom-show-personal-messages-in-buffer t
558
559
560
561
  "*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
562
563
nonexistent) buffer in which the message is inserted."
  server)
David Byers's avatar
David Byers committed
564

David Byers's avatar
X    
David Byers committed
565
(def-kom-var kom-pop-personal-messages nil
566
  "*Non-nil means pop up a buffer with personal messages as they arrive.
David Byers's avatar
X    
David Byers committed
567
568
kom-show-personal-messages-in-buffer decides which buffer to pop."
  server)
569

570
571
572
(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
573
(def-kom-var kom-ding-on-new-letter nil
574
  "*Non-nil means ding if a message arrives in the letter box. See 
David Byers's avatar
X    
David Byers committed
575
576
kom-ding-on-priority-break for valid values."
  server)
577
578


David Byers's avatar
X    
David Byers committed
579
(def-kom-var kom-ding-on-priority-break 1
580
581
  "*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
582
583
program named by kom-audio-player."
  server)
David Byers's avatar
David Byers committed
584

David Byers's avatar
X    
David Byers committed
585
(def-kom-var kom-ding-on-wait-done 1
586
587
588
  "*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
589
590
function to call."
  server)
591

David Byers's avatar
X    
David Byers committed
592
(def-kom-var kom-ding-on-common-messages 0
593
594
595
596
597
598
599
  "*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
600
  server)
David Byers's avatar
David Byers committed
601

David Byers's avatar
X    
David Byers committed
602
(def-kom-var kom-ding-on-group-messages 1
603
  "*Non-nil means ding as group messages arrive.
604
605
606
607
608
609
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
610
  server)
611

David Byers's avatar
X    
David Byers committed
612
(def-kom-var kom-ding-on-personal-messages 2
613
  "*Non-nil means ding as personal messages arrive.
614
615
616
617
618
619
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
620
  server)
David Byers's avatar
David Byers committed
621
622


David Byers's avatar
David Byers committed
623
(def-kom-var kom-ding-on-no-subject 2
624
  "*How to ding if the user has not entered a subject line.
625
626
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
627
628
to call."
  server)
David Byers's avatar
David Byers committed
629

630

David Byers's avatar
X    
David Byers committed
631
(def-kom-var kom-audio-player "audioplay"
David Byers's avatar
David Byers committed
632
633
  "*Program to play audio files."
  server)
David Byers's avatar
David Byers committed
634

Per Cederqvist's avatar
.  
Per Cederqvist committed
635

636
637
638
639
640
641
642
643
(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)

644
645
646
647
(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
648
(def-kom-var kom-default-message-recipient 'group
David Byers's avatar
David Byers committed
649
650
651
  "*Determines default recipient of personal messages.

everybody means the default recipient is everybody.
David Byers's avatar
David Byers committed
652
653
654
655
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. 
David Byers's avatar
X    
David Byers committed
656
657
sender    means the sender of the last message received."
  server)
David Byers's avatar
David Byers committed
658
659


David Byers's avatar
X    
David Byers committed
660
(def-kom-var lyskom-filter-outgoing-messages t
661
  "*t if outgoing remote-control messages and automatic replies are not
662
663
to be displayed in the buffer."
  server)
David Byers's avatar
David Byers committed
664
665


David Byers's avatar
X    
David Byers committed
666
667
668
(def-kom-var kom-friends nil
  "*List of people whose names should be formatted using kom-friends-face."
  server)
669

670
671
672
673
(def-kom-var kom-morons nil
  "*List of people whose names should be formatted using kom-morons-face."
  server)

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

David Byers's avatar
David Byers committed
677
678
679
680
(def-kom-var kom-smileys t
  "*Non-nil means to reformat smileys in text."
  server)

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

David Byers's avatar
X    
David Byers committed
685
686
(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
687

David Byers's avatar
David Byers committed
688
(def-kom-var kom-autowrap t
David Byers's avatar
David Byers committed
689
690
  "*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
691
692
  server)

693
694
695
(def-kom-var kom-keep-alive-interval 180
  "*The number of seconds between periodic requests used to keep the session alive"
  server)
696

David Byers's avatar
David Byers committed
697
698
699
700
;;;
;;; lyskom-button-actions has been moved to swedish-strings.el on account
;;; of there being a bunch of language-dependent strings in it.
;;;
701
702


703
704
705
706
(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
707
(def-kom-var lyskom-url-protocol-regexp
708
709
  "\\(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
710

David Byers's avatar
X    
David Byers committed
711
(def-kom-var lyskom-text-buttons
712
713
  '(
    ;; Text numbers
714
715
716
717
718
719
    ("\\(\\<[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)
720
721
     )

David Byers's avatar
David Byers committed
722
723
724
725
726
    ;; Email

    ("[^()<>@,;:\"\\\\\000- ]+@[^\000- <>;,.'\"!:?) \t\012\014]+\\(\\.[^\000- <>;,.'\"!:?)]+\\)+"
     email 0 0 kom-url-face)

727
728
    ;; URLs

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

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

737
738
    ;; JySKom enhancements

David Byers's avatar
David Byers committed
739
740
741
    ("<(?m[|ö]te *\\([0-9]+\\)[^0-9>]*)?>" conf 0 1 nil)
    ("<(?text *\\([0-9]+\\)[^0-9>]*)?>" text 0 1 nil)
    ("<(?person *\\([0-9]+\\)[^0-9>]*)?>" pers 0 1 nil)
David Byers's avatar
David Byers committed
742

743
744
    ;; Info node reference

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

David Kågedal's avatar
David Kågedal committed
748
    )
749
750
751
752
753
754
  "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.
TYPE is the button type. Valid button types are defined in lyskom-button-actions
BUTTON-MATCH is the number of the parenthesized expression that is the actual button.
BUTTON-ARG-MATCH is the number of the expression to used as the button argument.
David Byers's avatar
X    
David Byers committed
755
FACE is the text face to apply to the button, or nil to use the default face.")
756

David Byers's avatar
X    
David Byers committed
757
(def-kom-var kom-url-viewer-preferences '("emacs"
758
759
                                          "windows"
                                          "w3")
David Byers's avatar
David Byers committed
760

761
  "*LysKOM will attempt to use URL viewers in the order specified here.
David Byers's avatar
David Byers committed
762
763
764
765
766
767
768
769
770
771
kom-url-managers is a list of all available viewers. Note that the elements
are all strings.

When you select an URL, this list is used to determine which URL
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
772
773
to some URL viewers."
  server)
774
775


David Byers's avatar
X    
David Byers committed
776
777
(def-kom-var kom-url-managers '(("default"
                            ".*"
778
                            "Browse-URL"
David Byers's avatar
X    
David Byers committed
779
780
                            lyskom-view-url-browse-url)
                           ("w3" 
781
782
783
			    "\\(http\\|gopher\\|ftp\\)"
			    "Emacs W3" 
			    lyskom-view-url-w3)
784
785
                           ("windows"
                            ".*"
786
                            "web brower"
787
                            lyskom-view-url-windows)
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
			   ("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
805
806
807
808
809
810
811
			    "\\(http\\|gopher\\|ftp\\|mailto\\|news\\|wais\\|file\\|telnet\\)"
			    "NCSA Mosaic"
			    lyskom-view-url-mosaic)
			   ("lynx"
			    "\\(http\\|gopher\\|ftp\\|mailto\\|news\\|wais\\|file\\|telnet\\)"
			    "Lynx"
			    lyskom-view-url-lynx))
812
813

  "List of URL managers. Each element is a list consisting of
David Byers's avatar
David Byers committed
814
815
816
817
818
(MANAGER-REGEXP PROTOCOLS NAME VIEW-FUNCTION). When LysKOM attempts to
view an URL, kom-url-viewer-preferences is scanned, and the URL
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
819
with the URL and the manager entry as arguments.")
David Byers's avatar
David Byers committed
820

David Byers's avatar
X    
David Byers committed
821
(def-kom-var kom-mosaic-command "/usr/local/bin/mosaic"
David Byers's avatar
David Byers committed
822
823
  "*Command to run to start Mosaic"
  server)
David Byers's avatar
David Byers committed
824

David Byers's avatar
X    
David Byers committed
825
(def-kom-var kom-netscape-command "netscape"
David Byers's avatar
David Byers committed
826
827
828
829
830
831
832
  "*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
833
834
is not. Instead, the latter should be \(\"netscape\" \"-d\" \"host:0\"\)"
  server)
David Byers's avatar
David Byers committed
835

Peter Liljenberg's avatar
Peter Liljenberg committed
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
(def-kom-var kom-lynx-terminal 'xterm
  "*Where to start Lynx.
Valid values are 'xterm (start Lynx in an xterm) and 'terminal (start
Lynx in Emacs terminal mode.")

(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.")
855

David Byers's avatar
X    
David Byers committed
856
(def-kom-var kom-confirm-multiple-recipients 'after
857
858
  "*Non-nil means ask the user for confirmation about recipients.
When the user writes a comment to a text with more than one recipient
859
860
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
861
862
sending the article."
  server)
863

David Byers's avatar
David Byers committed
864
865
866
867
868
869
870
871
(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
872
(def-kom-var kom-check-commented-author-membership t
873
874
  "*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
875
876
add them as recipients."
  server)
877

David Byers's avatar
X    
David Byers committed
878
(def-kom-var kom-inhibit-typeahead nil
879
  "*If non-nil, discard keyboard input that arrives while a LysKOM command is
David Byers's avatar
X    
David Byers committed
880
881
executing. "
  server)
882

David Byers's avatar
X    
David Byers committed
883
884
(def-kom-var kom-max-buffer-size nil
  "*If non-nil, ensure that buffers won't grow any larger than this"
885
  server)
David Byers's avatar
David Byers committed
886

David Byers's avatar
X    
David Byers committed
887
888
(def-kom-var lyskom-print-complex-dates t
  "If non-nil, print today and yesterday using a special format.")
889

David Byers's avatar
David Byers committed
890
891
892
893
894
(def-kom-var kom-show-namedays nil
  "*Non-nil means display namedays when running in swedish.
This variable will eventually be replaced with something else."
  server)

David Byers's avatar
David Byers committed
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
(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
to be a list of pairs, (SERVER . PROXY) where SERVER is the server for
which PROXY, a proxy specification is to be used. The special value t
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.")

910
911
912
913
914
915
916
917
918
919
920
921
922
(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
923
(def-kom-var kom-server-aliases
David Kågedal's avatar
David Kågedal committed
924
925
926
  '(("kom.lysator.liu.se" . "LysKOM")
    ("kom.ludd.luth.se" . "LuddKOM")
    ("rydkom.rydnet.lysator.liu.se" . "RydKOM")
David Kågedal's avatar
David Kågedal committed
927
928
    ("kom.csd.uu.se" . "CSD-KOM")
    ("striterax.medio.mh.se" . "MedioKOM")
929
    ("kom.mds.mdh.se" . "MdS-KOM")
930
    ("kom.stacken.kth.se" . "TokKOM")
David Byers's avatar
David Byers committed
931
    ("com.helsinki.fi" . "HelKOM")
932
933
    ("kom.cd.chalmers.se" . "CD-KOM")
    ("community.roxen.com" . "Roxen Community KOM"))
David Byers's avatar
X    
David Byers committed
934
  "*An alist mapping server names to shorter identification strings")
David Byers's avatar
David Byers committed
935

David Byers's avatar
X    
David Byers committed
936
937
938
(def-kom-var kom-ansaphone-on nil
  "t if automatic replies to personal messages are in effect."
  local)
939

940
941
942
943
(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
944
945
946
(def-kom-var kom-ansaphone-record-messages t
  "*t if messages are recorded while the ansaphone is on."
  server)
947

David Byers's avatar
X    
David Byers committed
948
949
950
(def-kom-var kom-ansaphone-show-messages t
  "*t if messages are to be shown when they are recorded."
  server)
951
952


David Byers's avatar
X    
David Byers committed
953
(def-kom-var lyskom-ansaphone-messages nil
954
  "Messages collected by the automatic reply facility.
David Byers's avatar
X    
David Byers committed
955
956
The most recent message is the first message in the list."
  local)
957

David Byers's avatar
X    
David Byers committed
958
959
960
(def-kom-var lyskom-ansaphone-when-set (current-time-string)
  "Time when the auto-reply facility was enabled."
  local)
961

David Byers's avatar
X    
David Byers committed
962
963
964
(def-kom-var kom-remote-control t
  "*t if LysKOM may be remotely controlled."
  server)
965

David Byers's avatar
X    
David Byers committed
966
(def-kom-var kom-remote-controllers nil 
David Byers's avatar
David Byers committed
967
968
  "*Persons who may control LysKOM using messages.By default you can
always control your own sessions. See kom-self-control for more
David Byers's avatar
X    
David Byers committed
969
970
information."
  server)
David Byers's avatar
David Byers committed
971

David Byers's avatar
X    
David Byers committed
972
(def-kom-var kom-self-control t
David Byers's avatar
David Byers committed
973
  "*If non-nil, remote control commands are accepted from sessions logged
David Byers's avatar
X    
David Byers committed
974
975
in as the same user as the current session."
  server)
David Byers's avatar
David Byers committed
976

David Byers's avatar
X    
David Byers committed
977
(def-kom-var kom-ansaphone-replies
David Byers's avatar
David Byers committed
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
  '((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)
    MESSAGE-TYPE is one of personal, group or common or nil
    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.

David Byers's avatar
X    
David Byers committed
997
998
If none of the elements match, KOM-ANSAPHONE-DEFAULT-REPLY is sent."
  server)
David Byers's avatar
David Byers committed
999

1000
1001
1002
1003
1004
1005
1006
1007
(def-kom-var kom-agree-text nil
  "*If non-nil the default text to use when agreeing with a text.
This variable can be a string, function or list. If a string, the
string is used as the message. If a function, the function is called
and the return value is used. If a list, one of the elements is selected
at random and used. This element may be a string, function or list."
  server)

David Byers's avatar
David Byers committed
1008
(def-kom-var kom-default-language nil
David Byers's avatar
David Byers committed
1009
  "*Which language to use for new sessions."
1010
1011
1012
  server 
  inherited
  protected)
David Byers's avatar
David Byers committed
1013

1014
(def-kom-var lyskom-language kom-default-language
David Byers's avatar
David Byers committed
1015
1016
  "The language currently in use."
  local
David Byers's avatar
X    
David Byers committed
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
  inherited
  protected)


(def-kom-var lyskom-edit-mode-map nil
  "Mode map for LysKOM edit."
  local)

(def-kom-var lyskom-edit-prefix nil
  "Mode-map for lyskom edit mode.")

(def-kom-var lyskom-customize-map nil
  "Keymap for the customize buffer"
  local)
Niels Möller's avatar
Niels Möller committed
1031

David Byers's avatar
David Byers committed
1032

David Kågedal's avatar
David Kågedal committed
1033
1034
1035
1036
1037
;;; =================================================================
;;;
;;; Language-dependent variables
;;;

David Byers's avatar
X    
David Byers committed
1038
1039
1040
(def-kom-var lyskom-onoff-table nil
  "A completion table for on and off selections."
  local)
David Kågedal's avatar
David Kågedal committed
1041

David Byers's avatar
David Byers committed
1042
1043
1044
1045
1046
(def-kom-var lyskom-language-codes nil
  "A list of ISO 639 language codes"
  local)
(put 'lyskom-language-codes 'lyskom-language-force t)

David Byers's avatar
X    
David Byers committed
1047
1048
1049
(def-kom-var lyskom-filter-predicate-list nil
      "A list of legal filter comparison predicates."
      local)
David Kågedal's avatar
David Kågedal committed
1050

David Byers's avatar
X    
David Byers committed
1051
1052
1053
(def-kom-var lyskom-filter-what nil
      "A list of legal filter conditions and their textual representation."
      local)
David Kågedal's avatar
David Kågedal committed
1054

David Byers's avatar
X    
David Byers committed
1055
1056
1057
(def-kom-var lyskom-filter-actions nil
      "A list of legal filter actions an their textual representation."
      local)
David Kågedal's avatar
David Kågedal committed
1058

David Byers's avatar
X    
David Byers committed
1059
1060
1061
(def-kom-var lyskom-filter-edit-map nil
  "Keymap for LysKOM filter edit"
  local)
David Kågedal's avatar
David Kågedal committed
1062

David Byers's avatar
X    
David Byers committed
1063
1064
1065
(def-kom-var lyskom-prioritize-mode-map nil
  "Keymap used in lyskom-prioritize-mode."
  local)
David Kågedal's avatar
David Kågedal committed
1066

David Byers's avatar
X    
David Byers committed
1067
1068
1069
(def-kom-var lyskom-prioritize-header-lines nil
  "Number of lines in the header of the prioritization buffer"
  local)
David Kågedal's avatar
David Kågedal committed
1070

David Byers's avatar
X    
David Byers committed
1071
1072
1073
(def-kom-var lyskom-prioritize-header nil
  "Header for the reprioritization buffer"
  inherited)
David Kågedal's avatar
David Kågedal committed
1074

David Byers's avatar
X    
David Byers committed
1075
1076
1077
(def-kom-var kom-ansaphone-default-reply nil
  "*Default message to send when the ansaphone is on."
  server)
David Kågedal's avatar
David Kågedal committed
1078

David Byers's avatar
David Byers committed
1079
1080
(def-kom-var kom-ispell-dictionary nil
  "*Dictionary to use for spell checking."
David Byers's avatar
David Byers committed
1081
1082
  server
  inherited)
David Byers's avatar
David Byers committed
1083

David Byers's avatar
X    
David Byers committed
1084
1085
(def-kom-var lyskom-button-actions nil
  "This variable defines valid button types in LysKOM. Each element is a
David Kågedal's avatar
David Kågedal committed
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
list consisting of (TYPE LABEL DEFAULT ACTIONS HINTS).
TYPE is the button type the entry defines
LABEL is a textual representation for the button type, used in menu titles. If
      it is a symbol, that symbol will be looked up using lyskom-get-string.
DEFAULT is the default action to take on a click. It must be a function.
ACTIONS are other possible actions. The format of this entry is described 
        below.
HINTS is a list of hints to override the default action. This is described 
      below.

The ACTIONS entry is used to construct a pop-up menu. It is a list consisting 
of lists with the format (STRING . FUNCTION). STRING is the menu label and
FUNCTION is the function to call when the menu item is selected.

The HINTS entry is used to generate hints that the default action should be 
overridden. It is a list containing elements (COMMAND . HINT) where COMMAND is
as interactive LysKOM command and HINT is a function to call. When a button
is generated while the command COMMAND is being executed, HINT is used as a 
hint for a new default action. The user has the option to ignore or used the 
hint.

David Byers's avatar
X    
David Byers committed
1107
Also see the function \"lyskom-add-button-action\"."
David Byers's avatar
David Byers committed
1108
1109
  local
  inherited)
David Kågedal's avatar
David Kågedal committed
1110

1111
1112
(put 'lyskom-button-actions 'lyskom-language-force t)

1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
(def-kom-var kom-show-imported-envelope-sender t
  "*If non-nil, show the envelope sender of texts imported by komimportmail."
  server)

(def-kom-var kom-show-imported-importer t
  "*If non-nil, show the name of the importer of an imported text."
  server)

(def-kom-var kom-show-imported-external-recipients t
  "*If non-nil, show the external recipients to an imported text."
  server)

1125
1126
1127
1128
1129
1130
1131
1132
1133
(def-kom-var kom-complete-numbers-before-names t
  "*If non-nil, reading conference and user names accepts the special 
forms ``m 4711'' or ``p 42'' as numeric references to conference 4711
and person 42 instead of trying to look for an object with a matching
name. If nil, any name matching the input will be preferred to a
numeric reference."
  server)


David Byers's avatar
X    
David Byers committed
1134
(def-kom-var kom-mercial nil
David Kågedal's avatar
David Kågedal committed
1135
1136
  "*When the user has seen all texts and has reached the view-time prompt,
this string is used as the argument to lyskom-tell-server.
David Byers's avatar
X    
David Byers committed
1137
1138
Users are encouraged to use their best sense of humor."
  server)
David Kågedal's avatar
David Kågedal committed
1139
1140


Niels Möller's avatar
Niels Möller committed
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
(defconst lyskom-commands
  '(
    describe-mode
    kom-slow-mode
    kom-quick-mode
    kom-send-message
    kom-create-conf
    kom-delete-conf
    kom-delete-text
    kom-display-time
    kom-go-to-conf
    kom-go-to-next-conf
    kom-jump
    kom-list-conferences 
    kom-list-persons
    kom-list-news
    kom-list-re
    kom-membership
David Byers's avatar
David Byers committed
1159
    kom-list-marks
Niels Möller's avatar
Niels Möller committed
1160
1161
1162
1163
1164
1165
    kom-postpone
    kom-set-session-priority
    kom-prioritize
    kom-status-person
    kom-status-conf
    kom-add-self
David Byers's avatar
David Byers committed
1166
    kom-change-priority
Niels Möller's avatar
Niels Möller committed
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
    kom-list-summary
    kom-sub-self
    kom-quit
    kom-recover 
    kom-start-anew
    kom-view
    kom-find-root-review
    kom-review-comments
    kom-review-tree
    kom-review-clear
    kom-review-last-normally-read
    kom-review-noconversion
    kom-review-next
    kom-find-root
    kom-review-by-to
    kom-review-more
    kom-review-first
    kom-review-all
    kom-view-commented-text
    kom-view-previous-commented-text
    kom-review-stack
    kom-review-presentation
    kom-review-backward
    kom-view-next-text
1191
1192
    kom-who-is-on
    kom-who-is-on-in-conference
Niels Möller's avatar
Niels Möller committed
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
    kom-who-am-i
    ;;   kom-display-who-buffer
    kom-list-clients
    kom-busy-wait
    kom-write-comment
    kom-comment-previous
    kom-write-footnote
    kom-private-answer
    kom-private-answer-previous
    kom-set-unread
    kom-write-text
    kom-send-letter
    kom-change-name
1206
    kom-change-parenthesis
Niels Möller's avatar
Niels Möller committed
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
    kom-change-password
    kom-change-supervisor
    kom-change-presentation
    kom-get-appreciation
    kom-get-abuse
    kom-mark-text
    kom-unmark-text
    kom-review-marked-texts
    kom-review-all-marked-texts
    kom-add-recipient
    kom-add-copy
1218
    kom-add-bcc
Niels Möller's avatar