annotate lisp/gnuserv.el @ 217:d44af0c54775 r20-4b7

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