|
149
|
1 ;;; gnuserv.el --- Lisp interface code between Emacs and gnuserv
|
|
|
2 ;; Copyright (C) 1989-1997 Free Software Foundation, Inc.
|
|
|
3
|
|
|
4 ;; Version: 3.1
|
|
|
5 ;; Author: Andy Norman (ange@hplb.hpl.hp.com), originally based on server.el
|
|
|
6 ;; Hrvoje Niksic <hniksic@srce.hr>
|
|
|
7 ;; Keywords: environment, processes, terminals
|
|
|
8
|
|
|
9 ;; This file is part of XEmacs.
|
|
|
10
|
|
|
11 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
12 ;; under the terms of the GNU General Public License as published by
|
|
|
13 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
14 ;; any later version.
|
|
|
15
|
|
|
16 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
17 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
19 ;; General Public License for more details.
|
|
|
20
|
|
|
21 ;; You should have received a copy of the GNU General Public License
|
|
|
22 ;; along with XEmacs; see the file COPYING. If not, write to the
|
|
|
23 ;; Free Software Foundation, 59 Temple Place - Suite 330,
|
|
|
24 ;; Boston, MA 02111-1307, USA.
|
|
|
25
|
|
0
|
26 ;;; Synched up with: Not in FSF.
|
|
|
27
|
|
149
|
28 ;;; Commentary:
|
|
|
29
|
|
|
30 ;; Gnuserv is run when Emacs needs to operate as a server for other
|
|
|
31 ;; processes. Specifically, any number of files can be attached for
|
|
|
32 ;; editing to a running XEmacs process using the `gnuclient' program.
|
|
|
33
|
|
|
34 ;; Use `M-x gnuserv-start' to start the server and `gnuclient files'
|
|
|
35 ;; to load them to XEmacs. When you are done with a buffer, press
|
|
|
36 ;; `C-x #' (`M-x gnuserv-edit'). You can put (gnuserv-start) to your
|
|
|
37 ;; .emacs, and enable `gnuclient' as your Unix "editor". When all the
|
|
|
38 ;; buffers for a client have been edited and exited with
|
|
|
39 ;; `gnuserv-edit', the client "editor" will return to the program that
|
|
|
40 ;; invoked it.
|
|
|
41
|
|
|
42 ;; Your editing commands and Emacs' display output go to and from the
|
|
|
43 ;; terminal or X display in the usual way. If you are running under
|
|
|
44 ;; X, a new X frame will be open for each gnuclient. If you are on a
|
|
|
45 ;; TTY, this TTY will be attached as a new device to the running
|
|
|
46 ;; XEmacs, and will be removed once you are done with the buffer.
|
|
|
47
|
|
|
48 ;; To evaluate a Lisp form in a running Emacs, use the `gnudoit'
|
|
|
49 ;; utility. For example `gnudoit "(+ 2 3)"' will print `5', whereas
|
|
|
50 ;; `gnudoit "(gnus)"' will fire up your favorite newsreader. Like
|
|
|
51 ;; gnuclient, `gnudoit' requires the server to be started prior to
|
|
|
52 ;; using it.
|
|
|
53
|
|
|
54 ;; For more information you can refer to man pages of gnuclient,
|
|
|
55 ;; gnudoit and gnuserv, distributed with XEmacs.
|
|
|
56
|
|
|
57 ;; gnuserv.el was originally written by Andy Norman as an improvement
|
|
|
58 ;; ver William Sommerfeld's server.el. Since then, a number of people
|
|
|
59 ;; have worked on it, including Bob Weiner, Darell Kindred, Arup
|
|
|
60 ;; Mukherjee, Ben Wing and Jan Vroonhof. It was completely rewritten
|
|
|
61 ;; (labeled as version 3) by Hrvoje Niksic in May 1997.
|
|
|
62
|
|
|
63 ;; Jan Vroonhof <vroonhof@math.ethz.ch> July/1996
|
|
|
64 ;; ported the server-temp-file-regexp feature from server.el
|
|
|
65 ;; ported server hooks from server.el
|
|
|
66 ;; ported kill-*-query functions from server.el (and made it optional)
|
|
|
67 ;; synced other behaviour with server.el
|
|
|
68 ;;
|
|
|
69 ;; Jan Vroonhof
|
|
|
70 ;; Customized.
|
|
|
71 ;;
|
|
|
72 ;; Hrvoje Niksic <hniksic@srce.hr> May/1997
|
|
|
73 ;; Completely rewritten. Now uses `defstruct' and other CL stuff
|
|
|
74 ;; to define clients cleanly. Dave, thanks!
|
|
0
|
75
|
|
|
76
|
|
149
|
77 ;;; Code:
|
|
|
78
|
|
|
79 (defconst gnuserv-rcs-version
|
|
|
80 "$Id: gnuserv.el,v 1.8 1997/05/18 03:40:06 steve Exp $")
|
|
0
|
81
|
|
120
|
82 (defgroup gnuserv nil
|
|
149
|
83 "The gnuserv suite of programs to talk to Emacs from outside."
|
|
|
84 :group 'environment
|
|
120
|
85 :group 'processes
|
|
|
86 :group 'terminals)
|
|
|
87
|
|
|
88
|
|
149
|
89 ;;;###autoload
|
|
|
90 (defcustom gnuserv-frame nil
|
|
|
91 "*The frame to be used to display all edited files.
|
|
|
92 If nil, then a new frame is created for each file edited.
|
|
|
93 If t, then the currently selected frame will be used.
|
|
|
94 If a function, then this will be called with a symbol `x' or `tty' as the
|
|
|
95 only argument, and its return value will be interpreted as above."
|
|
|
96 :tag "Gnuserv Frame"
|
|
|
97 :type '(radio (const :tag "Create new frame each time" nil)
|
|
|
98 (const :tag "Use selected frame" t)
|
|
|
99 (function-item :tag "Use main Emacs frame"
|
|
|
100 gnuserv-main-frame-function)
|
|
|
101 (function-item :tag "Use visible frame, otherwise create new"
|
|
|
102 gnuserv-visible-frame-function)
|
|
|
103 (function-item :tag "Create special Gnuserv frame and use it"
|
|
|
104 gnuserv-special-frame-function)
|
|
|
105 (function :tag "Other"))
|
|
|
106 :group 'gnuserv)
|
|
0
|
107
|
|
149
|
108 (defcustom gnuserv-done-function 'kill-buffer
|
|
|
109 "*Function used to remove a buffer after editing.
|
|
|
110 It is called with one BUFFER argument. Functions such as 'kill-buffer' and
|
|
|
111 'bury-buffer' are good values. See also `gnuserv-done-temp-file-function'."
|
|
|
112 :type '(radio (function-item kill-buffer)
|
|
|
113 (function-item bury-buffer)
|
|
|
114 (function :tag "Other"))
|
|
|
115 :group 'gnuserv)
|
|
0
|
116
|
|
149
|
117 (defcustom gnuserv-done-temp-file-function 'kill-buffer
|
|
|
118 "*Function used to remove a temporary buffer after editing.
|
|
|
119 It is called with one BUFFER argument. Functions such as 'kill-buffer' and
|
|
|
120 'bury-buffer' are good values. See also `gnuserv-done-temp-file-function'."
|
|
|
121 :type '(radio (function-item kill-buffer)
|
|
|
122 (function-item bury-buffer)
|
|
|
123 (function :tag "Other"))
|
|
|
124 :group 'gnuserv)
|
|
|
125
|
|
|
126 (defcustom gnuserv-find-file-function 'find-file
|
|
|
127 "*Function to visit a file with.
|
|
|
128 It takes one argument, a file name to visit."
|
|
120
|
129 :type 'function
|
|
|
130 :group 'gnuserv)
|
|
114
|
131
|
|
149
|
132 (defcustom gnuserv-view-file-function 'view-file
|
|
|
133 "*Function to view a file with.
|
|
|
134 It takes one argument, a file name to view."
|
|
|
135 :type '(radio (function-item view-file)
|
|
|
136 (function-item find-file-read-only)
|
|
|
137 (function :tag "Other"))
|
|
120
|
138 :group 'gnuserv)
|
|
0
|
139
|
|
149
|
140 (defcustom gnuserv-program "gnuserv"
|
|
|
141 "*Program to use as the editing server."
|
|
120
|
142 :type 'string
|
|
|
143 :group 'gnuserv)
|
|
0
|
144
|
|
149
|
145 (defcustom gnuserv-visit-hook nil
|
|
|
146 "*Hook run after visiting a file."
|
|
|
147 :type 'hook
|
|
|
148 :group 'gnuserv)
|
|
114
|
149
|
|
149
|
150 (defcustom gnuserv-done-hook nil
|
|
|
151 "*Hook run when done editing a buffer for the Emacs server.
|
|
|
152 The hook functions are called after the file has been visited, with the
|
|
|
153 current buffer set to the visiting buffer."
|
|
120
|
154 :type 'hook
|
|
|
155 :group 'gnuserv)
|
|
114
|
156
|
|
149
|
157 (defcustom gnuserv-kill-quietly nil
|
|
|
158 "*Non-nil means to kill buffers with clients attached without requiring confirmation."
|
|
|
159 :type 'boolean
|
|
120
|
160 :group 'gnuserv)
|
|
114
|
161
|
|
149
|
162 (defcustom gnuserv-temp-file-regexp "^/tmp/Re\\|/draft$"
|
|
|
163 "*Regexp which should match filenames of temporary files deleted
|
|
|
164 and reused by the programs that invoke the Emacs server."
|
|
|
165 :type 'regexp
|
|
|
166 :group 'gnuserv)
|
|
78
|
167
|
|
149
|
168 (defcustom gnuserv-make-temp-file-backup nil
|
|
|
169 "*Non-nil makes the server backup temporary files also."
|
|
120
|
170 :type 'boolean
|
|
|
171 :group 'gnuserv)
|
|
114
|
172
|
|
149
|
173
|
|
|
174 ;; The old functions are provided as aliases, to avoid breaking .emacs
|
|
|
175 ;; files. However, they are obsolete and should be avoided.
|
|
114
|
176
|
|
149
|
177 (defvaralias 'server-frame 'gnuserv-frame)
|
|
|
178 (defvaralias 'server-done-function 'gnuserv-done-function)
|
|
|
179 (defvaralias 'server-done-temp-file-function 'gnuserv-done-temp-file-function)
|
|
|
180 (defvaralias 'server-find-file-function 'gnuserv-find-file-function)
|
|
|
181 (defvaralias 'server-program 'gnuserv-program)
|
|
|
182 (defvaralias 'server-visit-hook 'gnuserv-visit-hook)
|
|
|
183 (defvaralias 'server-done-hook 'gnuserv-done-hook)
|
|
|
184 (defvaralias 'server-kill-quietly 'gnuserv-kill-quietly)
|
|
|
185 (defvaralias 'server-temp-file-regexp 'gnuserv-temp-file-regexp)
|
|
|
186 (defvaralias 'server-make-temp-file-backup 'gnuserv-make-temp-file-backup)
|
|
|
187
|
|
|
188
|
|
|
189 ;;; Internal variables:
|
|
|
190
|
|
|
191 (defstruct gnuclient
|
|
|
192 "An object that encompasses several buffers in one.
|
|
|
193 Normally, a client connecting to Emacs will be assigned an id, and
|
|
|
194 will request editing of several files.
|
|
|
195
|
|
|
196 ID - Client id (integer).
|
|
|
197 BUFFERS - List of buffers that \"belong\" to the client.
|
|
|
198 NOTE: one buffer can belong to several clients.
|
|
|
199 DEVICE - The device this client is on. If the device was also created.
|
|
|
200 by a client, it will be placed to `gnuserv-devices' list.
|
|
|
201 FRAME - Frame created by the client, or nil if the client didn't
|
|
|
202 create a frame.
|
|
|
203
|
|
|
204 All the slots default to nil."
|
|
|
205 (id nil)
|
|
|
206 (buffers nil)
|
|
|
207 (device nil)
|
|
|
208 (frame nil))
|
|
|
209
|
|
|
210 (defvar gnuserv-process nil
|
|
|
211 "The current gnuserv process.")
|
|
|
212
|
|
|
213 (defvar gnuserv-string ""
|
|
|
214 "The last input string from the server.")
|
|
|
215
|
|
|
216 (defvar gnuserv-current-client nil
|
|
|
217 "The client we are currently talking to.")
|
|
|
218
|
|
|
219 (defvar gnuserv-clients nil
|
|
|
220 "List of current gnuserv clients.
|
|
|
221 Each element is a gnuclient structure that identifies a client.")
|
|
|
222
|
|
|
223 (defvar gnuserv-devices nil
|
|
|
224 "List of devices created by clients.")
|
|
|
225
|
|
|
226 (defvar gnuserv-special-frame nil
|
|
|
227 "Frame created specially for Server.")
|
|
|
228
|
|
|
229 ;; We want the client-infested buffers to have some modeline
|
|
|
230 ;; identification, so we'll make a "minor mode".
|
|
|
231 (defvar gnuserv-minor-mode nil)
|
|
|
232 (make-variable-buffer-local 'gnuserv-mode)
|
|
|
233 (pushnew '(gnuserv-minor-mode " Server") minor-mode-alist)
|
|
|
234
|
|
|
235
|
|
|
236 ;; Sample gnuserv-frame functions
|
|
|
237
|
|
|
238 (defun gnuserv-main-frame-function (type)
|
|
|
239 "Returns a sensible value for the main Emacs frame."
|
|
|
240 (if (eq type 'x)
|
|
|
241 (car (frame-list))
|
|
|
242 nil))
|
|
0
|
243
|
|
149
|
244 (defun gnuserv-visible-frame-function (type)
|
|
|
245 "Returns a frame if there is a frame that is truly visible, nil otherwise.
|
|
|
246 This is meant in the X sense, so it will not return frames that are on another
|
|
|
247 visual screen. Totally visible frames are preferred. If none found, return nil."
|
|
|
248 (if (eq type 'x)
|
|
|
249 (cond ((car (filtered-frame-list 'frame-totally-visible-p
|
|
|
250 (selected-device))))
|
|
|
251 ((car (filtered-frame-list (lambda (frame)
|
|
|
252 ;; eq t as in not 'hidden
|
|
|
253 (eq t (frame-visible-p frame)))
|
|
|
254 (selected-device)))))
|
|
|
255 nil))
|
|
|
256
|
|
|
257 (defun gnuserv-special-frame-function (type)
|
|
|
258 "Creates a special frame for Gnuserv and returns it on later invocations."
|
|
|
259 (unless (frame-live-p gnuserv-special-frame)
|
|
|
260 (setq gnuserv-special-frame (make-frame)))
|
|
|
261 gnuserv-special-frame)
|
|
|
262
|
|
|
263
|
|
|
264 ;;; Communication functions
|
|
|
265
|
|
|
266 (defun gnuserv-sentinel (proc msg)
|
|
|
267 (case (process-status proc)
|
|
|
268 (exit (message "Gnuserv subprocess exited; restarting")
|
|
|
269 ;; This will also kill all the existing clients.
|
|
|
270 (gnuserv-start-1))
|
|
|
271 (closed (message "Gnuserv subprocess closed"))
|
|
|
272 (signal (message "Gnuserv subprocess killed"))))
|
|
|
273
|
|
|
274 (defun gnuserv-process-filter (proc string)
|
|
|
275 "Process gnuserv client requests to execute Emacs commands."
|
|
|
276 (setq gnuserv-string (concat gnuserv-string string))
|
|
|
277 ;; C-d means end of request.
|
|
|
278 (when (string-match "\C-d$" gnuserv-string)
|
|
|
279 (cond ((string-match "^[0-9]+" gnuserv-string) ; client request id
|
|
|
280 (let ((header (read-from-string gnuserv-string)))
|
|
|
281 ;; Set the client we are talking to.
|
|
|
282 (setq gnuserv-current-client (car header))
|
|
|
283 ;; Evaluate the expression
|
|
|
284 (condition-case oops
|
|
|
285 (eval (car (read-from-string gnuserv-string (cdr header))))
|
|
|
286 ;; In case of an error, write the description to the
|
|
|
287 ;; client, and then signal it.
|
|
|
288 (error (setq gnuserv-string "")
|
|
|
289 (gnuserv-write-to-client gnuserv-current-client oops)
|
|
|
290 (setq gnuserv-current-client nil)
|
|
|
291 (signal (car oops) (cdr oops)))
|
|
|
292 (quit (setq gnuserv-string "")
|
|
|
293 (gnuserv-write-to-client gnuserv-current-client oops)
|
|
|
294 (setq gnuserv-current-client nil)
|
|
|
295 (signal 'quit nil)))
|
|
|
296 (setq gnuserv-string "")))
|
|
|
297 (t
|
|
|
298 (error "%s: invalid response from gnuserv" gnuserv-string)
|
|
|
299 (setq gnuserv-string "")))))
|
|
|
300
|
|
|
301 (defun gnuserv-write-to-client (client-id form)
|
|
|
302 "Write the given form to the given client via the gnuserv process."
|
|
|
303 (when (eq (process-status gnuserv-process) 'run)
|
|
|
304 (let* ((result (format "%s" form))
|
|
|
305 (s (format "%s/%d:%s\n" client-id
|
|
|
306 (length result) result)))
|
|
|
307 (process-send-string gnuserv-process s))))
|
|
|
308
|
|
|
309
|
|
|
310 ;; The following two functions are helper functions, used by
|
|
|
311 ;; gnuclient.
|
|
|
312
|
|
|
313 (defun gnuserv-eval (form)
|
|
|
314 "Evaluate form and return result to client."
|
|
|
315 (gnuserv-write-to-client gnuserv-current-client (eval form))
|
|
|
316 (setq gnuserv-current-client nil))
|
|
|
317
|
|
|
318 (defun gnuserv-eval-quickly (form)
|
|
|
319 "Let client know that we've received the request, and then eval the form.
|
|
|
320 This order is important as not to keep the client waiting."
|
|
|
321 (gnuserv-write-to-client gnuserv-current-client nil)
|
|
|
322 (setq gnuserv-current-client nil)
|
|
|
323 (eval form))
|
|
114
|
324
|
|
149
|
325
|
|
|
326 ;; "Execute" a client connection, called by gnuclient. This is the
|
|
|
327 ;; backbone of gnuserv.el.
|
|
|
328 (defun gnuserv-edit-files (type list &optional flags)
|
|
|
329 "For each (line-number . file) pair in LIST, edit the file at line-number.
|
|
|
330 The visited buffers are memorized, so that when \\[gnuserv-edit] is invoked
|
|
|
331 in such a buffer, or when it is killed, or the client's device deleted, the
|
|
|
332 client will be invoked that the edit is finished.
|
|
114
|
333
|
|
149
|
334 TYPE should either be a (tty TTY TERM PID) list, or (x DISPLAY) list.
|
|
|
335 If FLAGS is `quick', just edit the files in Emacs.
|
|
|
336 If FLAGS is `view', view the files read-only."
|
|
|
337 (or (not flags)
|
|
|
338 (memq flags '(quick view))
|
|
|
339 (error "Invalid flag %s" flags))
|
|
|
340 (let* ((old-device-num (length (device-list)))
|
|
|
341 (new-frame nil)
|
|
|
342 (dest-frame (if (functionp gnuserv-frame)
|
|
|
343 (funcall gnuserv-frame (car type))
|
|
|
344 gnuserv-frame))
|
|
|
345 ;; The gnuserv-frame dependencies are ugly.
|
|
|
346 (device (cond ((frame-live-p dest-frame)
|
|
|
347 (frame-device dest-frame))
|
|
|
348 ((null dest-frame)
|
|
|
349 (case (car type)
|
|
|
350 (tty (apply 'make-tty-device (cdr type)))
|
|
|
351 (x (make-x-device (cadr type)))
|
|
|
352 (t (error "Invalid device type"))))
|
|
|
353 (t
|
|
|
354 (selected-device))))
|
|
|
355 (frame (cond ((frame-live-p dest-frame)
|
|
|
356 dest-frame)
|
|
|
357 ((null dest-frame)
|
|
|
358 (setq new-frame (make-frame nil device))
|
|
|
359 new-frame)
|
|
|
360 (t (selected-frame))))
|
|
|
361 (client (make-gnuclient :id gnuserv-current-client
|
|
|
362 :device device
|
|
|
363 :frame new-frame)))
|
|
|
364 (setq gnuserv-current-client nil)
|
|
|
365 ;; If the device was created by this client, push it to the list.
|
|
|
366 (and (/= old-device-num (length (device-list)))
|
|
|
367 (push device gnuserv-devices))
|
|
|
368 ;; Visit all the listed files.
|
|
|
369 (while list
|
|
|
370 (let ((line (caar list)) (path (cdar list)))
|
|
|
371 (select-frame frame)
|
|
|
372 ;; Visit the file.
|
|
|
373 (funcall (if (eq flags 'view)
|
|
|
374 gnuserv-view-file-function
|
|
|
375 gnuserv-find-file-function)
|
|
|
376 path)
|
|
|
377 (goto-line line)
|
|
|
378 (run-hooks 'gnuserv-visit-hook)
|
|
|
379 ;; Don't memorize the quick and view buffers.
|
|
|
380 (when (null flags)
|
|
|
381 (pushnew (current-buffer) (gnuclient-buffers client))
|
|
|
382 (setq gnuserv-minor-mode t))
|
|
|
383 (pop list)))
|
|
|
384 (cond ((and flags (device-on-window-system-p device))
|
|
|
385 ;; Exit if on X device, and quick or view.
|
|
|
386 ;; NOTE: if the client is to finish now, it must absolutely
|
|
|
387 ;; /not/ be included to the list of clients. This way the
|
|
|
388 ;; client-ids should be unique.
|
|
|
389 (gnuserv-write-to-client (gnuclient-id client) nil))
|
|
|
390 (t
|
|
|
391 ;; Else, the client gets a vote.
|
|
|
392 (push client gnuserv-clients)
|
|
|
393 ;; Explain buffer exit options. If dest-frame is nil, the
|
|
|
394 ;; user can exit via `delete-frame'. OTOH, if FLAGS are
|
|
|
395 ;; nil and there are some buffers, the user can exit via
|
|
|
396 ;; `gnuserv-edit'.
|
|
|
397 (if (and (null flags)
|
|
|
398 (gnuclient-buffers client))
|
|
|
399 (message (substitute-command-keys
|
|
|
400 "Type `\\[gnuserv-edit]' to finish editing"))
|
|
|
401 (or dest-frame
|
|
|
402 (message (substitute-command-keys
|
|
|
403 "Type `\\[delete-frame]' to finish editing"))))))))
|
|
0
|
404
|
|
149
|
405
|
|
|
406 ;;; Functions that hook into Emacs in various way to enable operation
|
|
|
407
|
|
|
408 ;; Defined later.
|
|
|
409 (add-hook 'kill-emacs-hook 'gnuserv-kill-all-clients t)
|
|
|
410
|
|
|
411 ;; A helper function; used by others.
|
|
|
412 (defun gnuserv-buffer-clients (buffer)
|
|
|
413 "Returns a list of clients to which BUFFER belongs."
|
|
|
414 (let ((client gnuserv-clients)
|
|
|
415 res)
|
|
|
416 (while client
|
|
|
417 (if (memq buffer (gnuclient-buffers (car client)))
|
|
|
418 (push (car client) res))
|
|
|
419 (pop client))
|
|
|
420 res))
|
|
|
421
|
|
|
422 ;; This function makes sure that a killed buffer is deleted off the
|
|
|
423 ;; list for the particular client.
|
|
|
424 ;;
|
|
|
425 ;; This hooks into `kill-buffer-hook'. It is *not* a replacement for
|
|
|
426 ;; `kill-buffer' (thanks God).
|
|
|
427 (defun gnuserv-kill-buffer-function ()
|
|
|
428 "Remove the buffer from the buffer lists of all the clients it belongs to.
|
|
|
429 Any client that remains \"empty\" after the removal is informed that the
|
|
|
430 editing has ended."
|
|
|
431 (let* ((buf (current-buffer))
|
|
|
432 (clients (gnuserv-buffer-clients buf)))
|
|
|
433 (while clients
|
|
|
434 (callf2 delq buf (gnuclient-buffers (car clients)))
|
|
|
435 ;; If no more buffers, kill the client.
|
|
|
436 (when (null (gnuclient-buffers (car clients)))
|
|
|
437 (gnuserv-kill-client (car clients)))
|
|
|
438 (pop clients))))
|
|
|
439
|
|
|
440 (add-hook 'kill-buffer-hook 'gnuserv-kill-buffer-function)
|
|
|
441
|
|
|
442 ;; Ask for confirmation before killing a buffer that belongs to a
|
|
|
443 ;; living client.
|
|
|
444 (defun gnuserv-kill-buffer-query-function ()
|
|
|
445 (or gnuserv-kill-quietly
|
|
|
446 (not (gnuserv-buffer-clients (current-buffer)))
|
|
|
447 (yes-or-no-p
|
|
|
448 (format "Buffer %s belongs to gnuserv client(s); kill anyway? "
|
|
|
449 (current-buffer)))))
|
|
|
450
|
|
|
451 (add-hook 'kill-buffer-query-functions
|
|
|
452 'gnuserv-kill-buffer-query-function)
|
|
|
453
|
|
|
454 (defun gnuserv-kill-emacs-query-function ()
|
|
|
455 (or gnuserv-kill-quietly
|
|
|
456 (not (some 'gnuclient-buffers gnuserv-clients))
|
|
|
457 (yes-or-no-p "Gnuserv buffers still have clients; exit anyway? ")))
|
|
|
458
|
|
|
459 (add-hook 'kill-emacs-query-functions
|
|
|
460 'gnuserv-kill-emacs-query-function)
|
|
|
461
|
|
|
462 ;; If the device of a client is to be deleted, the client should die
|
|
|
463 ;; as well. This is why we hook into `delete-device-hook'.
|
|
|
464 (defun gnuserv-check-device (device)
|
|
|
465 (when (memq device gnuserv-devices)
|
|
|
466 (let ((client gnuserv-clients))
|
|
|
467 (while client
|
|
|
468 (when (eq device (gnuclient-device (car client)))
|
|
|
469 ;; we must make sure that the server kill doesn't result in
|
|
|
470 ;; killing the device, because it would cause a device-dead
|
|
|
471 ;; error when `delete-device' tries to do the job later.
|
|
|
472 (gnuserv-kill-client (car client) t))
|
|
|
473 (pop client)))
|
|
|
474 (callf2 delq device gnuserv-devices)))
|
|
|
475
|
|
|
476 (add-hook 'delete-device-hook 'gnuserv-check-device)
|
|
|
477
|
|
|
478 (defun gnuserv-temp-file-p (buffer)
|
|
114
|
479 "Return non-nil if BUFFER contains a file considered temporary.
|
|
|
480 These are files whose names suggest they are repeatedly
|
|
|
481 reused to pass information to another program.
|
|
|
482
|
|
149
|
483 The variable `gnuserv-temp-file-regexp' controls which filenames
|
|
114
|
484 are considered temporary."
|
|
|
485 (and (buffer-file-name buffer)
|
|
149
|
486 (string-match gnuserv-temp-file-regexp (buffer-file-name buffer))))
|
|
0
|
487
|
|
149
|
488 (defun gnuserv-kill-client (client &optional leave-frame)
|
|
|
489 "Kill the gnuclient CLIENT.
|
|
|
490 This will do away with all the associated buffers. If LEAVE-FRAME,
|
|
|
491 the function will not remove the frames associated with the client."
|
|
|
492 ;; Order is important: first delete client from gnuserv-clients, to
|
|
|
493 ;; prevent gnuserv-buffer-done-1 calling us recursively.
|
|
|
494 (callf2 delq client gnuserv-clients)
|
|
|
495 ;; Process the buffers.
|
|
|
496 (mapc 'gnuserv-buffer-done-1 (gnuclient-buffers client))
|
|
|
497 (unless leave-frame
|
|
|
498 (let ((device (gnuclient-device client)))
|
|
|
499 ;; kill frame created by this client (if any), unless
|
|
|
500 ;; specifically requested otherwise.
|
|
|
501 ;;
|
|
|
502 ;; note: last frame on a device will not be deleted here.
|
|
|
503 (when (and (gnuclient-frame client)
|
|
|
504 (frame-live-p (gnuclient-frame client))
|
|
|
505 (second (device-frame-list device)))
|
|
|
506 (delete-frame (gnuclient-frame client)))
|
|
|
507 ;; If the device is live, created by a client, and no longer used
|
|
|
508 ;; by any client, delete it.
|
|
|
509 (when (and (device-live-p device)
|
|
|
510 (memq device gnuserv-devices)
|
|
|
511 (second (device-list))
|
|
|
512 (not (member* device gnuserv-clients
|
|
|
513 :key 'gnuclient-device)))
|
|
|
514 ;; `gnuserv-check-device' will remove it from `gnuserv-devices'.
|
|
|
515 (delete-device device))))
|
|
|
516 ;; Notify the client.
|
|
|
517 (gnuserv-write-to-client (gnuclient-id client) nil))
|
|
0
|
518
|
|
149
|
519 ;; Do away with the buffer.
|
|
|
520 (defun gnuserv-buffer-done-1 (buffer)
|
|
|
521 (let ((clients (gnuserv-buffer-clients buffer)))
|
|
|
522 (while clients
|
|
|
523 (callf2 delq buffer (gnuclient-buffers (car clients)))
|
|
|
524 (when (null (gnuclient-buffers (car clients)))
|
|
|
525 (gnuserv-kill-client (car clients)))
|
|
|
526 (pop clients))
|
|
|
527 ;; Get rid of the buffer
|
|
|
528 (save-excursion
|
|
|
529 (set-buffer buffer)
|
|
|
530 (run-hooks 'gnuserv-done-hook)
|
|
|
531 (setq gnuserv-minor-mode nil)
|
|
|
532 (funcall (if (gnuserv-temp-file-p buffer)
|
|
|
533 gnuserv-done-temp-file-function
|
|
|
534 gnuserv-done-function)
|
|
|
535 buffer))))
|
|
0
|
536
|
|
149
|
537
|
|
|
538 ;;; Higher-level functions
|
|
0
|
539
|
|
149
|
540 ;; Choose a `next' server buffer, according to several criteria, and
|
|
|
541 ;; return it. If none appropriate are found, return nil.
|
|
|
542 (defun gnuserv-next-buffer ()
|
|
|
543 (let* ((frame (selected-frame))
|
|
|
544 (device (selected-device))
|
|
|
545 client)
|
|
|
546 (cond
|
|
|
547 ;; If we have a client belonging to this frame, return
|
|
|
548 ;; the first buffer from it.
|
|
|
549 ((setq client
|
|
|
550 (car (member* frame gnuserv-clients :key 'gnuclient-frame)))
|
|
|
551 (car (gnuclient-buffers client)))
|
|
|
552 ;; Else, look for a device.
|
|
|
553 ((and
|
|
|
554 (memq (selected-device) gnuserv-devices)
|
|
|
555 (setq client
|
|
|
556 (car (member* device gnuserv-clients :key 'gnuclient-device))))
|
|
|
557 (car (gnuclient-buffers client)))
|
|
|
558 ;; Else, try to find just any client, and return its first buffer.
|
|
|
559 (gnuserv-clients
|
|
|
560 (car (gnuclient-buffers (car gnuserv-clients))))
|
|
|
561 ;; Oh, give up.
|
|
|
562 (t nil))))
|
|
0
|
563
|
|
149
|
564 (defun gnuserv-buffer-done (buffer)
|
|
|
565 "Mark BUFFER as \"done\" for its client(s).
|
|
|
566 Calls `gnuserv-done-function' and returns another gnuserv buffer as a
|
|
|
567 suggestion for the new current buffer."
|
|
|
568 ;; Check whether this is the real thing.
|
|
|
569 (unless (gnuserv-buffer-clients buffer)
|
|
|
570 (error "%s does not belong to a gnuserv client" buffer))
|
|
|
571 ;; Backup/ask query.
|
|
|
572 (if (gnuserv-temp-file-p buffer)
|
|
|
573 ;; For a temp file, save, and do NOT make a non-numeric backup
|
|
|
574 ;; Why does server.el explicitly back up temporary files?
|
|
|
575 (let ((version-control nil)
|
|
|
576 (buffer-backed-up (not gnuserv-make-temp-file-backup)))
|
|
|
577 (save-buffer))
|
|
|
578 (if (and (buffer-modified-p)
|
|
|
579 (y-or-n-p (concat "Save file " buffer-file-name "? ")))
|
|
|
580 (save-buffer buffer)))
|
|
|
581 (gnuserv-buffer-done-1 buffer)
|
|
|
582 (gnuserv-next-buffer))
|
|
0
|
583
|
|
149
|
584 ;; Called by `gnuserv-start-1' to clean everything. Hooked into
|
|
|
585 ;; `kill-emacs-hook', too.
|
|
|
586 (defun gnuserv-kill-all-clients ()
|
|
|
587 "Kill all the gnuserv clients. Ruthlessly."
|
|
|
588 (mapc 'gnuserv-kill-client gnuserv-clients))
|
|
|
589
|
|
|
590 ;; Actually start the process. Kills all the clients before-hand.
|
|
|
591 (defun gnuserv-start-1 (&optional leave-dead)
|
|
|
592 (gnuserv-kill-all-clients)
|
|
|
593 (when gnuserv-process
|
|
|
594 (set-process-sentinel gnuserv-process nil)
|
|
|
595 (condition-case ()
|
|
|
596 (delete-process gnuserv-process)
|
|
|
597 (error nil)))
|
|
|
598 ;; If we already had a server, clear out associated status.
|
|
|
599 (unless leave-dead
|
|
|
600 (setq gnuserv-string "")
|
|
|
601 (setq gnuserv-current-client nil)
|
|
|
602 (let ((process-connection-type t))
|
|
|
603 (setq gnuserv-process
|
|
|
604 (start-process "gnuserv" nil gnuserv-program)))
|
|
|
605 (set-process-sentinel gnuserv-process 'gnuserv-sentinel)
|
|
|
606 (set-process-filter gnuserv-process 'gnuserv-process-filter)
|
|
|
607 (process-kill-without-query gnuserv-process)))
|
|
|
608
|
|
|
609
|
|
|
610 ;;; User-callable functions:
|
|
0
|
611
|
|
|
612 ;;;###autoload
|
|
|
613 (defun gnuserv-start (&optional leave-dead)
|
|
|
614 "Allow this Emacs process to be a server for client processes.
|
|
149
|
615 This starts a gnuserv communications subprocess through which
|
|
0
|
616 client \"editors\" (gnuclient and gnudoit) can send editing commands to
|
|
149
|
617 this Emacs job. See the gnuserv(1) manual page for more details.
|
|
0
|
618
|
|
|
619 Prefix arg means just kill any existing server communications subprocess."
|
|
|
620 (interactive "P")
|
|
|
621 ;; kill it dead!
|
|
149
|
622 (and gnuserv-process
|
|
|
623 (not leave-dead)
|
|
|
624 (message "Restarting gnuserv"))
|
|
|
625 (gnuserv-start-1 leave-dead))
|
|
0
|
626
|
|
149
|
627 ;;;###autoload
|
|
|
628 (defun gnuserv-edit (&optional arg)
|
|
|
629 "Mark the current gnuserv editing buffer as \"done\", and switch to next one.
|
|
0
|
630
|
|
149
|
631 The `gnuserv-done-function' is used to dispose of the buffer after marking it
|
|
|
632 as done; it is `kill-buffer' by default.
|
|
0
|
633
|
|
149
|
634 Files that match `gnuserv-temp-file-regexp' are considered temporary and
|
|
|
635 are saved unconditionally and backed up if `gnuserv-make-temp-file-backup'
|
|
|
636 is non-nil. They are disposed of using `gnuserv-done-temp-file-function'.
|
|
114
|
637
|
|
149
|
638 When all of a client's buffers are marked as \"done\", the client is notified.
|
|
0
|
639
|
|
149
|
640 If invoked with a prefix argument, or if there is no gnuserv process
|
|
|
641 running, only starts server process. Invoked with \\[gnuserv-edit]."
|
|
0
|
642 (interactive "P")
|
|
149
|
643 (if (or arg (not gnuserv-process)
|
|
|
644 (memq (process-status gnuserv-process) '(signal exit)))
|
|
|
645 (gnuserv-start)
|
|
|
646 (switch-to-buffer (or (gnuserv-buffer-done (current-buffer))
|
|
|
647 (current-buffer)))))
|
|
0
|
648
|
|
149
|
649 ;;;###autoload
|
|
|
650 (global-set-key "\C-x#" 'gnuserv-edit)
|
|
0
|
651
|
|
|
652 (provide 'gnuserv)
|
|
|
653
|
|
78
|
654 ;;; gnuserv.el ends here
|
