Mercurial > hg > xemacs-beta
annotate etc/gnuserv.README @ 5428:73eef12660cd
Converted gnuserv docs to GPLv3 or later.
| author | Mats Lidell <matsl@xemacs.org> |
|---|---|
| date | Sat, 06 Nov 2010 22:57:08 +0100 |
| parents | 807b51903ed4 |
| children | 863f16484873 |
| rev | line source |
|---|---|
| 2437 | 1 **** WARNING **** |
| 2 This file was never meant to be proper documentation, and now is bitrotted. | |
| 3 See the file gnuserv.1 and/or the sources for more information. | |
| 428 | 4 |
|
5428
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
5 |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
6 This file is part of XEmacs. |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
7 |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
8 XEmacs is free software: you can redistribute it and/or modify it |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
9 under the terms of the GNU General Public License as published by the |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
10 Free Software Foundation, either version 3 of the License, or (at your |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
11 option) any later version. |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
12 |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
13 XEmacs is distributed in the hope that it will be useful, but WITHOUT |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
16 for more details. |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
17 |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
18 You should have received a copy of the GNU General Public License |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
19 along with XEmacs. If not, see <http://www.gnu.org/licenses/>. |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
20 |
|
73eef12660cd
Converted gnuserv docs to GPLv3 or later.
Mats Lidell <matsl@xemacs.org>
parents:
2437
diff
changeset
|
21 |
| 428 | 22 **** |
| 23 NOTE: This version of gnuserv has some enhancements over the original version | |
| 24 distributed by Andy Norman. See the end of this file for more details. | |
| 25 **** | |
| 26 | |
| 27 To install, copy gnuserv.el into a directory on your GNU Emacs | |
| 28 load-path. Edit Makefile and change INCLUDES to point to the src | |
| 29 directory underneath your emacs source tree (or make yourself a | |
| 30 config.h file in this directory by hand, starting with config.h.proto | |
| 31 as a first cut) and type: | |
| 32 | |
| 33 make | |
| 34 | |
| 35 This should compile the server and the two clients. Now put gnuserv, | |
| 36 gnuclient and gnudoit in a directory that users have in their executable | |
| 37 search paths. | |
| 38 | |
| 39 File : Description | |
| 40 ---------------------------------------------------------------- | |
| 41 Makefile : Makefile to build gnuserv | |
| 42 LICENSE : GNU General License | |
| 43 README : this file | |
| 44 gnuclient.c : editor client C code | |
| 45 gnudoit.c : eval client C code | |
| 46 gnuserv.1 : gnuserv man page | |
| 47 gnuserv.c : server C code | |
| 48 gnuserv.el : server LISP code for GNU Emacs V18,V19, | |
| 49 XEmacs/Lucid Emacs and Epoch V4 | |
| 50 gnuserv.h : server/client C header file | |
| 51 gnuslib.c : server/client C common code | |
| 52 src.x11fns.diff : diffs to src/x11fns to raise window (for emacs18) | |
| 53 | |
| 54 config.h.proto : Use this file as the starting point for constructing | |
| 55 a config.h if you don't have access to the | |
| 56 one that was used when compiling your emacs. | |
| 57 | |
| 58 If you find *any* problems at all with gnuserv, or you can think of better | |
| 59 ways of doing things (especially remote file access), please e-mail me at one | |
| 60 of the addresses below. | |
| 61 | |
| 62 ange@hplb.hpl.hp.com | |
| 63 ange@hpl.hp.co.uk | |
| 64 ...!hplabs!hplb!ange | |
| 65 ...!ukc!hplb!ange | |
| 66 | |
| 67 | |
| 68 | |
| 69 This version of gnuserv has been enhanced by a number of people, including | |
| 70 Bob Weiner <weiner@mot.com>, Darrell Kindred <dkindred@cmu.edu>, | |
| 71 Arup Mukherjee <arup@cmu.edu>, and Ben Wing <ben@xemacs.org>. The | |
| 72 modifications are basically as follows: | |
| 73 | |
| 74 Bob Weiner: | |
| 75 | |
| 76 Integrated support for several versions of emacs. New requests | |
| 77 from gnuclient cause the creation of new frames. Removed the | |
| 78 restriction on the length of the string passed to gnudoit. Later | |
| 79 added a server-done-function variable to control what happens to | |
| 80 a buffer after the user is done with it. Mods to each of the .c | |
| 81 files as well as gnuserv.el. | |
| 82 | |
| 83 Darrell Kindred: | |
| 84 | |
| 85 Removed the restriction on the length of the string returned from | |
| 86 a gnudoit request, for the purposes of unix/internet sockets. | |
| 87 Allow the gnudoit request to be read from stdin if it's not | |
| 88 specified on the command line. Internet sockets are not opened | |
| 89 unless the GNU_SECURE variable is specified. Unix sockets are | |
| 90 created in a protected ancestral directory, since many Unix | |
| 91 variants don't enforce socket permissions properly. An internet | |
| 92 socket accepting local connections is not opened by default | |
| 93 because this would make it possibly to override all security on | |
| 94 the unix socket. See the man page for details. Unless told to do | |
| 95 otherwise by a command-line argument, gnuclient and gnudoit now | |
| 96 try to open a unix socket by default if support for them was | |
| 97 compiled in. Mods to each of the .c files and to gnuserv.el. | |
| 98 | |
| 99 Arup Mukherjee: | |
| 100 Removed the restriction on the length of the string returned from | |
| 101 a gnudoit request, for the purposes of sysv ipc. Added support | |
| 102 for the "gnuserv-frame" variable allowing you to specify control | |
| 103 whether or not new screens are created in response to each | |
| 104 gnuclient request. Made a number of other bugfixes and changes to | |
| 105 the lisp part of the code, allowing gnuserv to work properly with | |
| 106 newer emacs versions. All the changes are listed in the changelog | |
| 107 at the beginning of gnuserv.el. Also fixed up the man page to | |
| 108 reflect the new gnuserv features. On HPs, stopped the "-r" | |
| 109 parameter (in gnuclient) from defaulting to /net/<remotehost>. | |
| 110 Not all installations want this, and it's much harder to debug | |
| 111 when things stop working. Changed the man page to reflect this. | |
| 112 Mods to each of the .c files, gnuserv.el and gnuserv.1 | |
| 113 | |
| 114 More recently - added Xauth(1X11)-style authentication to gnuserv (as | |
| 115 of version 2.1). Although the code is completely new, credit is | |
| 116 due to Richard Caley <rjc@cogsci.edinburgh.ac.uk> ... he wrote a | |
| 117 prototype implementation from which I borrowed the basic | |
| 118 mechanism for hooking Xauth into gnuserv. | |
| 119 | |
| 120 Ben Wing: | |
| 121 Added gnuattach. |