annotate etc/gnuserv.README @ 0:376386a54a3c r19-14

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